       Istruzioni per chi deve installare la guida in un sito WWW
       ==========================================================
Versione 3.0

Per prima cosa, ricordate che l'operazione di mirroring di questa guida e'
soggetta alle condizioni indicate nel primo capitolo della guida e deve
comunque essere stata esplicitamente autorizzata da me per E-mail.


Configurazione del server
=========================

E' necessario che la configurazione del server HTTP risponda ad alcuni
semplici requisiti.

Per prima cosa, dovete abilitare, se non lo e' gia', il vostro server
HTTP a spedire file di tipo Javascript.
Se usate Apache o NCSA basta inserire, preferibilmente al fondo del file
srm.conf, la direttiva

AddType application/x-javascript .js

In alternativa, potete inserire nel file mime.types la riga

application/x-javascript js

quindi resettare il demone HTTP (o killarlo e farlo ripartire).

Un'altra condizione: il mirror deve essere installato in una directory
denominata icfaq . Possibilmente, esso deve rispondere al percorso /icfaq/
o /mirror/icfaq/ rispetto alla radice del server. Questo per garantire un
minimo di uniformita', visto il grande numero dei mirror.

Inoltre, il server (come avviene normalmente) deve accettare index.htm come
nome dell'ipertesto di default in una directory, per caricare correttamente
la guida.


Mirroring mediante programma automatico
=======================================

A partire da questa versione, e' caldamente suggerito il mirroring
automatico della guida, visto il grande numero di mirror e la fatica
necessaria per mantenerli manualmente aggiornati.

A questo scopo, vi consiglio di utilizzare l'utility Perl "mirror" (v2.8 o
superiore), che e' utilizzata dai maggiori siti FTP mondiali per mantenere
i propri mirror. Essa puo' essere scaricata dal sito sunsite.doc.ic.ac.uk
nella directory /packages/mirror/, oppure da ftp.poli.studenti.to.it in
/pub/unix/siteutil/ (in entrambi i casi usando FTP).

Io provvedero' a spedirvi il file mirror.icfaq, che contiene i settaggi
necessari per effettuare il mirroring automatico della guida. Esso deve
essere personalizzato, modificando il valore del parametro local_dir e
assegnandogli il percorso completo della directory (fisico, rispetto alla
radice del file system) in cui deve essere memorizzata la guida (ad esempio
/etc/httpd/htdocs/icfaq/ ). Il file deve essere quindi salvato nella
directory in cui avete installato mirror.

Voi dovete provvedere a inserire nella crontab del vostro sistema il
seguente comando, in modo che sia eseguito almeno una volta alla settimana:

/percorso_per_mirror/mirror /percorso_per_mirror/mirror.icfaq

dove percorso_per_mirror e' il percorso completo, rispetto alla radice del
file system, della directory in cui avete installato mirror.

Potete verificare regolarmente il log del mirroring, che viene memorizzato
nel file .mirror all'interno della directory della guida.

Non e' comunque obbligatorio usare mirror, anche se e' il pacchetto piu'
diffuso: qualsiasi software che faccia la stessa operazione, via FTP o WWW,
andra' benissimo.


Mirroring mediante spedizione di ZIP
====================================

Se proprio non potete mettere in piedi il mirror automatico, provvedero' a
spedirvi ad ogni aggiornamento i due file ICFAQ30W.ZIP e ICFAQ30Z.ZIP.

Per installarli e' sufficiente seguire la procedura riportata:
1) Se questa e' la prima versione che installate, create la directory in cui
   sara' memorizzata la guida, quindi create al suo interno una subdirectory
   denominata zip (minuscolo). Altrimenti, cancellate tutti i file contenuti
   in precedenza nelle due directory.
2) Scompattate l'archivio ICFAQ30W.ZIP nella directory della guida. Control-
   late che i nomi dei file siano tutti *minuscoli* (se l'unzip che state
   usando ve li crea maiuscoli, dovrete rinominarli. Per evitare questo
   stupido problema, potete scompattare l'archivio su di un PC e quindi
   trasferire i file sul server via FTP: dovrebbero arrivare minuscoli.)
3) Scompattate l'archivio ICFAQ30Z.ZIP nella directory zip. 
4) Al termine delle operazioni, se installate la guida su un server Unix,
   e' probabilmente necessario rinominare il file index.htm in index.html,
   a meno che il vostro server non accetti entrambi i nomi come file di
   default per la directory.


Vi ringrazio per la collaborazione.
Per ogni problema o dubbio non esitate a mandarmi un E-mail.
