For the really impatient ¶

Open a terminal as a normal user and call:

curl http://github.com/dim/retrospectiva/raw/2-0-stable/script/remote/retrospectiva_installer.rb | ruby

For the less impatient ¶

Installing Retrospectiva has never been easier. If administrating your server is not exactly your thing, or if you just want to try Retrospectiva out without installing dozens of packages, the Single-Step-Installer might be the right choice for you.

It works with all Unix based systems (such as Linux, MacOS, BSD, Solaris, etc. ). Only a few things are required:

• ruby 1.8.x (run ruby -v to check the version)
• curl or wget, gzip (should always be installed)

Please see the Troubleshooting section at bottom of this page for help on requirements.

Installation

Change to the directory where you want to install it in and let the installer do the rest!

cd /home/user/webapps
curl http://github.com/dim/retrospectiva/raw/2-0-stable/script/remote/retrospectiva_installer.rb | ruby

If curl fails (because it is not installed on your system), just try wget instead:

cd /home/user/webapps
wget -O - http://github.com/dim/retrospectiva/raw/2-0-stable/script/remote/retrospectiva_installer.rb | ruby

Done! The script will create a new retrospectiva/ folder inside the chosen directory and download all the required components automatically. Furthermore, it will set-up and initialize a sqlite3 database for you.

When the script completes, you will be provided with next steps. After you have completed step 2, 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.

Notes

The Single-Step-Installer provides a basic set-up of useful features. If you feel even a little comfortable to manage your own server, please have a look at the step-by-step Installation guide, which provides a more comprehensive set of options for your Retrospectiva installation.

Troubleshooting ¶

If ruby is missing on your server you can install it via:

# Ubuntu, Debian, etc.
sudo apt-get install ruby libruby rdoc ri ruby1.8-dev

# Fedora, CentOS, RedHat, etc.
sudo yum install ruby ruby-irb ruby-libs ruby-rdoc ruby-devel readline

# MacOS
# Follow this link: http://rubyosx.rubyforge.org/

Should something go wrong during the installation, please create a ticket