Installation

Minimum requirements

Before starting installation you must check the system minimum requirements: Please consult the respective manuals for installation and configuration of web server and libraries.

Operative environment configuration

The PHP environment must be configured to support all systems and libraries above indicated.
Some PHP paramaters must be set as below:

on php.ini
alternatively on Apache module (/etc/httpd/conf/httpd.conf):
<IfModule mod_php4.c>
	AddIcon /icons/php4.gif .php3 .php4 .php .phtml
	php_admin_flag safe_mode off
	php_admin_flag register_globals on
	php_value arg_separator.output "&amp;"
	php_value session.save_handler user
	php_value session.use_trans_sid 0
</IfModule>
To configure PHP in general or for different configuration methods, please consult the official guide and annotations on www.php.net site.

Please check also the users disk quota that must be enough to handle files and database.

NOTE:If you get a CGI Timeout Error on IIS server during installation, you must change the CGI Script Timeout parameter to a bigger value (Administrative Tools -> Internet Information Services -> right click on Web Sites icon -> Properties -> Home Directory -> Configuration -> Process Options -> change CGI script timeout value to 1200 seconds).

AIOCP Installation

Please verify that the operative environment is correctly setup as described in previous paragraphs.

Copy all content of AIOCP folder on server's web root or in a subfolder.
If you are using FTP to upload an AIOCP encoded version, please make sure to set your FTP client's transfer mode to BINARY before upload PHP files to your server.

Now it's possible to proceed in two ways:

Automatic installation

This procedure allows you to automatically install database and configure the fundamental configuration parameters.

Please modify the following files and directories permissions in a way that could be writeable by the software (chmod 777 on unix-like systems): These files permissions could be restored to read-only after installation.
In case of errors, you could modify manually these files as described in next paragraph.

Using a common web browser (program used to viewing sites as Microsoft® Internet Explorer or Netscape®), go to your site where the installation program of AIOCP is located: http://<yoursite>/install/install.php

If the operative environment is setup correctly you must see the AIOCP installation module.

Note that:
The installation module is available only in english language due to it's crucial function.
This installation process will destroy any database data from previous installations. Please backup any previous installation data.
Due to large amount of data of some database tables, the installation process may take a while, so please be patient and do not interrupt the installation process until finish.

To start installation you must fill the form and push the INSTALL button.

The following are the requested fields on installation form: If the installation process has been completed without errors the system is ready for it's first execution.
Now you can safely remove the install folder and restore to read-only the configurations files permissions.
In case of installation errors you could complement or repeat the installation process using the following procedure.

Manual installation

To manually install AIOCP you must edit the configuration files and install the database.

Edit configuration files

The essential files and constants for AIOCP installation are:

Database installation

Inside the install folder there are two SQL files for database schema and data. These files must be used in the correct order: If you wish to change the tables prefix (the default is aiocp_) you must use a text editor with search and replace tool and operate the following substitutions: To execute these SQL files you could use the MySQL commands from server shell:
mysql
mysql> CREATE DATABASE AIOCP;
shell> mysql AIOCP < aiocp_db_structure.sql
shell> mysql AIOCP < aiocp_db_data.sql
In the example above AIOCP is the database name.

Alternatively (if you have configured the admin/phpMyAdmin/config.inc.php file) you could use the utility http://<mysite>/admin/phpMyAdmin/index.php by which you could create database ans execute SQL statements.

Post installation

Once the installation process is completed you must:

AIOCP configuration

After installation, AIOCP must be ready to use all of it's functions except email sending for wich you must manually edit the following file: The remaining configuration files are listed below. I suggest to NOT edit these files unless you are sure about what are you doing: To configure the e-commerce payment and shipping modules, please consult the relative documentation located on the following folders:

Access and Security

Once completed the installation and configuration procedures above described, you may access to AIOCP system pointing your web browser to http://<yoursite>/admin/code/index.php and using the following data: To protect your site and guarantee exclusive access, please remember to change the password using the editor Users -> User Editor. This editor allows you also to set your data and preferences.

To increase the security level I strongly suggest to protect the entire admin folder using a web based user authentication system.
One of the quickest ways to secure a directory on an Apache web server is to implement Htaccess web based user authentication. For more information, please consult http://httpd.apache.org/docs/howto/htaccess.html.
If you are using a different web server please consult the relative documentation.