Installazione su Linux

Questa guida fornisce una breve descrizione delle componenti da installare per attivare un server KeyWorks.

 

Utente linux

Creare un utente linux con nome KeyWorks ed utilizzarlo per installarvi ant e tomcat (vedi punti successivi).

 

Java

Installare Java JDK 1.6.

RPM:

jdk-1.6.0_45-fcs.x86_64

 

PostgreSQL

Creare un disco o volume logico dedicato ad ospitare i dati del database. Si suggerisce l’utilizzo di LVM per consentire di espandere il disco all’aumentare dei dati nel database.

Installare PostgreSQL 9.3 disponibile nella distribuzione Linux.

 

Tomcat Produzione (PostgreSQL)

Scaricare Tomcat 6 dal link http://apache.fastbull.org/tomcat/tomcat-6/v6.0.43/bin/apache-tomcat-6.0.43.zip ed estrarlo nella home di isharedoc.

In alternativa è possibile utilizzare Tomcat6 disponibile nella distribuzione Linux.

Configurare in $TOMCAT_HOME/conf/server.xml

aggiungere i seguenti jar nella cartella $TOMCAT_HOME/lib

effettuare il deploy del war file in $TOMCAT_HOME/webapps

 

Tomcat Produzione (Oracle)

Scaricare Tomcat 6 dal link http://apache.fastbull.org/tomcat/tomcat-6/v6.0.43/bin/apache-tomcat-6.0.43.zip ed estrarlo nella home di isharedoc.

In alternativa è possibile utilizzare Tomcat6 disponibile nella distribuzione Linux.

Configurare in $TOMCAT_HOME/conf/server.xml

aggiungere i seguenti jar nella cartella $TOMCAT_HOME/lib

effettuare il deploy del war file in $TOMCAT_HOME/webapps

 

Configurazioni Tomcat

Configurazioni per l’applet su protocollo HTTPS (Tomcat7)

Per consentire il corretto funzionamento dell’applet di acquisizione di iShareDoc, impostare l’opzione HttpOnly a false al fine di inviare correttamente i cookies via https.

Modificare il file conf/context.xml:

Documentazione di riferimento: https://tomcat.apache.org/migration-7.html#Session_cookie_configuration

 

Configurazioni per lettere accentate

Per gestire in modo corretto le GET con lettere accentare, è necessario modificare il file conf/server.xml:

 

Configurazioni per POST di grandi dimensioni

Per gestire richieste POST molto grandi e con molti parametri, è necessario modificare il file conf/server.xml:

Rotazione catalina.out

Per evitare che il file di log catalina.out cresca all’infinito, è possibile attivare delle procedure di rotazione su base tempo e dimensione.

Articolo di riferimento all’articolo: http://docs.keyworks.it/article/rotazione-di-tomcat-catalina-out/

 

Ant

Scaricare ANT 1.9.x dal link https://ant.apache.org/bindownload.cgi ed estrarlo nella home di isharedoc.

In alternativa è possibile utilizzare Ant disponibile nella distribuzione Linux.

 

Libreoffice

Installare Libreoffice Server disponibile nella distribuzione Linux.

Esempio RPM:

Aggiornamento Libreoffice ad una nuova versione (es 5.0.3.2)

Python

Installare Python 2.7.x disponibile nella distribuzione Linux.

 

iShareDoc

Creare la directory /etc/sistematica e copiarvi i files di configurazione di isharedoc.

Copiare isharedoc.war nella webapp di tomcat.

Aggiungere in catalina.sh la seguente variabile: