Dimitrij Denissenko h1. Install Ruby, RubyGems & Rails The great Ruby Enterprise Edition couldn't make this step simpler, just visit http://www.rubyenterpriseedition.com/download.html and follow the instructions. For _customized_ installation, please follow the links below: * Debian/Ubuntu #1 - http://jamesconstable.co.uk/web-development/installing-ruby-on-rails-via-passenger-on-ubuntu-804/ * Debian/Ubuntu #2 - https://help.ubuntu.com/community/RubyOnRails * CentOS/Red Hat #1 - http://www.catapult-creative.com/2009/02/04/installing-rails-on-centos-5/ * CentOS/Red Hat #2 - http://blog.phatsite.com/?p=25 * FreeBSD - http://arthur.one2net.co.ug/index.php?id=28 h1. Install Retrospectiva h6. Step 1: Download - "Latest Version":http://github.com/dim/retrospectiva/tarball/master bq. Note: To keep your version up-to-date, you can instead simply clone the repository @git clone git://github.com/dim/retrospectiva.git@ h6. Step 2: Unpack {{{ tar xzvf dim-retrospectiva-*.tar.gz }}} h1. Configure Retrospectiva h6. Step 1: Create Database and User Create a database and a database user for Retrospectiva. Login to the database console or interface and execute the following SQL code (MySQL example, please set your own password): {{{ CREATE DATABASE IF NOT EXISTS retrospectiva; GRANT ALL PRIVILEGES ON retrospectiva.* TO "retrospectiva"@"localhost" IDENTIFIED BY "xxxxxxxxxxx"; }}} h6. Step 2: Configure Database * Create the configuration for your preferred database from @config/templates/database.DBNAME.yml@ to @config/database.yml@. Example (MySQL):<br/> @cp config/templates/database.mysql.yml config/database.yml@ * Now open the @config/database.yml@ with a text editor and adjust the configuration details in the *production* section. bq. Note: Please see the "Rails - Getting Started Guide":http://guides.rubyonrails.org/getting_started.html#configuring-a-database for more information. h6. Step 3: Load Initial Content {{{ rake RAILS_ENV=production db:setup }}} If you have configured your @config/database.yml@ correctly, the database will be filled with the initial schema and content. h1. Run retrospectiva As a quick test, you can run Retrospectiva in the built-in +Webrick+ web-server, simply by calling: {{{ ruby script/server -e production -p3000 }}} Retrospectiva will start and will be accessible on http://your-hostname:3000. To enter the administration environment login as *admin* and use *password* as password. Please login to the admin area and review/update the settings under +Admin/Setup+. For more information see/update the [[Configuration]] page. Please do not forget to change this default password after successful login. h1. Tasks Background tasks can be configured/managed directly in the Administration interface of Retrospectiva. You still need a (single) cron-job to trigger the execution. Call @crontab -e@ and paste the following line: {{{ * * * * * RAILS_ENV=production ruby /path/to/retrospectiva/script/retro_tasks }}} h1. Deploy You can integrate Retrospectiva within your own web server, please see the [[Deployment]] page in the [[Retrospectiva|Retrospectiva Wiki]] for more information. 2006-12-01T16:08:26+00:00 2009-12-02T12:57:07+00:00 53