Innehållsförteckning |
---|
Under uppbyggnad!
Ladda ner applikationerna
- Ladda ner zip fil för frontend applikation från Mavens cetrala repository.
- 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.
...
- hibernate-entitymanager-3.6.0.Final.jar
- hsqldb-2.2.9.jar
...
Innehållsförteckning |
---|
Förutsättningar
Följande förutsätts vara installerat innan AGP installeras:
Java Runtime Environment
EI från och med version 3.1.0 kräver Java 11 eller senare (verfierad med OpenJDK 11)
EI från och med version 3.0.0 kräver Java 8 eller senare (verfierad med OpenJDK 1.8.0)
- ActiveMQ
- MySQL
Ladda ner applikationerna
Kan hämtas från Ineras Nexus (se Release information för länken) och hittas med:
Kodblock | ||||
---|---|---|---|---|
| ||||
<dependency>
<groupId>se.skltp.ei</groupId>
<artifactId>skltp-ei-frontend</artifactId>
<version>X.Y.Z</version>
<classifier>exec</classifier>
</dependency> |
Kodblock | ||||
---|---|---|---|---|
| ||||
<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:
Kodblock | ||
---|---|---|
| ||
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.
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
...
ActiveMQ-konfiguration
Se över inställningar för ActiveMQ
Hantera root certifikat
Installationsmanual Certifikat
Release
Genomför en en release med MMC
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. Gör en touch på /<MULE_HOME>/apps/skltp-ei-application-mule-[front|backend]-app/mule-config.xml för att ladda om applikationen så att den nya log-konfigurationen används.
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.
- Ta bort tidigare version av samma applikation om det finns en sådan, tex olika releasekandidater (RC).
- Kopiera applikationen (zip) till <MULE_HOME>/apps
- verifiera i loggar att releasen gick bra
- Vid problem tas releasen bort genom att ta bort anchor-filen för motsvarande applikation.
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. Gör en touch på /<MULE_HOME>/apps/skltp-ei-application-mule-[front|backend]-app/mule-config.xml för att ladda om applikationen så att den nya log-konfigurationen används.
Ladda om EI vid konfigurationsförändringar - exempelvis när nya prenumeranter lagts till
För varje nod
...
Starta applikationerna
EI kan startas upp som en vanliga java-applikationer. Exempel:
Kodblock | ||||
---|---|---|---|---|
| ||||
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 |
Några parametrar i exemplet ovan är av extra vikt:
-Dspring.config.import=/opt/ei-backend/config/application.properties
- Möjliggör överlagring av defaultkonfigurering i egen fil application.properties (se även avsnittet om konfiguration ovan).-Dlog4j.configurationFile=file:///opt/ei-frontend/config/log4j2.xml
- Möjliggör överlagring av logginställningar.