Jämförda versioner

Nyckel

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

TODO: Uppdatera

Innehållsförteckning

Äldre versioner

SKLTP VP - Installation av äldre versioner

Förutsättningar

Följande förutsätts vara installerat innan VP installeras:

  1. ActiveMQ. Ifall loggning inte görs via VP kan man istället använda Mules inbäddade activemq.
  2. Installera Mule version 3.7.0. Rekommendationer, minnesinställningar, runtimeberoenden, loggning mm för SKLTP finns på följande instruktion
  3. SKLTP TAK 1.5.0 eller senare installerad, se installationsanvisning. Konfiguration enligt installationsanvisning förutsätts
  4. Certifikat installerat, se installationsmanual

Ny installation av VP

1. Ladda ner applikationen


Kodblock
wget http://repo1.maven.org/maven2/se/skltp/vp/vp-services/x.y.z/vp-services-x.y.z.zip

där x.y.z är en vaersion av vp, exempelvis

wget http://repo1.maven.org/maven2/se/skltp/vp/vp-services/3.1.3/vp-services-3.1.3.zip

2. Konfigurera VP applikation

Varning

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.

...

VP har konfigurationsfiler för att konfigurera olika parametrar som styr applikationens funktioner. Hur dessa parametrar konfigureras och dess betydelse beskrivs i detalj på SKLTP VP (Mule) - Konfiguration.

  1. Säkerställ att vp-config-override.properties och vp-security-override.properties finns under /usr/local/mule-standalone-3.7.0/conf/ för att kunna överlagra default parametrar
    1. Skapa en vp-config-override.properties och en vp-security-override.properties, konfigurera enligt SKLTP VP (Mule) - Konfiguration

      Kodblock
      sudo vi /usr/local/mule-standalone-3.7.0/conf/vp-config-override.properties


      Kodblock
      sudo vi /usr/local/mule-standalone-3.7.0/conf/vp-security-override.properties


  2. Säkerställ att fil med hsa information finns under /usr/local/mule-standalone-3.7.0/conf/
    1. Ladda ner HSA fil med endast SE nod som kompletterar den riktiga HSA filen.

      Kodblock
      wget http://skl-tp.atlassian.net/wiki/download/attachments/5308496/hsacachecomplementary.xml
      mv hsacachecomplementary.xml /usr/local/mule-standalone-3.7.0/conf/hsacachecomplementary.xml


    2. Uppdatera i parametern HSA_FILES vp-config-override.properties för att lägga till hsacachecomplementary.xml och läsa in SE noden

      Kodblock
      vi /usr/local/mule-standalone-3.7.0/conf/vp-config-override.properties
       
      HSA_FILES=/usr/local/mule-standalone-3.7.0/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.
  3. Säkerställ att korrekta certifikatsfiler finns under /usr/local/mule-standalone-3.7.0/certs/ och att vp-security-override.properties pekar på certifikatsfilerna.
    1. Saknas /usr/local/mule-standalone-3.7.0/certs/, skapa den och lägg era certifikatsfiler i katalogen.

      Kodblock
      mkdir /usr/local/mule-standalone-3.7.0/certs/
       
      cp my-cert.p12 /usr/local/mule-standalone-3.7.0/certs/
      cp my-trustsore.jks /usr/local/mule-standalone-3.7.0/certs/


    2. Se SKLTP VP (Mule) - Konfiguration, hur konfiguration i vp-security-override.properties skall göras för att peka ut certifikatsfiler.
    3. Vid behov , se Installationsmanual Certifikat för hur en truststore hanteras.

3. Installation

Se gemensam installationsanvisning längre ner på sidan.

Installationsanvisning (delade delar)

Genomför en en release med MMC

Se /wiki/spaces/NTJP/pages/591659054

Genomför en en release manuellt när inte MMC finns tillgängligt

  1. Monitorera mule.log för att se loggar

    Kodblock
    tail -f /usr/local/mule-standalone-3.7.0/logs/mule.log $


  2. Ta bort tidigare version av samma applikation om det finns en sådan, tex olika releasekandidater (RC).
    1. I /usr/local/mule-standalone-3.7.0/apps, radera vp-services-[version]-anchor.txt för att trigga så att Mule tar bort applikationen under kontrollerade former.

      Kodblock
      rm /usr/local/mule-standalone-3.7.0/apps/vp-services-3.1.3-anchor.txt


    2. Säkerställ att applikationen tagits av Mule genom katalogen vp-services-[version] inte längre finns kvar.

      Kodblock
      ll -a /usr/local/mule-standalone-3.7.0/apps


  3. Driftsätt applikation (zip)
    1. Kopiera den nedladdade zip-filen, vp-services-[version].zip,  till /usr/local/mule-standalone-3.7.0/apps. Mule packar upp applikationen till en katalog vp-services-[version].

      Kodblock
      cp vp-services-3.1.3.zip /usr/local/mule-standalone-3.7.0/apps


    2. En fil med namn vp-services-[version]-anchor.txt (vp-services-3.1.3.zip) skapas vid en lyckad driftsättning.

      Kodblock
      ll -a /usr/local/mule-standalone-3.7.0/apps
       
      -rw-r--r--  1 mule mule   75 26 okt 21.59 vp-services-23.21.93-anchor.txt
      drwxr-xr-x  5 mule mule 4096 15 okt 13.17 vp-services-23.21.93


  4. Verifiera i loggar hur releasen gick, /usr/local/mule-standalone-3.7.0/logs/mule-app-vp.log och  /usr/local/mule-standalone-3.7.0/logs/mule.log
    1. /usr/local/mule-standalone-3.7.0/logs/mule.log ser man status på driftsättningen.

      Kodblock
      ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
      + New app 'vp-services-3.1.3'							   +
      ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
      INFO  2013-08-28 08:50:27,837 [WrapperListener_start_runner] org.mule.module.launcher.MuleApplicationClassLoader: [vp-services-3.1.3] Loading the following jars:
      =============================
      -
      -
      -
      ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
      + Started app 'vp-services-3.1.3'			               +
      ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


      Kodblock
      **********************************************************************
      *            - - + APPLICATION + - -            * - - + STATUS + - - *
      **********************************************************************
      * vp-services-3.1.3				                * DEPLOYED           *
      **********************************************************************


    2. /usr/local/mule-standalone-3.7.0/logs/mule-app-vp.log ser man följande vid en lyckad start.

      Kodblock
      **********************************************************************
      * Application: vp-services-3.1.3                       *
      * OS encoding: UTF-8, Mule encoding: UTF-8                           *
      *                                                                    *
      * Agents Running:                                                    *
      *   JMX Agent                                                        *
      *   Wrapper Manager: Mule PID #20712, Wrapper PID #20705             *
      **********************************************************************
      2013-08-28 08:51:31,182 INFO  org.mule.module.logging.DispatchingLogger - Start force a reset of VagvalAgent...
      2013-08-28 08:51:31,186 INFO  org.mule.module.logging.DispatchingLogger - Initialize VagvalAgent TAK resources...
      2013-08-28 08:51:31,187 INFO  org.mule.module.logging.DispatchingLogger - Fetch all virtualizations from TAK...
      2013-08-28 08:51:31,503 INFO  org.mule.module.logging.DispatchingLogger - Fetch all permissions from TAK...
      2013-08-28 08:51:31,801 INFO  org.mule.module.logging.DispatchingLogger - Save virtualizations and permissions to local TAK copy: /home/mule/.tk.devtest.localCache
      2013-08-28 08:51:31,932 INFO  org.mule.module.logging.DispatchingLogger - Init VagvalAgent loaded number of permissions: 161
      2013-08-28 08:51:31,934 INFO  org.mule.module.logging.DispatchingLogger - Init VagvalAgent loaded number of virtualizations: 116
      2013-08-28 08:51:31,935 INFO  org.mule.module.logging.DispatchingLogger - Init VagvalAgent done
      2013-08-28 08:51:31,936 INFO  org.mule.module.logging.DispatchingLogger - Successfully force reset VagvalAgent


  5. Om driftsättningen misslyckas skapas inte en vp-services-[version]-anchor.txt, applikationen startar inte och följande ses i /usr/local/mule-standalone-3.7.0/logs/mule.log

    Kodblock
    **********************************************************************
    *            - - + APPLICATION + - -            * - - + STATUS + - - *
    **********************************************************************
    * vp-services-3.1.3 			                * FAILED             *
    **********************************************************************


Info
titleDriftsätta virtualiseringar

Notera att virtuella tjänster, teststubbar och schemas läggs på efter en deploy, se rubriken Driftsätta Virtualiseringar

Verifiera installationen av Virtualiseringsplattformen med anrop till Ping tjänst

Med hjälp av ett verktyg som SoapUI går det att göra anrop till tjänster som exponeras av Virtualiseringsplattformen. För att verifiera att installationen gått bra kan man använda bifogat SoapUI projekt genom att följa följande instruktion.

...