Installazione

Requisiti minimi

Prima di procedere all'installazione di AIOCP è necessario verificare i requisiti minimi del sistema: Per l'installazione e la configurazione del server web e delle librerie richieste consultate i rispettivi manuali.

Configurazione dell'ambiente operativo

Per il corretto funzionamento di AIOCP è necessario configurare il PHP in modo che supporti i sistemi e le librerie sopra indicate, è necessario inoltre che alcuni parametri di PHP siano impostati come segue:

su php.ini
oppure su modulo Apache (/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>
Per la configurazione degli aspetti generali del PHP o per diverse modalità di configurazione, fate riferimento alla guida ed alle annotazioni ufficiali sul sito www.php.net.

Sarà inoltre necessario controllare le quote disco degli utenti che dovranno essere sufficienti a gestire i file ed il database.

NOTA: Se si verifica l'errore CGI Timeout Error sul server IIS durante l'installazione, dovrete aumentare il valore della variabile CGI Script Timeout (Administrative Tools -> Internet Information Services -> cliccate con il pulsante destro del mouse su Web Sites icon -> Properties -> Home Directory -> Configuration -> Process Options -> cambiate il valore di CGI script timeout a 1200 seconds).

Installazione AIOCP

Verificate che l'ambiente operativo sia correttamente installato e configurato così come descritto nei paragrafi precedenti.

Copiate tutto il contenuto della cartella AIOCP nella web root del vostro server o in una sottocartella.
Se utilizzate un FTP per trasferire la versione encoded di AIOCP, assicuratevi di impostare il trasferimento dei file PHP in modalità binaria (BINARY) prima di inviare i file al server.

A questo punto è possibile procedere in due modi:

Installazione automatica

Attraverso questo processo è possibile installare automaticamente il database e configurare i parametri di sistema principali.

Modificate i permessi delle seguenti file e directory in modo tale che siano scrivibili dal software (chmod 777 su sistemi unix-like): Questi file potranno essere reimpostati su sola lettura al termine dell'installazione.
Nel caso che il programma di installazione non riuscisse a modificare questi file, sarà sempre possibile modificarli manualmente come descritto nel paragrafo successivo.

Usando un comune web browser (programma di navigazione internet come Microsoft® Internet Explorer o Netscape®) collegatevi al vostro sito all'indirizzo in cui si trova il programma di installazione di AIOCP: http://<miosito>/install/install.php

Se l'ambiente operativo è correttamente configurato dovreste vedere il modulo di installazione di AIOCP.

Nota che:
Data la criticità di questo componente, il programma di installazione si presenta solo ed esclusivamente in lingua inglese.
Il processo di installazione eliminerà qualsiasi dato delle precedenti installazioni di AIOCP, se ci si trova in questo caso sarà quindi opportuno fare delle copie (backup) dei dati.
A causa delle dimensioni di alcune tabelle il processo di installazione potrebbe durare a lungo (anche decine di minuti), sarà quindi necessario essere pazienti e non interrompere il processo di installazione fino al suo completamento.

Per procedere all'installazione sarà necessario compilare opportunamente il modulo e premere il pulsante INSTALL.

Di seguito l'elenco dei campi richiesti nel modulo di installazione: Se l'installazione è andata a buon fine il sistema sarà pronto per la sua prima esecuzione.
A questo punto possiamo rimuovere la cartella install dal server e ripristinare i permessi di sola lettura nei file di configurazione.
In caso contrario possiamo complementare o ripetere l'installazione usando la procedura manuale descritta di seguito.

Installazione manuale

Per installare manualmente AIOCP occorre modificare i file di configurazione ed installare il database.

Modifica file di configurazione

I file e le costanti di configurazione essenziali per l'avvio di AIOCP sono:

Installazione del database

All'interno della cartella install sono contenuti i file SQL che contengono lo schema ed i dati del database che andranno utilizzati nel corretto ordine: Se si desidera cambiare il prefisso delle tabelle sarà necessario usare un editor di testi che abbia una funzione cerca e sostituisci e operare le seguenti sostituzioni: Per eseguire i file SQL potete usare i comandi MySQL dalla shell del server:
mysql
mysql> CREATE DATABASE AIOCP;
shell> mysql AIOCP < aiocp_db_structure.sql
shell> mysql AIOCP < aiocp_db_data.sql
Nell'esempio precedente si è supposto che il nome del database fosse AIOCP.

In alternativa (se avete già configurato il file admin/phpMyAdmin/config.inc.php) potete usare l'utility http://<miosito>/admin/phpMyAdmin/index.php con la quale potete creare il database ed eseguire i file SQL attraverso l'apposito comando.

Post installazione

Una volta terminato il processo di installazione occorre:

Configurazione AIOCP

Terminata l'installazione, AIOCP dovrebbe essere in grado di sfruttare tutte le sue funzioni ad eccezion fatta per l'invio delle email per le quali è necessario configurare correttamente il file: Si sconsiglia di NON modificare gli altri file di configurazione presenti nel sistema a meno che non si sappia esattamente cosa si sta facendo: Per la configurazione dei moduli di pagamento e di trasporto per il commercio elettronico, consultate la documentazione presente nelle cartelle:

Accesso e Sicurezza

Una volta terminate le fasi di installazione e configurazione sopra descritte potete accedere al sistema collegandovi col browser all'indirizzo http://<miosito>/admin/code/index.php ed usando i seguenti dati: Al fine di proteggere il vostro sito e garantirvi un'accesso esclusivo, ricordatevi di cambiare la password tramite il modulo Utenti -> Modifica. Sempre tramite questo modulo potete anche inserire i vostri dati e le vostre preferenze.

Per avere un maggior livello di sicurezza si consiglia vivamente di proteggere l'intera cartella admin con un sistema di autenticazione utente web-based.
Uno dei modi più semplici e sicuri per proteggere una cartella su un server Apache è usare l'autenticazione Htaccess. Per maggiori informazioni consultate http://httpd.apache.org/docs/howto/htaccess.html.
Se usate un diverso web server consultate la relativa documentazione.