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.
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.
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.
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.
Voer het gedownloade bestand uit en de installatie begint.
Er wordt gevraagd waar het programma geïnstalleerd moet worden.
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.
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.
Behoud het standaard poortnummer.
De ‘Default locale’ is prima.
Alles is gereed om de installatie te beginnen.
Als het goed is, zal de installatie vlot verlopen.
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.
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.
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.
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.
Nu wordt gevraagd akkoord te gaan met de licentievoorwaarden.
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.
Hier wordt gevraagd waar de PostGIS uitbreiding geplaatst kan worden. We laten dit staan, mits dit klopt met de locatie van de PostgreSQL installatie.
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).
Nu wordt PostGIS geïnstalleerd. Dit verloopt redelijk vlot.
Het is afhankelijk van de toepassing van de database, voor het gemak wordt de vraag bevestigd met ‘Ja’.
Het is afhankelijk van de toepassing van de database, voor het gemak wordt de vraag bevestigd met ‘Ja’.
Het is afhankelijk van de toepassing van de database, voor het gemak wordt de vraag bevestigd met ‘Ja’.
De installatie van PostGIS is geslaagd en de database is aangemaakt.
De Stack Builder geeft aan dat alle aangevinkte uitbreidingen zijn geïnstalleerd.
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.
Nadat pgAdmin III is geopend, maak een verbinding (Connect) met de PostgreSQL server.
Voer het wachtwoord in dat behoort bij de gebruiker ‘postgres’.
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.
De nieuwe login krijgt de naam ‘basuser’. Natuurlijk kun je ook een andere naam kiezen.
Kies een wachtwoord voor deze login, vul deze twee keer in en onthoud deze. Sluit af met ‘OK’.
De PostgreSQL database server heeft nu twee logins.
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’. NB belangrijk is dat de database met de character-set UTF-8 wordt aangemaakt!
We noemen de database ‘bagdb’. Kies de zojuist gemaakte inlog ‘baguser’ als eigenaar van de database.
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’.
Kies in het scherm de uitbreiding ‘postgis’.
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’.
Kies als ‘Filename’ het eerder gedownloade bestand ‘bag-laatst.backup’ en kies als ‘Rolename’ de eerder aangemaakte login ‘basuser’.
De restore opties:
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.
Kies eventueel een ‘Refresh’ om de navigatiestructuur te verversen, zodat alle herstelde data zichtbaar wordt.
De database is klaar voor gebruik:
De data bevindt zich in het schema ‘bagactueel’. Houd hiermee rekening als je de BAG-data gebruikt in bijv. QGIS of een andere applicatie.