Konfiguration av Virtualiseringsplattformen

VP 2.2.1 och senare

Från och med version 2.2.1 överlagras defaultinställningar genom att på applikationens classpath skapa 2 filer, För att överlagra defaultinställningar behöver en fil med namnet vp-config-override.properties och vp-security-override.properties. I dessa 2 filer definierar man endast de parametrar som skall skilja sig från de defaultinställningar som finns definierade i applikationen. I den mule-paketerade applikationen (vp-services-[version].zip) finns defaultinställningar definierade under <zip>/classes/vp-config.properties, respektive <zip>/classes/vp-security.properties.

Parametrar i vp-config.properties

Parameter = Unikt namn på konfigurations parameter.

Default värde = Värdet på parametern, så som det är konfigurerat i den paketerade VP applikationen. Kan överlagras med egna värden vid behov, se version av VP ovan för mer info om överlagring av parametrar.

Kommentar = Förklaring/hjälp för en parameter.

Applikationsinställningar

Generella inställningar för VP, som inte faller in under något specifikt område

Dashboard för enkel statistik på tillgängliga tjänster

Monitorera om VP är operativ

VP exponerar en tjänst som kan användas för att avgöra om tjänsten VP är operativ, dvs att alla nödvändiga resurser som VP behöver finns tillgängliga och fungerar.

Notera att denna tjänst inte skall blandas ihop med virtuella tjänsten Ping eller PingForConfiguration.

VP exponerar även tjänsten PingForConfiguration, definierad i RIV TA.

http://${TP_HOST}:${PINGFORCONFIGURATIONSERVICE_RIVTABP20_PORT}/${TP_BASE_URI}/${PINGFORCONFIGURATIONSERVICE_RIVTABP20_INBOUND_URI} 

http://${TP_HOST}:${PINGFORCONFIGURATIONSERVICE_RIVTABP21_PORT}/${TP_BASE_URI}/${PINGFORCONFIGURATIONSERVICE_RIVTABP21_INBOUND_URI}

Hantering av VP's lokala cache för Tjänsteadresseringskatalogen

Konfiguration för tjänsten reset TAK cache, vlken används för att ladda in ny information från Tjänsteadresseringskatalogen.

Hantering av lokal cache av HSA's organisationsträd

Konfiguration för tjänsten reset HSA cache, vlken används för att ladda in ny information från HSA. Informationen från HSA representeras i form av XML filer som läses in i VP.

...

Kommaseparerad lista av sökvägar till filer som innehåller HSA information att ladda in i VP's HSA cache.

Köhantering, ActiveMQ

Inställningar för ActiveMQ och köer för hantering av loggar

Generellt tjänster, ändpunkter

...

TP_DISPATCH_MAX_THREADS_ACTIVE

...

TP_DISPATCH_MAX_THREADS_IDLE

...

TP_DISPATCH_MAX_THREADS_TTL

...

TP_RECEIVE_MAX_THREADS_ACTIVE

...

TP_RECEIVE_MAX_THREADS_IDLE

...

TP_RECEIVE_MAX_THREADS_TTL

...

SERVICE_TIMEOUT_MS

...

Ange i millesekunder, defaultvärde hur länge en ändpunkt skall vänta innan ett synkront anrop avbryts.

...

SOCKET_SO_LINGER_MS

...

SO_TIMEOUT is the timeout that a read() call will block. If the timeout is reached, a java.net.SocketTimeoutException will be thrown. 

# If you want to block forever put this option to zero (the default value), then the read() call will block until at least 1 byte could be read.

...

VP_MULE_HTTPS_PRODUCER_CONNECTOR_TCPNODELAY

...

VP_MULE_HTTPS_PRODUCER_CONNECTOR_KEEPALIVE

...

VP_MULE_HTTPS_PRODUCER_CONNECTOR_KEEPALIVE_TIMEOUT_MS

...

VP_MULE_HTTPS_CONSUMER_CONNECTOR_TCPNODELAY

...

VP_MULE_HTTPS_CONSUMER_CONNECTOR_KEEPALIVE_TIMEOUT_MS

...

VP_MULE_HTTP_CONSUMER_CONNECTOR_TCPNODELAY

...

VP_MULE_HTTP_CONSUMER_CONNECTOR_KEEPALIVE

...

VP_MULE_HTTP_CONSUMER_CONNECTOR_KEEPALIVE_TIMEOUT_MS

...

VP_MULE_HTTP_CONSUMER_CONNECTOR_SERVICE_TIMEOUT_MS

...

Ange i millesekunder hur länge VP skall vänta på att en klient har leveretat hela sitt svar

...

VP_MULE_HTTP_CONSUMER_CONNECTOR_SOCKET_SO_LINGER_MS

...

SO_TIMEOUT is the timeout that a read() call will block. If the timeout is reached, a java.net.SocketTimeoutException will be thrown. 

# If you want to block forever put this option to zero (the default value), then the read() call will block until at least 1 byte could be read.

...

TP_HOST

...

TP_PORT

...

TP_PORT_HTTP

...

TP_BASE_URI

...

Inställningar för att VP´s koppling till Tjänsteadresseringskatalogen (TAK)

...

TP_SOKVAGVALSINFO_URL

...

http://localhost:8082/tp-vagval-admin-services/SokVagvalsInfo/v2

...

Adress till tjänsten i TAK för att hämta behörigheter och routing information.

...

TK_HOST

...

https://${TP_HOST}:${GETSUPPORTEDSERVICECONTRACTS_RIVTABP21_PORT}/${TP_BASE_URI}/GetSupportedServiceContracts/1/rivtabp21?connector=VPProducerConnector

...

Default till https på port 23001 för bakåtkompabilitet.

...

GETSUPPORTEDSERVICECONTRACTS_OUTBOUND_URI

...

tp-vagval-admin-services/GetSupportedServiceContracts

...

http://${TP_HOST}:${TP_PORT_HTTP}/${TP_BASE_URI}/services/GetSupportedServiceContracts/2/rivtabp21

...

...

Version 2 av adress till tjänsten i TAK för att hämta information om vilka tjänstekontrakt som stöds av en verksamhet/system (logisk adress).

...

GETSUPPORTEDSERVICECONTRACTS_RIVTABP21_PORT

...

GETLOGICALADDRESSESBYSERVICECONTRACT_OUTBOUND_URI

...

tp-vagval-admin-services-1.3.1/GetLogicalAddresseesByServiceContract

...

Adress till tjänsten i TAK för att hämta information om vilka verksamheter/system (logisk adress) en konsument har behörighet att anropa, givet tjänstekontrakt.

...

GETLOGICALADDRESSESBYSERVICECONTRACT_RIVTABP21_PORT

...

23001

Port till tjänsten i TAK för att hämta information om vilka verksamheter/system (logisk adress) en konsument har behörighet att anropa, givet tjänstekontrakt.

...

Ersätter GETLOGICALADDRESSESBYSERVICECONTRACT_RIVTABP21_PORT för att kunna styra om

man vill ha http eller https internt. Default till samma port som tidigare.

...

finnas på classpath.

För att överlagra defaultinställningar vad gäller säkerhet behöver en fil med namnet vp-security-override.properties finnas på classpath.

Instruktion för tidigare versioner av VP

SKLTP VP - Konfiguration av äldre versioner

Release Note - Virtualiseringsplatformen, för att läsa om förändringar mellan olika versioner

Instruktion för sensate versionen av VP - 2.2.7

Typiska inställningar i vp-security-overide.properties

TBD

Typiska inställningar i vp-config-overide.properties

TBD

Komplett sammanställning av alla inställningar som finns i VP

2.2.7-RC1 vp-config.properties

2.2.7-RC1 vp-security.properties

Konfiguration av specifika features

Feature keep-alive

För de virtuella tjänster i VP som har stöd för keep-alive finns det möjlighet att per tjänst styra om keep-alive skall vara aktiverat eller ej. Ett default värde (feature.keepalive) sätts för alla virtuella tjänster som sedan kan överlagras av respektive tjänst som vill aktivera keep-alive. Aktiveringen av keep-alive görs enligt en given konvention:

...

Default sätts connection och response timeouten i parametern SERVICE_TIMEOUT_MS.

Parametrar i vp-security.properties (Certifikat inställningar)

Sökväg till katalog innehållandes certifikat

Truststore

En truststore innehåller certifikat från andra intressenter som vp förväntas kommunicera med och lita på.

Keystore som producent

Keystore som innehåller autentiseringsinformation som skall skickas till konsumenter när VP agerar som producent, dvs när VP tar emot information.

Keystore som konsument

Keystore som innehåller autentiseringsinformation som skall skickas till producenter när VP agerar som konsument, dvs när VP skickar information.

...

TP_TLS_STORE_CONSUMER_TYPE

...

TP_TLS_STORE_CONSUMER_FILE

...

.

...

TP_TLS_STORE_CONSUMER_PASSWORD

...

TP_TLS_STORE_CONSUMER_KEY_PASSWORD

...

Konfigurera loggning av LogEvents

Konfiguration av loggning görs i <mule-hom>/apps/<vp-services>/classes/log4j.xml, notera att det inte krävs någon omstart av applikationen, ändringar slår direkt i runtime.

...

** logEvent-info.start ***********************************************************
IntegrationScenarioId=
ContractId=
LogMessage=xreq-in
ServiceImpl=vagval-dynamic-routing-flow
Host=33.33.33.1 (33.33.33.1)
ComponentId=1133a557-b5cc-11e3-bd36-2da34769782a
Endpoint=https://localhost:20000/vp/tjanst1
MessageId=15c27c95-b5cc-11e3-bd36-2da34769782a
BusinessCorrelationId=15cc67b1-b5cc-11e3-bd36-2da34769782a
BusinessContextId=
ExtraInfo=
-senderid=tp
-originalServiceconsumerHsaid=null
-source=se.skl.tp.vp.util.LogTransformer
-cxf_service=urn:skl:tjanst1:rivtabp20
-rivversion=RIVTABP20
-receiverid=vp-test-producer
Payload=
** logEvent-info.end *************************************************************

VP 2.2.2 och senare

I VP 2.2.2 infördes möjligheten styra loggning av payload av eller på. All loggning av LogEvents styrs från VP 2.2.2 enbart med följande konstruktion, se kommentar i exemplet för olika lognivåer.

   <!--      
        For logging events to QUEUE using EventLogger:
        
        NOTE: For now default is to log payload for each request/response, however for performance
        etc the opposite is the goal, to not log payload by default. This will be addressed in
        coming releases.
        
        DEBUG puts logevents (with payload) and errorevents on log queue
        INFO puts logevents (without payload) and errorevents on log queue
        ERROR will only put errorevents on log queue
         
    -->
    <logger name="org.soitoolkit.commons.mule.messageLogger">
        <level value="DEBUG" />
    </logger>

...