SKLTP EI - Driftsintruktioner, Installation

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. Tillföra två jar-filer på MULE-HOME/lib/opt:
   1. hibernate-entitymanager-3.6.0.Final.jar
      
   2. hsqldb-2.2.9.jar (TBD: BEHÖVS HSQL-JAR UTANFÖR DEN ENGAN UTV MILJÖN?)
      
2. Ladda ner MySQL Connector/J från MySQL och tillför den till MULE-HOME/lib/shared/default/
   
   1. I skrivande stund är det v5.1.26 som är senaste gällande version. 
   2. Välj "Platform Independent", TAR eller ZIP spelar ingen roll.
   3. Välj "No thanks, just start my download." för att slippa logga in.
   4. Packa upp den nedladdade filen och flytta jar-filen mysql-connector-java-n.n.n/mysql-connector-java-n.n.n-bin.jar till MULE-HOME/lib/shared/default/ 
      
3. Ladda ner AMQ-jar från följande länk och tillför den på MULE-HOME/lib/shared/default/ (TBD: DETTA BÖR VÄL REDAN VARA GJORT I GRUNDUPPSÄTTNINGEN?)
   
4. Starta om Mule

Databas

Skapa databas och användare

CREATE DATABASE ei;
GRANT ALL PRIVILEGES ON ei.* TO ei_user@<ipadress> IDENTIFIED BY '<ett lösenord>';

Skapa tabeller

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

Genomför en en release med MMC

Se 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.

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.

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

1.  Gör en touch på /<MULE_HOME>/apps/skltp-ei-application-mule-[front|backend]-app/mule-config.xml 
2. Kolla i loggfilen mule-app-ei.log som finns i /<MULE_HOME>/logs/ och se att allt laddas som det ska.
3. Kolla i webbgränssnittet för ActiveMQ för att verifiera att prenumeranten verkligen lagts till.