Jämförda versioner

Nyckel

  • Dessa rader lades till.
  • Denna rad togs bort.
  • Formateringen ändrades.

...


VP Camel fungerar som en distributör av meddelanden från en konsument av information till en eller flera producenter av information, samt levererar svar från dessa.
För att detta ska fungera ska VP installeras, samt ha tillgång till vägvals-data (adresseringar) samt behörigheter via en installerad TAK-databas.
För underhåll finns en applikation StatusProbe som kontrollerar att VP fungerar som den ska. Denna är inte nödvändig för normal funktion, men rekommenderas.

...

Det finns även en applikation StatusProbe som kan användas för att kontrollera status för VP Camel (och andra applikationer).
Hur man installerar och använder den kan läsas på sidan Status-probe.

...

Notera att om det finns en redan installerad version av VP så är detta steget redan genomfört och endast ev förändringar kring nya eller borttagna properties behövs hanteras.
Se release notes för VP på Release Note - Virtualiseringsplatformen för att hämta information om eventuella förändringar mellan releaser.

...

  1. Säkerställ att application-custom.properties och application-security-custom.properties finns under <vp-camel-intall-dir>/conf/ (annars behöver de skapas/kopieras) för att kunna överlagra default parametrar.

  2. Med ledning av konfigurations-anvisningarna, sätt de parametrar som eventuellt behöver ändras.

  3. För att “Trädklättring” ska fungera (se förklaring här: UppdateraHSACache - Bakgrund, arkitektur och implementation) så ska en fil med hsa information finnas i den mapp som pekas ut i application-custom.properties.
    Observera att denna funktionalitet kommer att försvinna i framtida versioner av VP Camel.

    1. Ladda ner en HSA fil med endast SE nod som kompletterar den riktiga HSA filen. Placera till exempel i config-katalogen.

      Kodblock
      wget http://skl-tp.atlassian.net/wiki/download/attachments/5308496/hsacachecomplementary.xml
      mv hsacachecomplementary.xml /usr/local/<vp-camel-intall-dir>/conf/hsacachecomplementary.xml


    2. Uppdatera värdet i parametern hsa.files i application-custom.properties, så att den pekar på katalogen där du lagt filen hsacachecomplementary.xml för att läsa in SE noden

      Kodblock
      vi /usr/local/<vp-camel-intall-dir>/conf/vp-config-override.properties
       
      hsa.files=/usr/local/<vp-camel-intall-dir>/conf/hsacachecomplementary.xml

    3. Finns det behov av att hämta en fil från HSA med ett komplett organisationsträd, läs följande instruktion.

  4. Säkerställ att korrekta certifikatsfiler finns. Dessa ligger default i <vp-camel-install-dir>/certs men kan också ligga i en egen-konfigurerad mapp som pekas ut i application-security-custom.properties.
    Se också till att (om en egen konfiguration gjorts) application-security-custom.properties listar rätt namn på certifikatsfilerna samt deras password.

    1. Saknas mappen <vp-camel-intall-dir>/certs/, skapa den och lägg era certifikatsfiler i katalogen.

      Kodblock
      mkdir /usr/local/<vp-camel-intall-dir>/certs/
       
      cp my-cert.p12 <vp-camel-intall-dir>/certs/
      cp my-trustsore.jks <vp-camel-intall-dir>/certs/
      cp my-client.jks <vp-camel-intall-dir>/certs/


    2. Se SKLTP VP - Konfiguration, hur konfiguration i application-security-custom.properties skall göras för att peka ut certifikatsfiler.

    3. Vid behov , se Installationsmanual Certifikat för hur en truststore hanteras.

...

  1. Med integrerad statustjänst:
    VP Camel exponerar en statustjänst vars port kan konfigureras i application-custom.properties.
    Man kan anropa den med t.ex. Curl:

    Kodblock
    curl --data "username=uname&password=pw" http://<serveradress>:8080/status

    och få ett svar:

    Kodblock
    {
      "Name": "vp-services-camel",
      "Version": "1.0.0-RC1",
      "BuildTime": "2019-09-11T09:15:30.887Z",
      "ServiceStatus": "Started",
      "Uptime": "20 minutes",
      "ManagementName": "vp-services",
      "JavaVersion": "1.8.0_161",
      "CamelVersion": "2.24.0",
      "TakCacheInitialized": "true",
      "TakCacheResetInfo": "Date:2019-09-12T15:41 Status:REFRESH_OK vagval:566 behorigheter:1034",
      "HsaCacheInitialized": "true",
      "HsaCacheResetInfo": "Date:2019-09-12T15:41 Status:true oldNum:0 newNum:31465",
      "JvmTotalMemory": "885 mB",
      "JvmFreeMemory": "817 mB",
      "JvmUsedMemory": "67 mB",
      "JvmMaxMemory": "1365 mB",
      "Endpoints": [
        "https://0.0.0.0:20000/vp",
        "http://0.0.0.0:8080/vp",
        "http://0.0.0.0:8080/status",
        "http://0.0.0.0:24000/resethsacache",
        "http://0.0.0.0:23000/resetcache"
      ]
    }


  2. Med SoapUI:
    a. Installera först SoapUI ( https://www.soapui.org/downloads/soapui/source-forge.html )
    b. Skapa ett SoapUI-projekt som kör request’s mot VP Camel. Tutorials finns på denna adress:
    https://www.soapui.org/learn/tutorials/web-service-example-projects.html
    c. För att kunna köra webtjänsten så måste man installera ett SITHS certifikat. Finns inget kan det beställas från Ineras Identifieringstjänst.
    I SoapUI väljer du sedan File > Preferences och sedan fliken SSL Settings. Som KeyStore väljer du det SITHS certifikat du har beställt och anger lösenordet som du fått i samband med beställningen.
    Notera att det är certifikatet för autentisering som skall användas, inte signering.
    e. Se till att adress till applikationen är korrekt, annars editera.
    f. Exekvera anrop genom att först dubbelklicka på önskat test och sedan klicka på den gröna pilen.
    g. Ett resultat kommer nu att dyka upp i fönstret till höger i SoapUI (th på bilden nedan). Se exempel-svar nedan och dess betydelse.

...