documentazione_3di:extraway_os:installazione_linux
Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
Entrambe le parti precedenti la revisioneRevisione precedenteProssima revisione | Revisione precedente | ||
documentazione_3di:extraway_os:installazione_linux [2015/02/03 16:32] – spassarotto | documentazione_3di:extraway_os:installazione_linux [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1 | ||
---|---|---|---|
Linea 1: | Linea 1: | ||
- | ====== Installazione su piattaforma Linux di ExtraWay Platform ====== | ||
- | In questo documento si tratterà l' | ||
- | |||
- | ===== Requisiti Hardware (server) ===== | ||
- | |||
- | Le specifiche della macchina server dipendono principalmente dal numero di utenti che utilizzerà l' | ||
- | In linea di massima le prestazioni di eXtraWay Platform dipendono dalla velocità dei dispositivi di memorizzazione, | ||
- | |||
- | ==== Requisiti Minimi ==== | ||
- | |||
- | * Processore Intel Pentium 4 o compatibile | ||
- | * 1 GB di RAM | ||
- | * Disco rigido dedicato con almeno 100 GB (per un archivio medio con allegati) | ||
- | |||
- | ==== Consigliati ==== | ||
- | |||
- | Per un utilizzo medio: circa 30 utenti collegati contemporaneamente, | ||
- | \\ | ||
- | * Processore Intel Xeon multicore o compatibile; | ||
- | * 4 GB di RAM; | ||
- | * Dispositivo di storage ad alta affidabilità (Raid) o moduli esterni (Nas, Sas); | ||
- | * Almeno 300 GB dedicati alla gestione dell' | ||
- | * Scheda di rete Gigabit o superiore; | ||
- | * Alimentazione tramite gruppo di continuità; | ||
- | |||
- | ===== Requisiti software ===== | ||
- | ==== Server ==== | ||
- | === Distribuzioni Linux Supportate === | ||
- | |||
- | eXtraway Platform è stato testato ed è utilizzato con diverse distribuzioni: | ||
- | |||
- | * [[http:// | ||
- | * [[http:// | ||
- | * [[http:// | ||
- | * [[http:// | ||
- | * [[http:// | ||
- | * [[http:// | ||
- | \\ | ||
- | Sono consigliati ad ora dal servizio assistenza 3di: | ||
- | * Redhat Enterprise 5 64bit | ||
- | * Centos 6.4 64bit | ||
- | * Ubuntu Server 12.04 LTS 64bit | ||
- | * Gentoo 64bit | ||
- | \\ | ||
- | === Librerie di sistema richieste === | ||
- | |||
- | Le librerie di sistema necessarie al corretto funzionamento dei componenti che compongono ExtraWay. Solitamente collocate in /lib e /usr/lib: | ||
- | |||
- | * libdl.so.2 | ||
- | * libz.so.1 | ||
- | * libstdc++.so.6 | ||
- | * libm.so.6 | ||
- | * libgcc_s.so.1 | ||
- | * libpthread.so.0 | ||
- | * libc.so.6 (minimo glibc 2.5) | ||
- | * libxml2.so.2 | ||
- | * libxslt.so.1 | ||
- | * libzip.so.1 o libzip.so.2 | ||
- | * libcurl.so.4 | ||
- | \\ | ||
- | <color # | ||
- | |||
- | //**Per installare le librerie su sistemi Ubuntu usare il seguente comando: | ||
- | |||
- | |||
- | sudo apt-get install libgcc1: | ||
- | |||
- | |||
- | === Pdftotext === | ||
- | Per l' | ||
- | \\ | ||
- | \\ | ||
- | In molte distribuzioni non è compresa nell' | ||
- | |||
- | |||
- | |||
- | === Imagemagick === | ||
- | Per l' | ||
- | \\ | ||
- | \\ | ||
- | In alcune distribuzioni non è compresa nell' | ||
- | |||
- | ===== Installazione e configurazione ===== | ||
- | ==== Preparazione dell' | ||
- | === Componenti che verranno installati === | ||
- | * Apache Tomcat 6.0.20 | ||
- | * Sun Java Runtime Environment 1.6.0_20 | ||
- | * LibreOffice 3.3.1 | ||
- | * ExtraWay Platform | ||
- | |||
- | |||
- | |||
- | === Preparazione della macchina server ==== | ||
- | |||
- | E' consigliato mantenere l' | ||
- | \\ | ||
- | Il pacchetto di installazione fornito da 3DI è già configurato per essere installato sotto il direttorio /opt | ||
- | \\ | ||
- | Montare il dispositivo di memorizzazione scelto sotto /opt e inserire un riga apposita in /etc/fstab | ||
- | \\ | ||
- | \\ | ||
- | __Creare un utente con nome " | ||
- | |||
- | === Copia dei files === | ||
- | |||
- | Copiare il pacchetto di installazione di Extraway nella cartella /opt. | ||
- | Nel caso non sia possibile utilizzare il sistema di pacchetti integrato per l' | ||
- | |||
- | === Abilitare permessi di scrittura sul tomcat-users.xml === | ||
- | Di base il file tomcat-users.xml è aperto in sola lettura, per abilitare il permesso di scrittura è necessario inserire il parametro " | ||
- | < | ||
- | <!-- Editable user database that can also be used by | ||
- | | ||
- | --> | ||
- | < | ||
- | type=" | ||
- | description=" | ||
- | factory=" | ||
- | pathname=" | ||
- | </ | ||
- | |||
- | * <color darkblue> | ||
- | |||
- | === Impostazione parametri del kernel per eXtraWay in / | ||
- | |||
- | Dalla release 24, eXtraWay necessita di ulteriore memoria condivisa a disposizione, | ||
- | Per impostare correttamente il kernel, aggiungere al file / | ||
- | |||
- | < | ||
- | # Impostazioni per eXtraWay | ||
- | # | ||
- | kernel.shmmax=268435456 | ||
- | </ | ||
- | |||
- | ed eseguire | ||
- | |||
- | sysctl -p | ||
- | |||
- | per applicare la modifica al sistema. | ||
- | ==== Installazione dei pacchetti ==== | ||
- | === ExtraWay Platform === | ||
- | Estrarre il pacchetto extraway nella cartella /opt. | ||
- | \\ | ||
- | Es. | ||
- | /opt# tar xvjf extraway_platform_*.tar.bz2 | ||
- | \\ | ||
- | Per garantire il funzionamento della piattaforma senza che ci sia necessità di credenziali amministrative (root) è necessario assegnare la cartella /opt all' | ||
- | \\ | ||
- | Es. | ||
- | /opt# chown -R extraway: | ||
- | \\ | ||
- | <color # | ||
- | \\ | ||
- | === LibreOffice === | ||
- | Nel caso si sia scelta la procedura di installazione manuale estrarre il pacchetto LibreOffice. | ||
- | \\ | ||
- | Es. | ||
- | /opt# tar xzf LibO_3.3.1_Linux_x86_install-rpm_en-US.tar.gz | ||
- | \\ | ||
- | Eseguire il comando di installazione di LibreOffice (install.sh) dalla cartella estratta e seguire le indicazioni. Solitamente non è necessario cambiare nessun parametro dall' | ||
- | \\ | ||
- | \\ | ||
- | Nel caso invece si pensi di utilizzare la versione della propria distribuzione è necessario controllare che i percorsi della cartella base di libreoffice e dei componenti basis e URE siano corretti nel file / | ||
- | \\ | ||
- | |||
- | ==== Accorgimenti per sistemi con versione di glibc antecedente alla 2.7 ==== | ||
- | \\ | ||
- | In alcuni sistemi è necessario installare la versione compatibile degli eseguibili eXtraWay. Questa versione è compilata con glibc 2.5. | ||
- | |||
- | Per installarli copiare i file contenuti in / | ||
- | \\ | ||
- | ==== Registrazione del motore del database (Extraway) ==== | ||
- | |||
- | Per poter utilizzare Extraway è necessario effettuare la registrazione. | ||
- | \\ | ||
- | Eseguire il seguente comando dalla cartella /opt: | ||
- | /opt~$ ./demo.sh registration | ||
- | |||
- | Durante la registrazione vengono chiesti i seguenti dati: | ||
- | * Numero di postazioni da abilitare | ||
- | * Numero di serie (se fornito) | ||
- | * Nome del responsabile | ||
- | * Nome dell' | ||
- | |||
- | Il primo numero è il numero massimo di istanze di xw che possono partire in contemporanea sul server ((Per convenzione si solito questo numero è il numero massimo di utenti che utilizzeranno il server in contemporanea diviso 15 e dipende anche dalle prestazioni della macchina)) | ||
- | ===== Automatismi ===== | ||
- | Per utima cosa bisogna procedere a configurare il sistema operativo per interagire con i componenti in modo automatico. | ||
- | |||
- | ==== Script di avvio ==== | ||
- | |||
- | Gli script per caricare automaticamente l' | ||
- | * tomcat6 | ||
- | * extraway (motore database) | ||
- | * extraway-fca (File Conversion Agent) | ||
- | * extraway-fcs (File Conversion Service) | ||
- | Tutti accettano i comandi start, stop e restart. | ||
- | \\ | ||
- | \\ | ||
- | <color # | ||
- | === Installazione automatica con script 3di === | ||
- | |||
- | Sono disponibili già per alcune distribuzioni degli script per inserirli automaticamente all' | ||
- | * [[ftp:// | ||
- | * [[ftp:// | ||
- | * [[ftp:// | ||
- | * [[ftp:// | ||
- | \\ | ||
- | <color # | ||
- | \\ | ||
- | === Installazione Manuale === | ||
- | |||
- | E' possibile anche installare questi file manualmente. E' necessario creare dei link ai file in / | ||
- | \\ | ||
- | Es. | ||
- | ~# ln -s / | ||
- | ~# ln -s / | ||
- | ~# ln -s / | ||
- | ~# ln -s / | ||
- | ~# ln -s / | ||
- | ~# ln -s / | ||
- | ~# ln -s / | ||
- | Si consiglia di spegnere tomcat leggermente prima, di seguito l' | ||
- | * tomcat6: start 80 | stop 19 | ||
- | * extraway: start 79 | stop 20 | ||
- | * extraway-fca: | ||
- | * extraway-fcs: | ||
- | |||
- | ==== Backup ==== | ||
- | E' altamente consigliato mantenere un backup dell' | ||
- | \\ | ||
- | Per fare ciò è necessario fermare i servizi extraway e tomcat6 prima di eseguire lo script di backup vero e proprio. | ||
- | \\ | ||
- | \\ | ||
- | Es. script backup da inserire nel crontab di root: | ||
- | / | ||
- | / | ||
- | / | ||
- | / | ||
- | <comando backup> | ||
- | / | ||
- | / | ||
- | / | ||
- | / |