Anchor
_Toc207425579 _Toc207425579

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.

Anchor
_Toc207425580 _Toc207425580

Krav til driftsmiljø

Anchor
_Toc295902103 _Toc295902103

Anchor
_Toc207425581 _Toc207425581

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>

Anchor
_Toc295902104 _Toc295902104

Anchor
_Toc207425582 _Toc207425582

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.

Anchor
_Toc295902105 _Toc295902105

Anchor
_Toc207425583 _Toc207425583

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.

Anchor
_Toc295902106 _Toc295902106

Anchor
_Toc207425584 _Toc207425584

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)

Anchor
_Toc207425585 _Toc207425585

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

Anchor
_Toc207425586 _Toc207425586

Installation af Stamdata Data Manager komponenter.

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

Anchor
_Toc207425587 _Toc207425587

Systemkrav

• Se specifikationen af DoDi platformen

Anchor
_Toc207425588 _Toc207425588

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)

Anchor
_Toc207425589 _Toc207425589

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

• Wiki Markup

  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.

Anchor
_Toc263424147 _Toc263424147

Anchor
_Toc207425590 _Toc207425590

Ændringslog

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