Konfiguration av hemkatalog

För att TAK skall kunna läsa konfiguration och andra filer behöver en hemkatalog definieras. Detta görs genom att tilldela en systemvariabel, kallad TAK_HOME, sökvägen till önskad katalog.

Systemvariabeln TAK_HOME måste vara uppsatt så att applikationsservern (Tomcat, JBoss etc.) känner till den. En uttömmande beskrivning av detta är beroende av det operativsystem och den applikationsserver som används och faller utanför denna dokumentations ramar, då allt för många varianter existerar.

Som exempel är dock vanligt att skapa en script-fil som anropas vid uppstart av Tomcat:

<Tomcat>/bin/setenv.sh

#!/bin/sh

export TAK_HOME=/etc/tak

Konfigurationsfil

TAK-applikationerna (tak-web och tak-services) hämtar konfiguration från filen tak-application.properties i hemkatalogen som definieras av TAK_HOME enligt ovan.

Nedan beskrivs innehållet i filen. Ett komplett exempel att utgå ifrån finns också i källkodspaketet, under katalog /resources/etc.

Obligatoriska inställningar

Konfigurationen måste innehålla databasinställningar samt namn på aktuell plattformsinstans.

TAK levereras med drivrutiner för MySQL, men kan även användas tillsammans med andra databaser, se mer detaljer om detta längre ner på sidan.

Plattforms-namnet används för information i webbgränssnittet samt vid kontroll av beställningar. Namnet skall därför i förekommande fall matcha det som används i TAK-API/Beställningsstödet.

tak-application.properties

# Database settings
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/tp_admin?autoReconnect=true
spring.datasource.username=tpadminuser
spring.datasource.password=tpadminpassword

# Platform instance name (change to a unique name)
tak.platform=SKLTP-DEFAULT

Ändring av logotyp och bakgrundsfärg

För att enklare särskilja miljöer kan logotyp-bild och bakgrundsfärg i sidhuvudet ändras enligt nedan. Bild-filen placeras i katalogen TAK_HOME.

tak-application.properties

# Custom logo and background styling (optional)
tak.image.logo = your-own-logo.png
tak.background = #cccccc;

Beställningshantering

För att hantera beställningar från Beställningsstödet behöver ett antal inställningar läggas till enligt exempel nedan. Certifikat-filerna som anges skall placeras i en katalog "security" under TAK_HOME.

tak-application.properties

# Order handling (optional)
#tak.bestallning.on=true
#tak.bestallning.url=<url to service: https://...>
#tak.bestallning.cert=<client cert filename>
#tak.bestallning.certType=<client cert type, pkcs12 or jks, default is pkcs12>
#tak.bestallning.pw=<password>
#tak.bestallning.serverCert=<truststore filename>
#tak.bestallning.serverCertType=<truststore type, pkcs12 or jks, default is jks>
#tak.bestallning.serverPw=<password for server cert>

Not: De båda parametrarna för certifikat-typ är nya från version 3.2.0. Deras default-värden återspeglar de typer som hade stöd tidigare.

Inställningar för mail alerts

För att få mejl t.ex. vid publicering behöver funktionen aktiveras och konfigureras enligt exemplet nedan. Exakt vilka parametrar som behöver anges beror på mailservern som används, exempelvis kan användarnamn/lösenord utelämnas om autentisering inte krävs.

Inställningar för innehåll och mottagare av dessa mail krävs också men konfigureras inte här, utan via webbgränssnittet (och lagras i databasen).

tak-application.properties

# Mail alterts (optional)
tak.alert.on.publicera=true
spring.mail.host=mailserver.example.com
spring.mail.username=username
spring.mail.password=password
spring.mail.properties.mail.transport.protocol=smtp
spring.mail.properties.mail.smtp.port=25
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

Konfiguration via miljövariabler

Filen tak-application.properties är valfri och det är möjligt att istället förse TAK med konfiguration genom miljövariabler med samma namn som parametrarna i filen. Detta kan vara praktiskt vid container-baserad drift. Exakt hur detta går till beror på driftmiljön, men som ett exempel kan tak-application.properties användas som en "env-file" tillsammans med Docker och Docker Compose.

Annan databas än MySQL

Det är möjligt att använda TAK tillsammans med en annan JDBC-kompatibel databas än MySQL, även om det inte är lika välbeprövat. Nedanstående exempel gäller Microsoft SQL Server.

Hämta drivrutiner, i detta fall paketet mssql-jdbc. Kopiera jar-filen till lib-katalogen i Tomcat.
Uppdatera tak-application.properties enligt vad som gäller för den aktuella databasen, se exemel nedan.
Starta om Tomcat.

spring.datasource.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.datasource.url=jdbc:sqlserver://localhost:1433;databaseName=tp_admin;encrypt=true;trustServerCertificate=true;
spring.datasource.username=tp_adminuser
spring.datasource.password=tp_adminpassword

Webbläsaren stöds inte