updated:  2024 10. July
published:  2023 29. March

Installation AKS

und der benötigten Software - PostgreSQL und PostGIS.

Der Betrieb der Kaufpreissammlung AKS-Niedersachsen umfaßt die folgenden Komponenten:

  • PostgreSQL - ein Datenbankmanager
  • PostGIS - eine Erweiterung für PostgreSQL zur Speicherung und Verwaltung von Geodaten
  • AKS-Niedersachsen

PostgreSQL

PostgreSQL 1 ist ein freies, objektrelationales Datenbankmanagementsystem. Für Windows werden Installationsroutine bei EDB zum Download 2 angeboten.

Lade dir die Installation z.B. die Version-15.5.1 3 (oder Version-15.3.3 4) für Windows herunter. Starte die Installationsroutine als Administrator. Vergebe ein Paßwort - einfach postgres. Entferne bei der Auswahl der Komponenten den Haken bei Stack Builder und pgAdmin 4. Mit dem Stack Builder wird das dazugehörige PostGIS über die Installationsroutine aus dem Internet nachgeladen und gleichzeitig installiert. Dieser Vorgang erübrigt sich, wenn PostGIS, wie in diesem Tutorial beschrieben, von “Hand” nachinstalliert wird. Die automatisierte Installation von PostGIS über den Stack Builder kann zu Fehlermeldungen führen. Hintergrund ist die weiter unten genannte Datei pg_hba.conf.

pgAdmin4

Das Administrationstool pgadmin4 ist ein Frontend mit graphischem Benutzerinterface für PostgreSQL Datenbanken. Im Prinzip ist es im Installationspacket von PostgreSQL dabei. Eine aktuellere Version bietet die Projektseite von pgAmin4 5. Nach der Installation wird das Programm mit pgAdmin4.exe gestartet.

Dienst starten

Bei PostgreSQL handelt es sich um eine Server-Client-Datenbank. Das heißt, die Datenbank liegt auf einem PC (Server) und andere PC’s (Client’s) können auf diese Datenbank zugreifen. Um abfragen der Client’s an den Server zu erhalten, muss ein sog. Dienst gestartet werden. Beim Einrichten von PostgreSQL und insbesondere beim Start des Management-Tool pgAdmin4.exe wird automatisch der entsprechende Dienst gestartet. Sollte das nicht erfolgt sein, dann kann der Dienst von “Hand” gestartet werden.

In Windows werden Dienste durch das Programm services.msc verwaltet. Nach dem Start des Programms mit Administratorrechten wird in der Spalte Name der Dienst postgresql-x64-15 selektiert und gestartet. Der Starttyp sollte auf Automatisch gestellt werden.

 Dienst starten: postgresql-x64-15 

Um den Dienst auf der Kommandokonsole von Windows zu prüfen, zu starten und zu stopen, mach folgendes:

cmd.exe 

 # 1. Vollständigen Dienstnamen ermitteln 
 sc query state=all | find "postgre"
 
 # 2. Informationen des Dienstes ausgeben (vollständiger Name erforderlich)
 sc query   postgresql-x64-15
 sc queryex postgresql-x64-15
 
 # 3. Status checken
 sc query   postgresql-x64-15 | find /I "state"

 # 4. Stop, Start nur als Administrator
 sc stop    postgresql-x64-15
 sc start   postgresql-x64-15

PostGIS

PostGIS 6 ist eine räumliche Datenbankerweiterung und baut auf PostgreSQL auf. Für das installierte PostgreSQL in der Version 15 muss auch die entsprechende PostGIS Version installiert werden. Der Direktlink 7 führt zum Download der entsprechenden PostGIS Version.

Vorbereitung der Installation

Vor der Installation von PostGIS muss die Datei pg_hba.conf geändert werden. Die Datei befindet sich im Installationsverzeichnis von PostgreSQL in: c:\Program Files\PostgreSQL\<Versionsnummer>\data. Die Zeilen unterhalb von # IPv4 local connections: wird vom Wert scram-sha-256 auf den Wert trust geändert. Hintergrund ist, dass AKS über die lokale IP4-Adresse (127.0.0.1/32) eine Verbindung zur PostGIS Datenbank aufbaut und der lokalen IP an sich vertraut werden kann.

File: pg_hba.conf 

 # TYPE  DATABASE        USER            ADDRESS                 METHOD

 # "local" is for Unix domain socket connections only
 local   all             all                                     scram-sha-256
 # IPv4 local connections:
 host    all             all             127.0.0.1/32            trust
 # IPv6 local connections:
 host    all             all             ::1/128                 scram-sha-256
 # Allow replication connections from localhost, by a user with the
 # replication privilege.
 local   replication     all                                     scram-sha-256
 host    replication     all             127.0.0.1/32            scram-sha-256
 host    replication     all             ::1/128                 scram-sha-256

Nach den Änderungen kann die Installation von PostGIS mit Administratorrechten erfolgen. Als Komponente sollte Create spatial database gewählt werden und als Paßwort ist das bei der Installation von PostgreSQL eingerichtete postgres einzugeben.

Alle darauf folgenden Meldungen und Informationen können mit “ja” oder “ok” bestätigt werden.

Database einrichten

Sind PostgreSQL und PostGIS installiert, kann die Datenbank eingerichtet werden. Dazu wird das Administrationstool von PostgreSQL in pgAdmin4.exe gestartet. Beim Start wird nach dem zuvor vergebenen Paßwort postgres gefragt.

 Admin-Tool - Paßwort: postgres 

Verbindung fehlgeschlagen

Nach der Eingabe des Paßwortes kann die Verbindung aus unterschiedlichsten Gründen fehlschlagen.

Liegt ein Authentifizierungsproblem vor, dann könnte das Problem an der Datei pg_hba.conf liegen (siehe oben).
 Authentifizierungsfehler 
Bei einem Timeout-Fehler ist vermutlich der PostgreSQL-Dienst im System nicht gestartet.
 Timeoutfehler 

Benutzer anlegen

Im Administrationtool von PostgreSQL pgAdmin4.exe wird als erstes ein neuer Benutzer aksuser angelegt. Mit der linken Maustaste wird der entsprechende Zweig «Object Explorer: Servers → PostgreSQL → Login Group Role...» selektiert und mit der rechten Maustaste öffnet sich das Untermenu «Menu: Create → Login Group Role...».

Wichtig: Der Benutzer muß alle Berechtigungen bekommen «Reiter: Privileges».

Datenbank anlegen

Als nächstes wird die Datenbank akstest im Zweig «Object Explorer: Server → PostgreSQL → Database» angelegt.

 1. Create Database... 
 2. Name der Datenbank - akstest 
 3. Template: postgis_33_sample 
Wichtig: Das Template postgis_33_sample im «Reiter: Definition» zu wählen.

Installation AKS

Packe die vom Hersteller aktuell zur Verfügung gestellte Version des Programm (Zip-Datei) in einem Verzeichnis aus. Dazu wird ein Paßwort benötigt, das ebenfalls vom Hersteller zu erfahren ist. Nach dem auspacken stehen zwei Dateien bereit. Eine weitere Zip-Datei aks<Version>nb.zip und eine Installationsdatei aks<Version>XXX_install.exe. Starte die Installationsdatei als Administrator. Soweit keine Fehlermeldungen auftauchen, können alle weiteren Meldungen mit OK oder Weiter bestätigt werden.

Fehlende Dateien kopieren

Bevor die AKS-Datenbank angelegt werden kann, sind ein paar fehlende SQL-Dateien in das Verzeichnis C:\Program Files (x86)\AKS\sqls zu kopieren. Diese Dateien sind:
wallgem_pxr.sql
wplzgeo.sql
wsubkre.sql

Die Dateien sind vom Hersteller zu beziehen oder von hier: aks-fehlende-sqls.zip 8 ( md5 )

AKS-Datenbank Verbindung herstellen

WICHTIG: Nach eigener Erfahrung bitte nicht als erstes die Datei aks.exe starten, sondern die Datei dbeinrichten.exe im Installationsverzeichnis von AKS C:\Program Files (x86)\AKS.

Mit dem Programm dbeinrichten.exe wird eine Verbindung zu einer existierenden PostgreSQL Datenbank hergestellt, eine neue Datenbank für AKS vorbereitet und mit Standardwerten aus PostGIS gefüllt. Der Start des Programms dbeinrichten.exe ist abhängig von der Existenz der Datei aksniwis.properties.

a) Die Datei aksniwis.properties existiert nicht. Es öffnet sich das Fenster zur Anmeldung an das Datenbanksystem.

b) Die Datei aksniwis.properties existiert bereits auf dem System, dann startet das Programm dbeinrichten.exe mit dem Fenster AKS-Programmverwaltung. Durch den Schalter Die Datenbank-Verbindung einrichten, gelangt man ebenfalls zur Anmeldung an das Datenbanksystem.

Im Fenster Anmeldung an das Datenbanksystem werden die oben dargestellten Werte eingetragen. Das Kennwortfeld ist laut AKS-Handbuch vorbelegt und kann leer bleiben. Für einen ersten Test wird der Schalter Test DB-Verbindung aktiviert. Eine Meldung zeigt die erfolgreiche Verbindung an. Danach wird Start aktiviert und das Fenster mit Ende geschlossen.

 Verbindung erfolgreich 

Erscheint die o.g. Meldung nicht, dann liegt vermutlich ein Problem der Datei C:\Program Files(x86)\aksniwis.properties vor. Einfach alle Dateien mit diesem Namen im System löschen und das Programm dbeinrichten.exe neu starten.

Hinweis: Unter Umständen kann es vorkommen, dass das Fenster nicht mehr auf Mauseingaben reagiert. Der Grund dafür ist, dass sich ein kleineres Meldungsfenster hinter dem vordergründigen Fenster geöffnet hat und nun verdeckt wird. Durch die Tastenkombination [Alt]+[Tabulatortaste] kann das kleinere Meldungsfenster in den Vordergrund gebracht werden. Eine andere Möglichkeit ist es, das Fenster vorab auf eine andere Position zu schieben.

Verbindungsfehler: Wenn die Verbindung fehlschlägt und mit der Fehlermeldung ... requested SCRAM-based authentication ... abbricht, dann muss die Datei pg_hba.conf geändert werden (siehe oben).

AKS-Datenbank anlegen

Nach der erfolgreichen Verbinung von AKS zum Datenbankmanager PostGIS, bzw. PostgreSQL, kann eine neue AKS-Datenbank erstellt werden. Das Programm dbeinrichten.exe wird gestartet und der Schalter Eine neue AKS-Datenbank anlegen getätigt.

Um das Länderkennzeichen und die Nummer des Bezirks zu ändern muss der Schalter Entsperren getätigt werden. Das Länderkennzeichen kann dem amtlichen Regionalschlüssel 9 entnommen werden.

Beispiel Regionalschlüssel
LK Bezirk Beschreibung
03 1 Niedersachsen, Region Braunschweig
03 2 Niedersachsen, Region Hannover
06 4 Hessen, Reg.-Bez. Darmstadt
06 5 Hessen, Reg.-Bez. Gießen
09 1 Bayern, Oberbayern
09 2 Bayern, Niederbayern
09 3 Bayern, Oberpfalz
09 4 Bayern, Oberfranken
09 5 Bayern, Mittelfranken

Der Schalter Tabelle für neue Datenbank anlegen generiert die PostGIS/PostgreSQL Datenbank für AKS. Das Protokoll steht unter: C:/Users/<UserName>/AppData/Local/Temp/aks/tabellenanlegen_ed.prt und sollte keine Fehlermeldung oder die Information über fehlende SQL-Dateien (siehe oben) aufweisen.

Geschäftsstellennummer ändern

Ist die Datenbank angelegt, kann optional die Geschäftsstellennummer geändert werden. Voreingestellt ist 100. Nach Angaben des Herstellers ist die Geschäftsstellennummer in der Datenbank in den Feldern mit Kauffallkennzeichen, Auftragskennzeichen, Gebietsnummern und Selektionsanweisungen (SQL) eingebunden. Für das Ändern der Geschäftsstellennummer wird eine Ausführungskennung benötigt, die vom Hersteller bezogen werden kann (Email v. 11.07.2023).

Hinweis: Eine Änderung der Geschäftstellennummer bewirkt auch eine Änderung im «AKS-Hauptmenu: Geschäftsstellendaten → Geschäftsstelle → Kenndaten → Reiter Einstellungen» in den Feldern Nummer der Geschäftsstelle, Nummer der zugehörigen Behörde und Gutachterausschusschlüssel (BW).

Die Ausführungskennung wird ebenfalls benötigt im: «AKS-Hauptmenu:  Programmverwaltung → Verwaltung → System‍-‍Programme → Bereinigungs‍-‍Funktionen»

AKS Einrichten

Das Programm wird aus dem Installationsverzeichnis C:\Program Files(x86)\AKS\aks.exe oder durch das Desktopsympol AKS gestartet.

Geschäftsstellendaten einrichten

Im «AKS-Hauptmenu: Geschäftsstellendaten → Geschäftsstelle → Kenndaten» werden die Daten zur Geschäftstelle eingeben. Alternativ kann das Programm C:\Program Files(x86)\AKS\geschaeftsstelle.exe gestartet werden.

Hinweis: Einige Felder werden durch den Schalter Entsperren nicht entsperrt. Das ist insbesondere bei der Länderkennung der Fall (siehe oben). Die Taste [F9] oder die Tastenkombination [Alt Gr] + [w] entsperrt die entsprechenden Felder.

Für den GAA im Landkreis Hof werden folgende Geschäftsstellendaten eingeben:

 Bezeichnung und Adresse 
 Zuständigkeitsbereich 
 Einstellungen 

Fehlende Verzeichnisspfade einstellen

Im «AKS-Hauptmenu - Programmverwaltung:  Verwaltung → Verwaltungsfunktionen → Lokale Einstellungen» werden insbesondere die Verzeichnisse für AKS eingestellt. Alternativ kann das Progamm aksadmin.exe gestartet werden.

Die Verzeichnisse für Web-Browser und PDF-Reader sind je nach Windows Version z.B. in:
Browser:        C:\Windows\SystemApps\Microsoft.MicrosoftEdge_8wekyb3d8bbwe\MicrosoftEdge.exe
Browser:        C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe
PDF-Reader: C:\Windows\SystemApps\Microsoft.MicrosoftEdge_8wekyb3d8bbwe\MicrosoftPdfReader.exe
PDF-Reader: C:\Program Files (x86)\Adobe\Acrobat Reader DC\Reader\AcroRd32.exe
PDF-Reader: C:/Program Files/Adobe/Acrobat DC/Acrobat/Acrobat.exe
Fotoverzeichnis

Das Fotoverzeichnis wird im «AKS-Hauptmenu - Programmverwaltung:  Verwaltung → Verwaltungsfunktionen → Allgemeine Einstellungen» eingestellt.

  1. https://www.postgresql.org/  ↩︎

  2. https://www.enterprisedb.com/downloads/postgres-postgresql-downloads  ↩︎

  3. Download PostgreSQL 15.5.1 - https://sbp.enterprisedb.com/getfile.jsp?fileid=1258790  ↩︎

  4. Download PostgreSQL 15.3.3 - https://sbp.enterprisedb.com/getfile.jsp?fileid=1258631  ↩︎

  5. https://www.pgadmin.org  ↩︎

  6. https://postgis.net/  ↩︎

  7. https://download.osgeo.org/postgis/windows/pg15/  ↩︎

  8. https://www.vermessungsprogramme.de/download/aks-fehlende-sqls.zip  ↩︎

  9. https://www.destatis.de/DE/Themen/Laender-Regionen/Regionales/Gemeindeverzeichnis/_inhalt.html  ↩︎

Stichworte (tags)