Apache Compile HOWTO

2.2.1. Cosa è OpenSSL

OpenSSL fornisce le librerie e i file include necessari ai prodotti menzionati precedentemente e fornisce inoltre una Applicazione per creare Certificati Server e client.

2.2.2. Download dei sorgenti

Sito di origine http://www.openssl.org

2.2.3. Compilazione e installazione

cd /usr/local
tar -xvzf openssl-0.9.7.tar.gz
 
cd openssl-0.9.7
 
./config shared 
 
make
make test
make install

echo "/usr/local/ssl/lib" >> /etc/ld.so.conf
ldconfig

	Selezionare la propria CPU per migliorare la velocità
	Di default il Makefile genera il codice per la CPU i486. Si può cambiare ciò editando il Makefile dopo aver eseguito config shared. Si cerchi -m486 e lo si sostituisca, per esempio, con -march=athlon

2.3.1. Cosa è gdbm

GNU dbm è una applicazione molto importante utilizzata da quasi tutte le distribuzioni. Perciò viene installata per convenzione su tutte le distribuzioni che ho provato.

Con tutta probabilità i necessari file header, vincolanti per compilare Apache con mod_rewrite e PHP, normalmente non sono installati. Per favore si consultino i CD/DVD della distribuzione e si installi il relativo pacchetto devel (La versione può variare):

rpm -i gdbm-devel-1.8.0-546

Questa procedura è stata verificata per SuSE e Redhat. Per favore si confermi per altri sistemi basati su RPM come Mandrake. Debian seguirà prima possibile.

Gli utenti di sistemi basati su Debian possono installare gdbm con il seguente:

apt-get install libgdbmg1-dev

2.3.2. Compilare e installare da se

Nell'improbabile caso che la propria distribuzione non contenga gdbm qui ci sono le istruzioni per compilarlo.

./configure 

make
make install

ldconfig

2.4.1. Cose'è MySQL

MySQL è un Database molto veloce, potente e piacevole da maneggiare.

Specialmente per applicazioni web dove la maggior parte degli accessi sono in lettura e pochi in scrittura, MySQL è la scelta migliore. La versione più recente è anche in grado di gestire le transazioni. Se si pianifica una applicazione web che deve scrivere parecchi Dati nel database, forse PostgreSQL è più adatto, si veda la Sezione 6.2.4 per i suggerimenti sull'installazione

Si necessita della C-API da MySQL per compilare PHP se si desidera il supporto a MySQL in PHP. È anche necessaria se si vuole utilizzare mod_authmysql, si veda la Sezione 4.3 per maggiori informazioni

2.4.2. Download

Sito di origine: http://www.mysql.com/downloads/

2.4.3. Compilazione e installazione

cd /usr/local
tar -xvzf mysql-3.23.55.tar.gz 
cd mysql-3.23.55

./configure \
--prefix=/usr/local/mysql \
--enable-assembler \
--with-innodb \
--without-debug

make 
make install 

/usr/local/mysql/bin/mysql_install_db
echo /usr/local/mysql/lib/mysql >> /etc/ld.so.conf 
ldconfig

Per migliorare la sicurezza, si aggiunga un utente MySQL sul proprio sistema ad es. »mysql«.

chown -R mysql /usr/local/mysql/var

Si potrebbe desiderare di lanciare automaticamente MySQL all'avvio, si copi /usr/local/mysql/share/mysql/mysql.server dentro /etc/init.d/ (o dovunque si trovino i propri script rc) e si crei il corrispondente link simbolico nelle directory runlevel.

cp /usr/local/mysql/share/mysql/mysql.server /etc/init.d/ ln -s /etc/init.d/mysql.server /etc/init.d/rc3.d/S20mysql ln -s /etc/init.d/mysql.server /etc/init.d/rc3.d/K20mysql

2.4.4. Rendere sicuro MySQL

Questa parte è opzionale e descrive come associare il demone MySQL all'IP localhost

Suggerisco semplicemente di associare MySQL all'interfaccia di loopback 127.0.0.1. Ciò assicura che nessuno possa connettersi al Demone MySQL tramite la rete. Ma naturalmente, questo ha senso solo se MySQL gira sulla stessa macchina del server web.

si modifichi la linea 107 del file /etc/init.d/mysql.server come mostrato di seguito:

Linea originale:

$bindir/safe_mysqld --datadir=$datadir --pid-file=$pid_file&

Linea modificata:

$bindir/safe_mysqld --datadir=$datadir --pid-file=$pid_file \ --bind-address=127.0.0.1&

In alternativa, si può completamente disabilitare la funzionalità di rete di MySQL.

$bindir/safe_mysqld --datadir=$datadir --pid-file=$pid_file \
--skip-networking &

2.5.1. Cosa è mm

È una libreria comune che permette ai programmatori Unix di semplificare gli accessi shm (Memoria condivisa). Viene utilizzata in molti prodotti, ad es. PHP e mod_ssl

2.5.2. Download

Sito di origine: ftp://ftp.ossp.org/pkg/lib/mm/mm-1.2.2.tar.gz

2.5.3. Compilazione e installazione

cd /usr/local
 
tar -xvzf mm-1.2.2.tar.gz
 
cd mm-1.2.2
 
./configure
make
make test
make install

ldconfig

3.1.1. Cosa è Apache

È semplicemente il miglior software per Server Web, molto flessibile da configurare per sopperire alle proprie necessità, ed è E-S-T-R-E-M-A-M-E-N-T-E stabile. Personalmente non ho mai avuto esperienze di crash in un ambiente di produzione (=materiale non sperimentale)

3.1.2. Download dei sorgenti

Sito di origine http://www.apache.org/dist/httpd/

cd /usr/local/ tar -xvzf apache_1.3.27.tar.gz

3.1.3. Patch per siti di larga scala

Se il proprio server web deve rispondere a molte richieste contemporaneamente e la macchina è sufficientemente robusta per fare questo, si può modificare il limite massimo di processi in esecuzione

Si faccia il download della patch da: http://www.delouw.ch/linux/apache-patch_HARD_SERVER_LIMIT.txt

--- httpd.h     Thu Mar 21 18:07:34 2002
+++ httpd.h-new Sun Apr  7 13:34:11 2002
@@ -320,7 +320,7 @@
 #elif defined(NETWARE)
 #define HARD_SERVER_LIMIT 2048
 #else
-#define HARD_SERVER_LIMIT 256
+#define HARD_SERVER_LIMIT 512
 #endif
 #endif

Questa patch aumenta il numero massimo di client concorrenti a 512. Ci si senta liberi di aumentarlo ulteriormente, se si è riusciti a modificare il proprio kernel ed il file /etc/security/limits.conf

	Evitare di esaurire i task
	Con le impostazioni sbagliate ciò potrebbe portare ad un »self-denial-of-service-attack«. Ci si assicuri di aver lasciato sufficienti processi per root

Si applichi la patch con:

cd /usr/local/apache_1.3.27/src/include

patch -p0 < apache-patch_HARD_SERVER_LIMIT.txt

3.2.1. Cosa è mod_ssl

Questo modulo è necessario per abilitare Apache per le richieste SSL (https). Applica una patch al codice sorgente ed estende le sue API (Application Programming Interface). Il risultato viene chiamato EAPI (Extended Application Programming Interface).

	Uso delle opzioni del compilatore durante la compilazione dei moduli
	Ci si assicuri che ogni modulo per il proprio server Apache sia compilato con l'opzione -DEAPI, altrimenti il Server web potrebbe bloccarsi o non avviarsi affatto.

Quasi tutti i moduli che conosco aggiungono l'opzione -DEAPI da soli, eccettuati mod_jserv e mod_jk

3.2.2. Download dei sorgenti

Sito di origine:http://www.modssl.org

3.2.3. Applicazione della patch ai sorgenti di Apache

cd /usr/local/

tar -xvzf mod_ssl-2.8.12-1.3.27.tar.gz
cd mod_ssl-2.8.12-1.3.27/

./configure --with-apache=../apache_1.3.27 

3.3.1. Cosa è mod_perl

mod_perl è una alternativa ai cgi-bin. I cgi tipicamente generano un nuovo processo per ogni richiesta e producono sovraccarico. Con mod_perl, l'interprete perl viene caricato in modo persistente nel server Apache e non ha bisogno di generare i processi per ogni richiesta.

3.3.2. Download dei sorgenti

Sito di origine: http://www.apache.org/dist/perl

3.3.3. Compilazione e installazione

cd /usr/local

tar -xvzf mod_perl-1.27.tar.gz

cd mod_perl-1.27

perl Makefile.PL \
EVERYTHING=1 \
APACHE_SRC=../apache_1.3.27/src \
USE_APACI=1 \
PREP_HTTPD=1 \
DO_HTTPD=1

make
make install

	Mod_perl non può essere compilato come DSO
	Non si compili mod_perl come DSO (Dynamic Shared Object)! Secondo varie fonti, Apache potrebbe bloccarsi (non ho mai provato).

3.4.1. Compilazione e installazione

EAPI_MM="/usr/local/mm-1.2.2" SSL_BASE="/usr/local/ssl" \
./configure \
--enable-module=unique_id \
--enable-module=rewrite \
--enable-module=speling \
--enable-module=expires \
--enable-module=info \
--enable-module=log_agent \
--enable-module=log_referer \
--enable-module=usertrack \
--enable-module=proxy \
--enable-module=userdir \
--enable-module=so \
--enable-shared=ssl \
--enable-module=ssl \
--activate-module=src/modules/perl/libperl.a \
--enable-module=perl

make
make install

3.4.2. Creare certificati SSL auto-firmati

cd /usr/local/ssl/bin

./openssl req -new > new.cert.csr
./openssl rsa -in privkey.pem -out new.cert.key
./openssl x509 -in new.cert.csr -out new.cert.cert \
-req -signkey new.cert.key -days 999

cp new.cert.key /usr/local/apache/conf/ssl.key/server.key
cp new.cert.cert /usr/local/apache/conf/ssl.crt/server.crt

	Nome comune
	OpenSSL chiede diverse cose. Un errore comune è quello di inserire un "nome comune" sbagliato. Questo deve essere lo FQHN (Fully Qualified HostName) del proprio Server, ad es. www.foo.org

4.1.1. Cosa è mod_dav

Dal punto di vista degli autori:

DAV significa: »Distributed authoring and Versioning«. Permette di gestire il proprio sito web in modo simile a un filesystem. È pensato per rimpiazzare l'upload tramite ftp al server web.

DAV è supportato da tutti gli strumenti per lo sviluppo web (le versioni più recenti) e sta per diventare uno standard largamente accettato per il web publishing.

4.1.2. Download dei sorgenti

Sito di origine: http://www.webdav.org/mod_dav/

4.1.3. Compilazione e installazione

cd /usr/local

tar -xvzf mod_dav-1.0.3-1.3.6.tar.gz
cd mod_dav-1.0.3-1.3.6

./configure --with-apxs=/usr/local/apache/bin/apxs

make
make install

	Nome del file che disorienta
	Il nome del file mod_dav-1.0.3-1.3.6 suggerisce che possa funzionare solo con Apache 1.3.6 ma attualmente funziona con tutti gli Apache >= 1.3.6

4.2.1. Cosa è auth_ldap

Dal punto di vista degli autori:

Se si vogliono unificare le proprie infrastrutture di login in una unica base comune di utenti/password, LDAP (Lightweight Directory Access Protocol) è il modo giusto per farlo. LDAP è uno standard aperto e largamente supportato.

Infrastrutture di login per LDAP:

Come gli Unix-Login per Linux, Solaris (altri?), l'FTP-Login (alcuni demoni ftp), l'autenticazione di base http, l'autenticazione e amministrazione di ruolo per Tarantella, l'autenticazione Samba (2.2.x dovrebbe supportarlo), anche LDAP è basato sul ruolo. Questo significa, per esempio, che si può definire un ruolo »manager« e assegnargli un utente come membro cosicché questo utente possa collegarsi ovunque sia permesso il collegamento ad un manager.

4.2.2. Download dei sorgenti

Sito di origine: http://www.rudedog.org/auth_ldap/

4.2.3. Compilazione e installazione

cd /usr/local

tar -xvzf auth_ldap-1.6.0.tar.gz

cd auth_ldap-1.6.0

./configure --with-apxs=/usr/local/apache/bin/apxs \
--with-sdk=openldap

make
make install

4.3.1. Cosa è mod_auth_mysql

È un modulo di autenticazione http di base. Permette di mantenere agevolmente il proprio utente in un Database MySQL

4.3.2. Download dei sorgenti

Sito di origine: ftp://ftp.kciLink.com/pub/mod_auth_mysql.c.gz

4.3.3. Compilazione e installazione

gunzip mod_auth_mysql.c.gz

/usr/local/apache/bin/apxs \
-c -I/usr/local/mysql/include \
-L/usr/local/mysql/lib/mysql \
-lmysqlclient -lm mod_auth_mysql.c

cp mod_auth_mysql.so /usr/local/apache/libexec/

Si aggiunga questa linea al proprio httpd.conf:

LoadModule mysql_auth_module libexec/mod_auth_mysql.so

E dove vengono aggiunti gli altri moduli:

AddModule mod_auth_mysql.c

Ci si assicuri che il percorso delle librerie e degli include di MySQL sia corretto.

	Percorso della libreria
	Ci si assicuri che il percorso /usr/local/mysql/lib/mysql sia inserito nel file /etc/ld.so.conf prima della compilazione

4.3.4. Esempio di configurazione

<location /manual/>
  AuthType Basic
  AuthUserfile /dev/null
  AuthName Testing
  AuthGroupFile /dev/null
  AuthMySQLHost localhost
  AuthMySQLCryptedPasswords Off
  AuthMySQLUser root
  AuthMySQLDB users
  AuthMySQLUserTable user_info
  <Limit GET POST>
    require valid-user
  </limit>
</location>

mysql < authmysql.sql

  create database http_users;
  connect http_users;

  CREATE TABLE user_info (
  user_name CHAR(30) NOT NULL,
  user_passwd CHAR(20) NOT NULL,
  user_group CHAR(10),
  PRIMARY KEY (user_name);

4.4.1. Cosa è mod_dynvhost

È un modulo che permette di definire nuovi Host Virtuali "al volo". Semplicemente si crei una nuova directory nel proprio percorso vhost, è tutto. Non è necessario far ripartire il server web

È una buona soluzione di hosting virtuale di massa per gli ISP

4.4.2. Download dei sorgenti

Sito di origine: http://funkcity.com/0101/projects/dynvhost/mod_dynvhost.tar.gz

4.4.3. Compilazione e installazione

cd /usr/local

tar -xvzf mod_dynvhost.tar.gz

cd dynvhost/

/usr/local/apache/bin/apxs -i -a -c mod_dynvhost.c

	Verificare httpd.conf
	Nota: Si guardi nel file httpd.conf per verificare che mod_dynvhost.so sia caricato all'avvio: LoadModule dynvhost_module libexec/mod_dynvhost.so

4.4.4. Esempio di configurazione

<DynamicVirtualHost /usr/local/apache/htdocs/vhosts/> 
  HomeDir / 
</DynamicVirtualHost>

Ora si crei una directory per ciascun host virtuale in /usr/local/apache/htdocs/vhosts/

ad es.

/usr/local/apache/htdocs/vhosts/foo.bar.org

Non è necessario far ripartire il server web

4.5.1. Cosa è mod_roaming

Dal punto di vista degli autori:

Mod_roaming è certamente di grande utilità. Sfortunatamente non funziona sulle connessioni tramite proxy. Si possono mantenere sincronizzati i propri bookmark di Netscape 4.x su differenti macchine. Non è supportato da nessun altro browser, inclusi Mozilla e Netscape 6.x.

4.5.2. Download dei sorgenti

Sito di origine: http://www.klomp.org/mod_roaming/

4.5.3. Compilazione e installazione

cd /usr/local 

tar -xvzf mod_roaming-1.0.2.tar.gz

cd mod_roaming-1.0.2

/usr/local/apache/bin/apxs -i -a -c mod_roaming.c

	Verificare httpd.conf
	Si controlli httpd.conf perché mod_roaming venga caricato all'avvio: LoadModule roaming_module libexec/mod_roaming.so

4.5.4. Esempio di configurazione

RoamingAlias /roaming /usr/local/apache/roaming
<Directory /usr/local/apache/roaming>
  AuthUserFile /usr/local/apache/conf/roaming-htpasswd
  AuthType Basic
  AuthName "Roaming Access"
  <Limit GET PUT MOVE DELETE>
    require valid-user
  </Limit>
</Directory>

5.1.1. Download dei sorgenti

Sito di origine: http://prdownloads.sourceforge.net/mod-gzip/mod_gzip-1.3.26.1a.tgz?download

5.1.2. Compilazione e installazione

Per compilare con successo mod_gzip è necessario modificare il Makefile e fornire il percorso corretto per apxs

make
make install

5.1.3. Esempio di configurazione

Si metta il seguente contenuto nel proprio /usr/local/apache/conf/httpd.conf:

mod_gzip_on                 Yes
mod_gzip_can_negotiate      Yes
mod_gzip_dechunk            Yes
mod_gzip_minimum_file_size  600
mod_gzip_maximum_file_size  0
mod_gzip_maximum_inmem_size 100000
mod_gzip_keep_workfiles     No
mod_gzip_temp_dir           /usr/local/apache/gzip
mod_gzip_item_include       file \.html$
mod_gzip_item_include       file \.txt$
mod_gzip_item_include       file \.jsp$
mod_gzip_item_include       file \.php$
mod_gzip_item_include       file \.pl$
mod_gzip_item_include       mime ^text/.*
mod_gzip_item_include       mime ^application/x-httpd-php
mod_gzip_item_include       mime ^httpd/unix-directory$
mod_gzip_item_include       handler ^perl-script$
mod_gzip_item_include       handler ^server-status$
mod_gzip_item_include       handler ^server-info$
mod_gzip_item_exclude       file \.css$
mod_gzip_item_exclude       file \.js$
mod_gzip_item_exclude       mime ^image/.*

Si potrebbe voler loggare il risultato della compressione nell'access log. Questo può essere ottenuto cambiando la direttiva LogFormat su /usr/local/apache/conf/httpd.conf

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" mod_gzip: %{mod_gzip_compression_ratio}npct." combined

5.2.1. Download dei sorgenti

Sito di origine: http://www.oldach.net/mod_gunzip.tar.gz

5.2.2. Compilazione e installazione

tar -xvzf mod_gunzip.tar.gz
cd mod_gunzip-2

/usr/local/apache/bin/apxs -i -a -c -lz mod_gunzip.c

5.2.3. Esempio di configurazione

Inserire il seguente contenuto nel proprio /usr/local/apache/conf/httpd.conf:

AddType text/html .htmz
AddHandler send-gunzipped .htmz

Ora si possono comprimere i propri file html e rinominarli ad es. in:

gzip index.html
mv index.html.gz index.htmz

Naturalmente bisogna modificare tutti i link a htmz, ad es. <a href="pagina.htmz">Qualche pagina</a>

6.2.1. Client IMAP

6.2.2. Download dei sorgenti

Sito di origine: http://www.washington.edu/imap/

6.2.3. Compilazione e installazione

cd /usr/local

tar -xvfz imap.tar.Z

cd imap

make slx SSLTYPE=nopwd 

	Nome del file per il download
	imap.tar.Z di solito è un link simbolico all'ultima release, attualmente è linkato a imap-2001a.tar.Z

6.2.4. PostgreSQL

cd /usr/local

tar -xvzf postgresql-7.3.2.tar.gz

cd postgresql-7.3.2

./configure \
--with-perl \
--enable-odbc \
--with-unixodbc  \
--with-pam \
--with-openssl \


make
make install

echo /usr/local/pgsql/lib >> /etc/ld.so.conf

ldconfig

6.2.5. Sablotron

tar -xvzf Sablot-0.97.tar.gz
cd Sablot-0.97

./configure
make
make install

ldconfig

6.2.6. pdflib

6.2.6.1. Cosa è pdflib

	PDFlib: è una libreria per generare al volo PDF. PDFlib è il componente software principale se si vogliono generare PDF sul proprio server, convertire testo e grafici o implementare l'output PDF nei propri prodotti.
--www.pdflib.com

Dal punto di vista degli autori:

	È un prodotto commmerciale
	PDFLIB è un Prodotto Commerciale. Si legga attentamente la licenza, per vedere se si ha bisogno di una licenza commerciale o meno

cd /usr/local/
tar -xvzf pdflib-4.0.3.tar.gz

cd pdflib-4.0.3

./configure --enable-shared-pdflib --enable-cxx

make
make install

ldconfig

6.2.7. gettext

cd /usr/local

tar -xvzf gettext-0.11.2.tar.gz

cd gettext-0.11.2

./configure

make
make check
make install

ldconfig

6.2.8. zlib

cd /usr/local

tar -xvzf zlib-1.1.4.tar.gz

cd zlib-1.1.4/

./configure

make
make test
make install

ldconfig

7.1.1. Cosa è APC

L'autore ha effettuato alcuni test di performance con APC, ed è stata una vera sorpresa. Una pagina Web PHP con un loop di query MySQL (per un totale di 10 query) è risultata essere più veloce del 50%

Lato negativo di APC: se si hanno altri utenti sul sistema che scrivono php, potrebbero non trovarlo agevole, poiché le modifiche sono del tutto ignorate a meno che non si svuoti la cache o si riavvii Apache. D'altra parte, fare si che APC faccia ogni volta un controllo per nuove versioni degli script, comporta un consistente decadimento delle prestazioni.

7.1.2. Download dei sorgenti

Sito di origine: http://apc.communityconnect.com/sources/apc-cvs.tar.gz

7.1.3. Compilazione e installazione

cd /usr/local

tar -xvzf apc-cvs.tar.gz

cd apc

./configure --enable-apc --with-php-config=/usr/local/bin/php-config

make
make install

cp modules/php_apc.so /usr/local/lib/php/extensions

echo 'zend_extension="/usr/local/lib/php/extensions/php_apc.so"' \
>> /usr/local/lib/php.ini
echo “apc.mode = shm” >> \
apc.mode = shm

Riavviare il Server Web Apache. Per provarlo, si crei un file php con il seguente contenuto:

<?php
apcinfo();
?>

7.2.1. Cosa è lo Zend-optimizer

Zend-Optimizer è un prodotto freeware closed source. Con lo stesso codice di test usato per APC, c'è stata una diminuzione di velocità di circa il 5% comparato con il PHP senza APC.

È necessario fare da se i propri test, per vedere se ci sono dei miglioramenti con il proprio codice. Ci si assicuri di NON usare Zend Optimizer insieme con APC, altrimenti l'intera configurazione non funzionerà.

7.2.2. Download dei file binari

Sito di origine: https://www.zend.com/store/free_download.php?pid=13

	Registrarsi presso zend.com
	È necessario registrarsi presso zend.com per avere accesso alla pagina di download

7.2.3. Installazione

Non c'è niente da compilare, questo prodotto è closed source ed è disponibile solo in formato binario per differenti piattaforme. Il nome del file varia in accordo con la propria piattaforma, l'esempio è per Linux su IA32.

cd /usr/local

tar -xvzf ZendOptimizer-2.1.0-Linux_glibc21-i386.tar.gz
	 
cd ZendOptimizer-2.1.0-Linux_glibc21-i386

./install.sh

Lo script di installazione è auto esplicativo, se si sono compilati Apache e PHP come descritto in questo documento, si può semplicemente premere INVIO a tutte le domande sui nomi dei percorsi.

8.2.1. Java2

8.2.2. Download dei binari

Si vada a http://java.sun.com/j2se/1.3/ [3]si scelga la propria piattaforma e si seguano i passi indicati sul sito.

8.2.3. Installazione dei binari

Eseguire il binario:

chmod +x j2sdk-1_3_1_02-linux-i386.bin

./j2sdk-1_3_1_02-linux-i386.bin

Dopo aver accettato la licenza, spacchettare il materiale, spostare la directory risultante in /usr/lib e creare un link simbolico appropriato

8.3.1. Installazione dei binari

cd /usr/local

tar -xvzf jakarta-tomcat-4.1.8.tar.gz

cd jakarta-tomcat-4.1.8

cd bin

rm *.bat

echo export JAVA_HOME=/usr/lib/java/ >> /etc/profile
. /etc/profile

Per attivare il manager di Tomcat, è necessario modificare /usr/local/jakarta-tomcat-4.1.8/conf/tomcat-users.xml aggiugendo un utente »admin« o con il ruolo »manager«. Il risultato dovrebbe essere qualcosa tipo questo:

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="manager"/>
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="admin" password="secret" roles="manager"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="role1" password="tomcat" roles="role1"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
</tomcat-users>

Ora dovrebbe essere possibile lanciare tomcat:

/usr/local/apache/jakarta-tomcat-4.1.8/bin/startup.sh

Dovrebbe essere possibile connettersi a: http://localhost:8080/index.jsp

8.4.1. Download dei sorgenti

Se si vuole avere una interfaccia nativa nel proprio Server Web Apache, è necessario compilare mod_jk il quale deve essere scaricato separatamente da qui: http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.18/src/jakarta-tomcat-connectors-4.1.18-src.tar.gz.

8.4.2. Compilazione e installazione

tar -xvzf jakarta-tomcat-connectors-4.1.18-src.tar.gz

cd jakarta-tomcat-connectors-4.1.18-src/jk/native

./buildconf
./configure --with-apxs=/usr/local/apache/bin/apxs

make
make install

8.4.3. Personalizzazione

Ora segue la parte noiosa, la personalizzazione dei file di configurazione. Prima si modifichi /usr/local/jakarta-tomcat-connectors-4.1.18-src/jk/conf/workers.properties, e si copi il file in /usr/local/apache/conf

Ho creato un workers.properties di esempio che funziona con le JSP e i servlet di prova che vengono forniti con la distribuzione di Tomcat. Si basa sul workers.properties di esempio di Tomcat

workers.tomcat_home=/usr/local/jakarta-tomcat-4.1.18

# workers.java_home deve puntare alla cartella della propria installazione di Java. Normalmente
# in essa si dovrebbero avere le directory bin e lib.
#
workers.java_home=/usr/lib/java2

# Si dovrebbe configurare il proprio separatore di ambiente... ps=\ su NT e / su UNIX
# e potrebbe essere differente in altri ambienti.
#
ps=/

# Gli operatori che dovrebbero creare e lavorare con i vostri plugin 
#
worker.list=worker1

#------ DEFINIZIONE DELL'OPERATORE DEFAULT ajp13 ------------------------------
#---------------------------------------------------------------------
# Definizione di un operatore chiamato ajp13 e di tipo ajp13
# Si noti che il nome e il tipo non devono coincindere.
#
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13

#------ DEFINIZIONE CLASSPATH -----------------------------------------
#---------------------------------------------------------------------
# Componenti class path addizionali.
#
worker.inprocess.class_path=$(workers.tomcat_home)$(ps)lib$(ps)tomcat.jar

# La JVM che abbiamo in uso
#
# Unix - Sun VM o blackdown
worker.inprocess.jvm_lib=$(workers.java_home)$(ps)jre$(ps)lib$(ps)i386$(ps)classic$(ps)libjvm.so

# Impostazione della posizione di stdout e stderr di tomcat
#
worker.inprocess.stdout=$(workers.tomcat_home)$(ps)logs$(ps)inprocess.stdout
worker.inprocess.stderr=$(workers.tomcat_home)$(ps)logs$(ps)inprocess.stderr

Di seguito, è necessario configurare il proprio file httpd.conf. Il seguente esempio coincide con quelli forniti da Tomcat.

LoadModule jk_module libexec/mod_jk.so
AddModule mod_jk.c

JkWorkersFile /usr/local/apache/conf/workers.properties
JkLogFile /var/log/httpd/mod_jk.log
JkLogLevel info
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
JkRequestLogFormat "%w %V %T"
JkMount /examples/servlet/* worker1
JkMount /examples/*.jsp worker1 

Dopo il riavvio di Apache, dovrebbe essere possibile connettersi alle proprie pagine JSP tramite Apache. Ad es.: http://localhost/examples/jsp/num/numguess.jsp

Per gli ulteriori passi, come l'installazione dei propri servlet e file jsp, sta a voi stessi...

	Variabili d'ambiente
	Se Tomcat non si avvia e/o le proprie servlet non possono essere avviate, l'errore più comune è non avere tutte le classi necessarie nella variabile CLASSPATH.

9.2.1. <users@httpd.apache.org>

Inviare una e-mail vuota a <users-subscribe@httpd.apache.org>

Prima di scrivere alla lista, controllare l'archivio: http://marc.theaimsgroup.com/?l=apache-httpd-users

9.2.2. <modperl@apache.org>

Inviare un e-mail a <modperl@apache.org> con il contenuto (non l'oggetto):

subscribe modperl

Prima di scrivere alla lista, controllare l'archivio: http://outside.organic.com/mail-archives/modperl/

9.2.3. <openssl-users@openssl.org>

Inviare un e-mail a <majordomo@openssl.org> con il contenuto (non l'oggetto):

subscribe openssl-users

Prima di scrivere alla lista, controllare l'archivio: http://www.mail-archive.com/openssl-users@openssl.org/

9.2.4. <modssl-users@modssl.org>

Inviare un e-mail a <majordomo@modssl.org> con il contenuto (non l'oggetto):

subscribe modssl-users

Prima di scrivere alla lista, controllare l'archivio: http://www.mail-archive.com/modssl-users@modssl.org/

9.2.5. <mysql@lists.mysql.com>

Inviare un e-mail vuota a <mysql-subscribe@lists.mysql.com>

Prima di scrivere alla lista, controllare l'archivio: http://lists.mysql.com/cgi-ez/ezmlm-cgi/

9.2.6. <pgsql-general@postgres.org>

Riempire la scheda di iscrizione presso http://developer.postgresql.org/mailsub.php

Prima di scrivere alla lista, controllare l'archivio: http://archives.postgresql.org/pgsql-general/

9.2.7. php.net

Riempire la scheda di iscrizione presso http://www.php.net/mailing-lists.php.

Ci sono diverse mailing list relative a php a cui iscriversi, alcune sono disponibili anche sul server news di php.net.

Prima di scrivere alla lista, controllare l'archivio che è linkato anche sulla pagina di iscrizione.

9.2.8. <apc-cache@lists.communityconnect.com>

Inviare un e-mail a <apc-cache-request@lists.communityconnect.com> con il contenuto (non l'oggetto):

subscribe