Förutsättningar
- Java 7 är installerat (Vissa äldre versioner kan köras med java 1.6). Se http://www.oracle.com/technetwork/java/javase/index-137561.html för nedladdning- och installationsanvisningar. Teknisk verifiering på senaste versionen har dock endast gjorts med Java 7 (Java SE 6 Update 37 har använts i vissa äldre versioner). TAK är ej validerad för Java 8.
- Apache Tomcat är installerad. Se http://tomcat.apache.org för nedladdning- och installationsinstruktioner. Teknisk verifiering har dock endast gjorts med Apache Tomcat 7.0.34 (Vissa äldre versioner har testats på Apache Tomcat 6.0.33).
- MySQL 5.1 eller senare är installerad. Verifiering är gjord med version 5.7. Se http://www.mysql.com/downloads/mysql/
Migrering från tidigare versioner
Om en installation redan finns behöver en migrering göras. Det beskrivs i följande dokument:
Installationsanvisning vid nyinstallation
Denna manual beskriver installation av senaste versionen av Tjänsteadresseringskatalogen (TAK). Kommandon som listas förutsätter en Linux-installation men motsvarande steg kan utföras även i Windows.
Information om senaste release går att finna här Release information.
Hämta databas-script och konfigurationsfil
SQL-script för att skapa databas och konfigurationsfil för Tomcat finns lagrade med källkoden och behöver hämtas därifrån.
- Gå till https://github.com/skltp/tak/releases
- Ladda ner paketet (zip eller tar.gz) som hör till den version som skall installeras. OBS! Viktigt att ta rätt version!
- Packa upp och säkerställ att du fått med följande filer:
/resources/tomcat-conf/context.xml
/resources/sql/tp-admin-DDL.sql
I tidiga versioner av TAK fanns en särskild distribution som innehöll sql-skript för att generera databas och databasförändringar. I senare versioner är denna borttagen och skripten tas direkt från GitHub enligt ovan.
MySQL Databas och databasinställningar
- Skapa användare i MySQL databasen med följande kommando
mysql –u root –p mysql> create database tp_admin character set utf8; mysql> grant usage on tp_admin.* to tp_adminuser@localhost identified by '<ett lösenord>'; mysql> grant all privileges on tp_admin.* to tp_adminuser@localhost; mysql> flush privileges; mysql> exit;
- Skapa tabeller i MySQL databasen för TAK med följande kommando
- Noterat att i version TAK 1.4.0 och tidigare används type=INNODB, från och med version 5.1.0 av MySQL skall istället engine=INNODB användas. Felet är åtgärdat i TAK 1.4.1-SNAPSHOT.
- Version 2.0 har major ändringar.
$ mysql -u tp_adminuser -p mysql> use <databas-namn>; mysql> source tak-parent-<senaste-version>/resources/sql/tp-admin-DDL.sql
SQL-Script
- Kopiera JDBC konfigurations fil till Tomcat med följande kommando
Obs: Ändra databas namn i context.xml fil
sudo cp tak-parent-<senaste>/tomcat-conf/context.xml /etc/tomcat/tak/conf/context.xml
- Uppdatera tomcats JDBC konfiguration med korrekt användarnamn och lösenordet för TAKs anslutning till MySQL
username="tp_adminuser" och password="<lösenord>", lösenordet på databasanvändaren tp_adminuser
sudo vi /usr/local/apache-tomcat-7.0.34/conf/context.xml <Resource name="jdbc/TP" auth="Container" type="javax.sql.DataSource" maxActive="10" maxIdle="10" maxWait="10000" username="tp_adminuser" password="<lösenord>" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://<hostname>:3306/<databas_namn>?autoReconnect=true" />
- Kopiera externa jar filer med scheman, MySQL JDBC drivrutin till Tomcats lib katalog med följande kommando
$ cd /local/java/tomcat/7.0.34/lib/ $ sudo wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.45/mysql-connector-java-5.1.45.jar $ sudo wget https://repo1.maven.org/maven2/javax/activation/activation/1.1/activation-1.1.jar $ sudo wget https://repo1.maven.org/maven2/com/sun/mail/javax.mail/1.5.1/javax.mail-1.5.1.jar $ sudo wget http://repo1.maven.org/maven2/javax/mail/javax.mail-api/1.5.1/javax.mail-api-1.5.1.jar
- Uppdatera tomcats SMTP konfiguration med korrekta inställningar.
sudo vi /<tomcat>/conf/context.xml <Resource name="mailSession" auth="Container" type="javax.mail.Session" mail.debug="false" mail.hostname="smtp.host.name" mail.smtp.user="user@server.com" password="password" mail.transport.protocol="smtp" mail.smtp.host="smtp.host.name" mail.smtp.auth="false" mail.smtp.starttls.enable="true" mail.smtp.EnableSSL.enable="true" mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory" mail.smtp.socketFactory.fallback="false" mail.smtp.port="465" mail.smtp.socketFactory.port="465" />
- Uppdatera tak-web-config.properties. Lägga till property 'tak.alert.on.publicera=true'
tak.alert.on.publicera=true
Standardanvändare i tak (endast äldre versioner)
För att kunna logga in i tak behöver man lägga till en standardanvändare
I senaste versionen av TAK kommer standardanvändarna att skapas när man kör tp-admin-DDL.sql (se
-- user=admin password=skltp -- user=skltp password=skltp INSERT INTO `Anvandare` (`id`, `anvandarnamn`, `losenord_hash`, `administrator`, `version`) VALUES (1, 'admin', '3e1a694fd3a41e113dfbd4bf108cdee44206d1b1', 1, 0), (2, 'skltp', '3e1a694fd3a41e113dfbd4bf108cdee44206d1b1', 0, 0);
När man väl har loggat i tak-web kan man ändra/ta bort standardanvändarna och lägga till nya via menyvalet "Administrera användare av tjänstekatalogen". Viktigt är att minst en användare har admin-behörigheter.
Installation av tak-web
Se till att stänga ned tomcatinstansen innan nedanstående steg görs. Detta för att undvika att tomcatprocessen hänger sig vid installationen.
- Ladda ner distribution av tak-web
$ wget http://central.maven.org/maven2/se/skltp/tak/tak-web/<senaste-version>/tak-web-<senaste-version>.war
- Placera war filen i Tomcat och starta Tomcat.
Installation av tak-services
Se till att stänga ned tomcatinstansen innan nedanstående steg görs. Detta för att undvika att tomcatprocessen hänger sig vid installationen.
- Ladda ner distribution av tak-services
wget http://central.maven.org/maven2/se/skltp/tak/tak-services/<senaste-version>/tak-services-<senaste-version>.war
- Placera war filen i Tomcat och starta Tomcat.
Verifiera installationen enligt nedan.
Verifiera installationen
Gå till http://<miljö>:8080/tak-web/ och se att inloggningsfönster för Tjänsteadresseringskatalogens admingui kommer upp.
Gå till http://localhost:8080/tak-services och se att de tjänster som exponeras av Tjänsteadresseringskatalogen kommer upp.
Reset cache på TAK publicerad version
http://<miljö>/tak-services/reset/pv
Gör en reset cache i SKLTP VP för att säkerställa att anropsbehörigheter och routinginformation hämtas korrekt från Tjänsteadresseringskatalogen, http://localhost:23000/resetcache. Värdet att titta på här är "Succesfully saved virtualizations and permissions to local TAK copy: /home/mule/.tk.devtest.localCache" som indikerar att uppdateringen av den lokala TAK cachen har gått bra.