Installation av databas

Installation av tjänstekatalog Revisionshistorik Innehållsförteckning

Inledning Denna anvisning vänder sig till den som skall driftsätta Tjänstekatalogen. Anvisningen innehåller instruktioner för hur man praktiskt driftsätter denna på Apache Tomcat. Anvisningen är uppdelad i tre stycken huvuddelar: 1. Installation av Tjänstekatalogens komponenter 2. Konfigurering av Tjänstekatalogens komponenter 3. Verifiering av installationen Tjänstekatalogen kan installeras i valfri JEE web-container och valfri databas med stöd för ANSI-SQL och JEE-kompatibel JDBC-drivrutin. Denna anvisning beskriver hur man driftsätter på Apache Tomcat och MySQL.

Installation Tjänstekatalogens upppackningsplats benämns i denna anvisning som ${DIST} och Apache Tomcats uppakcningsplats som ${TOMCAT_HOME}. Tjänstekatalogen kommer hädanefter att benämnas som TK.

Förutsättningar Nedanstående förutsättningar gäller för installation på Apache Tomcat och MySQL. 

  

Java 1.6 eller senare är installerat. Se http://www.oracle.com/technetwork/java/javase/index-137561.html för nedladdning- och installationsanvisningar. Teknisk verifiering har dock endast gjorts med Java SE 6 Update 27. Apache Tomcat är installerad. Se http://tomcat.apache.org för nedladdning- och installationsinstruktioner. Teknisk verifiering har dock endast gjorts med Apache Tomcat 6.0.33. MySQL 5.1 är installerad. Se http://www.mysql.com/downloads/mysql/ för nedladdning- och installationsinstruktioner. Tjänstekatalogens distributionsfil är nedladdad och uppackad på filsystemet. Distributionen finns att ladda ner på följande adress: http://forge.osor.eu/frs/?group_id=126

Konfigurera driftmiljö Innan själva installationen av tjänstekatalogen kan påbörjas, behöver man konfigurera miljön som skall köra plattformen. Filen ${DIST}/TK_ENVIRONMENT innehåller de miljövariabler som behöver vara på plats för att kunna installera och starta tjänstekatalogen.

Installation av databas Tjänstekatalogen lagrar information om tjänstekonsumenter, tjänsteproducenter, anropsbehörigheter etc. i en MySQL-databas. Innan man kan börja använda tjänstekatalogens webbtjänster och administrationsapplikation behöver man installera denna databas. Installera databasen genom att genomföra följande steg: mysql –u root –p create database tp_admin character set utf8; grant usage on tp_admin.* to tpadminuser@localhost identified by ’tpadminpassword’; grant all privileges on tp_admin.* to tpadmin@localhost; flush privileges; exit

Nu ska det finnas en loggdatabas för att tjänstekatalogens information. Ett databasschema måste dock skapas. Gör det här genom följande kommando: mysql –u tpadminuser–p –database=tp_admin < ${DIST}/sql/tp_admin_DDL.sql

Databasen är nu färdigkonfigurerad.

Installation av Tjänstekatalogens komponenter Administrationsapplikationen och webbtjänsten är paketerade i varsin fil. Dessa filer är tp-vagval-admin-services-1.3.0.war och tp-vagval-admin-web-1.3.0.war och finns tillgängliga i ${DIST}/webapps. När man driftsätter en applikation på Apache Tomcat utan anpassning får applikationen en URL som delvis består av war-filens namn. Skulle man vilja ha ett annat namn måste man manuellt byta namn på filen till det namn vill ha. Filändelsen måste dock vara det samma. Även JDBC-drivrutinen måste kopieras in till Apache Tomcat. För att installera dessa komponenter följ nedanstående instruktioner: 1. Kopiera Tjänstekatalogens webbtjänster till Apache Tomcats webapps katalog. cp –rf ${DIST}/webapps/tp- vagval-admin-services-1.3.0.war ${TOMCAT_HOME}/webapps/

2. Kopiera Tjänstekatalogens administrationsapplikation till Apache Tomcats webapps katalog. cp –rf ${DIST}/webapps/tp-vagval-admin-web-1.3.0.war ${TOMCAT_HOME}/webapps/

3. Kopiera MySQL’s JDBC-drivrutin genom att kopiera den till Apache Tomcats lib-katalog. cp –rf ${DIST}/lib/mysql-connector-java-5.1.3 ${TOMCAT_HOME}/lib/

Konfiguration av Apache Tomcat Det som behövs konfigureras i Apache Tomcat är en datakälla för att kunna kommunicera med MySQL-databasen. I tjänstekatalogens distribution finns filen ${DIST}/tomcat-conf/Context.xml förkonfigurerad. Denna fil kan användas rakt av om ingen annan extern konfiguration har gjorts av Apache Tomcat. Om denna filen ej används behöver man lägga till följande information i ${TOMCAT_HOME}/conf/Context.xml.

Installationen och konfiguration av tjänstekatalogen är nu klar. Nästa steg är att verifiera installationen för att se att allt fungerar som det är tänkt.

Verifiering Denna sektion innehåller ett par enkla steg för verifiering av tjänstekatalogen. Notera att om man har installerat tjänstekatalogen på en annan maskin än den man utför verifiering på måste man byta ut localhost mot ip-adressen där tjänstekatalogen har installerats. För att förenkla uppstart och nedstängning av tjänstekatalogen medkommer script för dessa aktioner. Dessa finns tillgängligs i ${DIST}/bin. Kopiera dessa till lämpligt ställe cp ${DIST}/bin/*.sh ~/bin

Viss modifikation till dessa script kan vara nödvändig att göra. Det som behöver göras är att ange sökvägen till Mule ESB och ActiveMQ. Modifiera start.sh och stop.sh enligt följande: start.sh #!/bin/bash

echo -n "Starting Apache Tomcat 6.0.33..." cd ${TOMCAT_HOME}/bin ./startup.sh &>/dev/null if [ $? == 0 ]; then echo " done." fi exit 0

stop.sh #!/bin/bash echo -n "Stopping Apache Tomcat 6.0.33..." cd ${TOMCAT_HOME}/bin ./shutdown &>/dev/null if [ $? == 0 ]; then echo "done." fi exit 0

När scripten är uppdaterade med rätt sökvägar är det dags att starta upp Apache Tomcat med TK installerad. Det här görs genom att använda de nyss modifierade start-scriptet start.sh. sh start.sh && tail –f ${TOMCAT_HOME}/logs/catalina.out

När Apache Tomcat är startad kan verifiering nu påbörjas. Verifiera installationen genom följande steg: 1. Se till att Apache Tomcat och MySQL är startad. 2. Öppna följande länk i en webbläsare: http://localhost:8080/tp-vagvaladmin-web-1.3.0/ 3. Verifiera att inloggningssidan till administrationsapplikationen visas. 4. Öppna följande länk i en webbläsare: http://localhost:8080/tp-vagvaladmin-services-1.3.0/SokVagvalsInfo?wsdl 5. Verfiera att webbtjänsten svarar med XML. Leta efter följande information i den XML som webbläsaren visar: