You need mysql, apache, php4 or php3 with corresponding modules that we have installed in the process of setting up the other CMS's so they won't be described here. You also need to install phplib and either phpmyadmin or webmin-mysql or some other gui interface to mysql unless you are happy with working with mysql through the command line.

Configuring the Action Apps config files

First go to the install page to have the ActionApps install documentation to refer to. Following those instructions we created a home directory to put APC in and installed the latest ActionApps from sourceforge using CVS. Installing from CVS makes it a lot easier to update you APC-AA installation however if you are happy with the feature set in the current stable version of APC-AA then you might be better to just download the latest stable version in a tar.gz file and then unpack it into /var/www. The installation process is then the same as once you have installed the APC-AA directory using CVS.

To install from cvs do the following:
    $ cd /var/www/
    $ sudo cvs -d:pserver:anonymous@cvs.apc-aa.sourceforge.net:/cvsroot/apc-aa login
press enter at the password prompt
    $ cvs -z3 -d:pserver:anonymous@cvs.apc-aa.sourceforge.net:/cvsroot/apc-aa co apc-aa
This will create the apc-aa directory in /var/www/
Then we had to add an alias to apache to let it access the apc-aa directory.

Alias /apc-aa/ /var/www/apc-aa/

<Directory /var/www/apc-aa/>
        Options Indexes MultiViews
        AllowOverride None
        Order allow,deny
        Allow from all
</Directory>

As apc-aa uses the .php3 extension for its php scripts we should edit the /etc/apache/httpd.conf and add .php3 and .phtml on the end of the

AddType application/x-httpd-php .php .php3 .phtml

Then we will restart apache

    # /etc/init.d/apache restart

Note - for some reason I found that I always had to restart apache twice to get it to run.

The next step is to edit the include/config.php3 script and configure it for the local machine. The first thing to do is uncomment line 20 and make sure that it is the correct path to the include directory in apc-aa.

$AA_INC_PATH = "/var/www/apc-aa/include/";

If this path is set wrong then you will get an error every time you try to open a php3 file in the apc-aa directory. Really annoying. Change path names to where they are on the local machine using the alias that was set up in apache. The lines you need to edit are  23, 28, 31, 34, 37, 38, or at least that is what they were in the config.php3 script when I installed action apps the first time I installed it. Change the database hostname, username and password to the one we set up ie cmsuser. Change line 115 to relect your hostname and then also edit /etc/apache/httpd.conf and add an alias for the img_upload directory and create the img_upload directory.
   $ mkdir /var/www/apc-aa/img_upload
and in the /etc/apache/httpd.conf add

Alias /img_upload/ /var/www/apc-aa/img_upload/

<Directory /var/www/apc-aa/img_upload>

Options Indexes MultiViews

AllowOverride None
Order allow,deny
Allow from all

</Directory>

In the include/locsessi.php3, locsess.php3 and locauth.php3 tell the script were the phplib directory has been placed in your machine was

$_PHPLIB["libdir"] = "";

changed to

$_PHPLIB["libdir"] = "phplib/";

Now we have to get the database created and populated see 4.2 in the manual (We used mysqladmin rather than createdb as is said in the install manual) then add the user and populate the database with the tables. First create the database either using or phpmyadmin or from the command line:
    $ mysql -u cmsuser -p
enter the password for cmsuser
   mysql> CREATE DATABASE aadb;
   mysql> q
then we have to populate the database with tables:
    $ cd /var/www/apc-aa/
Again enter the mysql cmsuser password when prompted.
    $ mysql -u cmsuser -p aadb;
   mysql> . doc/aadb.sql
   mysql> q

When you go to http://www.sydney.wilderness.org.au/apc-aa/admin/setup.php3 you are greeted with the setup page. Click on init to create the superadmin account. Enter the details for your superadmin account and click on create. You will then be asked to login using this account and create your first slice. Click on the Add Slice link and then log in using the username and the password of the superadmin account that you have just created. You will then be taken to the Create New Slice/Module page in the AA Control Panel. See here for information on how to create a slice.