Gå till slutet av bannern
Gå till början av bannern

SKLTP TAK - Installationsmanual

Hoppa till slutet på meta-data
Gå till början av metadata

Du visar en gammal version av den här sidan. Visa nuvarande version.

Jämför med nuvarande Visa sidhistorik

« Föregående Version 17 Nästa »

Förutsättningar

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.

  • 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.
  • Apache Tomcat är installerad. Se http://tomcat.apache.org för nedladdning- och installationsinstruktioner. Teknisk verifiering har dock endast gjorts med Apache Tomcat 7.0.34 (Vissa äldre versioner har testats på Apache Tomcat 6.0.33).
  • MySQL 5.1 eller senare är installerad. Verifiering är gjord med version 5.7. 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

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

MySQL Databas och databasinställningar

SQL och configfiler för senaste versionen går att hitta på Github https://github.com/skltp/tak.

Hämta filerna tp-admin-DDL.sql och context.xml från Github. OBS! Viktigt att välja TAG beroende på vilken version man ska installera.

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

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

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.


  • 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
  • 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 /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"
/>
  • 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.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 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-web-config.properties
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

Fel vid återgivning av makro 'jira' : Det går inte att hitta Jira-servern för detta makro. Detta kan bero på applikationslänkens konfiguration.
)

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

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

Installation av 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 distribution av tak-services
wget http://central.maven.org/maven2/se/skltp/tak/tak-services/<senaste-version>/tak-services-<senaste-version>.war
  • Placera war filen i Tomcat och 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.

  • Inga etiketter