AGP - Installation plattform

Owned by Göran Erkstam (Unlicensed)
Last updated: juni 07, 2022 by Björn Pettersson
1 min read

Inledning

Denna sida beskriver installation av Aggregeringsplattformen utan några tjänster. Tjänsterna installeras separat som pluginer till aggregeringsplattformen. Se AGP - Installation tjänst

Förutsättningar

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

  1. Java Runtime Environment

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

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

  2. SKLTP TAK 2.4.0 eller senare installerad, se TAK installationsanvisning.

  3. EngagemangIndex (EI), se SKLTP EI - Driftsintruktioner, Installation

Ladda ner applikation

Kan hämtas från Ineras Nexus, https://nexus.drift.inera.se/repository/maven-public/ och hittas med:

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

Exempel med wget där X.Y.Z är versionnummret:

wget https://nexus.drift.inera.se/repository/maven-public/se/skltp/agp/agp-application/X.Y.Z/agp-application-X.Y.Z-exec.jar

Konfigurera applikation

Applikationen konfigureras som en Spring-boot applikation, dvs genom att antingen skapa:

  1. <agp-install-dir>/conf/application.properties eller

  2. <agp-install-dir>/conf/application-<spring-profile>.properties

Det senare att föredra då man endast behöver konfigurera skillnaden från default inställningarna. Observera att applikationen då behöver startas med parametern: -Dspring.profiles.active=<spring-profile>

För detaljer om konfiguration, se AGP - Konfiguration

Starta applikationen

AGP kan startas upp som en vanlig java applikation. Exempel:

java -jar -Dfile.encoding=UTF-8 -Duser.country=SE -Duser.language=sv -Dspring.profiles.active=custom -Xms512m -Xmx1536m -Dlog4j.configurationFile=file:///opt/agp/config/log4j2.xml -Dloader.path=/opt/agp/services/ agp-application-3.0.0-exec.jar

Några parametrar i exemplet ovan är av extra vikt:

  1. -Dspring.profiles.active=custom - Möjliggör överlagring av default konfigurering i egen fil application-custom.properties (se även kapitlet ovan).

  2. -Dlog4j.configurationFile=file:///opt/agp/config/log4j2.xml - Möjliggör overlagring av loginställningar.

  3. -Dloader.path=/opt/agp/services/ - Spring-Boot lägger denna sökväg till sin classpath. Detta möjliggör att vi kan lägga alla våra tjänsteimplementationer här. Aggregeringsplattformen kommer då automatiskt att läsa in dem vid uppstart. Se även AGP - Installation tjänst