Kompilieren einer One Identity Manager-Datenbank
Nach Änderungen von Konfigurationsdaten, wie beispielsweise Änderungen an Prozessen, Skripten, Bildungsvorschriften, Objektdefinitionen, Methodendefinitionen oder präprozessorrelevanten Konfigurationsparametern müssen Sie die Datenbank mit dem Database Compiler kompilieren.
Nach einer Schemainstallation, einer Schemaaktualisierung oder dem Import eines kompletten Kundenkonfigurationspaketes wird die Kompilierung aus dem Configuration Wizard oder dem Database Transporter heraus sofort gestartet. Nach dem Import von Hotfixpaketen oder eingeschränkten Kundenkonfigurationspaketen kompilieren Sie die Datenbank mit dem Database Compiler.
HINWEIS: Das Symbol in der Statuszeile der Programme weist darauf hin, dass die Datenbank kompiliert werden muss.
Detaillierte Informationen zum Thema
Kompilieren einer Datenbank mit dem Database Compiler
Vor Beginn der Kompilierung müssen alle Aufträge für den DBQueue Prozessor abgearbeitet werden. Befinden sich noch Aufträge in der Datenbank, weist der Database Compiler darauf hin.
Damit die Kompilierung von HTML-Anwendungen erfolgreich durchgeführt werden kann, müssen Pakete aus dem NPM-Repository heruntergeladen werden. Stellen Sie daher sicher, dass die Arbeitsstation, auf der kompiliert werden soll, eine Verbindung zur Webseite registry.npmjs.org:443 herstellen kann.
Alternativ ist es möglich, die Pakete von einem Proxy-Server herunterzuladen und manuell zur Verfügung zu stellen.
Um eine Datenbank zu kompilieren
-
Wählen Sie im Designer den Menüeintrag Datenbank > Datenbank kompilieren.
-
Auf der Startseite des Database Compilers, klicken Sie Weiter.
-
Auf der Seite Kompiliervorgaben legen Sie fest, welche Anteile der Datenbank neu kompiliert werden sollen.
Tabelle 35: Kompiliervorgaben
Webservices |
Der One Identity Manager bietet die Möglichkeit Daten einzubinden, die über die verschiedene Webservice-Schnittstellen bereit gestellt werden. Die Webservice-Proxy-Quellen werden in der Datenbank abgelegt. Der Database Compiler kompiliert den Proxy-Code aller Webservices zu einer DLL und speichert diese in der Datenbank. Bei Änderungen am Proxy-Code eines Webservices ist die Kompilierung der Daten erforderlich. |
Typsicheres Datenbankmodell |
Aus den Tabellen-und Spaltendefinitionen werden typsichere Klassen erzeugt, die Sie in Skripten verwenden können. Damit wird beim Schreiben der Skripte sowie beim Kompilieren der Skripte geprüft, ob die verwendeten Klassen korrekt sind.
TIPp: Verwenden Sie nach einer Schemaerweiterung diese Option zum Kompilieren der Datenbank. |
Skripte der Skriptbibliothek |
Um die Skripte der Skriptbibliothek zu kompilieren, wählen Sie eine der folgenden Einträge.
-
Skripte nicht übersetzen: Die Skripte der Skriptbibliothek werden nicht kompiliert.
-
Skripte ohne Abhängigkeiten: Diese Variante führt dazu, dass Skriptänderungen erst mit dem Neustart der One Identity Manager-Werkzeuge wirksam werden.
-
Skripte inkl. aller Abhängigkeiten: Es werden die Skripte und alle Abhängigkeiten, wie beispielsweise Bildungsregeln, Methoden und Prozesse, neu kompiliert. Damit wird gewährleistet, dass die Skriptänderungen sofort nachgeladen und wirksam werden. Ein Neustart der One Identity Manager-Werkzeuge ist nicht erforderlich. |
Bildungsregeln, Methoden, etc. |
Skriptausdrücke, wie beispielsweise Bildungsregeln, Formatierungsskripte oder Methodendefinitionen, kompiliert werden. Um einzuschränken, welche Skriptausdrücke kompiliert werden sollen, blenden Sie über weitere Auswahlmöglichkeiten ein. |
Prozesse |
Prozesse werden kompiliert. Um einzuschränken, welche Prozesse kompiliert werden sollen, blenden Sie über weitere Auswahlmöglichkeiten ein.
-
alle Prozesse: Es werden alle Prozesse kompiliert.
-
geänderte Prozesse: Es werden alle Prozesse kompiliert, die seit der letzten Kompilierung geändert wurden.
-
ausgewählte Prozesse: Wählen Sie einzelne Objekte, deren Prozesse kompiliert werden sollen.
Um einzelne Objekte auszuwählen
-
Klicken Sie die Schaltfläche [...].
-
Wählen Sie zwischen der Kompilierung der geänderten Prozesse, aller Prozesse oder ausgewählter benutzerdefinierter Prozesse.
-
(Optional) Schränken Sie die Vorauswahl weiter ein.
-
Klicken Sie OK. |
Kompilierung der Webprojekte |
Webprojekte werden kompiliert. Um einzuschränken, welche Webprojekte kompiliert werden sollen, blenden Sie über weitere Auswahlmöglichkeiten ein. |
Markiere WHERE-Klauseln als sicher |
Where-Klauseln werden extrahiert und als vertrauenswürdig markiert. |
Extrahiere sprachabhängige Texte |
Texte aus Skripten werden für die Übersetzung in andere Sprachen extrahiert. Es werden die Vorlagen für die Übersetzung erzeugt. |
-
Um den Kompiliervorgang zu starten, klicken Sie Weiter.
-
Auf der Seite Kompilierung wird der Verarbeitungsfortschritt angezeigt. Die Kompilierung kann einige Zeit in Anspruch nehmen. Nachdem die Kompilierung abgeschlossen ist, klicken Sie Weiter.
-
Um das Programm zu beenden, klicken Sie auf der letzten Seite Fertig.
Ausgabe von Fehlern und Warnungen während der Kompilierung
Wenn Kompilierfehler oder Warnungen auftreten:
-
Korrigieren Sie die Fehler nach Beendigung der Kompilierung.
-
Kompilieren Sie die Datenbank erneut.
Fehler werden während des Kompiliervorgangs im Database Compiler in einem separaten Protokollfenster angezeigt.
-
Durch Doppelklick auf die Fehlermeldung im unteren Teil des Protokollfensters wird zur entsprechenden Zeile in der Quellcodeansicht im oberen Bereich des Protokollfensters gesprungen. Die Quellcodeansicht dient lediglich zur Darstellung, eine Bearbeitung des Eintrages ist nicht möglich.
-
Über Speichern speichern Sie die Fehlermeldungen in eine Datei.
-
Über Schließen schließen Sie das Fehlerprotokoll. Anschließend wird die Kompilierung fortgesetzt.
Abbildung 11: Ausgabe von Fehlermeldungen
Alle Kompilierfehler und Warnungen werden während der Kompilierung aufgezeichnet. Nach Abschluss der Kompilierung können Sie Fehler und Warnungen einsehen.
Um Meldungen anzuzeigen und zu speichern
-
Um eine Meldung im Fehlermeldungsfenster anzuzeigen, wählen Sie die Schaltfläche Anzeigen. Ausführliche Informationen zum Fehlermeldungsfenster finden Sie im One Identity Manager Handbuch zur Prozessüberwachung und Fehlersuche.
-
Um alle Meldungen in eine Datei zu speichern, wählen Sie einen Eintrag und verwenden Sie das Kontextmenü Protokoll in Datei speichern.
-
Um eine Meldung in die Zwischenablage einzufügen, wählen Sie den Eintrag und verwenden Sie Strg + C.
Transportieren kundenspezifischer Änderungen
Im One Identity Manager ist eine automatische Versionsverwaltung integriert, die einen konsistenten Stand der Bestandteile des One Identity Manager untereinander als auch zur Datenbank sichert. Werden Programmerweiterungen implementiert, die die Struktur verändern, beispielsweise Tabellenerweiterungen, ist eine Aktualisierung der Datenbank erforderlich.
Die Aktualisierung der Datenbank ist dann notwendig, wenn Hotfixes und Service Packs zur eingesetzten One Identity Manager-Version oder vollständige Versionsänderungen verfügbar sind. Des Weiteren ist es erforderlich, dass kundenspezifische Änderungen aus einer Entwicklungsdatenbank in die Testdatenbank und in die Datenbank des Produktivsystems zu übernehmen sind.
Detaillierte Informationen zum Thema