SKLTP TAK - Installationsmanual

Owned by Göran Erkstam (Unlicensed)
Last updated: okt. 09, 2023 by Björn Pettersson
3 min read

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.