Die AE-Datenbank einrichten - PostgreSQL
Dieses Thema führt Sie durch die notwendigen Schritte zum Einrichten einer PostgreSQL Datenbank für die Automation Engine.
Hinweise:
-
Sie können entweder eine grafische Oberfläche, wie z. B. pgAdmin, oder eine Kommandozeilenschnittstelle, wie z. B. psql, zur Installation von PostgreSQL verwenden.
-
Es wird empfohlen, Kleinbuchstaben zu verwenden, wenn Sie mit PostgreSQL arbeiten.
-
Es gibt eine Reihe von obligatorischen und empfohlenen Datenbankeinstellungen, die Ihnen helfen, Ihre Datenbank zu optimieren, um eine optimale Leistung zu erzielen. Weitere Informationen finden Sie unter Empfehlungen für PostgreSQL.
Wichtig! Sie müssen die Parameter vacuum_cost_limit = 10000 und shared_preload_libraries = pg_stat_statements setzen. Andernfalls wird die Datenbank nicht gestartet.
-
Die angegebenen SQL-Anweisungen können in die psql-Shell kopiert werden.
Diese Seite beinhaltet Folgendes:
Erforderlicher Speicherplatz
Der anfänglich benötige Datenbank-Speicherplatz, der für eine Automation Engine-Installation benötigt wird, hängt vom Typ und von der Größe des Systems ab:
-
Testsysteme: 1 GB
-
Produktionssysteme
-
Kleine Systeme: 5–20 GB
-
Mittlere Systeme: 20–50 GB
-
Große Systeme: > 50 GB
-
Weitere Informationen finden Sie unter Automic Automation Systemanforderungen und Dimensionierung.
Codepage-Einstellungen
Wichtig! Es wird empfohlen, PostgreSQL mit UTF8-Kodierung einzurichten und die LATIN1- oder LATIN9-Kodierung auf dem Mandanten zu verwenden. Die Kodierung, die Sie für die-Datenbank verwenden, hängt vom Zeichensatz ab, den Sie unterstützen müssen.
Stellen Sie außerdem sicher, dass der in XML_ENCODING in der Variablen UC_SYSTEM_SETTINGS definierte Zeichensatz mit dem Zeichensatz übereinstimmt, der auf der Client-Seite ausgewählt wurde. Weitere Informationen finden Sie unter XML_ENCODING.
So scheint beispielsweise LATIN9 (ISO8859-15) die bessere Wahl zu sein, da LATIN1 das Eurozeichen (€) nicht unterstützt.
Eine PostgreSQL-Datenbank einrichten
-
(DB Computer) Erstellen Sie einen Benutzer, der sich mit der Automation Engine verbindet, und legen Sie ein Passwort fest. Sie können den Benutzernamen frei definieren. Sie können auch doppelte Anführungszeichen verwenden, um zu verhindern, dass er automatisch in Kleinschreibung geändert wird, oder um Großschreibung oder CamelCase-Schreibweise zu verwenden. Sie müssen jedoch sicherstellen, dass der Benutzername während des gesamten Setup konsistent verwendet wird:
CREATE USER "[Benutzername]" WITH
LOGIN
PASSWORD '[Kennwort]'
CONNECTION LIMIT -1;
-
Erstellen Sie einen Ordner, in dem der Tablespace und der Index für die Automation Engine gespeichert werden.
-
Erstellen Sie die Tablespaces ae_data und ae_index unter diesen Namen und unter Verwendung des Pfades zu dem zuvor erstellten Ordner als Speicherort. Stellen Sie sicher, dass Ihr Benutzer über die erforderlichen Berechtigungen verfügt, um Tablespaces zu ändern:
CREATE TABLESPACE ae_data
OWNER postgres
LOCATION '[Verzeichnispfad]';
ALTER TABLESPACE ae_data
OWNER TO [Benutzername];
CREATE TABLESPACE ae_index
OWNER postgres
LOCATION '[Verzeichnispfad]';
ALTER TABLESPACE ae_index
OWNER TO [Benutzername];
Hinweise:
-
Es ist nicht möglich, die Registerkartelespace und den Index auf einmal anzulegen und zu ändern. Sie müssen sie nacheinander ausführen (anlegen und ändern).
-
Wenn Sie den Namen der Tablespaces (ae_data oder ae_index) ändern, müssen die Namen auch in der Installationsdatei UC_DDL.SQL und in der Datenbanktabelle UC_DBSYN geändert werden. Dasselbe gilt für jede Aktualisierung von AE.
-
Es wird empfohlen, nur die Tablespaces ae_data und ae_index zu verwenden. Andernfalls müssen Sie alle SQL-Dateien während des Aktualisierungsvorgangs manuell anpassen.
-
-
Erstellen Sie die neue Datenbank mit dem Benutzer, der für die Automation Engine erstellt wurde. Die Kodierung ist obligatorisch, und Ihre Datenbank muss die gleiche Kodierung wie der Client verwenden.
Wichtig: Stellen Sie sicher, dass Sie die Werte TEMPLATE, ENCODING, LC_COLLATE oder LC_CTYPE nicht ändern.
CREATE DATABASE [Datenbank]
WITH
OWNER = "[Benutzername]"
TEMPLATE = template0
ENCODING = 'UTF8'
TABLESPACE= ae_data
LC_COLLATE = 'C'
LC_CTYPE = 'C'
CONNECTION LIMIT = -1;
-
Legen Sie ein neues Schema für die Automation Engine an.
Wichtig! Wechseln Sie zur neu erstellten Datenbank, bevor Sie ein neues Schema erstellen.
CREATE SCHEMA [Schema]
AUTHORIZATION "[Benutzername]";
-
Fügen Sie den Standardsuchpfad zu Ihrem Benutzer hinzu.
ALTER ROLE "[Benutzername]" IN DATABASE [Datenbank]
SET search_path TO '[Schema]';
Hinweis: Verwenden Sie das folgende String-Format für die Verbindung mit der neuen Datenbank:
SQLDRIVERCONNECT=ODBCVAR=NNJNIORP,host=host01 port=5432 dbname=[Datenbank] user=[Benutzername] password=[Passwort] connect_timeout=10 client_encoding=[Kodierung]
Der String nach dem Komma ist ein Standard PostgreSQL Verbindungs-String.
Windows-Einrichtung
Die folgenden .dll-Dateien müssen dem bin-Ordner der Automation Engine und der Dienstprogramme hinzugefügt oder in den Windows-Pfad aufgenommen werden:
-
libpq.dll
-
ssleay32.dll
-
libeay32.dll
Zusätzlich für PostgreSQL-Versionen unter 11.0:
-
libintl-8.dll
-
libiconv-2.dll
Diese Dateien sind Teil des psqlodbc-Pakets und können von https://www.postgresql.org/ftp/odbc/versions/dll/heruntergeladen werden. Stellen Sie sicher, dass Sie die aktuellste Version für Ihre PostgreSQL-Installation verwenden.
UNIX
Stellen Sie sicher, dass ein PostgreSQL-Mandant installiert ist.
Installationsbeispiel
Das folgende Beispiel zeigt den Installations- und Verbindungs-String einer Datenbank mit den folgenden Parametern:
-
Benutzer: automic
-
Passwort: 1
-
Speicherort: C:\pg, C:\pg2
-
Datenbank: aedb
-
Schema: dbo
CREATE USER "automic" WITH
LOGIN
PASSWORD '1'
CONNECTION LIMIT -1;
CREATE TABLESPACE ae_data
OWNER postgres
LOCATION 'C:\pg';
ALTER TABLESPACE ae_data
OWNER TO automic;
CREATE TABLESPACE ae_index
OWNER postgres
LOCATION 'C:\pg2';
ALTER TABLESPACE ae_index
OWNER TO automic;
CREATE DATABASE aedb
WITH
OWNER = "automic"
TEMPLATE = template0
ENCODING = 'UTF8'
TABLESPACE = ae_data
LC_COLLATE = 'C'
LC_CTYPE = 'C'
CONNECTION LIMIT = -1;
--Wechseln Sie zur neu erstellten Datenbank, bevor Sie ein neues Schema erstellen.
CREATE SCHEMA dbo
AUTHORIZATION "automic";
ALTER ROLE "automic" IN DATABASE aedb
SET search_path TO 'dbo';
SQLDRIVERCONNECT=ODBCVAR=NNJNIORP,host=host01 port=5432 dbname=aedb user=automic password=1 connect_timeout=10 client_encoding=LATIN9
Siehe auch: