Asennusohje. Sahara-ryhmä. Helsinki Ohjelmistotuotantoprojekti HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

Transkriptio

1 Asennusohje Sahara-ryhmä Helsinki Ohjelmistotuotantoprojekti HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

2 Kurssi Ohjelmistotuotantoprojekti (6 ov) Projektiryhmä Sanna Keskioja Sampo Lehtinen Hanna Liedenpohja Seppo Syrjänen Asiakas Joni Salmi Johtoryhmä Juha Taina Kimmo Simola Kotisivu Versiohistoria Versio Päiväys Tehdyt muutokset Ensimmäinen versio: pohja ja tietokanta./ss

3 Sisältö i 1 Johdanto 1 2 Tietokannan asentaminen PostgreSQL:n käyttöönotto asennusscriptillä PostgreSQL:n käyttöönotto käsin pg_hba.conf Tietokannan alustus

4 1 Johdanto 1 Tämä dokumentti antaa ohjeet Tanja-järjestelmän asentamiseen Apache/PHP/PostgreSQLympäristöön.

5 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

6 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 and listening port 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 password missä 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,

7 koska dumpissa eri taulujen välinen järjestys ei ole eheystarkistusten suhteen oikein. 4