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.