Page History
Navitabs | ||||
---|---|---|---|---|
| ||||
Table of Contents |
---|
Introduktion
Vejledning til installation og konfiguration af NAP Platformen.
Formål
Formålet med dokumentet er, at man med dokumentet i hånden kan installere NAP Platformen uden yderligere informationer.
Dokumentet rummer guides til installation af de enkelt delkomponenter af nap-platformen.
Forudsætninger
Software requirements:
Software | Version |
---|---|
Java | 8 og 13 |
Docker | Gerne nyeste |
node | 10+ |
Det lokale udviklingsmiljø er opsat med docker-compose.
For at kunne køre de compose filer, der bliver beskrevet nedenfor kræves et docker netværk kaldet nap_net. Hvis dette ikke allerede er lavet kør `docker network create nap_net`
nap-admin-web
Krav til applikationsservere
Komponenten er udviklet og testet under WildFly-8.2.0.Final på udviklingsplatformen. Servicen kan deployes i produktion på Wildfly-8.2.0.Final applikationsservere.
Installation
Er en statisk service som hostes i NSPs wildfly8 image.
Kør `docker-compose up` fra compose/test for at starte en wildfly server i docker på nap_net netværket.
Således vil containeren være tilgængelig på http://localhost:4500/ samt http://localhost:8080/nap/admin/web/ hvis (https://svn.nspop.dk/svn/components/nap/nap-compose/) kører på samme netværk som en reverse proxy.
Krav til adgang til andre services
Forbindelse til nap-admin
Servicen benytter sig af nap-admin som backend, og denne skal være tilgængelig på den nedenstående konfigurerbare serverurl.
2.4. Konfiguration
For at konfigurerer denne service skal en configurations.json fil volume mappes til pack/webapp/assets/.
Key | Value |
---|---|
projectsEndpoint | Endpoint mapping |
ServerUrl | Relative path til nap-reference-facade |
Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.
nap-lobby-web
Krav til applikationsservere
Komponenten er udviklet og testet under WildFly-8.2.0.Final på udviklingsplatformen. Servicen kan deployes i produktion på Wildfly-8.2.0.Final applikationsservere.
Installation
Er en statisk service som hostes i NSPs wildfly8 image.
Kør `docker-compose up` fra compose/test for at starte en wildfly server i docker på nap_net netværket.
Således vil containeren være tilgængelig på http://localhost:4200/ samt http://localhost:8080/nap/lobby/web/ hvis (https://svn.nspop.dk/svn/components/nap/nap-compose/) kører på samme netværk som en reverse proxy.
Det er denne url der åbnes i nap-java-host
Krav til adgang til andre services
2.3.1. Framing
Servicen benytter sig af nap-angular-sdk og nap-typescript-sdk og er udviklet til at være indlejret i et nap-java-host eller et andet host system, hvor den får alt sin kontekst.
Det meste funktionalitet er bundet op på denne kontekst.
Forbindelse til nap-admin
Servicen benytter sig af nap-admin som backend, og denne skal være tilgængelig på den nedenstående konfigurerbare serverurl.
Konfiguration
For at konfigurerer denne service skal en configurations.json fil volume mappes til pack/webapp/assets/.
Key | Value |
---|---|
projectsEndpoint | Endpoint mapping |
ServerUrl | Relative path til nap-reference-facade |
Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.
nap-test-web
Krav til applikationsservere
Komponenten er udviklet og testet under WildFly-8.2.0.Final på udviklingsplatformen. Service kan deployes i produktion på Wildfly-8.2.0.Final applikationsservere.
Installation
Er en statisk service som hostes i NSPs wildfly8 image.
Kør `docker-compose up` fra compose/test for at starte en wildfly server i docker på nap_net netværket.
Således vil containeren være tilgængelig på http://localhost:4300/ samt http://localhost:8080/nap/test/web/ hvis (https://svn.nspop.dk/svn/components/nap/nap-compose/) kører på samme netværk som en reverse proxy.
nap-administration
Krav til applikationsservere
Komponenterne er udviklet og testet under WildFly-8.2.0.Final på udviklingsplatformen. Servicen kan deployes i produktion på Wildfly-8.2.0.Final applikationsservere.
Krav til adgang til andre services
Servicen benytter sig af dokumentdelingsservicen og det er et krav, at denne kan nåes på den url, der er specificeret i properties.
Det er et krav for at køre tests, at dokumentsdelingsservicen på test2 kan køres.
Installation
Kør `docker-compose up` fra compose/test for at starte en wildfly server i docker på nap_net netværket.
Konfiguration
Alt konfiguration foregår ved at loade filer fra wildfly modulet dk.sds.nsp.nap.reference.facade.
De følgende konfigurationsfiler skal således volume mappes ind i modulet "dk/sds/nsp/nap/admin/main/" på applikations serveren (/pack/wildfly8/modules/ i docker).
Konfigurationsfiler | |
---|---|
Filnavn | Indhold |
nap-admin-compose-ds.xml | Datasource beskrivelse. <datasources xmlns="http://www.jboss.org/ironjacamar/schema" |
log4j-napadmin.xml | log4j konfiguration |
nap.jks | JKS fil indeholdende NAP certifikat til audience /nap |
nap-admin.properties | # Path to the service provider certificate |
trusted-sts-certs.jks | JKS fil med certifikater fra STS providers. |
Disse filer bliver loadet ind på classpath når applikationen deployes.
Ved konfigurationsændringer skal wildfly serveren genstartes.
nap-host-java
MANGLER INFORMATION HER
installere den fil, der passer til dit styre system fra www.nsp.dk.
Forbindelse til nap-admin og nap-Lobby
Servicen benytter sig af nap-admin og nap-lobby enten lokalt eller på test1.