AE DB Load

Administratoren verwenden das AE-Dienstprogramm DB Load (ucybdbld), um Daten für verschiedene Zwecke in die AE-Datenbank zu laden. Sie können Initialdaten, Inhalte, die mit dem Transportkoffer transportiert wurden, oder Inhalte zur Berechnung der erwarteten Laufzeiten von ausführbaren Objekten laden. Sie können auch ILM-Partitionen installieren und Rapid Automation-Lösungen laden.

Wichtig!

  • Dieses Dienstprogramm unterstützt die Konvertierung von Legacy-Codierungen in UTF-8. Wenn Sie das Dienstprogramm AE.DB Load zum Laden eines Transportkoffers verwenden, der aus einer vorherigen Version entladen wurde, die eine andere Codierung als UTF-8 verwendet, können Sie über die Kommandozeile die Codierung übergeben, die verwendet werden soll, um die Daten in UTF-8 zu konvertieren.

  • Sie können auch UTF-8 verwenden, wenn Sie den Namen der INI-Datei und ihren Pfad (-I) angeben.

Wenn Sie zum ersten Mal Initialdaten in eine vorhandene AE-Datenbank laden, wird auch deren Schema aktualisiert. Da die Größe vieler Textfelder jetzt größer ist, kann das Laden länger als üblich dauern.

Diese Seite beinhaltet Folgendes:

Starten des Dienstprogramms

Folgen Sie einer der folgenden Optionen:

Windows

  • *G.EXE (ucybdbldg.exe)

    Normaler Start des Dienstprogramms, G steht für die grafische Benutzeroberfläche

  • *.EXE

    Programm, dem Startparameter für Batch-Aufrufe zugewiesen werden können, siehe Startparameter – Dienstprogramme

  • *.BAT

    Batch-Datei für das Dienstprogramm

UNIX

  • *.sh

    Normaler Start des Dienstprogramms

  • Ohne Dateiendung

    Programm, dem Start-Parameter für den Batch-Aufruf zugeordnet werden können.

Daten in die Datenbank laden

AE DB Load identifiziert automatisch den Ladetyp und ermöglicht Ihnen die Durchführung der folgenden Aktionen:

  • Daten für Neu- und Upgrade-Installationen laden

    Das Dienstprogramm erstellt das Datenbankschema und lädt INITIAL- und STANDARD-Daten. Wählen Sie die Datei <DB-Verzeichnis>\DB\GENERAL\<vers>\UC_UPD.TXT. der gewünschten Version.

    Beim Laden von Initialdaten in die AE-Datenbank erscheint ein Dialog, in dem Sie installieren und konfigurieren können. Weitere Informationen finden Sie unter Laden der AE-Datenbank. Sie können ILM auch mit Hilfe der Startparameter für Dienstprogramme mit einer Befehlszeilenschnittstelle (CLI) installieren. Weitere Informationen finden Sie unter Startparameter – Dienstprogramme.

    Wenn Sie die Datenbank installieren oder aktualisieren, erscheint ein Dialog, in dem Sie die Authentifizierungsmethode auswählen können. Geben Sie die Passphrase in die Textfelder der Optionen Server und Server und Agent ein. Wird verwendet, um den Unternehmensschlüssel zu generieren. Weitere Informationen finden Sie unter Authentifizierung von Agenten.

    Sie können diesen Schritt auch verwenden, um Automic Automation-Administratorbenutzern alle verfügbaren Berechtigungen zu gewähren. Dazu müssen Sie die Benutzer mit der Umgebungsvariablen ADMIN_USERS angeben, unter Verwendung von Apostrophen. Wenn Sie mehr als einen Benutzer definieren möchten, geben Sie sie in einer kommagetrennten Liste an.

    Beispiele

    Einzelner Benutzer: 'USER1/DEV'

    Mehrere Benutzer: 'USER1/DEV','USER2/DEV','USER3/PO'

  • Laden von Daten, die zuvor mit Hilfe von AE DB Unload entladen wurden

    Der Inhalt von Transportkoffern oder bestimmten Tabellen wird in der Datei UC_DATA.TXT gespeichert. Sie können sie in die gleiche oder in eine andere AE-Datenbank laden. Das Zielsystem muss zu diesem Zweck die gleiche Service Pack-Version wie das Quellsystem oder eine spätere verwenden. Weitere Informationen finden Sie unter Transportieren von Daten.

  • Erwartete Laufzeit berechnen (ERT)

    Hierfür muss der Wert des Schlüssels ERT_CALCULATION in der Variablen UC_CLIENT_SETTINGS auf BATCH konfiguriert werden. Wählen Sie das DB-Verzeichnis aus >\DB\GENERAL\<vers>\UC_UPD_ESTIMATE_ERT. TXT-Datei, die automatisch die Laufzeit berechnet und sie in Ihre Datenbank lädt. Die letzte Zeile dieser Datei ruft die Funktion zur ERT-Berechnung auf. Standardmäßig umfasst dies das gesamte AE-System, aber Sie können auch einen bestimmten Client definieren. Weitere Informationen finden Sie unter ERT-Parameter.

    Beispiel

    ESTIMATE_ERT 1000

DB Load und Versionsmanagement

Nach dem Laden eines Transportkoffers in einen Client, für den VERSION_MANAGEMENT aktiviert ist (auf YES festgelegt), gibt es eine wichtige Zunahme bei der Verwendung von Arbeitsprozessen, vor allem der DWPs. Wenn Sie mehrere DB Load-Vorgänge gleichzeitig oder in kurzer Folge ausführen und/oder wenn viele Benutzer mit dem System verbunden sind, kann es sein, dass die Leistung des Systems auch nach Abschluss von DB Load nachlässt. Dies liegt daran, dass AE Einträge in der internen Aufgabenlisten (ITL)-Tabelle (ITL_TType=GEN_OX) erstellt, um Versionsverwaltungseinträge für die Objekte zu erstellen, die aus dem Transportkoffer geladen werden. Diese Einträge werden unabhängig von DB Load durch die DWPs verarbeitet. Diese Verarbeitung kann einige Minuten, aber auch Stunden dauern und länger als der DB Load-Vorgang selbst andauern. Jeder DWP kann alle 4 Sekunden ein Versionsverwaltungsobjekt erstellen.

In diesem Fall wird die folgende Fehlermeldung in den Protokollen von DB Load aufgeführt:

U00038129 Waiting 1 minute for the generation of Version Control Objects. Processing will be continued afterwards.

Tipp: In diesem Fall sollten Sie in Erwägung ziehen, weitere DWPs hinzufügen.

Mögliche Meldungen und Fehler

  • Wenn beim Aktualisieren der Datenbank oder beim Laden von Initialdaten ein SQL-Fehler auftritt, wird ein Dialogfeld geöffnet, das die folgenden Optionen bietet:

    • Erneut versuchen
      Verarbeitet die SQL-Kommandos ab der Position erneut, an der der Fehler aufgetreten ist. Die Verarbeitung wird fortgesetzt, wenn das Problem nicht erneut auftritt.

    • Abbrechen
      Beendet den Ladevorgang und das Dienstprogramm.

    • Ignorieren
      Überspringt das Kommando, das den Fehler verursacht hat.

    Wichtig! "Ignorieren" und "Abbrechen" können zu einer inkonsistenten Datenbank führen. Eine entsprechende Meldung wird angezeigt, die Sie bestätigen müssen, wenn Sie fortfahren möchten.

  • Die Meldung U0038128 wird angezeigt und informiert Sie, dass die Dienstprogrammversion und die Datenbankversion nicht übereinstimmen. Dies geschieht, wenn Sie versuchen, Transportkoffer-Dateien zu laden, während die Revision im AE-System aktiv ist.

    Wichtig: Brechen Sie das Dienstprogramm AE DB Load nicht ab. Der Ladevorgang wird gestartet, sobald die Verarbeitung der für die Revisionierung erforderlichen Daten abgeschlossen ist (siehe AE DB Revision Report). Diese Vorgehensweise stellt sicher, dass auch bei mehrmaligem Laden von Daten keine für den Revisionsprozess relevanten Daten verloren gehen. Je nach Größe der zu ladenden Objekte kann dieser Vorgang einige Zeit in Anspruch nehmen.

  • Meldung U00038042 Aktion erforderlich! Überprüfen Sie, ob der Index NK_AH_IDNR_bearb mit der Definition in uc_ddl.sql übereinstimmt

    Wenn das DB Load-Log diese Meldung enthält, müssen Sie den NK_AH_IDNR_bearb-Index manuell aktualisieren, indem Sie den Index löschen und die entsprechende create-Anweisung aus uc_ddl.sql kopieren, da eine automatische Aktualisierung viel Zeit in Anspruch nehmen kann. Sie müssen dies aber nicht während der Ausführung von DB Load vornehmen, sondern können es später erledigen.

  • Meldung U00038320 Database is set to a non-supported collation '&01'

    Für UTF8 muss die Sortierung Latin1_General_100_CI_AS_SC_UTF8 in der MS SQL-Datenbank definiert sein, da andernfalls die Zeichen nicht richtig interpretiert werden können. Weitere Informationen finden Sie unter Die AE-Datenbank einrichten - MS SQL.

Siehe auch: