NSP
Leverance beskrivelse SOSI-DCC 2.4.1

Introduktion

Denne note beskriver i korte træk leverancen af SOSI-DCC version 2.4.1 til NSP projektet.

Leverance

Leverancen er tagget som https://svn.softwareborsen.dk/sosi-dcc/tags/release/2.4.1/ (og også som https://svn.nspop.dk/svn/lakeside/sosi-dcc/tags/release-2.4.1/) som herefter refereres til som SVN-RELEASE.

Leverancebeskrivelse


Release 2.4.1 indeholder følgende ændringer i forhold til sidste release 2.4.0:
- Fix for failing deployment on certain Wilfly instances: Specified initalization order for subdeployments
- Fix for excessive logging to Wildlfy server log
(Taget direkte fra 'changes.txt' under SVN-RELEASE)

Dokumentation

Al dokumentation til komponenten kan findes under SVN-RELEASE/doc/ (inklusiv dette dokument).

Kildekode

Ligger under SVN-RELEASE/modules/

Binære artefakter

Komponent bundlen ligger under https://svn.softwareborsen.dk/sosi-dcc/releases/ og er bygget på følgende miljø:
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T17:41:47+01:00)
Maven home: /usr/local/Cellar/maven/3.3.9/libexec
Java version: 1.8.0_92, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_92.jdk/Contents/Home/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "10.11.4", arch: "x86_64", family: "mac"

Vejledninger

Byggevejledning

For at bygge komponent-pakken direkte fra source, afvikles
mvn assembly:assembly -Ddescriptor=assembly-jboss.xml
ind fra modules/.

Testafvikling

Unit tests afvikles som en del af bygget.
Udover dette er der en SystemTest suite som kan afvikles for at verificere et deployment. Test-suitens formål er primært at sikre at det asykrone setup er korrekt, dvs. JMS køerne er konfigureret korrekt. Da den asynkrone kald semantik ikke understøttes på NSP og basis-platformen heller ikke indeholder en JMS provider giver det ikke mening af afvikle SystemTesten i et NSP setup. Testen af de asynkrone kald kan fjernes fra projektet.
Releasen blev desuden testet manuelt på Wildfly 8.2.0.

Øvrige vejledninger


Benyt følgende installations-vejledning til at installere DCCen på JBoss 8 (Wildfly) på NSP:

  1. Den byggede/downloadede installationspakke udpakkes. I det følgende refereres roden i den udpakkede folder "sosi-dcc-jboss" som $NSPDCC_ROOT.
  2. Kopier 'log4j-dcc.properties', 'log4j-nspslalog.properties', 'nspslalog-sosidcc.properties' og 'dcc-config.xml' fra $NSPDCC_ROOT/etc/config/ til $JBOSS_HOME/standalone/configuration/ på JBoss serveren
  3. Erstat <RetryInterval>300000</RetryInterval> i $JBOSS_HOME/standalone/configuration/dcc-config.xml med et negativ tal for at slå asynkrone retries helt fra og for at undgå at DCCen forsøger at læse fra en ikke-eksisterende Redo-kø.
  4. Konfigurer DCC'en som beskrevet i 'SOSI-DCC konfigurationsvejledning', herunder konfiguration af SSL/TLS.
  5. Næste skridt er at deployere DCC war filen. Det gøres ved at kopiere 'decoupling.ear' fra $NSPDCC_ROOT/dist/ til $JBOSS_HOME/standalone/deployments/ på JBoss serveren.
  6. Verificer at der ikke er nogen fejl i $JBOSS_HOME/standalone/log/decoupling.log og i $JBOSS_HOME/standalone/log/server.log


\\
Følgende warnings kan ignoreres:
\\
14:53:59,261 WARN  \[org.jboss.as.server.deployment\] (MSC service thread 1-11) JBAS015960: Class Path entry xml-apis.jar in /content/decoupling.ear/decoupling.war/WEB-INF/lib/serializer-2.7.1.jar  does not point to a valid jar for a Class-Path reference.
\\
14:53:59,265 WARN  \[org.jboss.as.server.deployment\] (MSC service thread 1-11) JBAS015960: Class Path entry xercesImpl.jar in /content/decoupling.ear/decoupling.war/WEB-INF/lib/xalan-2.7.1.jar  does not point to a valid jar for a Class-Path reference.
\\
14:53:59,265 WARN  \[org.jboss.as.server.deployment\] (MSC service thread 1-11) JBAS015960: Class Path entry xml-apis.jar in /content/decoupling.ear/decoupling.war/WEB-INF/lib/xalan-2.7.1.jar  does not point to a valid jar for a Class-Path reference.
\\
14:53:59,265 WARN  \[org.jboss.as.server.deployment\] (MSC service thread 1-11) JBAS015960: Class Path entry serializer.jar in /content/decoupling.ear/decoupling.war/WEB-INF/lib/xalan-2.7.1.jar  does not point to a valid jar for a Class-Path reference.