Konfiguration av Tak - GUI

TAK 1.3.1 och tidigare

Enligt ärende SKLTP-253 finns det i TAK 1.3.1 och tidigare ingen möjlighet till att överlagra parametrar i en konfigurationsfil. Detta är löst från och med release 1.3.2.

TAK 1.3.2 och senare

...

Varning
Denna sida gäller inte för senaste versionen av TAK

Konfigurationsfil context.xml

Konfigurationsfilen context.xml ska placeras i conf-katalogen i Tomcat-installationen.

Uppdatera context.xml med korrekta detaljer för TAKs anslutning till MySQL:
- username - databasanvändare, default "tp_adminuser"
- password - lösenordet för databasanvändaren
- <hostname> - databasserver (default "localhost")
- <databas_namn> - databas (default "tp_admin")

Kodblock

language	text

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

För att kunna använda notifieringar med e-post måste även följande steg göras:

Uppdatera context.xml med konfiguration för extern mailserver (SMTP). Aktivera även i filen tak-web-config.properties (se längre ner på sidan).

Kodblock

language	text

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

Konfiguration av TAK-web

För att TAK-web ska kunna läsa konfigurationsfil behövs en sökväg till filens hemkatalog sättas upp. Detta görs genom att tilldela en systemvariabel, kallad TAK_HOME, sökvägen till den katalog där konfigurationsfilen ska finnas.

Utöver att TAK_HOME måste vara definierad som måste konfigurationsfilen ha rätt namnsättning (se nedan). Den kan antingen vara en vanlig *.properties fil eller en *.groovy fil:

tp-vagvaltak-admin-web-config.properties
tp-vagval-admintak-web-config.groovy

Om båda filerna finns kommer groovy-filen överlagra eventuella överlappande properties i den första filen.

...

language	text
title	TAK_HOME i specifika miljö

...

Konfiguration applikationsserver

Om För att TAK-GUI applikation web-applikationen ska kunna läsa konfigurationsfilerna måste systemvariabeln TAK_HOME vara uppsatt så att den applikationsserver (Tomcat, JBoss etc.) känner till den. Hur detta görs En uttömmande beskrivning av detta är beroende av det operativsystem och den som 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:

Kodblock

language	bash
title	<Tomcat>/bin/setenv.sh

#!/bin/sh

export TAK_HOME=/etc/tak

Vad kan konfigureras

TAK-GUI:et är utvecklat i ramverket Grails. I det generella fallet beskrivs vad som kan konfigureras bäst i dokumentationen för Grails, den hittar du här.

Konfiguration av annan databas än Mysql

Ett specifikt fall av konfiguration kan dock vara på sin plats att redovisa. Då annan databashanterare än Mysql (standard installation) önskas kan det behövas att man konfigurerar objekt/relationsmappningslagret Hibernate med en specifik databasdialekt. Givetvis räcker det inte att enbart byta databasdialekt för att kunna använda en annan databas. Konfiguration liknande den som görs för Tomcat i context.xml under paragrafen "Installationsanvisning vid nyinstallation av senaste officiella releasen" i SKLTP TAK - Installationsmanual måste också göras.

För att byta databas och dialekt räcker det att ändra i context.xml. Exempel för SQL Server:

<Resource
    name="jdbc/TP"
    auth="Container"
    type="javax.sql.DataSource"
    maxActive="8"
    maxTotal="8"
    maxIdle="10"
    maxWaitMillis="10000"
    username="tp_adminuser"
    password="pwd123"
    driverClassName = "com.microsoft.sqlserver.jdbc.SQLServerDriver"
    url="jdbc:sqlserver://172.20.64.1:60133;databaseName=sql_server_test"
/>

Hibernatedialekt behöver normalt sett inte sättas manuellt, nedanstående gammal information ligger kvar ifall behovet ändå skulle uppstå.

Ett exempel på konfiguration av hibernatedialekt ser ut som följer:

Kodblock

language	text
title	tp-vagval-admintak-web-config.properties

hibernate.dialect=org.hibernate.dialect.HSQLDialect

...

Kodblock

language	groovy
title	tp-vagval-admintak-web-config.groovy

hibernate {
	dialect = "org.hibernate.dialect.HSQLDialect"
}

Möjliga värden för hibernatedialekter hittas här.

Konfiguration av publiceringsnotifieringar

Notifiering via mail skickas vid publicering/rollback av versioner. Aktivera/deaktivera alert ska konfigureras i tak-web-config.properties.

Kodblock

language	groovy
title	tak-web-config.properties

tak.alert.on.publicera=true

Alla andra properties ligger i databas tabel databastabell TAKSettings och kan konfigureras via TAK-web-sida.

TAK 2.3.4 och senare

Från och med version 2.3.4 finns två nya funktioner:

Hantera inläsning av JSON-formatterade TAK-beställningar
Infört stöd i TAK för standardvägval

Förändringen för standardvägval behöver inte konfigureras, utan kan användas direkt.
För att kunna importera JSON-filer, så behövs en konfigurering i två steg, beroende på om man vill "för hand" klistra in innehållet i filen
eller om man vill kunna importera fil-innehållet via filernas ordningsnummer. För att åstadkomma det första alternativet:
(Observera att denna konfigurering krävs även om man genomför steg 2)

1) Lägg till i db-tabell ”TAKSettings” properties

mail.alerter.ny.tjanstekontrakt.toAddress
mail.alerter.ny.tjanstekontrakt.subject
mail.alerter.ny.tjanstekontrakt.text

Det finns ett skript som skapar properties: resources/sql/v2.3.4/skapa-nya-properties.sql

Versionen innehåller 2 ändringar:

Hantera inläsning av JSON-formatterade TAK-beställningar
Inför stöd i TAK för standardvägval

Förändringen för standardvägval behöver inte konfigureras, utan kan användas direkt.
För att kunna importera JSON-filer, så behövs en konfigurering i två steg, beroende på om man vill "för hand" klistra in innehållet i filen
eller om man vill kunna importera fil-innehållet via filernas ordningsnummer. För att åstadkomma det första alternativet:
(Observera att denna konfigurering krävs även om man genomför steg 2)

1) Lägg till i db-tabell ”TAKSettings” properties

mail.alerter.ny.tjanstekontrakt.toAddress
mail.alerter.ny.tjanstekontrakt.subject
mail.alerter.ny.tjanstekontrakt.text

Det finns ett skript som skapar properties: resources/sql/v2.3.4/skapa-nya-properties.sql

Versionen innehåller 2 ändringar:

Hantera inläsning av JSON-formatterade TAK-beställningar
Inför stöd i TAK för standardvägval

Förändringen för standardvägval behöver inte konfigureras, utan kan användas direkt.
För att kunna importera JSON-filer, så behövs en konfigurering i två steg, beroende på om man vill "för hand" klistra in innehållet i filen
eller om man vill kunna importera fil-innehållet via filernas ordningsnummer. För att åstadkomma det första alternativet:
(Observera att denna konfigurering krävs även om man genomför steg 2)

1) Lägg till i db-tabell ”TAKSettings” properties

mail.alerter.ny.tjanstekontrakt.toAddress
mail.alerter.ny.tjanstekontrakt.subject
mail.alerter.ny.tjanstekontrakt.text

Det finns ett skript som skapar properties: resources/sql/v2.3.4/skapa-nya-properties.sql

...

2) För att kunna importera via ordningsnummer

...

möjlighet att hämta JSON-filer med beställningar via deras ordningsnummer.
Då krävs att följande sätts i filen tak-web-config.properties (närmare beskrivning finns här).

Kodblock

language	text
title	tak-web-config.properties

tak.bestallning.url=<url till den site där json-filerna

...

 finns>
tak.bestallning.cert=<namn på certifikatet  som

...

 identifierar användaren>
tak.bestallning.pw=<lösenord till certifikatet ovan>

...


tak.bestallning.serverCert=<namn på certifikatet som

...

 verifierar servern>
tak.bestallning.serverPw=<lösenord till server-certifikatet>

Eventuella fel skrivs ut i web-gränssnittet.

Utöver detta finns möjlighet för TAK-operatörer att ladda upp JSON-filer till ett beställnings-stöd via sh-script.

I mappen resources/bin/jsonScripts/ finns två filer: example.sh och jsonbestallning.sh. Båda filerna innehåller, förutom script,
även detaljerad information hur man ska använda dem. Den första, example.sh, är bara en fil där man kan sätta de variabler
(url, användarnamn, ev filnamn) som man tror kommer att upprepas under proceduren, så man slipper fylla i dem vid ett
direkt anrop till jsonbestallning.sh, som är den fil där anropet görs.
Eventuella fel skrivs ut i kommandofönstret.

...

2) För att kunna importera via ordningsnummer

...

TAK 2.5.1 och senare

Från och med version 2.5.1 finns möjlighet att kontrollera att en beställning avser rätt SKLTP-instans. För att aktivera kontrollen behöver en ny parameter sättas i filen tak-web-config.properties

...

,

...

Eventuella fel skrivs ut i web-gränssnittet.

Utöver detta finns möjlighet för TAK-operatörer att ladda upp JSON-filer till ett beställnings-stöd via sh-script.

I mappen resources/bin/jsonScripts/ finns två filer: example.sh och jsonbestallning.sh. Båda filerna innehåller, förutom script,
även detaljerad information hur man ska använda dem. Den första, example.sh, är bara en fil där man kan sätta de variabler
(url, användarnamn, ev filnamn) som man tror kommer att upprepas under proceduren, så man slipper fylla i dem vid ett
direkt anrop till jsonbestallning.sh, som är den fil där anropet görs.
Eventuella fel skrivs ut i kommandofönstret.

...

2) För att kunna importera via ordningsnummer

...

se exempel nedan.

Kodblock

language	text
title	tak-web-config.properties

...

tak.

...

Eventuella fel skrivs ut i web-gränssnittet.

Utöver detta finns möjlighet för TAK-operatörer att ladda upp JSON-filer till ett beställnings-stöd via sh-script.

...

platform=NTJP-DEV

Jämförda versioner

Gammal version 22

Ny version Aktuell

Nyckel

Konfiguration av Tak - GUI

TAK 1.3.1 och tidigare

TAK 1.3.2 och senare

Konfigurationsfil context.xml

Konfiguration av TAK-web

Konfiguration applikationsserver

Vad kan konfigureras

Konfiguration av annan databas än Mysql

Konfiguration av publiceringsnotifieringar

TAK 2.3.4 och senare

TAK 2.5.1 och senare

Sidjämförelse

Jämförda versioner

Gammal version 22

Ny version Aktuell

Nyckel

Konfiguration av Tak - GUI

TAK 1.3.1 och tidigare

TAK 1.3.2 och senare

Konfigurationsfil context.xml

Konfiguration av TAK-web

Konfiguration applikationsserver

Vad kan konfigureras

Konfiguration av annan databas än Mysql

Konfiguration av publiceringsnotifieringar

TAK 2.3.4 och senare

TAK 2.5.1 och senare