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.
<Resource name=”jdbc/TP”
auth=”Container”
type=”javax.sql.DataSource”
maxActive=”10”
maxIdle=”10”
maxWait=”10000”
username=”tpadminuser”
password=”tpadminpassword”
driverClassName=”com.mysql.jdbc.Driver”
url=”jdbc:mysql://localhost:3306/tp_admin?autoReconnect=true”
/>
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:
<?xml version=”1.0” encoding=”UTF-8” ?>
<wsdl:definitions name=”SokVagvalsServiceSoap11LitDocService”
targetNamespace=”urn:skl:tp:vagvalsinfo:v1”
