Installera nuvarande officiella version av Tjänsteadresseringskatalogen på Linux

Installera nuvarande officiella version av Tjänsteadresseringskatalogen på Linux

Förutsättningar

Java 1.6 eller Java 7 är installerat. Se http://www.oracle.com/technetwork/java/javase/index-137561.html för nedladdning- och installationsanvisningar. Teknisk verifiering har dock endast gjorts med Java SE 6 Update 37 samt Java 7. TAK är ej validerad för Java 8.
Apache Tomcat är installerad. Se http://tomcat.apache.org för nedladdning- och installationsinstruktioner. Teknisk verifiering har dock endast gjorts med Apache Tomcat 6.0.33.
MySQL 5.1 är installerad. Se http://www.mysql.com/downloads/mysql/

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 av senaste officiella releasen

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_admin.* to tp_adminuser@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

Not: 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.

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

Kopiera externa jar filer med scheman, MySQL JDBC drivrutin till Tomcats lib katalog med följande kommando

$ cd /local/java/tomcat/7.0.34/lib/

$ sudo wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.27/mysql-connector-java-5.1.27.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 http://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

För att kunna logga in i tak behöver man lägga till en standardanvändareStandardanvändare i tak

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

Driftsätta tak-web

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 distribution av tak-web

$ 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

cd /www/inera/war/tak/
sudo ln -sf ../../releases/tak-web.war tak-web.war

Driftsätta tak-services

Ladda ner distribution av tak-services

wget http://central.maven.org/maven2/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

cd /www/inera/war/tak/
sudo ln -sf ../../releases/tak-services.war tak-services.war

#sudo service tomcat status
sudo service tomcat start tak

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.

release 2.3.1 (upcoming)