Stamdata
Installationsvejledning



Indholdsfortegnelse
1 Formål
2 Krav til driftsmiljø
2.1 Krav til applikationsservere
2.2 Krav til operativsystem
2.3 Krav til database
2.4 Krav til hardware
3 Installation af Stamdata
3.1 Installation af Stamdata Data Manager komponenter.
3.1.1 Systemkrav
3.1.2 Forberedelse af database og datasource
3.1.3 Installation af en komponent
4 Ændringslog

Formål

Vejledning til installation og konfiguration af Stamdata.
Dokumentet indeholder komponentens krav til det omliggende miljø, herunder krav til operativsystem, standard applikationer som f.eks. applikationsservere, databaseservere, java-versioner mm., angivet på version og service pack niveau.
Eksterne applikationer defineres som applikationer det kræver netværksadgang at tilgå, herunder også adgang til andre virtuelle miljøer residerende på samme hardware som komponenten.
Vejledningen skal tillige indeholde information om evt. konfiguration af standard applikationer og lign.
Footprint på hardware angives, dvs. mængden af RAM, harddisk, CPU, netværk osv. komponenten forventeligt anvender.

Krav til driftsmiljø

Krav til applikationsservere

Stamdata Komponenterne er udviklet og testet under JBoss AS7.1.1.Final.
Komponenterne kræver SUN/Oracle Java 6.0 eller højere.
Desuden skal Mysql Connector Driver 5.1.21 (mysql-connector-java-5.1.21-bin.jar) bruges.
For at installere driveren, skal der deployes et mysql-modul i JBoss. Det gøres ved at placere filen mysql-connector-java-5.1.21-bin.jar i <JBOSS_HOME>/modules/com/mysql/main.
I samme directory oprettes en fil module.xml med følgende indhold:
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.0" name="com.mysql">
<resources>
<resource-root path="mysql-connector-java-5.1.21.jar"/>
</resources>
<dependencies>
<module name="javax.api"/>
</dependencies>
</module> <?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.0" name="com.mysql">
<resources>
<resource-root path="mysql-connector-java-5.1.21.jar"/>
</resources>
<dependencies>
<module name="javax.api"/>
</dependencies>
</module>

Krav til operativsystem

Der stilles ingen krav til operativsystemet, ud over det åbenlyse krav om at Java er understøttet på operativsystemet. Ubuntu Linux bruges som operativsystem på NSP'en.

Krav til database

Komponenten er testet mod MySQL version 5.1.50, det er dog sandsynligt at komponenten vil fungere korrekt selv mod ældre MySQL versioner. Det er den samme MySQL version som bliver brugt på NSP platformen.

Krav til hardware

Der er nogle minimumskrav for at kunne afvikle komponenten fornuftigt til test formål. Dog skal man forvente at bruge high-end hardware (både cpu, ram, netkort & diske) for at kunne opfylde svartidskravene på NSP platformen.
Minimumskravene, for fornuftig performance på et test-setup er:

• Intel Core 2 eller lignende CPU
• 2 GB ram
• Nødvendig harddisk plads for at kunne håndtere alle registre (10+ GB)

Installation af Stamdata

Stamdata består af 1 DoDi komponent:

1. Stamdata Data Manager

og 3 NSP komponenter:

1. Kopi-Register-Servicen
2. Enkeltopslag i Autorisationsregisteret
3. Enkeltopslag i CPR-registeret

Installation af Stamdata Data Manager komponenter.

På DoDi'en skal deployes en komponent for hver importer.

Systemkrav

• Se specifikationen af DoDi platformen

Forberedelse af database og datasource

Log ind i database serveren og gør følgende:

• Opret en database med navn 'sdm_warehouse'.
• Load tabellerne fra filen db/schema.sql ind i databasen. F.eks. ved:

mysql -uroot -p -e "CREATE DATABASE sdm_warehouse"

• Opret bruger 'sdm4' som har følgende privilegier til 'sdm_warehouse' databasen: CREATE, DROP, ALTER, DELETE, INDEX, INSERT, SELECT, UPDATE.

Brugeren kan oprettes med følgende SQL-udtryk: GRANT CREATE, DROP, ALTER, DELETE, INDEX, INSERT, SELECT, UPDATE ON sdm_warehouse.* TO 'sdm4'@'localhost' identified by 'password' som i samme omgang opretter brugeren (med password "password") og tildeler de ønskede rettigheder.
Rettighederne udover INSERT,SELECT,UPDATE,DELETE benyttes af et library der ved opstart af komponenten automatisk installerer initielt skema og eventuelle skemaopdateringer ved opdatering af komponenten.

• Databasen skal replikeres vha. MySQL replikering som beskrevet i DoDi platform specifikationen. Derved kan NSP komponenterne få adgang til de samme tabeller.

I JBoss skal der oprettes en datasource, som komponenterne kan slå op ved hjælp af JNDI. Det kan (fx) gøres ved at logge ind på applikationsserveren og ved hjælp af jboss-cli.sh køre følgende:
/subsystem=datasources/jdbc-driver=mysql:add(driver-name="mysql",driver-module-name="com.mysql")
/subsystem=datasources/data-source="java:/SDMDS":add(jndi-name="java:/SDMDS",driver-name="mysql",connection-url="jdbc:mysql://localhost:3306/sdm_warehouse",user-name="sdm4", password="sdm4",min-pool-size=1,max-pool-size=5)

Installation af en komponent

I det følgende beskrives de generelle trin for at deploye én komponent. I stier osv., der er specifikke for hver komponent, bruges <komponent> som placeholder, så vejledningen angiver fx
<JBOSS_HOME>/modules/sdm4/config/<component>/main/module.xml
vil det under installationen af importeren "cprimporter" blive til den konkrete sti
<JBOSS_HOME>/modules/sdm4/config/cprimporter/main/module.xml

1. Opret et JBoss konfigurationsmodul ved at oprette følgende fil:

<JBOSS_HOME>/modules/sdm4/config/<component>/main/module.xml
Med følgende indhold
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.0" name="sdm4.config.<component>">
<resources>
<resource-root path="."/>
</resources>
</module>
I samme directory som module.xml-filen placeres

• En tom fil ved navn config.properties

• En konfigurationsfil til log-opsætning med fx følgende indhold: log4j.rootCategory=INFO, FILE log4j.logger.dk.nsi=INFO \\ log4j.appender.FILE=org.apache.log4j.RollingFileAppender log4j.appender.FILE.File=$\{jboss.server.log.dir\}/<komponent>.log log4j.appender.FILE.Append=true log4j.appender.FILE.MaxFileSize=100MB log4j.appender.FILE.MaxBackupIndex=10 log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern=%d \[%-2p\] %c - %m%n \\ \\

1. I konfigurationsfilen config.properties sættes nu følgende properties:

jdbc.JNDIName=<JNDI-navn på datasource opsat i applikationsserver>
(fx java:/SDMDS fra eksemplet ovenfor) sdm.dataDir=<rootdir for data til importeren>
(fx <JBOSS_HOME>/domain/data/sdm4)
sdm.stabilizationPeriod=<antal sekunder filer skal være uændret før de importeres>
(fx 10)

1. For at konfigurere SLA logging skal der oprettes to filer i samme directory som module.xml

\\
Følgende filer oprettes
nspslalog-sdm-<komponent>.properties
med eksempel-indhold:
nspslalog.log4j.configure=true
\\
log4j-nspslalog.properties
med eksempel-indhold:
log4j.appender.SLALOGFILE=org.apache.log4j.RollingFileAppender
log4j.appender.SLALOGFILE.File=$\{jboss.server.log.dir\}/<komponent>-sla.log
log4j.appender.SLALOGFILE.MaxFileSize=10MB
log4j.appender.SLALOGFILE.MaxBackupIndex=10
log4j.appender.SLALOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.SLALOGFILE.layout.ConversionPattern= \
%d\{dd-MM-yyyy HH:mm:ss,SSS\} \[%t\] %-5p %c - %m%n
log4j.logger.dk.sdsd.nsp.slalogdata=INFO, SLALOGFILE
\\

1. Deploy komponentens WAR-fil, fx ved at kopiere den til:

<JBOSS_HOME>/standalone/deployments
Der bør ikke komme fejlmeddelelser på ERROR-niveau i jboss's server.log.
NB. Komponenten skal ikke være udstillet til omverden. Altså firewall regler skal ikke tillade adgang til denne service.

1. Kør følgende

curl -I http://<host>:<port>/<komponent>/status
og kontroller at komponenten returnerer HTTP-kode 200.

Ændringslog

Kilden til dette dokument kan findes på:
https://svn.nspop.dk/svn/trifork/sdm4-core/trunk/doc/Installationsvejledning.docx