Förutsättningar

Rätt version av Java version är installerat. Från TAK 3.2.0 gäller Java 11 (TAK 2.5.0-3.1.x kräver Java 8, äldre versioner kräver Java 7).
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/sql/tp-admin-DDL.sql
/resources/tomcat-conf/context.xml (endast versioner före 3.0)
/resources/etc/tak-web.properties (endast versioner före 3.0)
/resources/etc/tak-application.properties (endast versioner från 3.0)

Skapa MySQL-databas

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.

Anpassa konfiguration

Använd konfigurationsfil(er) som hämtades i ett tidigare steg som utgångspunkt för konfiguration. Notera att det är andra filer som används från TAK version 3.0 jämfört med tidigare.

Se följande sidor för detaljer:

Installera externa jar-filer (endast versioner före 3.0)

Hämta externa jar filer med scheman, MySQL JDBC drivrutin till Tomcats lib-katalog med följande kommandon. Behöver inte göras från version 3.0 av TAK.

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

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.

Öppen info: SKLTP

SKLTP TAK - Installationsmanual