...
...
...
- Förutsättningar
- Migrering från tidigare versioner
- Installationsanvisning vid nyinstallation av senaste officiella releasen
Installera nuvarande officiella version av Tjänsteadresseringskatalogen på Linux
Förutsättningar
...
Innehållsförteckning |
---|
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. Teknisk verifiering har dock endast gjorts med . Senaste version är verifierad med Apache Tomcat 9.0 (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 (upcoming)
- Migrering till 2.4.0
- Migrering till 3.0.0
- Migrering till 3.2.0
Installationsanvisning vid nyinstallation
...
Hitta senaste officiella version och ersätta <senaste-version> i nedanstående skript:er från den här listan http://central.maven.org/maven2/se/skltp/tak/tak-parent/
Senare i instruktionen ska man ladda ned war-filer från http://central.maven.org/maven2/se/skltp/tak/tak-web/ och http://central.maven.org/maven2/se/skltp/tak/tak-services/.
Installationsanvisning för att installare admingui för Tjänsteadresseringskatalogen, i skrivande stund version <senaste-version>. Följ instruktionen stegvis från första punkt till sista.
- Hämta hem källkoden
Gå till https://github.com/skltp/tak. Välj den tag som hör ihop med <senaste-version>. Ladda ned.
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 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_adminuser.* to tp_admin
@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
...
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. |
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
Kodblock |
---|
$ 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
Kodblock |
---|
$ mysql -u tp_adminuser -p
mysql> use tp_admin;
mysql> source tp-admin-DDL.sql
|
Info | ||
---|---|---|
| ||
tp-admin-DDL.sql hittas alltså i källkoden som laddats ned från GitHub. |
...
- Kopiera JDBC konfigurations fil till Tomcat med följande kommado
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 /<tomcat>
/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"
/>
...
Det finns även mappar i den katalogen med versionsnummer, dessa används bara vid uppdatering inte vid nyinstallation. |
Info | ||
---|---|---|
| ||
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.
Kodblock |
---|
$ 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 |
- 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
...
-- 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
);
I senaste versionen av TAK kommer standardanvändarna att skapas när man kör tp-admin-DDL.sql (se SKLTP-942 - TAK - Lägg till standardanvändare då man skapar databasschema CLOSED )
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
Varning |
---|
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.
Kodblock |
---|
$ 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 |
...
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-services
...
$ wget -O tak-services.war https://repo.ntjp.se/repository/SKLTP-Releases/se/skltp/tak/tak-services/<senaste-version>/tak-services-<senaste-version>.war |
Under /www/inera/war/tak/ skapas länkar till den faktiska war filen, flytta tak-services.<senaste-version>.war till /www/inera/war/tak/releases/tak-services.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.
...