Installation instructions for Earth 0.2
Download Earth
Untar the distribution and move to the root directory of the distribution
tar zxvf earth-0.2.tar.gz cd earth-0.2
Dependencies
Earth is built using the language Ruby, the Ruby code coverage tool rcov, the web development framework Ruby on Rails, and the database Postgres. If you don't have these installed follow these instructions.
Create Earth database
Create three databases "earth_production", "earth_test" and "earth_development" which are accessible by the user "earth", with the password "earth". If you need help with this see these instructions.
Migrate the database
rake db:migrate
Create Certificate
Create two new directories in the config directory to store both the certificate and keys.
mkdir config/certificates mkdir config/keys chmod 755 config/certificates chmod 755 config/keys
Create a certificate in order to authenticate a plugin by signing it.
script/create_cert
Enter the details required from the create_cert script.
Sign and Install File Monitor Plugin
Authenticate the File Monitor.
script/earth_plugins sign lib/earth_plugins/file_monitor.rb
Install the plugin into Earth.
script/earth_plugins install lib/earth_plugins/file_monitor.rb main_loop Earthd
Run the unit tests (optional)
For a good deal of confidence that everything is set up correctly and working, run the unit tests. It's as simple as:
rake
Start Earth daemon
./script/earthd start
Choose a directory to watch
The first time you use Earth, pick a directory to watch that is small and doesn't have too many files. That way it won't take too long for the daemon to do the initial indexing of its contents.
./script/earthd add directory_to_watch
Monitoring the daemon
Depending on the size of the directory to be watched, the daemon will take a while to index the directory. Then after that, it will quickly see changes.
To see the status of the daemon
./script/earthd status
Start web application
The simplest way to get started is to use "Webrick" the default web server that comes with Rails.
./script/server
Use the Earth web application
Point your browser at http://localhost:3000 and you're using Earth!
