The installation instructions assumes that you have a fully functioning web server.
These are the minimum requirements needed before installation of AIOCP can be successful:
For help with the installation and configuration of the web server and the required libraries please refer to the specific manuals.
If installing on your home or office computer (for local testing only) there are a number of packages for the various operating systems that will assist in establishing these requirements:
On remote, hosted or dedicated servers the configuration and availability of these applications will depend on the host provider or the operating system that is installed upon the server. If you encounter a problem with your host provider and the use of AIOCP check the support and services page.
In order for AIOCP to work properly, you will need to have a functioning MySQL DBMS prior to beginning the install process.
AIOCP will create a database and the associated tables, provided the details are correctly entered, during the installation process. On occasion however, it may be necessary to create the database ahead of time. Just make a note of the appropriate settings before proceeding with the installation:
[MySQL] mysql - u root UPDATE mysql.user SET Password=OLD_PASSWORD('mypassword') WHERE User='root'; FLUSH PRIVILEGES; quit;
arg_separator.output = "&" magic_quotes_gpc = On magic_quotes_runtime = Off magic_quotes_sybase = Off
php_value arg_separator.output "&" php_value magic_quotes_gpc On php_value magic_quotes_runtime Off php_value magic_quotes_sybase Off
When installing AIOCP for the first time, verify the system requirements. Assuming you have a working Apache/IIS web server, with PHP and a MySQL DBMS, you are on your way to installing AIOCP.
The AIOCP upgrade process may vary at each release. Detailed instructions are contained on the UPGRADE.TXT file attached to each AIOCP release.
AIOCP can be downloaded from SourceForge.net. The file is a compressed archive so you will need an utility program, either locally or on your host server, that can "unzip" the file (i.e. WinZip, WinRAR, 7Zip). Ensure that you choose latest stable release version.
We are assuming you have established a working web server, with the necessary requirements, and that you know where to put files to display on the web server.
Unzip the distribution file into a directory under your web server root. If you are using the Apache web server, this is typically c:\apache group\apache\htdocs on the Windows OS and /usr/local/apache/htdocs or /var/www/ on a UNIX-like system but it my vary particularly on hosted servers and between different distributions of GNU-Linux OS.
What you do to install AIOCP on a remote host is largely dependant upon the facilities your host provides - with regard to Control Panel software and connection resources. It may also depend upon your own skills concerning server access methods. A simple and typical procedure may involve: unzip the AIOCP distribution file to a local directory on your local computer and then FTP the files to the host server placing them either directly under, or in, a directory under the web server root. There are many free FTP programs available for this operation, such as Filezilla. A Google search or visit to any of the open source resource sites will assist you in finding a suitable tool.
When you have finished uploading the files and folders, change the files owner to the Web server user (typically "www-data" or "apache"). On POSIX based systems (like Unix, Linux, etc), change to the AIOCP directory and enter the following system command (substitute the user name appropriate for your system): chown -R apache.
Change the files access permission so that all user can write into the them. On POSIX based systems change to the AIOCP directory and enter the following system command: chmod -R 777. For security reasons, you must properly set the permissions of these files at the end of the installation process.
This type of installation will automatically install the database and will configure the essential system parameters. The installation process will delete any data of previous installations of AIOCP, reason why in this case it is advisable to make backup copy of these data.
Point your Web browser (i.e. Mozilla Firefox or Internet Explorer) to the AIOCP installation script (http://www.yoursite.com/install/install.php or http://yoursite.com/aiocp_folder/install/install.php). To start the installation you must fill up the form completely and press the button INSTALL.
If the installation completed succesfully the system is ready for the first execution. At this point you can jump to the Post Installation and Configuration section.
In case the installation did not complete succesfully you can use the manual procedure described in the next section.
In order to manually install AIOCP you must edit some configuration files and install the database.
The essential files and configuration parameters are:
In the install folder there are all the SQL files with the structure and data of the database:
If you want to change the prefix of the tables you must use a text editor with the search and replace function and perform the following substitutions:
To execute the SQL files you can use the DBMS commands from the command shell of the server. For MySQL you can use the following syntax:
mysql -u root -p mysql> CREATE DATABASE AIOCP; mysql> quit shell> mysql -u root -p AIOCP < aiocp_db_structure.sql shell> mysql -u root -p AIOCP < aiocp_db_data.sql
As another option you can use an external DBMS manager (i.e. phpMyAdmin) to create the database and run the SQL files by using the specific commands.
Once the installation is completed you must:
Once the above installation procedure is successfully completed, AIOCP will work in "basic" mode. Some additional configuration steps are required in order to activate some features (i.e. email, PDF, e-commerce payments) and to personalize some settings to fit your needs. All you have to do is to manually edit the following configuration files:
Configuration files are self-explanatory. If you encounter a problem please check the Support and Services page.
Once the installation and configuration procedures are completed, you can access the administration section by pointing your Web browser to http://www.yoursite.com/aiocp_folder/admin/code/ and using the following username and password:
In order to protect your system and be granted with an unique personal access, remember to change the password with the Users form.
To achieve a better level of security you have to protect the whole admin folder with a web-based user autentication system. For Apache check the Apache Authentication, Authorization, and Access Control.