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

    <Resource name="jdbc/isharedoc"
        auth="Container"
        factory="org.apache.commons.dbcp.BasicDataSourceFactory"
        type="javax.sql.DataSource"
        username="isharedoc"
        password="isharedoc"
        driverClassName="org.postgresql.Driver" 
        url="jdbc:postgresql://localhost:5432/isharedoc"
        maxActive="30"
        maxIdle="10"
        removeAbandoned="true"
        removeAbandonedTimeout="30"
        maxWait="5000"
        logAbandoned="true"
        validationQuery="SELECT TIMESTAMP 'today' AT TIME ZONE 'Europe/Rome'"
        accessToUnderlyingConnectionAllowed="true"/>

aggiungere i seguenti jar nella cartella $TOMCAT_HOME/lib

commons-dbcp-1.4.jar
commons-pool-1.6.jar
postgresql-9.3-1100.jdbc4.jar

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

  <GlobalNamingResources>

    <Resource name="jdbc/isharedoc"
        auth="Container"
        factory="org.apache.commons.dbcp.BasicDataSourceFactory"
        type="javax.sql.DataSource"
        username="isharedoc_prod"
        password="isharedoc_prod"
        driverClassName="oracle.jdbc.driver.OracleDriver"
        url="jdbc:oracle:thin:@127.0.0.1:1521:orcl"
        maxActive="30"
        maxIdle="10"
        removeAbandoned="true"
        removeAbandonedTimeout="30"
        maxWait="5000"
        logAbandoned="true"
        validationQuery="SELECT sysdate from dual"
        accessToUnderlyingConnectionAllowed="true"/>

  </GlobalNamingResources>

aggiungere i seguenti jar nella cartella $TOMCAT_HOME/lib

commons-dbcp-1.4.jar
commons-pool-1.6.jar
ojdbc6.jar

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:

....
<Context useHttpOnly="false">
....

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:

    <Connector port="4080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="4443" URIEncoding="UTF-8" />

 

Configurazioni per POST di grandi dimensioni

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

    <Connector port="4080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="4443"
               maxPostSize="50000000" maxParameterCount="50000" />
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:

libreoffice-core-4.0.4.2-9.el6.x86_64
libreoffice-impress-4.0.4.2-9.el6.x86_64
libreoffice-base-4.0.4.2-9.el6.x86_64
libreoffice-4.0.4.2-9.el6.x86_64
libreoffice-ure-4.0.4.2-9.el6.x86_64
libreoffice-pdfimport-4.0.4.2-9.el6.x86_64
libreoffice-emailmerge-4.0.4.2-9.el6.x86_64
libreoffice-headless-4.0.4.2-9.el6.x86_64
libreoffice-graphicfilter-4.0.4.2-9.el6.x86_64
libreoffice-pyuno-4.0.4.2-9.el6.x86_64
libreoffice-opensymbol-fonts-4.0.4.2-9.el6.noarch
libreoffice-calc-4.0.4.2-9.el6.x86_64
libreoffice-math-4.0.4.2-9.el6.x86_64
libreoffice-writer-4.0.4.2-9.el6.x86_64
libreoffice-draw-4.0.4.2-9.el6.x86_64

Aggiornamento Libreoffice ad una nuova versione (es 5.0.3.2)

cd /home/isharedoc
wget http://download.documentfoundation.org/libreoffice/stable/5.0.3/rpm/x86_64/LibreOffice_5.0.3_Linux_x86-64_rpm.tar.gz
tar -xvf LibreOffice_5.0.3_Linux_x86-64_rpm.tar.gz
su -
/etc/init.d/libreoffice-server stop
ps -ef | grep office
yum remove openoffice* libreoffice*
cd /home/isharedoc/LibreOffice_5.0.3.2_Linux_x86-64_rpm/RPMS
yum install *.rpm
nano /etc/init.d/libreoffice-server
# modificare da: DAEMON=soffice a: DAEMON=libreoffice5.0
/etc/init.d/libreoffice-server start
ps -ef | grep office
rm -rf /home/isharedoc/LibreOffice_5.0.3_Linux_x86-64_rpm.tar.gz
rm -rf /home/isharedoc/LibreOffice_5.0.3.2_Linux_x86-64_rpm

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:

export CATALINA_OPTS="-Djava.awt.headless=true -XX:PermSize=128m -XX:MaxPermSize=512m -Xms2048m -Xmx4096m"