OPEN-XCHANGE. Procedura d'installazione su piattaforma Linux Mandrake Stefano Bordini Rel.: 1.1

Transcript

1 OPEN-XCHANGE Procedura d'installazione su piattaforma Linux Mandrake 10.1 Stefano Bordini Rel.: 1.1

2 Ringraziamenti Desidero ringraziare: Il team Open-Xchange Mike Fetherston (Open-Xchange on Gentoo) Fabrice Ch-Anglay (Open-Xchange on Fedora Core 3.0) e tutti coloro che, partecipando al Forum OX e offrendo il proprio contributo sul sito Open-Xchange Wiki, mi hanno aiutato a scrivere questa documentazione. 2

3 Definizione dei prerequisiti del sistema Questa guida contiene le informazioni necessarie all'installazione di Open-Xchange. In queste pagine non sarà descritta la procedura d'installazione di Linux Mandrake, ma saranno indicati i pacchetti necessari all'installazione di OX e la loro configurazione. I pacchetti in questione sono i seguenti: Nome Webmin PostgreSQL Apache2 OpenLDAP Postfix Cyrus Tomcat Descrizione Tool di amministrazione remota via web Database relazionale Web server LDAP server SMTP server IMAP/POP3 server Servlet container E' consigliabile utilizzare Mandrake Control Center per installare/aggiornare il software. Gli aggiornamenti possono essere effettuati tramite uno dei siti FTP raggiungibili cliccando su Mandrake Updates. 3

4 Installazione WEBMIN Webmin fornisce un'interfaccia web-based in grado di amministrare da remoto un sistema Linux. Questo tool fornisce gli strumenti per gestire le utenze, l'hardware, i logs, i servizi in esercizio sul sistema. In effetti la sua presenza non è indispensabile ai fini dell'installazione di Open-Xchange, tuttavia è uno stumento estremamente comodo che facilita notevolmente i processi di configurazione. Dopo aver installato il pacchetto tramite i files RPM a corredo della distribuzione, avviare il servizio tramite Mandrake Control Center o da riga di comando, digitando service webmin start Verificare che tutto funzioni correttamente utilizzando un browser, specificando l'indirizzo oppure Installazione/configurazione di PostgreSQL Dopo aver installato PostgreSQL dagli RPM a corredo della distribuzione Linux Mandrake, è opportuno modificare alcuni file di configurazione. Aprire il file: /var/lib/pgsql/data/postgresql.conf ed assicurarsi che sia presente/attiva la seguente istruzione: tcpip_socket = true Aprire il file: /var/lib/pgsql/data/pg_hba.conf ed aggiungere, se non sono presenti, le seguenti righe: local all all trust host all trust commentando, se esiste, questa riga: #local all all ident sameuser IMPORTANTE: la mancanza del pacchetto perl-dbd-pg potrebbe causare degli errori in fase di startup del servizio. Assicurarsi che tale pacchetto sia installato correttamente. 4

5 Creazione del database e delle utenze per Open-Xchange Open-Xchange ha bisogno di un'utenza/gruppo e di un database (PostgreSQL) definiti sul sistema per essere installato correttamente. Per questo motivo è necessario aprire una shell e digitare quanto segue: Comando Descrizione useradd ox su postrgres createuser -A -D -P openexchange createdb openexchange exit Definisce utenza/gruppo sul sistema operativo switch sull'utenza di servizio PostgreSQL crea l'utenza openexchange all'interno del database crea un database chiamato openexchange ritorna all'utenza root A questo punto è possibile utilizzare Webmin per verificare il funzionamento di PostgreSQL. Dopo aver effettuato il logon con Webmin, cliccare su Servers PostgreSQL Database Server. Se tutto funziona correttamente si dovrebbero individuare sia il database openexchange sia l'utenza openexchange definite precedentemente. In questa fase è sufficiente verificare che il servizio PostgreSQL possa essere fermato e riavviato senza errori. Nota: E' importante ricordare la password dell'utente openexchange: dovrà essere utilizzata in seguito. Installazione di Apache2 Installare Apache2 tramite gli RPM forniti con la distribuzione di Linux Mandrake Per configurare Apache2 è possibile utilizzare Webmin, cliccando su Servers Apache Webserver e, successivamente, su Configurazione modulo. Verificare che il percorso relativo al file eseguibile sia definito correttamente, per cui: Path del file eseguibile: /usr/sbin/httpd Cliccare sull'icona Modifica file di configurazione e verificare che il percorso relativo al file di configurazione di apache sia nella directory corretta: Path del file di configurazione: /etc/httpd/2.0/conf/httpd2.conf Anche in questo caso, è sufficiente verificare che il servizio Apache possa essere fermato e avviato senza errori. Nota: è possibile che il file eseguibile di Apache e il suo file di configurazione non siano apparentemente collocati nelle directory sopra indicate. In questo caso è opportuno verificare tramite shell di comando la possibile presenza di collegamenti che si riferiscono a tali files. 5

6 Installazione di OpenLDAP Dopo aver installato OpenLDAP dai pacchetti RPM a corredo della distribuzione di Linux Mandrake, verificare tramite Webmin, che il servizio possa essere arrestato e riavviato senza errori. Per eseguire questo controllo da riga di comando, digitare quanto segue: service ldap restart In seguito, modificare il file /etc/openldap/ldap.conf definendo i seguenti parametri: Base dc=oxtest,dc=com ATTENZIONE: non digitare spazi dopo la virgola Host localhost ldap_version 3 scope sub Configurare il file /etc/openldap/slapd.conf definendo i seguenti parametri: include /usr/share/openldap/schema/core.schema include /usr/share/openldap/schema/cosine.schema include /usr/share/openldap/schema/corba.schema include /usr/share/openldap/schema/inetorgperson.schema include /usr/share/openldap/schema/java.schema include /usr/share/openldap/schema/misc.schema include /usr/share/openldap/schema/nis.schema include /usr/share/openldap/schema/openldap.schema # include /etc/openldap/schema/openxchange.schema database suffix bdb dc=oxtest,dc=com rootdn cn=oxadmin,dc=oxtest,dc=com rootpw oxadmin index objectclass index gidnumber,memberuid pres,eq eq # index uid,mailenabled,cn,sn,givenname,lnetmailaccess,alias,logindestination eq,sub # include /etc/openldap/acl_ox.auth Attenzione: questo non è tutto il contenuto del file! 6

7 E' importante creare un file (nell'esempio acl_ox.auth) che definisca le autorizzazioni di accesso ad OpenLDAP. Procedere con un text editor qualsiasi o da riga di comando come segue: vi /etc/openldap/acl_ox.auth access to dn.base="" by * read access to dn.base="cn=subschema" by * read # protect the userpassword attribute access to attr=userpassword by self =w by anonymous auth # global address book access to dn.subtree="o=addressbook,ou=oxobjects,dc=oxtest,dc=com" by group.exact="cn=addressadmins,o=addressbook,ou=oxobjects,dc=oxtest,dc=com" write by users read # personal address book access to dn.regex="^ou=addr,(uid=([^,]+),ou=users,ou=oxobjects,dc=oxtest,dc=com)$" attrs=children by dn.exact,expand="$1" write access to dn.regex="^uid=([^,]+),ou=addr,(uid=([^,]+),ou=users,ou=oxobjects,dc=oxtest,dc=com)$" attrs=entry by dn.exact,expand="$2" write # default rule allowing users full access to their own entries access to * by self write by users read 7

8 Installazione di Postfix (SMTP server) Dopo aver installato Postfix dai pacchetti RPM a corredo della distribuzione di Linux Mandrake, verificare tramite Webmin, che il servizio possa essere arrestato e riavviato senza errori. Per eseguire questo controllo da riga di comando, digitare quanto segue: service postfix restart In seguito, modificare il file /etc/postfix/master.cf e /etc/postfix/main.cf definendo i seguenti parametri: /etc/postfix/master.cf #lmtp unix - - y - - lmtp lmtp unix - - n - - lmtp /etc/postfix/main.cf myhostname = mailserver.oxtest.com mydomain = oxtest.com myorigin = $mydomain mydestination = $mydomain inet_interfaces = all mailbox_transport = lmtp:unix:/var/spool/postfix/public/lmtp local_recipient_maps= alias_maps = ldap:/etc/postfix/ldapalias virtual_mailbox_domains = ldap:/etc/postfix/ldapdomalias lmtp_cache_connection = NO Attenzione: questo non è tutto il contenuto del file! Dopo aver salvato la configurazione, è opportuno creare i file ldapalias e ldapdomalias necessari alla risoluzione delle caselle di posta degli utenti e dei domini virtuali. /etc/postfix/ldapalias server_host = :389 bind = no version = 3 search_base = ou=users,ou=oxobjects,dc=oxtest,dc=com scope = sub query_filter = uid=%s result_attribute = mail /etc/postfix/ldapdomalias server_host = :389 bind = no version = 3 search_base = ou=users,ou=oxobjects,dc=oxtest,dc=com scope = sub query_filter = uid=%s result_attribute = maildomain 8

9 Installazione di Cyrus e SASL (IMAP/POP3 server) Per installare Cyrus-Imapd è necessario scaricare da internet i pacchetti RPM necessari, da un mirror qualsiasi che fornisce le distribuzioni Mandrake, ad esempio: ftp://bo.mirror.garr.it/pub/mirrors/mandrake/official/10.1/i586/media/main/ I pacchetti da scaricare sono i seguenti: 10/05/04 12:00AM 6,603,642 cyrus-imapd mdk.i586.rpm 10/05/04 12:00AM 265,003 cyrus-imapd-devel mdk.i586.rpm 10/05/04 12:00AM 1,135,878 cyrus-imapd-murder mdk.i586.rpm 10/05/04 12:00AM 597,363 cyrus-imapd-nntp mdk.i586.rpm 10/05/04 12:00AM 153,709 cyrus-imapd-utils mdk.i586.rpm 10/09/04 12:00AM 384,288 cyrus-sasl mdk.i586.rpm E' possibile che durante l'installazione venga chiesto di soddisfare alcune dipendenze, in tal caso è necessario scaricarne i pacchetti. Per automatizzare il processo d'installazione di Cyrus (ma anche di altro software) e delle eventuali dipendenze è consigliabile aggiungere una sorgente d'installazione all'interno del Mandrake Control Center, nella sezione relativa alla gestione RPM, specificando come FTP Server uno dei mirror che forniscono i pacchetti di Mandrake (quello indicato in precedenza è sufficiente). In questo modo, richiedendo l'installazione di Cyrus tramite Mandrake Control Center, il sistema operativo sarà in grado di attingere al software dal nuovo supporto e potrà soddisfare automaticamente l'installazione delle eventuali dipendenze. Dopo aver installato Cyrus è opportuno verificare, tramite Webmin, che il servizio possa essere arrestato e riavviato senza errori. Per eseguire questo controllo da riga di comando, digitare quanto segue: service cyrus-imapd restart Successivamente, è necessario modificare il file di configurazione /etc/cyrus.conf definendo i seguenti parametri: imap imaps pop3 pop3s sieve cmd= imapd listen= imap prefork=0 cmd= imapd -s listen= imaps prefork=0 cmd= pop3d listen= pop3 prefork=0 cmd= pop3d -s listen= pop3s prefork=0 cmd= timsieved listen= sieve prefork=0 lmtpunix cmd=lmtpd listen= /var/spool/postfix/public/lmtp prefork=0 Attenzione: questo non è tutto il contenuto del file! 9

10 Modificare il file di configurazione /etc/imapd.conf per utilizzare SASL come sistema di autenticazione per Cyrus: admins: cyrus allowanonymouslogin: no allowplaintext: yes unixhierarchysep: yes servername: localhost virtualdomains: yes defaultdomain: oxtest.com loginrealms: oxtest.com autocreatequota: 5000 quotawarn: 90 lmtpsocket: /var/spool/postfix/public/lmtp sasl_pwcheck_method: saslauthd sasl_mech_list: PLAIN Attenzione: questo non è tutto il contenuto del file! Verificare che SASL supporti LDAP come metodo di autenticazione, digitando: saslauthd -v dovrebbe essere visualizzato un messaggio simile: authentication mechanisms: getpwent kerberos5 pam imap rimap shadow ldap IMPORTANTE: Se LDAP non appare come metodo di autenticazione, provate a reistallare il pacchetto cyrussasl o a consultare Google, in ogni caso è inutile continuare con l'installazione finchè non si risolve il problema. /etc/sysconf/saslauthd Verificare che all'interno del file siano definiti i seguenti parametri: SASL_AUTHMECH=pam Adesso installa il modulo pam_ldap /etc/ldap.conf (file di configurazione utilizzato dal sistema PAM_LDAP usato da SASL per accedere all'ldap) Verificare che all'interno del file siano definiti i seguenti parametri: host base dc=oxtest,dc=com ldap_version 3 rootbinddn cn=oxadmin,dc=oxtest,dc=com scope sub Attenzione: questo non è tutto il contenuto del file! 10

11 /etc/ldap.secret(file di configurazione utilizzato dal sistema PAM di SASL per accedere all'ldap) Verificare che all'interno del file sia definita la password relativa all'utenza di amministrazione di ldap: oxadmin E' opportuno definire i permessi su questo file in modo che sia accessibile solo all'utenza root. Infine, per un corretto funzionamento di Cyrus con il supporto di autenticazione SASL, è necessario definire una password per l'utenza di servizio cyrus e, successivamente, definire la stessa utenza all'interno del database utenti utilizzato da SASL, perciò da riga di comando: passwd cyrus saslpasswd2 -c cyrus (definire la password, per es.: cyrusadmin) (definire la stessa password) Per rendere operative le modifiche è necessario riavviare i servizi, quindi: service ldap restart service postfix restart service cyrus-imapd restart service saslauthd restart L'ultima cosa da fare è configurare i moduli PAM per il servizio IMAP (e POP nel caso venga usato), per cui: cd /etc/pam.d aprire il file imap e modificarlo come segue: vi imap #%PAM-1.0 #auth required pam_stack.so service=system-auth #account required pam_stack.so service=system-auth auth sufficient pam_ldap.so auth required pam_unix.so account sufficient pam_ldap.so account required pam_unix.so Definire le stesse modifiche al file POP se si vuole applicare l'autenticazione PAM anche a questo servizio. 11

12 Installazione di pacchetti RPM aggiuntivi dalla distribuzione Mandrake Per procedere con la definizione dei prerequisiti di Open-Xchange è necessario installare i seguenti pacchetti: Jdom b9.2jpp ant jpp postgresql-jdbc apache2-devel xerces-j jpp ed i seguenti moduli perl, per i quali sarà necessario soddisfare delle dipendenze: perl-convert-asn perl-ldap-0.31 perl-io-socket-ssl-0.96 perl-authen-sasl-2.08 perl-net_ssleay-1.25 Dipendenze: perl-xml-parser-2.34 perl-xml-sax perl-xml-namespacesupport_1.08 I pacchetti Jdom e ant possono essere scaricati dal link: ftp://bo.mirror.garr.it/pub/mirrors/mandrake/official/10.1/i586/media/jpackage Alcune dipendenze del pacchetto Jdom: Jpackage-utils_ jpp xalan-j jpp xerces-j jpp xml-commons b2.6jpp xml-commons-apis b2.6jpp xml-commons-resolver-1.1-2jpp NOTA: E' possibile che sia necessario soddisfare alcune dipendenze non indicate in questo documento :-) 12

13 Installazione dei moduli JAVA Per installare correttamente Open-Xchange è necessario avvalersi di alcuni moduli Java, scaricabili gratuitamente dal sito SUN. Per questo motivo è necessario connettersi ai seguenti link e scaricare i pacchetti: Java 2 Platform, Standard Edition (J2SE) (piattaforma Java 2) cliccare sul link Download JDK 5.0 update 4, accettare i termini di licenza e scaricare il pacchetto per linux jdk-1_5_0_04-linux-i586-rpm.bin (circa 45 Mb) Alla stesura di questo documento, l'ultima versione di J2SE è la 5.0. Dopo aver eseguito il download del file, è necessario modificarne le proprietà e procedere all'installazione come segue: chmod 700 jdk-1_5_0_04-linux-i586-rpm.bin./jdk-1_5_0_04-linux-i586-rpm.bin (invio) (invio) JavaMail (framework per realizzare applicazioni di messaging e mail) cliccare sul link Download, accettare i termini di licenza e scaricare il pacchetto in formato.zip javamail-1_3_3-ea.zip (circa 2,5 Mb) Alla stesura di questo documento, l'ultima versione di Javamail è la Dopo aver eseguito il download del file, è necessario procedere all'installazione come segue: unzip javamail-1_3_3-ea.zip cd javamail-1.3.3ea cp mail.jar /usr/share/java (invio) (invio) (invio) JAF (JavaBeans Application Framework) cliccare sul link Download, accettare i termini di licenza e scaricare il pacchetto in formato.zip jaf-1_0_2-upd2.zip (circa 352 Kb) Alla stesura di questo documento, l'ultima versione di JAF è la Procedere all'installazione come segue: unzip jaf-1_0_2-upd2.zip cd jaf-1_0_2-upd2 cp -R * /usr/share/java (invio) (invio) (invio) 13

14 JTA (Java Transaction API) cliccare sui link Download sia per ClassFiles che per JavaDocs, accettare i termini di licenza e scaricare i pacchetti in formato.zip: jta-1_0_1b-classes.zip jta-1_0_1b-doc.zip (circa 8 Kb) (circa 102 Kb) Per l'installazione dei pacchetti è sufficiente copiare il contenuto dei files.zip all'interno della cartella /usr/share/java. Java Servlet Development Kit cliccare sul link Download relativo al pacchetto Java Servlet Development Kit 2.1, accettare i termini di licenza e scaricare il pacchetto per piattaforma Solaris SPARC jsdk2_1-solsparc.tar.z (circa 456 Kb) Alla stesura di questo documento, l'ultima versione di J2SDK è la 2.1 Per l'installazione del pacchetto procedere come segue: tar xzf jsdk2_1-solsparc.tar.z chown -R root:root jsdk2.1 cp -R jsdk2.1 /usr/local (invio) (invio) (invio) 14

15 Installazione di Tomcat Per installare Tomcat è necessario scaricare il pacchetto connettendosi al sito La versione di Tomcat utilizzata in questa guida è la 5.5.9, tuttavia è consigliabile scaricare una nuova release qualora fosse disponibile. Dopo aver scaricato il pacchetto jakarta-tomcat tar.gz, digitare quanto segue: tar xzf jakarta-tomcat tar.gz cd jakarta-tomcat mkdir /usr/local/tomcat5 cp -R * /usr/local/tomcat5 (invio) (invio) (invio) (invio) Prima di procedere, è opportuno definire alcune variabili di ambiente. Per questo motivo è necessario editare con vi il file.bashrc all'interno della cartella /root e digitare quanto segue: cd /root vi.bashrc export JAVA_HOME=/usr/java/jdk1.5.0_04 PATH=$PATH:/usr/java/jdk1.5.0_04/bin la modifica alla variabile PATH è indispensabile per fornire al sistema operativo la possibilità di rintracciare i file necessari al processo di compilazione di OX. A questo punto, per verificare che tomcat funzioni correttamente, avviare il servizio digitando /usr/local/tomcat5/bin/startup.sh e arrestarlo digitando /usr/local/tomcat5/bin/shutdown.sh 15

16 Può essere comodo realizzare uno script che consenta di avviare/arrestare il servizio di tomcat in modo più efficiente. Per questo motivo, se si desidera, è necessario creare un file all'interno della directory /etc/init.d con il nome del servizio che si vuole gestire, e scrivere quanto segue: cd /etc/init.d vi tomcat #! /bin/sh start() { echo echo "Avvio di TOMCAT" echo /usr/local/tomcat/bin/startup.sh } stop() { echo echo "Arresto di TOMCAT" echo /usr/local/tomcat/bin/shutdown.sh } restart() { stop start } case "$1" in start) start ;; stop) stop ;; restart) stop start ;; *) echo "Usage: service tomcat {start stop restart}" exit 1 esac exit $? Da questo momento sarà possibile avviare/fermare/riavviare tomcat digitando: service tomcat start/stop/restart 16

17 Compilazione di Open-Xchange Dopo aver scaricato l'ultima versione di OpenExchange dal sito è necessario entrare nella directory che si è creata scompattando il file tar.gz di OX con il comando: tar xzf open-xchange-0.8.x-x.tar.gz cd open-xchange-0.8.x-x Successivamente (e per comodità) si potrà procedere alla creazione di un file che consentirà di automatizzare i processi di configurazione di OpenExchange. Per cui, da riga di comando, si deve creare il file oxinst.sh (o un file con qualsiasi altro nome) con vi ed impostare i seguenti parametri di configurazione, quindi: vi oxinst.sh Parametro script Descrizione./configure \ --prefix=/usr/local/ox \ Directory dove sarà installato Open-Xchange --with-mailjar=/usr/share/java/mail.jar \ --with-activationjar=/usr/share/java/activation.jar \ --with-jdomjar=/usr/share/java/jdom.jar \ --with-xercesjar=/usr/share/java/xerces-j2.jar \ --with-jsdkjar=/usr/local/tomcat5/common/lib/servlet-api.jar \ --with-jdbcjar=/usr/share/pgsql/pg74.1jdbc3.jar \ --with-dbname=openexchange \ --with-dbuser=openexchange \ --with-dbpass=openexchange \ --with-domain=oxtest.com \ Nome del db utilizzato da Open-Xchange Utente per la gestione del db di Open-Xchange Password impostata durante la creazione dell'utente openexchange Dominio di posta elettronica --with-basedn=dc=oxtest,dc=com \ --with-rootdn=cn=oxadmin,dc=oxtest,dc=com \ --with-rootpw=oxadmin \ --with-organization= OX-Test \ --enable-webdav \ --with-runuid=ox \ --with-rungid=ox Salvare il file e procedere alla compilazione come segue: sh oxinst.sh make make install NOTA: per evitare fastidiosi messaggi di warning relativi al database, è necessario che il servizio postgresql sia avviato. 17

18 Dopo aver installato con successo Open-Xchange, è necessario copiare i seguenti files nella directory cgi-bin di Apache: cd /usr/local/ox/share/perl cp login.* /var/www/cgi-bin Verificare la schermata di login di OX con un browser, caricando l'indirizzo: oppure Successivamente, copiare il resto dei files relativi all'interfaccia web di OX, quindi: cd /var/www/html mkdir -p cfintranet/webmail cd /usr/local/ox/share/groupware/data cp -R images css javascript /var/www/html/cfintranet cd /usr/local/ox/share/webmail/data cp -R images css javascript /var/www/html/cfintranet/webmail 18

19 Open-Xchange: installazione servlets A questo punto è opportuno configurare Tomcat5 per ospitare le servlets di Open-Xchange. La procedura è la seguente: cd /usr/local/tomcat5/webapps mkdir -p servlet/web-inf/classes cd servlet/web-inf/classes cp /usr/local/ox/share/servlets/*.class. Per gestire le servlets in modo opportuno è indispensabile definire il file web.xml quindi, all'interno della directory /usr/local/tomcat5/webapps/servlet/web-inf/ digitare: vi web.xml <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" " <web-app> <display-name> Open-Xchange Servlets and WebDAV </display-name> <description> Open-Xchange </description> <servlet> <servlet-name>intranet</servlet-name> <servlet-class>intranet</servlet-class> </servlet> <servlet> <servlet-name>webmail</servlet-name> <servlet-class>webmail</servlet-class> </servlet> <servlet> <servlet-name>documents</servlet-name> <servlet-class> com.openexchange.webdav.documents </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet>...continua... 19

20 <servlet> <servlet-name>calendar</servlet-name> <servlet-class> com.openexchange.webdav.calendar </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>tasks</servlet-name> <servlet-class> com.openexchange.webdav.tasks </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>contacts</servlet-name> <servlet-class> com.openexchange.webdav.contacts </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet>...continua... 20

21 <servlet> <servlet-name>folders</servlet-name> <servlet-class> com.openexchange.webdav.folders </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>projects</servlet-name> <servlet-class> com.openexchange.webdav.projects </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>groupuser</servlet-name> <servlet-class> com.openexchange.webdav.groupuser </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet>...continua... 21

22 <servlet> <servlet-name>attachments</servlet-name> <servlet-class> com.openexchange.webdav.attachments </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>freebusy</servlet-name> <servlet-class> com.openexchange.webdav.freebusy </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>ical</servlet-name> <servlet-class> com.openexchange.webdav.ical </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet>...continua... 22

23 <servlet> <servlet-name>vcard</servlet-name> <servlet-class> com.openexchange.webdav.vcard </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet> <servlet-name>bookmarks</servlet-name> <servlet-class> com.openexchange.webdav.bookmarks </servlet-class> <init-param> <param-name>openexchange.propfile</param-name> <param-value> /usr/local/open-xchange/etc/groupware/system.properties </param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>intranet</servlet-name> <url-pattern>/intranet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>webmail</servlet-name> <url-pattern>/webmail</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>documents</servlet-name> <url-pattern>/webdav.documents/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>calendar</servlet-name> <url-pattern>/webdav.calendar/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>tasks</servlet-name> <url-pattern>/webdav.tasks/*</url-pattern> </servlet-mapping>...continua... 23

24 <servlet-mapping> <servlet-name>contacts</servlet-name> <url-pattern>/webdav.contacts/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>folders</servlet-name> <url-pattern>/webdav.folders/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>projects</servlet-name> <url-pattern>/webdav.projects/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>groupuser</servlet-name> <url-pattern>/webdav.groupuser/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>attachments</servlet-name> <url-pattern>/webdav.attachments/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>freebusy</servlet-name> <url-pattern>/webdav.freebusy/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>ical</servlet-name> <url-pattern>/webdav.ical/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>vcard</servlet-name> <url-pattern>/webdav.vcard/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>bookmarks</servlet-name> <url-pattern>/webdav.bookmarks/*</url-pattern> </servlet-mapping> </web-app> 24

25 Successivamente, definire la directory lib e copiare al suo interno i seguenti files: cd /usr/local/tomcat5/webapps/servlet/web-inf mkdir lib cd lib cp /usr/local/ox/lib/*.jar. Configurare la variabile JAVA_OPTS intervenendo sui file di configurazione di Tomcat: vi /usr/local/tomcat5/bin/catalina.sh JAVA_OPTS= -Dopenexchange.propfile=/usr/local/ox/etc/groupware/system.properties A questo punto è possibile procedere alla definizione della servlet relativa al Setup utente di OX. Prima di tutto è necessario modificare il file di configurazione di tomcat relativo alle utenze di amministrazione come segue: cd /usr/local/tomcat5/conf vi tomcat-users.xml <?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="tomcat"/> <role rolename="role1"/> <role rolename="manager"/> <user username="tomcat" password="tomcat" roles="manager"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="role1" password="tomcat" roles="role1"/> </tomcat-users> Accedere alla Web GUI con un browser all'indirizzo e, cliccando sul link Tomcat Manager, fornire le credenziali di autenticazione definite precedentemente (username: tomcat / password: tomcat). Nella pagina di amministrazione, alla sezione WAR file to deploy, cliccare sul pulsante Browse e sfogliare la cartella contenente la servlet da installare, e cioè /usr/local/ox/lib selezionando il file umin.war Cliccare sul pulsante Deploy. 25

26 WEBDAV Per definire la servlet relativa alle estensioni WebDAV procedere come segue: cd /usr/local/tomcat5/webapps/servlet/web-inf/classes cp /usr/local/ox/lib/webdav.jar. jar xvf webdav.jar Questo comando scompatterà il file webdav.jar e creerà due directory: com e META-INF Entrare all'interno della directory com e digitare quanto segue: cd com/openexchange mkdir -p tools/webdav cd tools/webdav cp /%sourceox%/build/com/openexchange/tools/webdav/*. cd /usr/local/tomcat5/webapps/servlet/web-inf/lib Verifica il contenuto della directory, copiando i files mancanti da /usr/local/ox/lib e definendo i link simbolici indicati: -rw-r--r-- 1 root root activation.jar -rw-r--r-- 1 root root comfiretools.jar -rw-r--r-- 1 root root intranet.jar lrwxrwxrwx 1 root root 24 jdom.jar -> /usr/share/java/jdom.jar -rw-r--r-- 1 root root mail.jar -rw-r--r-- 1 root root nas.jar lrwxrwxrwx 1 root root 32 pg74.1jdbc3.jar -> /usr/share/pgsql/pg74.1jdbc3.jar* -rw-r--r-- 1 root root sessiond.jar -rw-r--r-- 1 root root umin.jar -rw-r--r-- 1 root root webdav.jar -rw-r--r-- 1 root root webmail.jar Sincronizzazione di Tomcat con Apache (mod_jk) Perchè tutto funzioni correttamente è indispensabile installare un connettore che consenta ad Apache di interfacciarsi con Tomcat. Per questo motivo è necessario connettersi al link e scaricare il file jakarta-tomcat-connectors-jk src.zip (1Mb circa) A questo punto si provveda alla compilazione del connettore secondo la procedura indicata: unzip jakarta-tomcat-connectors-jk src.zip Rinominare la cartella creata in jakarta-tomcat-connector e, successivamente, digitare quanto segue: mv jakarta-tomcat-connector /usr/src cd /usr/src/jakarta-tomcat-connector/jk/native2 26