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
Se över inställningar för ActiveMQ
Hantera root certifikat
Installationsmanual Certifikat
Release
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. 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.
...
ActiveMQ-konfiguration
Se över inställningar för ActiveMQ
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.