Under uppbyggnad!

Ladda ner applikationerna

1. Ladda ner zip fil för frontend applikation från Mavens cetrala repository.
2. Ladda ner zip fil för backend applikation från Mavens cetrala repository.

Lägg till runtime beroenden

I de fall runtime beroenden inte är installerade behöver följande göras.

...

1. hibernate-entitymanager-3.6.0.Final.jar
2. hsqldb-2.2.9.jar

...

Förutsättningar

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

1. Java Runtime Environment

   1. EI från och med version 3.1.0 kräver Java 11 eller senare (verfierad med OpenJDK 11)

   2. EI från och med version 3.0.0 kräver Java 8 eller senare (verfierad med OpenJDK 1.8.0)

2. ActiveMQ
3. MySQL

Ladda ner applikationerna

Kan hämtas från Ineras Nexus (se Release information för länken) och hittas med:

<dependency>
  <groupId>se.skltp.ei</groupId>
  <artifactId>skltp-ei-frontend</artifactId>
  <version>X.Y.Z</version>
  <classifier>exec</classifier>
</dependency>

<dependency>
  <groupId>se.skltp.ei</groupId>
  <artifactId>skltp-ei-backend</artifactId>
  <version>X.Y.Z</version>
  <classifier>exec</classifier>
</dependency>

Exempel med wget där 3.0.0 är versionnumret:

wget https://repo.ntjp.se/repository/SKLTP-Releases/se/skltp/ei/skltp-ei-backend/3.0.0/skltp-ei-backend-3.0.0-exec.jar

Konfigurera applikationerna

Applikationerna konfigureras som Spring Boot-applikationer, dvs. genom att skapa <ei-install-dir>/config/application.properties . Observera att applikationen behöver startas med parametern spring.config.import=<ei-install-dir>/config/application.properties

För detaljer om konfiguration, se AGP - Konfiguration

Databas

Skapa databas och användare

...

Kör sql-scriptet för att skapa tabeller i EI databasen.

Konfigurera EI applikation

För att överlagra default inställningar, skapa en ei-config-override.properties i MULE_HOME/conf.

SKLTP EI - Konfiguration

Mule konfiguration, instruktion för att stoppa/starta

Se över minnesinställningar i Mule

Säkerställ att EI applikationen startas i rätt turordning, EI är beroende av att VP är igång.

...

ActiveMQ-konfiguration

Se över inställningar för ActiveMQ

Hantera root certifikat

Installationsmanual Certifikat

Release

Hantera att Engagemangsindex behöver tillgång till Virtualiseringsplattformen vid uppstart

Vid uppstart av EI krävs att VP är tillgängligt. I de fall EI och VP ligger deployade på samma Mule server  kan detta bli problem då EI startar för VP. Detta hanteras genom att efter uppstart göra en omladdning av EI genom antingen:

• Touch på skltp-ei-application-mule-backend-app-<version>/mule-config.xml
• Deploya om EI genom att ta bort skltp-ei-application-mule-backend-app-<version>-anchor.txt och lägga på skltp-ei-application-mule-backend-app-<version>.zip

Genomför en en release med MMC

Se SKLTP - Mule Management Console

Notera att tillfälligt behöver log4j.xml kopieras till <MULE_HOME>/apps/skltp-ei-application-mule-[front|backend]-app/classes för att kunna konfigurera loggning

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

Notera att EI består av 2 applikationer och att rekommendationen är att genomföra följande på en applikation åt gången.

1. Ta bort tidigare version av samma applikation om det finns en sådan, tex olika releasekandidater (RC).
2. Kopiera applikationen (zip) till <MULE_HOME>/apps
3. verifiera i loggar att releasen gick bra
4. Vid problem tas releasen bort genom att ta bort anchor-filen för motsvarande applikation.

...

java -jar -Dfile.encoding=UTF-8 -Duser.country=SE -Duser.language=sv -Dspring.config.import=/opt/ei-backend/config/application.properties -Xms512m -Xmx1536m -Dlog4j.configurationFile=file:///opt/ei-backend/config/log4j2.xml -Dio.netty.leakDetection.level=PARANOID skltp-ei-frontend-3.0.0-exec.jar