TODO: Namn på konfigurationsfiler har bytts i senare versioner. Detta behöver uppdateras.
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
För att TAK Gui:et 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-vagval-admin-web-config.properties
- tp-vagval-admin-web-config.groovy
Om båda filerna finns kommer groovy-filen överlagra eventuella överlappande properties i den första filen.
$ printenv | grep 'TAK_HOME'
Konfiguration applikationsserver
Om TAK-GUI applikation 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 ä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.
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.
Ett exempel på konfiguration av hibernatedialekt ser ut som följer:
hibernate.dialect=org.hibernate.dialect.HSQLDialect
Eller om groovy-filen används:
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.
tak.alert.on.publicera=true
Alla andra properties ligger i databas tabel TAKSettings och kan konfigureras via 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
När du använder TAK kan du ändra värdet på ovanstående properties på sidan 'Administrera TAK-inställningar' i användargränssnittet.
2) För att kunna importera via ordningsnummer
För TAK ska kunna ladda ner json-filer från beställning-stödet krävs det 2 certifikat. Ett för att identifiera användaren, samt ett för att verifiera servern.
Det första i formatet .p12 och det andra som en .jks-fil. När certifikaten finns tillgängliga, kontrollera om miljö-variabeln TAK_HOME är satt.
Om inte, så skapa en valfri mapp och peka ut den med variabeln, t.ex. C:\Temp\tak.
I denna mapp lägger man filen tak-web-config.properties, som man kan kopiera från resources/etc/ i installationen.
I denna fil ska nedanstående properties sättas. Certifikaten lägger man i en mapp "security" inne i TAK_HOME-mappen.
tak.bestallning.url=<url till den site där json-filerna finns, t.ex. https://bestallningsstod.tjansteplattform.se:443/bs-api/api/takOrders/ >
tak.bestallning.cert=<namn på certifikatet som identifierar användaren, t.ex. keystore_kentor_siths_test.p12
tak.bestallning.pw=<lösenord till certifikatet ovan>
tak.bestallning.serverCert=<namn på certifikatet som verifierar servern, t.ex truststore_p12_bs.jks >
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.