Förutsättningar

Java version 8 är installerat (gäller från version 2.5.0). Tidigare versioner kan köras med Java 7. Senaste version är verifierad med OpenJDK 1.8.0 men tidigare har även Oracle Java SE använts.
Apache Tomcat är installerad. Se http://tomcat.apache.org för nedladdning- och installationsinstruktioner. Senaste version är verifierad med Apache Tomcat 9.0 (vissa äldre versioner har testats på Apache Tomcat 6.0 och 7.0).
MySQL 5.1 eller senare är installerad. Verifiering av senaste TAK är gjord med version 8.0. Se http://www.mysql.com/downloads/mysql/
För notifieringar med e-post krävs även att det finns en extern SMTP-server som kan nyttjas.

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.

Skapa MySQL-databas och anpassa konfiguration

Skapa användare och databas i MySQL med följande kommandon

$ 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;

Använd det nedladdade SQL-scriptet för att skapa tabeller med mera i MySQL-databasen för TAK. Gå till katalogen med scriptet tp-admin-DDL.sql och använd med följande kommandon

$ mysql -u tp_adminuser -p
mysql> use tp_admin;
mysql> source tp-admin-DDL.sql

SQL-Script

tp-admin-DDL.sql hittas alltså i källkoden som laddats ned från GitHub. Det finns även mappar i den katalogen med versionsnummer, dessa används bara vid uppdatering inte vid nyinstallation.

Standardanvändare

För att kunna logga in i TAK första gången används standardanvändare som skapas av SQL-scriptet (se information i script-filen). När man väl har loggat in 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.

Kopiera JDBC-konfigurationsfilen context.xml som hämtades tidigare, till conf-katalogen i Tomcat-installationen.
Uppdatera context.xml med korrekta detaljer för TAKs anslutning till MySQL:
- username - databasanvändare, default "tp_adminuser"
- password - lösenordet för databasanvändaren
- <hostname> - databasserver (default "localhost")
- <databas_namn> - databas (default "tp_admin")

<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"
/>

Installera externa jar-filer

Hämta externa jar filer med scheman, MySQL JDBC drivrutin till Tomcats lib-katalog med följande kommandon

$ cd <tomcat>/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 https://repo1.maven.org/maven2/javax/mail/javax.mail-api/1.5.1/javax.mail-api-1.5.1.jar

Installation av tak-web och 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 war-filerna och placera i Tomcats webapps-katalog.

$ cd <tomcat>/webapps
$ wget -O tak-web.war https://repo.ntjp.se/repository/SKLTP-Releases/se/skltp/tak/tak-web/<senaste-version>/tak-web-<senaste-version>.war
$ wget -O tak-services.war https://repo.ntjp.se/repository/SKLTP-Releases/se/skltp/tak/tak-services/<senaste-version>/tak-services-<senaste-version>.war

Starta Tomcat.

Verifiera installationen enligt nedan.

Valfri ytterligare konfiguration

Filen tak-web-config.properties är frivillig men kan användas för ytterligare konfiguration enligt SKLTP TAK - Konfiguration.

Kopiera filen från /resources/etc/tak-web-config.properties i den tidigare hämtade källkoden. Filen skall placeras i en katalog som anges av variabeln TAK_HOME. Se SKLTP TAK - Konfiguration för detaljer.

För att kunna använda notifieringar med e-post måste även följande steg göras:

Uppdatera context.xml med konfiguration för extern mailserver (SMTP).

<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"
 />

Kontrollera i filen tak-web-config.properties att property tak.alert.on.publicera=true

tak-web-config.properties

tak.alert.on.publicera=true

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.

SKLTP TAK - Installationsmanual