Asennusohje Sahara-ryhmä Helsinki 24.8.2005 Ohjelmistotuotantoprojekti HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos
Kurssi 581260 Ohjelmistotuotantoprojekti (6 ov) Projektiryhmä Sanna Keskioja Sampo Lehtinen Hanna Liedenpohja Seppo Syrjänen Asiakas Joni Salmi Johtoryhmä Juha Taina Kimmo Simola Kotisivu http://www.cs.helsinki.fi/group/sahara Versiohistoria Versio Päiväys Tehdyt muutokset 0.1 24.8.2005 Ensimmäinen versio: pohja ja tietokanta./ss
Sisältö i 1 Johdanto 1 2 Tietokannan asentaminen 2 2.1 PostgreSQL:n käyttöönotto asennusscriptillä................ 2 2.2 PostgreSQL:n käyttöönotto käsin...................... 3 2.3 pg_hba.conf................................. 3 2.4 Tietokannan alustus............................. 3
1 Johdanto 1 Tämä dokumentti antaa ohjeet Tanja-järjestelmän asentamiseen Apache/PHP/PostgreSQLympäristöön.
2 Tietokannan asentaminen 2 [Taisi olla joku verbatim-temppu, jolla esimerkkikoodit sai siisteiksi] Tanja vaatii toimiakseen PostgreSQL-tietokantapalvelimen, sinne tunnuksen sahara sekä tietokannan tanja. Asetukset (edellisten lisäksi kone, jossa tietokanta on käytössä sekä TCP-portti, jossa tietokanta palvelee) kerrotaan Tanjan tiedosto asetukset/tietokantayhteys.php. 2.1 PostgreSQL:n käyttöönotto asennusscriptillä Tanjan mukana toimitetaan asennusscripti asenna-pq.sh, joka Tietojenkäsittelytieteen sovellusympäristössä koneessa db.cs.helsinki.fi alustaa PostgreSQL-palvelimen ja asentaa siihen Tanja-sovelluksen tietokannat. Asennus tehdään komennolla sh asenna-pq.sh Loki tyypillisestä asennuksesta on liitteessä 1 (tiedostossa pg-asennus.txt). Katso komennolla echo $PGPORT missä portissa palvelin pyörii. Tarvitset tätä tietoa Tanja-sovellukselle kerrottavaksi. Tietokanta on nyt valmis käytettäväksi. Voit katsoa PostgreSQL:n hallintatyökalulla, että esim. taulu kayttaja on asentunut oikein: psql -U sahara tanja Password: Welcome to psql 7.4.7, the PostgreSQL interactive terminal. Type: copyright for distribution terms h for help with SQL commands? for help on internal slash commands g or terminate with semicolon to execute query q to quit tanja=> d kayttaja Table "public.kayttaja"column Type Modifiers + + kid integer not null default nextval( public.kayttaja_kid_seq ::text) etunimi character varying sukunimi character varying sposoite character varying salasana character varying uusisalasana character varying uusisposoite character varying viimkaytto timestamp with time zone default now() Indexes: "kayttaja_kid_key"unique, btree (kid) "kayttaja_sposoite"btree (sposoite) Triggers: kayttaja_trigger BEFORE INSERT OR UP- DATE ON kayttaja FOR EACH ROW EXECUTE PROCEDURE touch() tanja=> q
3 2.2 PostgreSQL:n käyttöönotto käsin Asenna tai hanki muuten käyttöön PostgreSQL-ympäristö. Tietojenkäsittelytieteen laitoksen ympäristössä tämä tapahtuu komennolla wanna-postgres. Aseta tietokannan hallintatunnuksen salasana. Käynnistä PostgreSQL:n tietokantapalvelin komennolla start-postgres: Postmaster daemon with pid 24385 and listening port 12346 has been started. Merkitse ylös missä portissa palvelin pyörii, tarvitset tätä tietoa Tanja-sovellukselle kerrottavaksi. Anna komento setup postgres, niin ympäristösi alustetaan tietokantapalvelimen kanssa toimimista varten. 2.3 pg_hba.conf Tietokantapalvelin ei oletuksen suostu keskustelemaan kuin samassa koneessa olevien sovellusten kanssa. Asia korjataan lisäämällä tiedoston pg_hba.conf (Host Based Authentication) (hakemistossa postgres/var) loppuun rivi: host tanja sahara 128.214.9.149 255.255.255.255 password missä 128.214.9.149 on WWW-palvelinkoneen IP-osoite. Anna komento pg_ctl reload, jotta muutos otetaan käyttöön. 2.4 Tietokannan alustus Tee Tanjalle käyttäjätunnus sahara komennolla psql <dbinit.sql Anna tietokannan ylläpitosalasana pyydettäessä. Seuraavaksi ladataan kantaan plpsql, jotta PL/PSQL-kielellä tehdyt triggerit toimivat. Anna tietokannan ylläpitosalasana pyydettäessä. createlang plpgsql tanja Varsinaisen Tanjan tietokannan luovat SQL-komennot ovat tiedostossa tanja-init.sql: psql <tanja-init.sql Anna aluksi tietokannan ylläpitosalasana, sitten saharan salasana. Tämän jälkeen tietokanta on käytettävissä. Jos käytössäsi on tietokantadumppi tanja.db, voit halutessasi palauttaa mahdollisen oletustietokannan komennolla psql -U sahara tanja <tanja.db Tämä vaihe ei ole välttämätön. Voit joutua ehkä antamaan em. komennon kaksi kertaa,
koska dumpissa eri taulujen välinen järjestys ei ole eheystarkistusten suhteen oikein. 4