Instructie (Windows - GUI)

Deze beschrijving is een voorbeeldinstructie om de benodigde software te installeren en daarbij tevens een database dump terug te zetten (te restoren). Het voorbeeld hier beschreven is voor de BAG PostGIS download, maar zal hetzelfde zijn voor andere NLExtract downloads, zoals de BGT en de BRK. Met dank aan Geert Doornbos voor opstellen van deze instructie.

We beschrijven de volgende stappen:



Database Dump Downloaden

Maak een nieuwe map met bijvoorbeeld de naam ‘NLExtract’. Dit is gewoon een locatie om de dumps die gedownload worden te bewaren.

lege map aanmaken

Ga naar de pagina (zoals beschreven in NLExtract Download Service) waar de gewenste database dump gekozen kan worden. In deze instructie kiezen we de BAG database.

dump downloaden

Kies ‘link opslaan als’ op ‘bag-laatst.backup’ via het contextmenu (rechter muisknop) en plaats het bestand in de zojuist gemaakte map ‘NLExtract’. Afhankelijk van de netwerkverbinding kan dit even duren, want het bestand is groter dan 2 GB.

dump gedownload

Je kunt eventueel bag-amstelveen.backup downloaden om te testen met een kleiner bestand.



PostgreSQL Installeren

Ga naar de PostgreSQL website en klik door naar de download pagina van EnterpriseDB. We kiezen hier het installatieprogramma (32 of 64 bit - zie <Win>+<Break>) voor de meest recente en stabiele versie, in dit geval 9.5.3.

PostgreSQL downloaden

Voer het gedownloade bestand uit en de installatie begint.

start installatie postgresql

Er wordt gevraagd waar het programma geïnstalleerd moet worden.

program files

Daarna wordt gevraagd welke map gekozen kan worden voor data (databases). Er wordt voorgesteld om een data map in de ‘Program Files’ map te gebruiken voor opslag van data. Dat is ongebruikelijk; beter is het om data van programmabestanden te scheiden. We kiezen een eigen map.

data files

Kies een wachtwoord voor de hoofdgebruiker ‘postgres’ en onthoud deze. De gebruikersnaam ‘postgres’ en het wachtwoord vormen de combinatie om op een later tijdstip toegang tot PostgreSQL te krijgen.

hoofdgebruiker password

Behoud het standaard poortnummer.

standard port number

De ‘Default locale’ is prima.

default locale

Alles is gereed om de installatie te beginnen.

start install

Als het goed is, zal de installatie vlot verlopen.

fast install

Nu is PostgreSQL geïnstalleerd. Het laatste scherm biedt de mogelijkheid om uitbreidingen toe te voegen. We laten het vinkje voor de Stack Builder aan staan, zodat we PostGIS kunnen installeren. Dit wordt hierna beschreven.

extensions


PostGIS Installeren

PostGIS is de uitbreiding op PostgreSQL die het mogelijk maakt om data met geometrische / geografische gegevens op te slaan en te verwerken.

We zien het beginscherm van de Application Stack Builder, dat in navolging op de PostgreSQL wordt uitgevoerd. Eventueel kan deze ook handmatig worden gestart.

Kies in het keuzemenu de PostgreSQL server.

stack builder

Kies in het volgende scherm de benodigde PostGIS bundle door een vinkje te plaatsen. Kies de bundle die bij de PostgreSQL installatie past. In deze instructie is dat 64 bit, PostgreSQL versie 9.5.

alternate text

Stack builder vraagt waar de gedownloade uitbreidingen geplaatst mogen worden. In deze instructie kiezen we voor de standaard map met de naam ‘downloads’ (waar alle downloads gebruikelijk toch al in komen). Een andere map zou ook prima moeten werken; het is bedoeld om tijdelijk te gebruiken.

alternate text

Nu wordt gevraagd akkoord te gaan met de licentievoorwaarden.

alternate text

Voor het gemak vinken we de keuze ‘Create spatial database’ aan. Het is in deze instructie de bedoeling om direct een database aan te maken die kan dienen om de dump (back-up) terug te zetten. Het kan uiteraard ook op een later moment, bijv. wanneer je een tweede database dump wilt terugzetten.

alternate text

Hier wordt gevraagd waar de PostGIS uitbreiding geplaatst kan worden. We laten dit staan, mits dit klopt met de locatie van de PostgreSQL installatie.

alternate text

Op het volgende scherm wordt de gebruikersnaam en het wachtwoord gevraagd. Hiermee krijgt het installatieprogramma toegang tot PostgreSQL en kan een database worden aangemaakt (daar hadden we immers voor gekozen).

alternate text

Nu wordt PostGIS geïnstalleerd. Dit verloopt redelijk vlot.

alternate text

Het is afhankelijk van de toepassing van de database, voor het gemak wordt de vraag bevestigd met ‘Ja’.

alternate text

Het is afhankelijk van de toepassing van de database, voor het gemak wordt de vraag bevestigd met ‘Ja’.

alternate text

Het is afhankelijk van de toepassing van de database, voor het gemak wordt de vraag bevestigd met ‘Ja’.

alternate text

De installatie van PostGIS is geslaagd en de database is aangemaakt.

alternate text

De Stack Builder geeft aan dat alle aangevinkte uitbreidingen zijn geïnstalleerd.

alternate text


PgAdmin III - BAG login toevoegen

De tool pgAdmin III is geïnstalleerd tijdens de installatie van PostgreSQL. Zoek deze op in het menu (of druk op de Windows toets en type ‘pgadmin’) en start het programma.

alternate text

Nadat pgAdmin III is geopend, maak een verbinding (Connect) met de PostgreSQL server.

alternate text

Voer het wachtwoord in dat behoort bij de gebruiker ‘postgres’.

alternate text

Maak een nieuwe ‘login’ aan. Dit is een gebruiker van de database. Het is de bedoeling om een login te hebben die past bij de terug te zetten database dump, zoals in deze instructie staat beschreven.

alternate text

De nieuwe login krijgt de naam ‘basuser’. Natuurlijk kun je ook een andere naam kiezen.

alternate text

Kies een wachtwoord voor deze login, vul deze twee keer in en onthoud deze. Sluit af met ‘OK’.

alternate text

De PostgreSQL database server heeft nu twee logins.

alternate text


PgAdmin III - BAG database aanmaken

De BAG database aanmaken omvat twee stappen, namelijk een PostgreSQL database aanmaken en een PostGIS uitbreiding toevoegen aan de database. Open voor het aanmaken van een nieuwe database het contextmenu (rechter muisknop) op ‘Databases’ en kies ‘New Database’.

alternate text

We noemen de database ‘bagdb’. Kies de zojuist gemaakte inlog ‘baguser’ als eigenaar van de database.

alternate text

Er is nu een nieuwe database aangemaakt, echter bevat deze nog geen PostGIS mogelijkheden. Hiervoor gaan we een uitbreiding toevoegen aan de database. Kies ‘New Extension’ in het contextmenu (rechter muisknop) op ‘Extensions’, binnen de database ‘bagdb’.

alternate text

Kies in het scherm de uitbreiding ‘postgis’.

postgis extension postgis extension public schema

Klik op ‘OK’ en de uitbreiding ‘postgis’ zal zichtbaar worden.



PgAdmin III - BAG dump terugzetten

Kies optie ‘Restore’ middels het contextmenu (rechter muisknop) op de zojuiste gemaakte database ‘bagdb’.

alternate text

Kies als ‘Filename’ het eerder gedownloade bestand ‘bag-laatst.backup’ en kies als ‘Rolename’ de eerder aangemaakte login ‘basuser’.

alternate text

De restore opties:

alternate text

Kies ‘Restore’ en het terugzetten van de dump zal beginnen.

Nu is het herstelproces van de BAG database begonnen. Dit kan, afhankelijk van de capaciteit van de computer, enige tijd in beslag nemen (kwartier/half uur). Aan het eind moet ‘Proces returned exit code 0’ zichtbaar zijn, dat aangeeft dat het terugzetten gelukt is.

restore process

Kies eventueel een ‘Refresh’ om de navigatiestructuur te verversen, zodat alle herstelde data zichtbaar wordt.

refresh

De database is klaar voor gebruik:

pgAdmin restore complete

De data bevindt zich in het schema ‘bagactueel’. Houd hiermee rekening als je de BAG-data gebruikt in bijv. QGIS of een andere applicatie.



comments powered by Disqus