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"