Chat now with support
Chat with Support

Identity Manager 9.3 - Administrationshandbuch für betriebsunterstützende Aufgaben

Über dieses Handbuch Simulieren von Datenänderungen im Manager Planen des Ausführungszeitpunktes von Operationen Bildungsregeln im Manager erneut anwenden Exportieren von Daten mit dem Manager Auswertung von Daten und Datenänderungen Auswertung der Prozessüberwachung im Manager Zeitpläne im One Identity Manager Mailvorlagen im One Identity Manager Kennwortrichtlinien im One Identity Manager Arbeiten mit Änderungskennzeichen Prüfen der Datenkonsistenz Kompilieren einer One Identity Manager-Datenbank Transportieren kundenspezifischer Änderungen Importieren von Daten mit dem Data Import Import und Export einzelner Dateien für die Softwareaktualisierung One Identity Manager-Datenbank für eine Test- oder Entwicklungsumgebung aus einer Datenbanksicherung erstellen Initialisieren des DBQueue Prozessor nach Erweiterung der Serverhardware Kommandozeilenprogramme Konfiguration von Einstellungen für die One Identity Manager-Werkzeuge

Create-web-dir.exe

Mit dem Programm Create-web-dir.exe können Sie eineOne Identity Manager Installation aus einem Verzeichnis, das ein One Identity Manager Setup enthält oder aus einer installierten One Identity Manager-Datenbank erstellen. Das Programm finden Sie auf dem Installationsmedium im Verzeichnis Modules\QBM\dvd\AddOn\SDK\LinuxWebInstall. Das Programm können Sie über die Kommandozeile ausführen.

Aufrufsyntax

create-web-dir.exe

[--mode=web|standalone]

--setup={Directory}|[--db-system=MSSQL|APPSERVER]

--db="{Connection string}"

--dest={Directory}

[ --modules={Module IDs}]

--targets= "{Targets}"

[--nlog={Path}\nlog.config]

[--web-config={Path}\appsettings.json]

[--web-app={URL}]

[--web-app-project={Web project}]

[--web-app-product={Product}]

[--web-app-auth={Authentifier}]

[--web-app-auth2={Authentifier}]

[--session-cert={Path}\SessionCertificate.pfx]

[--create-session-cert]

[--session-cert-issuer="{Issuer}"]

[--appserver-url={URL}]

[--auth="Module={Authentication string}"]

[--server-name --targets-from-server --config-from-server]

[--variable{Key=Value}]

[--nologo]

Aufruf des Programms
  • Windows: C:/installer/create-web-dir.exe

  • Linux: mono /installer/create-web-dir.exe

Tabelle 61: Parameter und Optionen des Programms
Parameter oder Option

Alternativ

Beschreibung
--mode

 

Modus der Installation. Zulässige Werte sind web (Standard) und standalone.

--setup

-s

Verzeichnis, dass das One Identity Manager Setup enthält und aus dem die Installation zusammengestellt werden soll. Geben Sie entweder das Verzeichnis mit dem One Identity Manager Setup oder eine Datenbankverbindung an.

--db-system

 

Datenbanksystem, dass als Quelle verbunden werden soll. Zulässige Werte sind MSSQL (Standard) und APPSERVER.
--db

-connect

Verbindungsparameter zur Datenbank, aus welcher die Installation erfolgen soll. Geben Sie entweder das Verzeichnis mit dem One Identity Manager Setup oder eine Datenbankverbindung an.

--dest

-d

Zielverzeichnis für die Installation.
--targets

-t

Kommagetrennte Liste der Maschinenrollen, die installiert werden sollen.
--modules

-m

Kommagetrennte Liste der Modul IDs zur Installation. Optional, wenn die Installation aus einer bestehenden Datenbank erfolgen soll.
--nlog

-n

(Optional) Ablagepfad für Konfigurationsdatei NLog.config.

--web-config

-w

(Optional) Ablagepfad für Konfigurationsdatei appsettings.json.

--web-app

 

(Optional) URL, für die eine Webanwendung in der Datenbank erzeugt werden soll.

--web-app-product

 

(Optional) Bezeichner des Produktes für die Webanwendung (QBMProduct.Ident_Product) oder UID des Produktes für die Webanwendung (QBMProduct.UID_DialogProduct).

--web-app-auth

 

(Optional) Bezeichner des primären Authentifizierungsmoduls (DialogAuthentifier.Ident_DialogAuthentifier) oder UID des primären Authentifizierungsmoduls (DialogAuthentifier.UID_ DialogAuthentifier) für die Webanwendung.

--web-app-auth2

 

(Optional) Bezeichner des sekundären Authentifizierungsmoduls (DialogAuthentifier.Ident_DialogAuthentifier) oder UID des sekundären Authentifizierungsmoduls (DialogAuthentifier.UID_ DialogAuthentifier) für die Webanwendung.

--session-cert

-c

(Optional) Pfad und Name der Zertifikatsdatei.

--create-session-cert

 

(Optional) Erzeugen eines neuen Zertifikates, wenn die angegebene Zertifikatsdatei nicht existiert.

--session-cert-issuer

 

(Optional) Herausgeber für die erzeugte Zertifikatsdatei.

Standard: "CN=Application Server"

--appserver-url

 

(Optional) URL des Anwendungsservers, mit dem die Webanwendung verbunden werden soll.

--auth

 

(Optional) Authentifizierungsdaten. Die Authentifizierungsdaten sind abhängig vom Authentifizierungsmodul. Ausführliche Informationen zu den One Identity Manager Authentifizierungsmodulen finden Sie im One Identity Manager Handbuch zur Autorisierung und Authentifizierung.

--config-from-server

 

(Optional) Holt die Konfiguration des One Identity Manager Service für den Jobserver aus der Datenbank und erzeugt die Konfigurationsdatei im Zielverzeichnis. Wenn dieser Parameter gesetzt ist, wird der Parameter --server-name benötigt.

--targets-from-server

 

(Optional) Holt die Maschinenrollen des Jobservers aus der Datenbank. Wenn dieser Parameter gesetzt ist, wird der Parameter --server-name benötigt.

--server-name

 

(Optional) Bezeichnung des Jobservers in der Datenbank (Tabelle QBMServer).

--variable

-v

(Optional) Ersetzen der Variablen in den Vorlagendateien (NLog.config, appsettings.json), die mit %Variablenname% angegeben sind. (Key=Value).

--nologo

 

(Optional) Gibt an, ob das Startbanner und die Copyright-Informationen angezeigt werden sollen.

--help

-h, -?

Anzeige der Hilfe zum Programm.

Beispiel: Installieren eines Anwendungsserver aus einem Verzeichnis

create-web-dir.exe

-s=I:\Main\2020.07.28.001

-d=C:\Work\Install

-m=ADS,ARS,CAP,CPL,DPR,EBS,EX0,LDP,NDO,QBM,QER,RMB,RMS,SAC,SAP,SBW,SHR,SP0,TSB

-t=Server\Web\AppServer,Server\Web\AppServer\SearchCrawler,Server\Web\AppServer\SearchIndex

-w=\work\Config\appsettings.json

-n=\work\Config\nlog.config

-c=\work\SessionCertificate.pfx

Beispiel: Installieren eines Anwendungsservers aus der Datenbank

create-web-dir.exe

-d=C:\Work\Install

--db-connect="Data Source=<Server>;Initial Catalog=<Database>;User ID=<DB User>;Password=<Password>"

-t=Server\Web\AppServer,Server\Web\AppServer\SearchCrawler,Server\Web\AppServer\SearchIndex

-w=\work\Config\appsettings.json

-n=\work\Config\nlog.config

-c=\work\SessionCertificate.pfx

Beispiel: Installieren eines Jobservers aus der Datenbank mit den Standardmaschinenrollen

create-web-dir.exe

--mode=standalone

-d=C:\Work\Install

--db-connect="Data Source=<Server>;Initial Catalog=<Database>;User ID=<DB User>;Password=<Password>"

-t=Server\Jobserver

--server-name=Server1

--targets-from-server

Konfiguration von Einstellungen für die One Identity Manager-Werkzeuge

Allgemeine Konfigurationseinstellungen der One Identity Manager-Werkzeuge können in einer Konfigurationsdatei appsettings.json vorgegeben werden. Die Einstellungen wirken global für alle One Identity Manager-Werkzeuge.

Tabelle 62: Allgemeine Konfigurationseinstellungen

Einstellung

Beschreibung

Cache

Benutzerdefiniertes Cache-Verzeichnis für Daten aus der Datenbank.

AssemblyCache

Benutzerdefiniertes Cache-Verzeichnis zur Ablage der Skriptassemblies.

CacheReloadInterval

Intervall in Sekunden, nach dem der lokale Cache aktualisiert werden soll. Diese Einstellung überschreibt die Einstellung des Konfigurationsparameters Common | CacheReload | Interval.

NoReloadBeep

Mit Aktivierung der Einstellung wird das akustische Signal beim Nachladen von gecachten Systemdaten abgeschaltet.

Eine Beispielkonfiguration finden Sie in der Konfigurationsdatei appsettings.json im One Identity Manager-Installationsverzeichnis. Um die Einstellungen der Beispielkonfiguration zu nutzen, entfernen Sie die Kommentarzeichen und speichern Sie die Änderungen.

Beispiel: Beispielkonfiguration in der Konfigurationsdatei appsettings.json
{
    "RuntimeDirs": {
    // Set the cache directories to a user defined place
    // "Cache": "C:\\Temp\\OneIM\\AppServerCache\\DB",
    // "AssemblyCache": "C:\\Temp\\OneIM\\AppServerCache\\Assemblies"
    },
 
    "ConnectionBehaviour": {
    // "CacheReloadInterval": "30",
    // "NoReloadBeep": "true"
    }
}
 

Für spezielle Konfigurationseinstellungen einzelner One Identity Manager-Komponenten können anwendungsspezifischen Konfigurationsdateien verwendet werden.

Die Konfigurationsdateien werden mit der Bezeichnung appsettings.<appName>.json im One Identity Manager-Installationsverzeichnis abgelegt, wobei appName der Name der One Identity Manager-Komponente ist.

Beispiel: appsettings.Manager.json

Verwandte Themen

Konfigurationswerte aus Azure Key Vault laden

Es ist möglich, Geheimnisse (Secrets), wie beispielsweise Verbindungszeichenfolgen aus Azure Key Vault zu laden und in der Konfigurationsdatei appsettings.json zu verwenden. Konfigurieren Sie dazu den Azure Key Vault-Konfigurationsanbieter.

Ausführliche Informationen finden Sie in der Microsoft Dokumentation unter Azure Key Vault.

Tabelle 63: Konfigurationseinstellungen für Azure Key Vault

Einstellung

Beschreibung

KeyVaultName

Name des Azure Key Vault. Den Namen finden Sie im Microsoft Azure Management Portal (https://portal.azure.com/).

Prefix

Wenn nur eine Teilmenge von Werten als Konfigurationsoptionen verfügbar sein soll, kann ein Präfix definiert werden.

Die Geheimnisse werden nach diesem Präfix gefiltert, das Präfix selbst wird aus der resultierenden Konfigurationseinstellung entfernt.

KeyDelimiter

Zeichenkette, die zur Trennung der Hierarchieebenen in der Konfiguration benutzt wird. Die Standard-Trennzeichenfolge sind zwei Bindestriche (--). Doppelpunkte (:) werden als Trennzeichen nicht unterstützt.

Beispiel: Azure Key Vault-Konfigurationsanbieter verwenden
"ConfigProviders": {
   "AzureKeyVault": {
     "Class": "AzureKeyVault",
    // Alternatively, the full name: "Class": "VI.Base.Config.AzureKeyVault.AzureKeyVaultConfigProvider, VI.Base.Config.AzureKeyVault",
     "KeyVaultName": "Key Vault Name",
     "Prefix": "Prefix",
     "KeyDelimiter": "--"
   }
 }
Beispiel: Verbindungszeichenkette für Anwendungsserver ermitteln

In der Konfigurationsdatei appsettings.json werden folgende Einstellungen für den Azure Key Vault vorgenommen.

"ConfigProviders": {
   "AzureKeyVault": {
     "Class": "AzureKeyVault",
     "KeyVaultName": "OneIM-General-KeyVault",
     "Prefix": "OneIM-DEV-",
     "KeyDelimiter": "-"
   }
 }

Das Geheimnis mit dem Namen OneIM-DEV-ConnectionStrings-AppServerDb wird in der Konfiguration als ConnectionStrings:AppServerDb gemappt. Dies entspricht dieser Sektion in der Konfigurationsdatei appsettings.json.

{
  "ConnectionStrings": {
    "AppServerDb": "..."
  }
}
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating