Terve!

Valitan, että Korpin asennuksessa teidän käyttöönne meni luvattoman kauan. 
Osasyynä tähän oli oma sairasteluni ja osasyynä ohjelmistojen 
versioyhteensopimattomuus. 

Pauli Kujala säätää vielä joitain javapapuja, mutta muutoin asennus alkaa 
olemaan valmis.

Korppi on monimutkainen järjestelmä, joka toimii periaatteessa seuraavalla 
tavalla:

  WWW-selaimen pyyntö -> Apache -> Tomcat -> Poolman -> PostgreSQL

Tässä hieman tietoa ko. komponenteista ja niihin vaikuttavista asioista. 
Kaikissa myöhemmin mainituissa asioissa on käytössä sama salasana, jonka 
saatte joko Paulilta tai minulta nykimällä hihasta. Periaatteesta 
salasanoja ei lähetellä sähköpostitse.

Korppi on asennettu koneisiin amritsar.it.jyu.fi ja hartman.it.jyu.fi. 
Käytän jäljempänä esimerkeissä hartman-konetta. Molemmissa ko. koneissa 
teillä on täydet sudo-oikeudet, eli voitte suorittaa haluamanne komennon 
rootin oikeuksilla kirjoittamalla komennon eteen sudo. Tämän käytössä 
pitää olla varovainen ja sitä ei saa käyttää sillä tavalla, että ottaa ko. 
komennon avulla haltuunsa esimerkiksi root-konsolin. Tarkoitan siis, että 
ette aja komentoja 'sudo su -', 'sudo passwd' tai vaikkapa 'cp /bin/bash 
~/bash && sudo chmod 4755 ~/bash'. Jokainen sudo-komento, jonka 
suoritatte, tulee minulle sähköpostina.

PostgreSQL:
-----------

PostgreSQL on koko ajan koneissa päällä. Sen voi kuitenkin sammuttaa 
komennolla 'sudo /etc/rc.d/init.d/postgresql stop' ja käynnistää 
vastaavasti parametrilla 'start'. Myös 'restart' on käytössä. PostgreSQL:n 
käyttäjätunnus on 'korppi' ja kannan nimi 'korppi'. PostgreSQL:ssä on 
testimateriaaliksi laitettu teille testikoneen (jamshedpur) kannan 
sisältö, jossa käyttäjien henkilötunnuksien loppuosat on nollattu ja 
kaikille on laitettu sama geneerinen salasana (jonka saatte Paulilta, 
ellette tiedä sitä jo).

Kantaan saa yhteyden komentoriviltä komennolla 'psql -U korppi'.

Kantaa voi hallita WWW:stä käsin (SSL-salatulla) phpPgAdmin-kilkkeellä. 
Sen WWW-osoite on 

  https://hartman.it.jyu.fi/phpPgAdmin/ (ja 
  https://amritsar.it.jyu.fi/phpPgAdmin/ ). 

PostgreSQL löytyy (tai tarkemminkin sen data) hakemistosta /var/lib/pgsql/.
Pääsyä kantaan hallitaan tiedostolla /var/lib/pgsql/data/pg_hba.conf.

Poolman:
--------

Poolman löytyy hakemistosta /usr/local/poolman. Poolmanin asetukset 
löytyvät tiedostosta /usr/local/poolman/lib/poolman.props. Poolmania ei 
tarvitse erikseen käynnistellä, vaan se on käytännössä vain kaksi 
jar-pakettia, jota käytetään Tomcatista käsin.

Tomcat:
-------

Tomcat löytyy hakemistosta /usr/local/tomcat ja sen asetukset monistakin 
tiedostoista, jotka löytyvät hakemistosta /usr/local/tomcat/conf.

Tomcat vaatii uudelleenkäynnistyksen papujen muuttuessa. Tomcat sammuu 
komennolla 'sudo /usr/local/tomcat/bin/shutdown.sh' ja käynnistyy 
komennolla 'sudo su - tomcat -c /usr/local/tomcat/bin/startup.sh'. 
Sammutuksen ja käynnistyksen välissä on hyvä tuhota Tomcatin 
väliaikaistyötiedostot, jotka löytyvät hakemistosta /usr/local/tomcat/work 
(vaikkapa 'sudo rm -rf /usr/local/tomcat/work/localhost*').

Tomcat kirjoittaa lokia tiedostoon /space/kotka/kotka.log (tai 
/home/korppi/html/kotka/kotka.log, joka on sama tiedosto linkitettynä).

Apache:
-------

Apache tottelee tavanomaista käynnistysskriptiä, eli siis seuraavat 
komennot ovat käytössänne:

'sudo /etc/rc.d/init.d/httpd stop'
'sudo /etc/rc.d/init.d/httpd start'
'sudo /etc/rc.d/init.d/httpd restart'

Apachea ei tarvitse koko aikaa olla käynnistelemässä uusiksi, ei edes 
silloinkaan kun Tomcattia restarttaillaan.

Apachessa käytössä oleva SSL-sertifikaatti kyselee passphrasea jokaisen 
käynnistyksen yhteydessä (joka on siis sama kuin kannan salasana).

Apachen pääkonfiguraatiotiedosto on /etc/httpd/conf/httpd.conf.

Korppi-systeemi:
----------------

Sivut sijaitsevat hakemistossa

  /home/httpd/hartman.it.jyu.fi/https/ (ja
  /home/httpd/amritsar.it.jyu.fi/https/ ). 

Varsinainen systeemi sijaitsee hakemistossa 

  /home/httpd/hartman.it.jyu.fi/https/kotka .

Te kuulutte kaikki ryhmään nimeltä wwwadmin ja sitä kautta uusia sivuja 
tehdessänne laittakaa ne ryhmän wwwadmin omistukseen ja ryhmälle 
kirjoitusoikeudet sivuihin, niin muutkin ryhmäläiset pääsevät editoimaan 
niitä.

Kysymyksiä? No varmasti. Minulta voi kysyä systeemin toiminnasta ja 
Paulilta koodauspuolesta.

-- 
  Harri Tuomi
  ATK-suunnittelija, JYU/MIT
  Agora C426.1, tel. (014) (260) 4979
  hamitu@it.jyu.fi