Before installing phpSATk please check the Requirements section.
Download a package (either zip, tar.gz or tar.bz2) of the current version and unpack it somewhere outside your document root. Move “phpsatk” and “phpsatk-lib” to a place where they can stay (that is, again, outside your document root). Now copy (or symlink if you webserver allows this) the contents of the htdocs folder contained in the package to the place beneath your document root where you want to reach your phpSATk installation.
Open “config.php” in an editor and change the paths defined as SAT_LOCAL and SAT_INCLUDEDIR to the paths to your “phpsatk” (LOCAL) and “phpsatk-lib” (INCLUDEDIR) directories.
Continue with the steps described below to finish the installation.
Get the sources from SVN, using the default subversion client this is done by executing
svn co http://phpsatk.eenterphace.org/svn/phpsatk/HEAD phpsatk
which will put the development version of phpSATk into a folder named phpsatk in the current folder, it will contain three folder (htdocs, phpsatk, phpsatk-lib).
If you are planning a site installation move the top-level phpsatk folder somewhere globally (but not web-)accessible - maybe /usr/share/phpsatk if you are on linux). You will also need to modify htdocs/config.php, set SAT_INCLUDEDIR to the path to the global phpsatk-lib dir (if you have followed the suggestion of /usr/share/phpsatk this will be /usr/share/phpsatk/phpsatk-lib). Now repeat the following steps for each repository/installation you want to do.
Copy the phpsatk (the one contained in the top-level directory) folder to create a local repository. It must not be accessible through you webserver - place it outside you docroot. If not doing a site installation also place phpsatk-lib in the same directory (also not accessible from the web). Now copy or symlink (if your webserver permits this) the htdocs folder into you document root. Depending on you setup you will need to modify config.php in the directory which was formerly called htdocs to match the directories.
Continue with the steps described below to finish the installation.
You will propably want to use some modules which need a database to work (especially the Authentication/Authorization modules), so create a database and import the dump (MySQL only atm) which is located in the global (phpsatk-lib) repository under contrib/base.sql. It contains tables for access control and the job server. This step will be included in some installation/packaging mechanism some day, but don’t expect this to come soon.
Change all permissions so that the user php is running on can read but not write them. The files in you document root need to be accessible by the webserver too (in most situations this will be the same user). Now give the php user write privileges to the cache folder (and its subdirectories) below the local repository (called ‘phpsatk’ before).
Go to you local repository and copy conf/local.conf.xml.dist to conf/local.conf.xml. Now open this file and change the given values to ones that match you environment.
The directives you want to change are:
You are now ready to open you web-browser and point it to the URL where your ‘htdocs’ directory is located.