Skip to content
This repository has been archived by the owner on Apr 16, 2024. It is now read-only.

installatie

Mark Prins edited this page Feb 14, 2019 · 1 revision

Installatiehandleiding

Aanmaken databases

De configuratiedatabases voor de webapplicatie kunnen zowel op Postgres of Oracle draaien.

· prefix_datastorelinker

Draaien SQL scripts

In de database folder staan de benodigde sql scripts voor zowel Postgres als Oracle:

Oracle

Voor gebruik van Oracle als datastore of als configuratiedatabase is het nodig dat de Oracle JDBC driver is geinstalleerd. Download daartoe de juiste versie en plaats deze ergens in het Java CLASSPATH. Voor het selecteren van de juiste versie is deze pagina behulpzaam: https://github.com/B3Partners/brmo/wiki/Welke-jdbc-driver

Postgis

Voor gebruik van Postgis als datastore of als configuratiedatabase is het nodig dat de PostgreSQL JDBC driver is geinstalleerd. Download daartoe de juiste versie van https://jdbc.postgresql.org/download.html en plaats deze ergens in het Java CLASSPATH.

Voor Postgis geldt dat het bovengenoemde configuratiescript gedraaid moet worden tegen de database 'datastorelinker' die als owner de user 'datastorelinker' heeft:

Als user postgres:

createdb -O datastorelinker datastorelinker
psql -f schema_export-postgres.sql datastorelinker datastorelinker

Verder is het tijdens het opzetten handig om de volgende regels op te nemen in pg_hba.conf:

local   datastorelinker datastorelinker                         trust
host    datastorelinker datastorelinker 127.0.0.1/32            trust

In productie kan (moet) dat strenger ingeregeld worden.

Deploy webapplicaties

Datastorelinker vereist Java JDK versie 8.

  • datastorelinker

Het is voldoende om het datastore linker web archive (war) op de daartoe geeigende plek te plaatsen. Voor Tomcat is dat de webapps folder.

Verder met de instellingen

Nadat de database is aangemaakt en de webapplicatie is gedeployed kunnen de instellingen worden goedgezet door de bijbehorende bestanden aan te passen en de webapplicaties te herladen via de Tomcat Manager.

Standaard beheerder account

Na installatie is de standaard beheerder account als volgt:

  • gebruiker: beheerder
  • wachtwoord: beheerder

Hiermee kan worden ingelogd in de datastorelinker

WEB-INF/users.xml

Hierin staat het beheerder account. Het kan hier niet gewijzigd worden. Gebruikersbeheer gaat via het tabblad gebruikers in de web interface.

WEB-INF/web.xml

Hierin staan instellingen voor de webapplicatie. De url die verwijst naar kaartenbalie hoeft niet langer gebruikt te worden.

In dit bestand kan een smtp server worden geconfigureerd zodat datastorelinker het resultaat van ETL-processen kan mailen:

<context-param>
    <param-name>defaultSmtpHost</param-name>
    <param-value>kmail.b3partners.nl</param-value>
</context-param> 

Het is niet mogelijk een gebruikersnaam/ wachtwoord mee te geven. Het is daarom nodig een smtp server in te richten die de server waarop datastorelinker draait vertrouwd.

Indien hiervoor lokaal een SMTP-server wordt ingericht is het belangrijk te weten dat Datastorelinker lokaal niet vanaf localhost communiceert, maar met het IP-adres van de server. Die moet dus in de whitelist van de SMTP-server worden opgenomen. Denk er verder aan dat het defaultSmtpHost en defaultFromEmailAddress e-mail adres in WEB-INF/web.xml van datastorelinker de domeinnaam bevat waarvoor de SMTP-server is ingeregeld.

Opstarten

Ga naar de web interface van datastore linker. Probeer in te loggen met de gebruikersnaam-wachtwoord combi voor het beheerders account (standaard beheerder, beheerder). Er kunnen nu fouten optreden. Dan gewoon nog een keer inloggen en desnoods nog een keer inloggen.