Axel i Apache Tomcat

Förberedelser

Se under rubriken Förbedelser i AxelInstallation.

Manuell installation:

Följ instruktionerna för Apache Tomcat för att få igång en Tomcat-instans.

Extrahera axel-war-[version](/bjoben/axel/wiki/version).tar.gz

Deploya de önskade war filerna från den extraherade katalogen axel-war-[version](/bjoben/axel/wiki/version)/webapps

• shs-broker-[version](/bjoben/axel/wiki/version).war
• riv-shs-[version](/bjoben/axel/wiki/version).war
• riv-ssek-[version](/bjoben/axel/wiki/version).war
• monitoring-war-[version](/bjoben/axel/wiki/version).war
• hawtio-default-[hawtio-version](/bjoben/axel/wiki/hawtio-version).war

Skapa index i Mongodatabasen genom att köra

• axel-war-[version](/bjoben/axel/wiki/version)/docs/mongo/createIndexes.sh

Konfigurera

Klar!

Konfigurera

Konfigurationsparametrar beskrivs generellt i detta AxelKonfiguration dokument.

För Tomcat gäller:

• Konfigurationsfilerna ligger i ${axel.home}/etc
• Vissa integrationskomponenter ligger i ${axel.home}/deploy
• Alla properties kan ligga i samma fil, men de kan också ligga i samma filstruktur som beskrivs AxelKonfiguration här.

axel.home måste sättas som en system property eller som en servlet context parameter, och är per default relativt webappens root-katalog.

T.ex. kan man lägga in något av följande i start-scriptet TOMCAT/bin/catalina.sh eller TOMCAT/bin/setenv.sh:

Detta gör att filerna tas från WEB-INF-katalogen:

export CATALINA_OPTS="-Daxel.home=WEB-INF"

För att peka ut en extern filkatalog (rekommenderas) så måste man prefixa med file: så här:

export CATALINA_OPTS="-Daxel.home=file:/opt/axel/"

Exempel på automatiserad installation från source

Axel finns installerad i en testmiljö hos NMT. I denna miljö byggs och installeras Axel från source. De installationsskript som används i den miljön finns tillgängliga [http://wiki.inera-axel.googlecode.com/git/files/axel_install/ här](http://wiki.inera-axel.googlecode.com/git/files/axel_install/ här)

Beskrivning av Axels war paketering

När Axel byggs skapas det ett distributionspaket anpassat för att använda när man vill installera Axel i en web container. Bygger man Axel från source så är sökvägen till paketet inera-axel/platforms/war/distribution-war/target/axel-war-[version](/bjoben/axel/wiki/version).tar.gz och i Maven har paketet groupId se.inera.axel.war och artifactId distribution-war.

/bin

Innehåller körbara skript.

• shs - skript för att köra Axels SHS-kommandoradsklient

/docs

Innehåller information och konfigurationsfiler för Mongodatabasen och Axels LDAP-katalog.

==== /docs/ldap ====

• axel-sytemtest.ldif - LDAP data som används i Axels systemtestmiljöer när FitNesse testerna körs
• install-openldap-ubuntu.sh - Exempelskript för att installera openldap för att användas i en testinstallation av Axel. OBS kör ej om Open LDAP används sedan tidigare på maskinen eftersom det då finns risk att data försvinner.
• axel-update.ldif - Konfiguration av adminanvändare och olcSuffix som används av install-openldap-ubuntu.sh
• shs.schema - LDAP schema för SHS 1.2
• shs.schema - LDAP schema för SHS 1.2 i ldif format

==== /docs/mongo ====

• README.md - README fil som beskriver hur man använder filerna i katalogen
• createIndexes.js - Skript för att skapa upp index i Axels mongodatabas
• createIndexes.sh - Körbart skript som exekverar createIndexes.js i utpekad Mongodatabas

/webapps

• shs-broker-[version](/bjoben/axel/wiki/version).war - SHS-brokern inklusive administrationsgränssnitt
• riv-shs-[version](/bjoben/axel/wiki/version).war - RIV/SHS-bryggan inklusive administrationsgränssnitt
• riv-ssek-[version](/bjoben/axel/wiki/version).war - RIV/SSEK-bryggan inklusive administrationsgränssnitt
• monitoring-war-[version](/bjoben/axel/wiki/version).war - Komponenter för övervakning av Axel t.ex. PingForConfiguration och Axel Health View MBean.
• hawtio-default-[hawtio-version](/bjoben/axel/wiki/hawtio-version).war - Hawtio inklusive Jolokia http://hawt.io/ för övervakning och konfiguration av Axel och ingående komponenter såsom Apache Camel.