Guida all'installazio= ne di Gorg

=0A=0A1=0A2010-04= -28=0A=0A=0AIntroduzione=0A

=0A=0A=0A

=0AGorg =C3=A8 un processore di backend XSLT per un sito web basa= to su XML. I file=0Asorgenti XML vengono trasformati e serviti al volo. I f= ile di output e le loro=0Adipendenze vanno nella cache. Le sue caratteristi= che principali: =0A

=0A=0A

Funziona con apache, lighttpd o w= ebrick (il server web di ruby)
Usa un sistema efficiente di c= aching
=0A Genera intestazioni HTTP coerenti quando pi=C3= =B9 nodi web forniscono lo stesso=0A contenuto=0A
=0A = Implementa un proprio sistema di compressione (alias mod_gzip), quindi=0A = non si appoggia al server web per comprimere il proprio output=0A
Supporta il caching su lato client
Il proprio XSL pu= =C3=B2 accettare e scrivere cookies
=0A Fornisce un proprio= motore di ricerca (l'indicizzazione del sito verr=C3=A0=0A sostanzialme= nte aggiornata in una versione futura)=0A

=0A=0A

=0AGorg co= nsente di distribuire la propria copia locale di=0Ahttp://www.gentoo.o= rg. Pu=C3=B2 usare sia script cgi che fastcgi con=0Aapache o lighttpd= , oppure il suo server web stand-alone. Il suo nome =C3=A8=0Al'abbreviazion= e per Gentoo.org perch=C3=A9 =C3=A8 stato creato pensando=0Aa= l sito di Gentoo quando c'=C3=A8 stato bisogno di trovare un sostituto per = AxKit.=0A

=0A=0A

=0AGorg =C3=A8 stato testato su x86, amd64, alpha, sp= arc, ppc, mips & hppa con i=0Aseguenti pacchetti:=0A

=0A=0A

=0A>=3Dnet-www/apache-2.0.55=0A>=3Dwww-apache/mod_=
fcgid-1.0.8 =0A=0A>=3Ddev-lang/ruby-1.8.4=0A>=3Ddev-libs/fcgi-2.4.0  =0A>=
=3Ddev-ruby/ruby-fcgi-0.8.6=0A>=3Ddev-libs/libxml2-2.6.23=0A>=3Ddev-libs/li=
bxslt-1.1.15=0A(Nel caso improbabile che si voglia sperimentare il=
 motore di ricerca di gorg)=0A>=3Ddev-db/mysql-4.0.26 (f=
ino a e incluse le versioni 5.*)=0A>=3Ddev-ruby/ruby-dbi-0.0.21=
=0A>=3Ddev-ruby/mysql-ruby=0A

=0A=0A=0A

=0A= =0A=0A=0AInstallazione di Gorg=0A

=0A= =0A=0A

=0ADefinire le proprie USE flag per installare apache con o senza = il supporto a mod_fcgi,=0Ain base all'uso che se ne vuole fare. La USE flag= mysql =C3=A8 richiesta solo per=0Ail motore di ricerca integrato.= =0A

=0A=0A=0APotrebbe essere necessario aggiungere una keyword per= alcune dipendenze=0Asulla propria architettura. =C3=88 possibile aggiunger= e una keyword per i pacchetti=0Arichiesti oppure accettare una architettura= diversa. gorg =C3=A8 stato installato e=0Atestato su x86, amd64, alpha, sp= arc, ppc, mips & hppa.=0A=0A=0A

=
=0A(Con il supporto ad apache)=0A# echo www-se=
rvers/gorg fastcgi apache -mysql >> /etc/portage/package.use=0A=0A(Senza il supporto ad apache)=0A# echo www-servers/=
gorg -fastcgi -apache -mysql >> /etc/portage/package.use=0A=0A=
(Verificare che le dipendenze siano disponibili per la propria architettura=
)=0A# emerge -pv gorg=0A=0A(Installare gorg)=0A# emerge gorg=0A

=0A=0A=0A

=0A=0A=0A=0AConfigurazione di Gorg=0A

=0AConfigurazione di apache=0A=0A=0A=0ASi pu=C3=B2 salt= are questa sezione se non verr=C3=A0 utilizzato apache. =0A=0A=0A

= =0AIn caso si voglia utilizzare fastcgi, che =C3=A8 comunque consigliato, b= isogna=0Aaggiungere -D FCGID alla variabile APACHE2_OPTS nel= =0Afile /etc/conf.d/apache2.=0A

=0A=0A

=0ASuccessivamente= , integrare le direttive di configurazione per apache dal file=0Adi esempio= /etc/gorg/vhost.sample nella propria configurazione per=0Ai v= host, ad esempio: /etc/apache2/vhosts.d/10_gorg.conf. I commen= ti=0Anel file di configurazione di esempio sono di aiuto.=0A

=0A=0A

= =0AInfine, copiare o creare un link simbolico agli script (c)cgi da=0A/usr/lib/ruby/site_ruby/<ruby-version>/gorg/fcgi-bin/gorg.fcgi=0Ae=0A/usr/lib/ruby/site_ruby/<ruby-version>/gorg/cgi-bin/{go= rg,search}.cgi=0Anelle cartelle (f)cgi del proprio sito web e verifi= care che siano eseguibili. =C3=88 consigliabile=0Acopiare search.cgi<= /path> solo nel caso in cui si desidera utilizzare il motore=0Adi ricerca i= ntegrato.=0A

=0A=0A=0A

=0A

=0AConfigurazi= one di gorg=0A=0A=0A

=0ACreare una copia del file di config= urazione di esempio=0A/etc/gorg/gorg.conf.sample chiamata /etc/gorg/gorg.conf=0Ae modificarlo. I commenti sono di aiu= to per definire i propri parametri. =C3=88=0Anecessario come minimo definir= e la cartella radice per i documenti web.=0A

=0A=0A

=0ASe non si vuole= utilizzare il file di configurazione predefinito=0A/etc/gorg/gorg.co= nf, =C3=A8 necessario definire la variabile d'ambiente=0Achiamata GORG_CONF che punta al file di configurazione.=0A

=0A=0A=0ASe= si desidera utilizzare la cache, ed il suo uso =C3=A8 raccomandato, =C3=A8= bene=0Aaccertarsi che la cartella di cache definita nel file di configuraz= ione abbia i permessi=0Acorretti. Se si sta usando apache, l'utente apacha = ha bisogno dell'accesso totale=0Aa quella cartella.=0A=0A=0A= =0A

=0A

=0AAggiungere i file mancanti=0A=0A=0A

=0ASupponendo di voler servire una copia locale di CVS, o una s= ua copia, o=0Adei link simbolici ad essa, =C3=A8 necessario scaricare alcun= i file dalla cartella=0Adyn.=0A

=0A=0A

=0A(Entrare nella cartella htdocs)=0A$ cd /percorso/cartella/radice/documenti=0A/htdocs $ cd dyn=0A/htdocs $ wget -O news-index.xml http://www.gentoo.org/dyn/news-ind=
ex.xml?passthru=3D1=0A/htdocs $ cd ..=0A(Eseguire lo st=
esso comando per qualunque altro dato che pu=C3=B2 risultare necessario=0Ad=
alla cartella /dyn directory)=0A

=0A=0A
=0AC'=C3=A8 anche = la necessit=C3=A0 di rendere le immagini disponibili al browser. La cartell= a=0Aimages si trova un livello sopra htdocs.=0ABa= sta definire un link simbolico e si =C3=A8 pronti a partire.=0A
=0A=0A=0A/htdocs $ ln -s= i ../images images=0A=0A(Dovrebbe apparire in questo modo:)=0A/htdocs $ ls -l=0Adrwxr-xr-x 3 neysx users 128 Sep 14 1= 7:45 css=0Adrwxr-xr-x 31 neysx users 744 Oct 26 00:03 doc=0Adrwxr-xr-x = 3 neysx users 544 Nov 2 16:53 dtd=0Adrwxr-xr-x 3 neysx users 168 Nov = 3 16:24 dyn=0A-rw-r--r-- 1 neysx users 1406 Jun 7 2003 favicon.ico=0Alr= wxrwxrwx 1 neysx users 10 Oct 21 22:29 images -> ../images/=0A-rw-r--r-= - 1 neysx users 190 Nov 9 2002 index.xml=0Adrwxr-xr-x 16 neysx users = 384 Apr 1 2004 main=0Adrwxr-xr-x 17 neysx users 6960 Nov 3 15:34 news= =0Adrwxr-xr-x 8 neysx users 192 Oct 23 14:52 proj=0Adrwxr-xr-x 4 neysx= users 96 Sep 17 14:05 security=0Adrwxr-xr-x 3 neysx users 736 Nov 2 = 16:40 xsl=0A=0A=0A
=0ANel CVS locale probabilmente appariranno dell= e voci in pi=C3=B9, ma quelle=0Acitate in precedenza dovrebbero essere disp= onibili e mantenute aggiornate.=0ARicordarsi anche di mantenere la cartella= images cos=C3=AC com'=C3=A8.=0A
=0A=0A=0A

= =0A=0A=0A=0AAvviare Gorg=0A
=0AIl server web stand-alone=0A=0A=0A
=0AIl modo pi=C3=B9= semplice per provarlo =C3=A8 eseguire gorg. Dovrebbe apparire=0Aqua= lcosa come:=0A
=0A=0A
=0A$ gorg=0A= =0AAvvio del server web Gorg sulla porta 8008=0A=0ADigitare Ctrl-C oppure "= kill 31479" per fermarlo=0A
=0A=0A
=0APuntare il browser su htt= p://localhost:8008 e dovrebbe=0Aessere possibile visualizzare il prop= rio sito preferito.=0A
=0A=0A=0A
=0A
=0AC= on apache=0A=0A=0A
=0ARiavviare apache (/etc/init.d/apac= he2 restart) e visitare=0Ahttp://localhost supponendo di ave= rlo installato sulla=0Apropria workstation.=0A
=0A=0A
=0ASe si stanno = utilizzando server fastcgi, dovrebbe essere possibile visualizzarli=0Acon <= c>top -u apache.=0A
=0A=0A
=0ASe non dovesse funzionare, provare i= l server web stand-alone=0A(digitaregorg). Se neanche questo metodo = dovesse funzionare,=0Averificare il file di configurazione /etc/gorg/= gorg.conf. Se=0Ainvece dovesse funzionare, verificare i file di conf= igurazione di apache ed i log.=0A
=0A=0A=0A
=0A=0A