Shell Installation Guide
From Fivedash Wiki
Contents |
[edit] Shell Installation Guide
[edit] Step 1 - Dependencies
- FIVEDASH requires Python, Apache 2, mod_python, and PostgreSQL
- Ensure that you have Python 2.5 or higher, Apache 2, mod_python, a recent version of PostgreSQL with the admin pack[1], Psycopg 2 and OpenSSL (if you intend to use SSL) installed.
- If reasonable, test that the above are functioning properly
On a recent release of Ubuntu the following should work swimmingly...
# apt-get install libapache2-mod-python python-psycopg2 postgresql-contrib openssl
[edit] Step 2 - Create database cluster or restart PostgreSQL
On most Linux systems, the cluster is already created for you.
All you need to do is restart PostgreSQ:. This is necessary to avoid potential conflict with an unresolved connection from the previous step. Such conflicts are rare, but I got one on a very clean system recently, so it's best to be safe... Prior to restarting, you may wish to review the connection settings in pg_hba.conf (especially if you wish to administer the system using an external program like psql). To restart PostgreSQL on Ubuntu, do something like this:
# /etc/init.d/postgresql-8.2 restart
If you are on some kind of Unix, you'll need to create a database cluster. Follow the instructions in your PostgreSQL installation bundle - it isn't very hard. The last step should be to start the server process or daemon.
[edit] Step 3 - Install FIVEDASH
# mkdir fivedash-0.7 # cd fivedash-0.7 # wget http://fivedash.googlecode.com/files/fivedash-0.7.tar.gz # tar -xzf fivedash-0.7.tar.gz # ./install
[edit] Step 4 - Configure Apache
Find out which user apache is running as (on Ubuntu it's usually www-data)
# ps -ef | grep apache (or ps -ef | grep httpd)
Change ownership of /var/fivedash to that user
# chown -R www-data:www-data /var/fivedash
Copy the apache config file to a useful location and enable it
# cp /usr/local/fivedash/apache2/sites-available/fivedash /etc/apache2/sites-available/ # ln -s /etc/apache2/sites-available/fivedash /etc/apache2/sites-enabled/
On some systems, mod_python and SSL need to be enabled (a separate step). This generally involves a minor modification to one of the Apache config files, or the placing of a symlink in one of the config directories. On some systems, this works:
# a2enmod mod_python # a2enmod ssl
Restart apache
# apache2ctl restart
[edit] Step 5 - Log in
If you configured SSL during the install, point your browser to https://your.server.name:7080
- (otherwise... http://your.server.name:7080)
[edit] Mac Users
[edit] Leopard
Instead of Step 4 above:
Change ownership of /var/fivedash to www (ps -ajx | grep apache lists the user as _www but the underscore is not required)
# chown -R www /var/fivedash
Copy the apache config file to a useful location
# cp /usr/local/fivedash/apache2/sites-available/fivedash /private/etc/apache2/other/fivedash.conf
- You may also need to enable SSL, and/or mod_python in your apache config
Restart apache
# apachectl restart
[edit] Tiger
FIVEDASH can be installed on Tiger, but it will take some effort. It's more likely to work if you install Apache 2, mod_python, PostgreSQL[2] and Psycopg 2 from source, which means you'll need to have the development tools installed. Some additional notes:
- If you haven't already, install python 2.5 and make sure you compile mod_python using the --with-python switch
- The source installer may not work. You may have to copy program files, create the /var/fivedash tree, and configure apache manually...
- A lot of work, but it is possible
[edit] Pre-existing SSL configurations
During the install, you should be given an option to use your existing keys.
[edit] Notes
- ↑ The admin pack (sometimes referred to as the contrib module) for PostgreSQL contains encryption algorithms used by fivedash.
- ↑ If you install PostgreSQL from source, the admin pack is a separate step. There should be a contrib directory in your build directory with its own makefile. Install that after installing PostgreSQL.
