Om dist av apache-servere ved UiO

[Overblikk] [Oppsett] [Lokale tilpasninger] [Andre nyttige ting] [Fil- og katalogrettigheter]

 

Advarsel

Denne informasjonen er utdatert, så du vil om 5 sek bli videresendt til riktig side.

 

Overblikk

USIT tilbyr dist av Apache web-server til lokale IT-ansvarlige ved UiO, ta kontakt med unix-drift@usit.uio.no for å be om å få distet denne, mens alle andre henvendeler om apache-disten bør sendes til webmaster@usit.uio.no. USIT sin httpd-dist er for tiden (pr. september 2002) basert på :

• Apache-1.3.27
• mod_perl-1.27
• mm-1.2.1
• mod_ssl-2.8.11-1.3.27
• php-4.2.3
• De aller fleste standard apache-moduler er kompilert inn som DSO (Dynamic Shared Objects). Unntaket er mod_perl, som er statisk innkompilert.

Om mod_perl: Under Linux er det en sær bug i kombinasjonen mellom mod_perl og den standard-perl'en vi dister (5.004), derfor er mod_perl kompilert med perl-5.6.0 under Linux, og den følger derfor med apache-disten på Linux.

Om PHP: Det er foreløpig ikke lagt inn noen database-støtte i PHP'en vi dister. Endel har etterlyst dette, og det er nå under utvikling en versjon av disten der det vil være støtte for både Oracle og MySQL.

Om mod_ssl: mod_ssl er å anse som "unsupported". Den er kompilert inn, og skal funke, men USIT kommer inntil videre ikke til å være behjelpelig med å sette opp SSL-baserte webservere hos de som mottar disten, ei heller ta på seg å skaffe sertifikater for de som vil bruke dette. mod_ssl er dynamisk linket mot OpenSSL (kjør "/local/bin/openssl version" for å se gjeldende versjonsnummer) som de fleste allerede får distet, si ifra til unix-drift@usit.uio.no hvis du mangler OpenSSL.

Full dokumentasjon av disse finner man på:

• Apache : http://www.apache.org/httpd.html.
• mod_perl : http://perl.apache.org/.
• PHP : http://www.php.net/.
• mod_ssl : http://www.modssl.org/.
• OpenSSL : http://www.openssl.org/.

I tillegg inneholder disten endel programmer (se README.UiO) og maler for UiO sin visuelle profil (basert på uhtml, http://www.usit.uio.no/it/web/uhtml/).

 

Oppsett

Apache distes kun til de it-ansvarlige som har bedt om å få dette til sine maskiner. De som tar imot denne disten bør sørge for at /local/www er en symlink til en katalog på en annen partisjon, av to grunner :

1. /local/www/htdocs og /local/www/logs kan bli veldig store, og disse katalogene bør ikke fylle opp /local partisjonen.
2. Det er meningen at det bare skal ligge USIT-distet software på /local, slik at man blant annet slipper å ta backup av /local på alle maskiner.

 

README.UiO

Se /local/www/README.UiO fra disten for oppdatert informasjon om katalogstruktur og annen informasjon.

 

Lokale tilpasninger

Dette må gjøres av lokal IT-ansvarlig på maskiner som skal motta httpd-disten:

1. Lokale endringer i httpd-oppsettet skal legges i fila /etc/httpd.conf. Der må det minst ligge to linjer :

   ServerAdmin webmaster@<din-enhet>.uio.no
   ServerName www.<din-enhet>.uio.no 

   Send evt. spørsmål om opprettelse av mailadressen webmaster@<din-enhet>.uio.no til postmaster@uio.no.

   Ved spørsmål om opprettelse av maskinaliaset www.enhet.uio.no, kontakt hostmaster@usit.uio.no.

2. Touch /etc/usit/http.server slik at httpd startes ved boot.
   
   
3. Opprett katalogen /local/www/htdocs (for web-dokumentene), gjerne til en annen partisjon eller et annet, lokalt, del av filtreet.
   
   
4. Kjør

   /local/www/bin/apachectl start

   for å starte webserveren (gjøres automatisk ved neste boot dersom fila /etc/usit/http.server finnes).
   
   
5. Fra /local/www/conf/httpd.conf :

   # Denne fila, /local/www/conf/httpd.conf, blir distet fra usit og kan
   # ikke modifiseres lokalt. Denne fila inkluderer to filer på den lokale
   # serveren som kan brukes til lokale endringer :
   #
   #  /etc/httpd.conf.pre : for ting som skal spesifiseres _før_ direktivene
   #                        i den distede httpd.conf
   #  /etc/httpd.conf     : for ting som skal spesifiseres _etter_ direktivene
   #                        i den distede httpd.conf
   #
   # Normalt skal man kun legge lokale modifikasjoner i /etc/httpd.conf siden
   # det vanligvis er _siste_ forekomst av et direktiv som trår i kraft. For
   # enkelte direktiver er det imidlertid _første_ forekomst som trår i kraft,
   # da må lokale modifikasjoner legges i /etc/httpd.conf.pre
   

Se også README.UiO.

 

Andre ting som man kanskje ønsker

1. Hvis man ønsker å bruke UHTML (http://www.usit.uio.no/it/web/uhtml/) til automatisk å legge på den visuelle profilen, så må man gjøre et par ting:
   • Opprett fila /local/www/site/uioprofil.conf, den skal inneholde navn på hvilke profiler som skal lastes ned, f.eks.:

     morgoth# cat /local/www/site/uioprofil.conf
     uio
     usit

     Liste over hvilke profiler som finnes får man ved å gjøre følgende kommando:

     rsync  wo.uio.no::uhtml-maler/*

     på en unix-maskin.
   • Scriptet /local/www/bin/hent_uioprofil laster ned profilene som er spesifisert i fila /local/www/site/uioprofil.conf. Dette scriptet legges automatisk inn i crontab på alle maskiner som tar imot disten, og kjøres hver natt. Det kan i tillegg kjøres manuelt for å laste ned profiler med en gang.
   • Man må også legge inn dette i /etc/httpd.conf for at serveren skal ta i bruk malene :

       <Files ~ "\.html$">
          SetHandler perl-script
          PerlHandler UHTML::Profile
       </Files>

     og restarte serveren med /local/www/bin/apachectl stop og så /local/www/bin/apachectl start. Ikke bruk restart for mod_perl skal vistnok lekke minne ved bruk av restart/graceful.
   
   
2. Ta kontakt med postmaster@usit.uio.no dersom du ønsker å opprette en mailingliste for webmaster for din enhet. Ta kontakt med hostmaster@usit.uio.no dersom du ønsker å opprette et alias www.enhet.uio.no for maskina som webserveren går på.
   
   
3. Rotering av logfiler kan gjøres med /local/www/bin/newlog, bør kjøres fra cron første dag i hver måned:

   1 0 1 * * /local/www/bin/newlog 

   Dette vil bli lagt inn automatisk i cron på alle maskiner som mottar disten.
   
   
4. Dersom man vil ha en link til instituttets server fra universitetets hjemmeside, så send en forespørsel til webmaster@usit.uio.no.
   
   
5. Hvis man ønsker at bestemte kataloger skal betjenes med egne hostnavn, for eksempel at http://www.<institutt>.uio.no/ skal serves fra /local/www/htdocs/institutt så kan dette gjøres med Apache sin VirtualHost direktiv. Les http://www.apache.org/docs/vhosts/index.html for hvordan dette gjøres.

   Eksempel på oppsett av virtuell host:
   Man har maskina fnord.uio.no med ip-adresse 10.0.42.42, og vil at http://www.florp.uio.no/ skal betjenes fra /local/www/virtual/www.florp.uio.no/htdocs, med log-filer på /local/www/virtual/www.florp.uio.no/logs.

   • Be hostmaster@usit.uio.no om å opprettet et alias (CNAME) www.florp.uio.no som peker på fnord.uio.no.
   • Legg dette i /etc/httpd.conf:

     NameVirtualHost 10.0.42.42
     <VirtualHost 10.0.42.42>
         DocumentRoot /local/www/htdocs
         ServerName fnord.uio.no
         Serveralias fnord
     </VirtualHost>
     <VirtualHost 10.0.42.42>
         ServerName www.florp.uio.no
         ServerAlias www.florp
         DocumentRoot /local/www/virtual/www.florp.uio.no/htdocs
         CustomLog /local/www/virtual/www.florp.uio.no/logs/access_log combined
         Errorlog /local/www/virtual/www.florp.uio.no/logs/error_log
     </VirtualHost>

   • Opprett katalogene /local/www/virtual/www.florp.uio.no/htdocs og /local/www/virtual/www.florp.uio.no/logs/
6. Webstatistikk: se her.

 

Fil- og katalogrettigheter

Forslag til eier og rettigheter på /local/www :

/local/www/bin	   : Siden dette området inneholder filer som eksekveres som
	             root ved oppstart, så skal katalogen og filene der kun
		     være skrivbare for root.

/local/www/cgi-bin : Hvis man ikke ønsker at andre enn root skal kunne legge
		     opp cgi-programmer som kjøres av serveren, bør også dette
		     området være eid av root. Eventuelt kan man opprette
		     en egen filgruppe for drift av www-serveren, og la
		     denne katalogen være skrivbar for denne gruppen.

/local/www/conf	   : Her spesifiseres viktige egenskaper ved serveren,
		     så denne katalogen bør kun være skrivbar for root.

/local/www/htdocs  : Man kan med fordel opprette egne filgrupper som skal
		     ha adgang til forskjellige kataloger under denne
		     katalogen, slik at ulike miljøer kan legge opp
		     informasjon her uten å måtte gå via root, dersom dette
		     er ønskelig.

/local/www/icons   : Som for htdocs-katalogen.

/local/www/logs	   : Bør kun være skrivbart for root. Et problem er om man
		     ønsker at filene her skal være *lesbare* for andre enn
		     root, siden de juridiske sidene ved allment lesbar
		     access_log er noe uklare. Hvis man velger å gjøre
		     log-filene lesbar kun for root, så husk å ta dette i
		     betraktning hvis en har scripts som roterer log-filene
		     siden nye log-filer vil opprettes med aksess 644.

---

Redaksjon: Webgruppa, webmaster@usit.uio.no
Dokument opprettet: 04.01.2001, endret: 11.01.2001Administrer dette dokumentet