...

Förutsättningar

• Rätt version av

...

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.

  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. Teknisk verifiering har dock endast gjorts  Senaste version är verifierad med Apache Tomcat 79.0 .34 (Vissa vissa äldre versioner har testats på Apache Tomcat 6.0 och 7.330).
• 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:

• Migrering till 1.3.2
• Migrering till 1.4.0
• Migrering till 2.0
• Migrering till 2.3.1
• Migrering till 2.4.0
• Migrering till 3.0.0
• Migrering till 3.2.0

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.

Info
Information om senaste release går att finna här Release information.

MySQL Databas och databasinställningar

...

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

...

• https://github.com/skltp/tak/blob/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

• https://github.com/skltp/tak/blob//resources/sql/tp-admin-DDL.sql

Det går också välja den tag som hör ihop med <senaste-version> och ladda hem hela källkoden och hämta filerna därifrån.

• Skapa användare i MySQL databasen med följande kommando

...

•  (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'<ett lösenord>’lösenord>';
mysql> grant all privileges on tp_admin.* to  tp_adminuser@localhost;
mysql> flush privileges;
mysql> exit;

•  Skapa tabeller Använd det nedladdade SQL-scriptet för att skapa tabeller med mera i MySQL-databasen för TAK med följande kommando

• . Gå till katalogen med scriptet tp-admin-DDL.sql och använd med följande kommandon

$ mysql -u tp_adminuser -p
mysql> use <databas-namn>tp_admin;
mysql> source tak-parent-<senaste-version>/resources/sql/tp-admin-DDL.sql

• 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

...

...

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

...

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:

• SKLTP TAK - Konfiguration - före version 3.0
• SKLTP TAK - Konfiguration - version 3.0 och senare

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 /local/java/tomcat/7.0.34/<tomcat>/lib/
$ sudo wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.2745/mysql-connector-java-5.1.2745.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 httphttps://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 och tak-services

• Ladda ner

...

$ wget http://central.maven.org/maven2/se/skltp/tak/tak-web/<senaste-version>/tak-web-<senaste-version>.war

Under /www/inera/war/tak/ skapas länkar till den faktiska war filen, flytta tak-web.2.0.war till /www/inera/war/tak/releases/tak-web.war

Driftsätta tak-services

• Ladda ner distribution av tak-web

...

• 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

• Placera war filen i Tomcat och starta Tomcat.

Driftsätta tak-services

• Ladda ner distribution av tak-services

wget http://central.maven.org/maven2
$ wget -O tak-services.war https://repo.ntjp.se/repository/SKLTP-Releases/se/skltp/tak/tak-services/<senaste-version>/tak-services-<senaste-version>.war

• Placera war filen i Tomcat och starta 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.

...