Guida di installazione di Oratio® su Windows (WIN32)

Sommario

• Prerequisiti
• Installazione
  • Installazione dei programmi
  • Configurazione di Apache
  • Permessi dei files
• Configurazione di Oratio®
  • Creare un database
  • Creare un utente
  • Avviare il programma

Prerequisiti

Oratio® é un programma di gestione integrata ERP distribuito con licenza GPL (GNU General Public License). Il programma si appoggia su database PostgresSQL e funziona in modalità CGI, vale a dire che é accessibile tramite un navigatore internet verso un server, locale o remoto. Per questo, per installare Oratio® é necessario assicurarsi che alcuni strumenti siano presenti sul Server/PC in questione.

Elenco dei programmi

1. ActivePerl per Windows, versione 5.8.x.x (consigliato MSI) reperibile sul sito ActiveState
2. Un server http Apache (Win32 Binary (MSI Installer))
3. Il sistema di gestione di base dati Postgres per Windows (postgresql-8.0.1.zip)
4. Le seguenti librerie per Perl : DBI-1.47 (ActiveState) e DBD-Pg (Versione 1.22 precomplilata)
5. La libreria Perl per le stampe in pdf: PDF-API2
6. Su certe installazioni Windows un problema potrebbe essere la mancanza della dll msvcr70.dll (Microsoft C Runtime Library). Se non è presente nella cartella system32 può essere scaricata da www.dll-files.com

Installazione

Installazione dei programmi :

• Installare Active Perl (effettuare un'installazione di default confermando le opzioni proposte)
• Installare Apache (effettuare un'installazione di default confermando le opzioni proposte).
  Nel caso in cui il servizio di Apache non venisse automaticamente installato è possibile installarlo manualmente eseguendo la seguente istruzione dal prompt di comandi :
  "C:\Programmi\Apache Group\Apache2\bin\apache" -k install -n "Apache2"
• Installare PostgreSQL(effettuare un'installazione di default confermando le opzioni proposte).
  NB: durante l'installazione viene richiesto di assegnare una password all'utente amministratore del database (postgres). E' necessario annotarsi questa password perchè sarà necessaria per l'utilizzo di Oratio®
  (Si sconsiglia di acconsentire alla generazione automatica!)
• Installare il modulo DBI (Database independent interface for Perl) ultilizzando Perl Package Manager:
  a) Estrarre il pacchetto DBI in una cartella a scelta (per semplicità si consiglia di creare una cartella "dbi" all'interno della cartella di Perl ("c:\perl\dbi")
  b) Aprire il programma Perl Package Manager (Start / Programmi / ActiveState ActivePerl /Perl Package Manager)
  e digitare la seguente istruzione:
  ppm> install DBI.ppd c:\perl\dbi\
  
• Installare il modulo DBD (Database independent interface for Perl) utilizzando Perl Package Manager:
  a) Estrarre il pacchetto DBD-Pg in una cartella a scelta (per semplicità si consiglia di creare una cartella "dbd" all'interno della cartella di Perl ("c:\perl\dbd")
  b) Aprire il programma Perl Package Manager (Start / Programmi / ActiveState ActivePerl /Perl Package Manager)
  e digitare la seguente istruzione:
  ppm> install DBD-Pg.ppd c:\perl\dbd\
  
• Decomprimere il file oratio-x.x.x.tar.gz nella cartella "C:\Programmi\Apache Group\Apache2\".
• Troverete tutti i files installati nella cartella "C:\Programmi\Apache Group\Apache2\oratio\ "
• Scaricare il file oratio-windows e decomprimerlo nella cartella "C:\Programmi\Apache Group\Apache2\oratio\"
• Posizionarsi nella cartella "C:\Programmi\Apache Group\Apache2\oratio\" ed eseguire un "doppio click" sul file oratio-windows.pl appena estratto

Configurazione di Apache

• Modificare il file di configurazione di Apache httpd.conf (di default si trova in C:\Programmi\Apache Group\Apache2\), aggiungendo il seguente testo :
  Alias /oratio/ "C:/Programmi/Apache Group/Apache2/oratio/" <Directory "C:/Programmi/Apache Group/Apache2/oratio"> AllowOverride All AddHandler cgi-script .pl Options +ExecCGI Order Allow,Deny Allow from All </Directory> <Directory "C:/Programmi/Apache Group/Apache2/oratio/users"> Order Deny,Allow Deny from All </Directory>
• Assicurarsi che la porta 80 non sia già utilizzata da un altro server Web presente sulla macchina (es.: Internet Information Services - IIS). Se così fosse, effettuare la modifica nel file di configurazione di Apache: da Listen 80 a Listen 8080
• Riavviare il servizio di Apache
• Riavviare il sistema

Configurazione di Oratio

Creare il database

• Aprire un browser internet e digitare l'indirizzo http://localhost:8080/oratio/admin.pl oppure http://localhost/oratio/admin.pl se si utilizza la porta standard(80). Sostituire eventualmente localhost con l'indirizzo/nome del server su cui é installato Oratio®.
• Selezionare la voce "Pg Database Administration"
• Compilare i campi host, port, user et password indicando rispettivamente l'indirizzo ip del server di database (di default localhost), la porta (generalmente 5432), il nome dell'utente e la password con cui accedere al database (assegnati nell'installazione di PostgreSQL)
• Inserire un nome da assegnare al database, scegliere la lingua per la creazione del piano dei conti e premere Continue
• L'operazione potrebbe richiedere alcuni minuti.

Creare un utente

• Richiamare la pagina http://localhost:8080/oratio/admin.pl oppure http://localhost/oratio/admin.pl se si utilizza la porta standard(80). Sostituire eventualmente localhost con l'indirizzo/nome del server su cui é installato Oratio®
• Accedere alla sezione "Add User"
• Inserire i valori desiderati
• Nella sezione "Database", inserire gli stessi dati utilizzati pre la creazione della base dati
• Terminato l'inserimento dei dati premere Save

Avviare il programma

• Richiamare la pagina http://localhost:8080/oratio/login.pl oppure http://localhost/oratio/login.pl se si utilizza la porta standard(80). Sostituire eventualmente localhost con l'indirizzo/nome del server su cui é installato Oratio®
• Inserire utente e password creati al punto precedente.
• Premere login
• Fare riferimento al manuale utente di Oratio® per l'utilizzo del prodotto.

Congratulazioni, avete installato il vostro ERP Open Source, Oratio® !