...

Introduktion

Vejledning Dette dokument giver en vejledning til installation og konfiguration af Napnap-reference-web og Napnap-reference-Facadefacade.

Formål

Formålet med dokumentet er, at man med dokumentet i hånden kan installere Nap-reference-web og NabNap-reference-Facade uden yderligere informationer.

Forudsætninger

Software requirementsKrav til software installeret:

...

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`.

Udviklingsprojekterne

Nap-reference-web og Nap-reference-facade ligger som repositories på svn.nspop.dk.

nap-reference-web
nap-reference-facade

Nap-reference-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

Start af projektet

nap-reference-web er Er en statisk service som ,  som hostes i NSPs wildfly8 Wildfly8 image.

Kør `docker-compose up` fra compose/test mappen, for at starte en wildfly server i docker på nap_net netværket.

Således vil Herefter er containeren være tilgængelig på http://localhost:4600/ samt http://localhost:8080/nap/reference/web/ hvis (https://svn.nspop.dk/svn/components/nap/nap-compose/) kører på samme netværk som en reverse proxy.

...

Servicen benytter sig af nap-angular-sdk og nap-typescript-sdk og er udviklet til at være indlejret i et værtssytem (eksempelvis nap-java-host), hvor den får alt sin kontekst.
Det meste funktionalitet er bundet op på denne kontekst og det skal derfor opsættes, for at få det fulde ud af nap-reference-web.

For opsætning af dette, skal nap-java-host, nap-lobby-web, samt nap-admin køres parallelt, og opsætning af det er yderligere beskrevet i NAP Platform services. 

Forbindelse til facade

Servicen benytter sig af nap-ref-facade som backend. Det er dog muligt at køre en konfiguration, hvor der det køres backend lessuden.

For at køre backendless skal `--configuration=mock` tilføjes startkommandoen i compose filen i  compose/development/.gøre dette, skal der rettes i command parameteren i docker-compose.yml i compose/development mappen.

command: npx ng serve --port 8080 --host 0.0.0.0 --disableHostCheck --public-host=localhost/nap/reference/web/

rettes til

command: npx ng serve --port 8080 --host 0.0.0.0 --disableHostCheck --public-host=localhost/nap/reference/web/ –-configuration=mock

Konfiguration

For at konfigurerer denne service skal en configurations.json fil, volume mappes til src/app/assets/.

...

Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne for loadbalanceren.

Nap-reference-facade

Krav til applikationsservere

...

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.

...

Ved konfigurationsændringer skal wildfly serveren genstartes.

Logfiler

Service kan logge kald til følgende logs:

• NSP-SLA-log
• Applikationslog

Servicen logger IKKE til audit log. 
Log er beskrevet i driftsvejledning.