ProCKSI

= ProCKSI Framework =

(needs to be updated)

== Installation and Basic Configuration ==

This section describes the installation and configuration of the ProCKSI server component. This includes the configuration of the web server and the database.

The server component will be installed into the home directory of the user ''procksi''. Therefore, make sure that it is on a separate partition / hard disk with much space. In the best case, this will be a RAID system.

Get the latest release of the server component, referred to in the following as ''RELEASE'', and extract it into ''/home/procksi/RELEASE.'' 

{{{

tar -xvzf RELEASE.tgz

}}}

Create a softlink from ''RELEASE'' to a generic directory ''/home/procksi/latest''. This will be accessed by the web server:

{{{

ln -s /home/procksi/RELEASE /home/procksi/latest

}}}

In order to test new versions, referred in the following as ''TEST'', before taking them officially online, create a softlink from ''TEST'' to a generic directory ''/home/procksi/test''. This will be accessed by the web server:

{{{

ln -s /home/procksi/TEST /home/procksi/test

}}}

In case that you want to bring the test version online, just delete the softlinks and repeat the previous steps for the new release. Please make sure that always both softlinks exist!

Make sure that a shared directory for log and lock files of all releases exists:

{{{

mkdir /home/procksi/logs

mkdir /home/procksi/locks

}}}

Change into the administrative directory and run the installation script. Change the server settings, database settings and directory settings if necessary.

{{{

cd /home/procksi/latest/admin

./setup.pl

}}}

Check that all links in ''/home/procksi/latest/bin'' point to the correct files of the operating system.