Guida di installazione di Oratio® su GNU/Linux

Sommario

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

Prerequisiti

Oratio® é un programma di gestione integrata ERP distribuito con licenza GPL. Il programma si appoggia su database PostgresSQL e funziona in modalità CGI, vale a dire che é accessibile tramite un navigatore internet. Per questo, prima di poter utilizzare Oratio® é necessario assicurarsi che gli strumenti utilizzati da quest'ultimo siano presenti sul server su cui verrà installato Oratio®

Elenco dei programmi

1. Perl, versione 5 e+, per maggiori informazioni fare riferimento al sito CPAN (Comprehensive Perl Archive Network)
2. Un server http Apache
3. Il sistema di gestione di base dati Postgres, versione 7.4 et+
4. Le librerie seguenti per Perl : DBD-Pg et DBI, reperibili sul sito CPAN
5. La libreria Perl per le stampe in pdf:
   - sistemi Debian : libpdf-api2-perl
   - altri sistemi Linux/Windows : PDF-API2
6. LaTeX (opzionale) : al fine di generare i docuemnti in formato PDF

Installazione

Installazione dei files :

• Decomprimere il file .tar.gz nella cartella /usr/local del vostro server Linux : tar xzvf oratio-x.x.x.tar.gz
• Troverete tutti i files installati nella cartella /usr/local/oratio/

Configurazione di Apache

• Creare un file chiamato oratio-httpd.conf nella cartella di configurazione di Apache (di default /etc/httpd/conf/ nel quale deve essere riportato il seguente testo :
  Alias /oratio/ /usr/local/oratio/ <Directory /usr/local/oratio> AddHandler cgi-script .pl Options ExecCGI Includes FollowSymlinks </Directory> <Directory "/usr/local/oratio/users"> Order Deny,Allow Deny from All </Directory>
• Modificare il file httpd.conf di Apache aggiungendo il testo seguente :
  # Oratio Include <ServerRoot>/oratio-httpd.conf

Permessi sui files

Assegnare la proprietà alla cartella users et templates all'utente di Apache (generalmente é apache:apache o www, o ancora nobody). Verificare il file di configurazione di Apache.
Per questo :
# chown apache:apache users templates
sostituendo eventualmente apache:apache con il nome dell'utente e del gruppo utilizzati da Apache.

Configurazione di PostgresSQL

• Si consiglia di creare un utente per l'accesso al database che verrà utilizzato in seguito da Oratio® .
• # su postgres $ createuser -d oratio
• Se volete assegnare una password a questo utente (consigliato), utilizzate il comando :
  $ createuser -d -P oratio
• Rispondere 'y' alla domanda : "Shall the new user be allowed to create more dataset? (y/n) y"
• Rispondere 'n' alla domanda : "Shall the new user be allowed to create more new users? (y/n) n"

Configurazione di Oratio®

Creare una base dati

• Aprire un browser internet e chiamare l'indirizzo http://localhost/oratio/admin.pl. 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 con cui accedere al database (nel nostro esempio oratio) e la password assegnata durante la creazione di questo utente.
• 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/oratio/admin.pl. 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

Connessione al programma

• Richiamare la pagina http://localhost/oratio/login.pl. 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® fornito unitamente al codice.

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