Update Tool

Das Update-Tool wurde überarbeitet. In den folgenden Abschnitten finden Sie einen Überblick über die wichtigsten Änderungen. Weitere Informationen finden Sie unter Update Tool.

Datenbank aktualisieren

X4 BPMS verwendet eine Datenbank und benötigt eine Datenbankverbindung über JDBC.

Neue Datenbank einrichten

Für die Verbindung werden folgende Angaben benötigt:

• JDBC-URL (z. B. jdbc:postgres:…)

• Datenbankbenutzer

• Passwort

Die JDBC-URL ist datenbankspezifisch und muss auf das korrekte Schema für X4 verweisen.

Datenbank vorbereiten

Die im Folgenden angegebenen Anweisungen für PostgreSQL, SQL Server und Oracle können zum Einrichten der Datenbank verwendet werden.

In den Anweisungen werden folgende Platzhalter verwendet:

• ${schemaName}: Name des Schemas für die X4-Tabellen (z. B. X4SERVER)

• ${databaseName}: Name der Datenbank (für SQL Server)

• ${userName}: Benutzername

• ${userPassword}: Passwort des Benutzers

PostgreSQL

CREATE USER ${userName} WITH PASSWORD '${userPassword}';
CREATE SCHEMA ${schemaName} AUTHORIZATION ${userName};
-- Grant privileges
GRANT CONNECT ON DATABASE ${databaseName} TO ${userName};
GRANT USAGE ON SCHEMA ${schemaName} TO ${userName};
GRANT CREATE ON SCHEMA ${schemaName} TO ${userName};
ALTER USER ${userName} SET search_path TO ${schemaName}, public;

Nachdem die Datenbank erfolgreich erstellt wurde, kann mit folgender JDBC-URL eine Verbindung zur Datenbank hergestellt werden:

jdbc:postgresql://<host>:5432/${databaseName}

SQL Server

-- Switch to master database to create the server login
USE "master";
CREATE LOGIN ${userName}
  WITH PASSWORD = '${userPassword}',
       DEFAULT_DATABASE = ${databaseName},
       CHECK_EXPIRATION=OFF,
       CHECK_POLICY=OFF;
-- Switch to X4 database and create a user mapped to the login
USE ${databaseName};
-- optional: create a schema if it does not exist
CREATE SCHEMA ${schemaName};
CREATE USER ${userName}
   FOR LOGIN ${userName}
  WITH DEFAULT_SCHEMA = ${schemaName};
ALTER ROLE db_datareader ADD MEMBER ${userName};
ALTER ROLE db_datawriter ADD MEMBER ${userName};
ALTER ROLE db_ddladmin ADD MEMBER ${userName};

Nachdem die Datenbank erfolgreich erstellt wurde, kann mit folgender JDBC-URL eine Verbindung zur Datenbank hergestellt werden (unter Umständen ist ein zusätzlicher Parameter wie encrypt=false erforderlich):

jdbc:sqlserver://<host>:1433;databaseName=${databaseName}

Oracle

CREATE USER "${userName}" IDENTIFIED BY "${userPassword}";
-- Grant Privileges --
GRANT UNLIMITED TABLESPACE TO ${userName};
GRANT CREATE SESSION TO ${userName};
GRANT CREATE TABLE TO ${userName};
GRANT CREATE SEQUENCE TO ${userName};
GRANT CREATE TRIGGER TO ${userName};
GRANT SELECT ON SYS.DBA_RECYCLEBIN TO ${userName};

Nachdem die Datenbank erfolgreich erstellt wurde, kann mit folgender JDBC-URL eine Verbindung zur Datenbank hergestellt werden (abhängig von Version und Einrichtung der Datenbank):

jdbc:oracle:thin:@<host>:1521:<sid>
jdbc:oracle:thin:@//<host>:1521/<serviceName

Schema bereitstellen (Deployment)

Führen Sie folgenden Befehl über eine Befehlseingabeaufforderung aus:

java -jar de.softproject.x4.update-7.5.0.jar --run-database-update --jdbc-url <jdbc-url> --jdbc-user <user> --jdbc-password <password>

Vorhandene Datenbank migrieren

Wenn bereits eine ältere Version der X4 BPMS (z. B. 7.4.x) verwendet wird, kann das bestehende Schema aktualisiert werden. Bei der Migration muss unterschieden werden, ob das Schema mit oder ohne Liquibase erstellt wurde.

Mit Liquibase erstelltes Schema migrieren

Da das verfügbare Schema davon abhängt, wie es installiert wurde, können wir an dieser Stelle kein allgemeingültiges Migrationsskript bereitstellen.

Die grundlegenden Punkte sind jedoch in allen Szenarien identisch:

• Stellen Sie sicher, dass der dedizierte Datenbankbenutzer ähnliche Rechte und Privilegien wie im vorherigen Kapitel beschrieben hat.

• Wenn die Liquibase-Steuertabellen (d.h. databasechangelog, databasechangeloglock) im Zielschema vorhanden sind, können Sie Folgendes ausführen:

java -jar de.softproject.x4.update-7.5.0.jar --run-database-update --jdbc-url <jdbc-url> --jdbc-user <usr> --jdbc-password <pwd>

• Wenn sie sich in einem separaten Schema befinden (z. B. schema_a), müssen Sie:

  • sicherstellen, dass der Datenbankbenutzer in der Lage ist, die Daten dieser Tabellen zu aktualisieren

  • den Parameter --liquibase-schema schema_a zur Befehlszeile hinzufügen

Ohne Liquibase erstelltes Schema migrieren

Ein ohne Liquibase erstelltes Schema enthält in der Regel mehr Tabellen als für den Betrieb von X4 erforderlich sind. Alle benötigten Tabellen sind jedoch vorhanden und kompatibel.

Wenn der Datenbankbenutzer alle erforderlichen Rechte und Privilegien besitzt, ist die Migration einfach:

java -jar de.softproject.x4.update-7.5.0.jar --run-database-update --jdbc-url <jdbc-url> --jdbc-user <usr> --jdbc-password <pwd>