Asennusohje Kotka-järjestelmälle versio 1.0 Hannu Pekkanen 4.6.2001 Kotka-järjestelmä on WWW-pohjainen kurssikirjanpitojärjestelmä, joka on toteutettu Jyväskylän Yliopiston tietotekniikanlaitokselle tietotekniikan cum laude -työprojektina syksyllä 2000 ja keväällä 2001. Järjestelmän tarkoituksena on yhdenmukaistaa kaitoksella käytetyt kurssikirjanpitojärjestelmät ja laajentaa niiden käytettävyys verkkoon. Kotka-järjestelmä on suunniteltu toimivaksi Linux-käyttöjärjestelmässä. Tämän lisäksi tarvittavia sovellusohjelmistoja ovat Apache, Java, Tomcat, Poolman ja Postgresql. Apache toimii http-palvelimena, johon asiakkaat ottavat yhteyttä. Tomcat kääntää tarvittavat tiedot oikeaan formaattiin, jota selaimet pystyvät hyödyntämään. Javaa käytetään sovelluksen tukena java-papujen muodossa. Poolman välittää tietokantahaut Postgresql tietokannanhallintajärjestelmälle, joka puolestaan ylläpitää sovelluksen tarvitseman tietokannan. HTTP-PALVELIMEN ASENNUS Lisätietoja asennuksesta löytyy URL-osoitteesta Http://httpd.apache.org/docs/install.html 1. Hae Apache osoitteesta http://httpd.apache.org/dist/ 2. Pura paketti johonkin hakemistoon komennolla gunzip apache_1.3.17.tar.gz; tar -xvf apache_1.3.17.tar 3. Apache täytyy konfiguroida DSO-moodiin, jotta mod_jk:ta pystytään hyödyntämään. Tämä tapahtuu seuraavilla komennoilla: cd ./configure \ --prefix=/usr/local/apache \ --enable-rule=SHARED_CORE \ --enable-module=so make 4. Asenna Apache komennolla make install 5. Muuta tiedostoa /usr/local/apache/conf/httpd.conf siten, että apache kuuntelee porttia 80. Tämä tapahtuu muuttamalla kohtaa "Port 8080", siten että kohtaan jää "Port 80". Muuta tietostoa myös siten, että Apache käynnistetään käyttäjänä nobody. Tämä tapahtuu muuttamalla kohtia "User root" ja "Group root", siten että tiedostoon jää arvot "User nobody" ja "Group nobody". 6. Tarkista Apachen toimivuus käynnistämällä Apache komennolla /usr/local/apache/bin/httpd -f /usr/local/apache/conf/httpd.conf Tarkista toimivuus selaimella ottamalla yhteys palvelimeen, johon asennusta ollaan suorittamassa. esim. osoitteeseen Http://ranchi.it.jyu.fi. JAVAN ASENNUS Lisätietoja asennuksesta löytyy URL-osoitteesta Http://java.sun.com/j2se/1.3/install-linux-sdk.html 1. Hae Java osoitteesta http://java.sun.com/j2se/1.3/download-linux.html 2. Aseta Java-paketille ajo-oikeudet komennolla chmod a+x j2sdk-1_3_0-linux-rpm.bin 3. Asenna paketti komennolla ./j2sdk-1_3_0-linux-rpm.bin su - -c " rpm -iv //j2sdk-1_3_0-linux.rpm" TOMCATIN ASENNUS Lisätietoja asennuksesta löytyy URL-osoitteesta Http://jakarta.apache.org/tomcat/jakarta-tomcat/src/doc/uguide/tomcat_ug.html 1. Hae Tomcatin build-paketti URL-osoitteesta http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.2.1/bin/ ja Tomcatin source-paketti osoitteesta Http://jakarta.apache.org/builds/tomcat/release/v3.2.1/src/ 2. Määrittele Tomcatin kotihakemisto komennolla TOMCAT_HOME=/usr/local/tomcat ; export TOMCAT_HOME Javan kotihakemisto komennolla JAVA_HOME=/usr/java/jdk1.3; export JAVA_HOME sekä lisäksi Java-kääntäjän hakemistopolku komennolla PATH=$PATH:/usr/java/jdk1.3; export PATH 3. Pura Tomcatin build-paketti komennolla gunzip jakarta-tomcat-3.2.1.tar.gz; tar -xvf jakarta-tomcat-3.2.1.tar 4. Siirrä paketti hakemistoon /usr/local/tomcat komennolla mv jakarta-tomcat-3.2.1 /usr/local/tomcat 5. Luo ryhmä- ja käyttäjätunnus tomcat komennoilla groupadd -g tomcat useradd -d /usr/local/tomcat -g tomcat -s /bin/bash -u tomcat 6. Muuta kaikki tiedostot tomcat-käyttäjän omistukseen komennolla chown -R tomcat:root /usr/local/tomcat 7. Pura Tomcatin "source"-paketti kohdan 3 tapaan. 8. Mene hakemistoon jakarta-tomcat-3.2.1-src/src/native/apache1.3. 9. Käännä mod_jk moduli Apachen käyttöön komennoilla /usr/local/apache/bin/apxs -o mod_jk.so -I../jk -I/usr/java/jdk1.3/include -I/usr/java/jdk1.3/include/linux -c *.c ../jk/*.c cp mod_jk.so /usr/local/apache/libexec POOLMANIN ASENNUS Lisätietoja asennuksesta löytyy URL-osoitteesta Http://sourceforge.net/projects/poolman/ 1. Hae Poolman 1.4.1 osoitteesta http://sourceforge.net/projects/poolman/ 2. Pura Poolmanin paketti, ja siirrä se hakemistoon /usr/local/ komennolla mv PoolMan-1.4.1/ /usr/local chown -R root:root /usr/local/PoolMan-1.4.1/ POSTGRESQL:n ASENNUS Lisätietoja asennuksesta URL-osoitteesta Http://postgresql.rmplc.co.uk/users-lounge/docs/7.0/admin/install855.htm. 1. Hae Postgresql osoitteesta Ftp://ftp.postgresql.org/pub/v7.0.3/postgresql-7.0.3.tar.gz 2. Luo postgres-käyttäjä samalla tavalla kuin tomcat-käyttäjä luvussa TOMCATIN ASENNUS kohdassa 5. 3. Mene hakemistoon postgresql-7.0.3/src. 4. Konfiguroi postgresql komennoilla ./configure --prefix=/usr/local/pgsql gmake gmake install chown -R postgres:root /usr/local/pgsql mkdir /usr/local/pgsql/data chown postgres /usr/local/pgsql/data su - postgres /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data 5. Alustetaan tietokanta. Mene postgres-käyttäjäksi komennolla su - postgres Käynnistä hallintaohjelmisto komennolla postmaster -i -D /usr/local/pgsql/data Luo kantaan käyttäjä kotka komennolla createuser kotka Luo tietokanta kotka komennolla createdb kotka Kirjottaudu sisään tietokantaan komennolla psql -U kotka Vaihda käyttäjälle salasana komennolla ALTER USER kotka WITH PASSWORD "" Luo kantaan taulut komennolla \i /sql_korppi.txt Laita kantaan testiaineisto komennolla \i /insert_korppi.txt Poistu hallintajärjestelmästä komennolla \q JÄRJESTELMÄN KONFIGUROINTI Järjestelmä täytyy konfiguroida seuraavalla tavalla, ennenkuin sitä voidaan käyttää. 1. Muokataan tiedostoon /etc/bashrc seuraavat tiedot: LD_LIBRARY_PATH=/usr/local/pgsql/lib TOMCAT_HOME=/usr/local/tomcat JAVA_HOME=/usr/java/jdk1.3 CLASSPATH=/usr/java/jdk1.3/lib:/usr/lib/pgsql/jdbc7.0-1.1.jar: /usr/local/PoolMan-1.4/lib/PoolMan.jar: /usr/local/PoolMan-1.4/lib/jdbc2_0-stdext.jar: /usr/local/PoolMan-1.4/lib export PATH LD_LIBRARY_PATH TOMCAT_HOME JAVA_HOME CLASSPATH 2. Editoidaan tiedostoon /usr/local/tomcat/conf/server.xml seuraavat tiedot: 3. Editoi tiedostoon /usr/local/apache/conf/httpd.conf seuraavat tiedot: LoadModule jk_module libexec/mod_jk.so Addmodule mod_jk.c Include /usr/local/tomcat/conf/mod_jk.conf-auto DirectoryIndex index.jsp DocumentRoot "/home/httpd/html/" 4. Editoi tiedostoa /usr/local/pgsql/data/pg_hba.conf seuraavasti: host all 130.234.167.177 255.255.255.255 trustlocal all trust (antaa oikeuden 130.234.167.177 koneelle oikeuden päästää sisään palvelimen tarjoamiin palveluihin.) host all 127.0.0.1 255.255.255.255 trust (antaa localhostille oikeuden oikeuden päästää sisään palvelimen tarjoamiin palveluihin.) host kotka 130.234.167.177 255.255.255.255 trust (antaa oikeuden 130.234.167.177 koneelle oikeuden päästää sisään Kotka- järjestelmän palveluihin. 5. Editoi tiedostoa /usr/local/PoolMan-1.4/lib/poolman.props siten, että tiedosto sisältää seuraavat tiedot: db_name.1=postgres db_driver.1=org.postgresql.Driver db_url.1=jdbc:postgresql://ranchi.it.jyu.fi/kotka db_username.1=kotka db_password.1= initialConnections.1=5 enableCache.1=true cacheSize.1=5 cacheRefresh.1=300000 connection_timeout.1=15000 checkfrequency.1=30000 usertimeout.1=10000 maximumsize.1=20 Muut tiedot ko. tiedostosta voi poistaa 6. Luo hakemisto /home/httpd/html/kotka ja kopio sinne sivusto CD-levyltä hakemistosta /mnt/cdrom/src/korppi. JÄRJESTELMÄN KÄYNNISTYS 1. Käynnistetään Postgresql komennolla su - postgres -c "/usr/local/pgsql/bin/postmaster -i -D /usr/local/pgsql/data &" 2. Käynnistetään Tomcat. su - tomcat -c /usr/local/tomcat/bin/startup.sh 3. Käynnistetään Apache. su - root -c "/usr/local/apache/bin/httpd -f /usr/local/apache/conf/httpd.conf" LISÄTIETOJA Lisätietoja järjestelmän asennuksesta voi tiedustella sähköpostiosoitteesta korppi@mit.jyu.fi.