Command Reference > pmrep-Befehlsreferenz > RegisterPlugin
  

RegisterPlugin

Registriert ein externes Plug-In in einem Repository. Das Registrieren eines Plug-Ins fügt dessen Funktionalität dem Repository hinzu. Verwenden Sie den RegisterPlugin-Befehl zum Aktualisieren vorhandener Plug-Ins.
Wenn Sie diesen Befehl verwenden, muss der Repository Service im exklusiven Modus ausgeführt werden. Sie können die Ausführung des Repository Service im exklusiven Modus im Administrator-Tool konfigurieren oder den Befehl infacmd UpdateRepositoryService verwenden.
Der RegisterPlugin-Befehl verwendet die folgende Syntax:
registerplugin

-i <input_registration_file_name_or_path>

[-e (update plug-in)]

[-l <NIS_login>

  {-w <NIS_password> |

  -W <NIS_password_environment_variable>}

  [-k (CRC check on security library)]]

[-N (is native plug-in)]
In der folgenden Tabelle werden die pmrep RegisterPlugin-Optionen und -Argumente beschrieben:
Option
Argument
Beschreibung
-i
input_registration_file_name_or_
path
Erforderlich. Name oder Pfad der Registrierungsdatei für das Plug-In.
-e
-
Optional. Aktualisieren Sie ein vorhandenes Plug-In. Nicht anwendbar bei Authentifizierungsmodulen.
-l
NIS login
Optional. Registriert Sicherheitsmodul-Komponenten. Stellen Sie die NIS-Anmeldung des Benutzers zur Verfügung, der ein externes Sicherheitsmodul registriert. Wenn das Plug-In ein Authentifizierungsmodul enthält, müssen Sie den externen Anmeldenamen angeben, andernfalls schlägt die Registrierung fehl. Diese Anmeldung wird als Administrator-Benutzername im Repository verwendet. Verwenden Sie diese Option nicht für andere Plug-Ins.
-w
NIS password
Optional. Verwenden Sie dies zum Registrieren von Authentifizierungsmodul-Komponenten.
Passwort für externes Verzeichnis des Benutzers, der das Modul registriert. Wenn das Plug-In ein Authentifizierungsmodul enthält, müssen Sie das Benutzerpasswort des externen Verzeichnisses angeben, andernfalls schlägt die Registrierung fehl. Verwenden Sie diese Option nicht für andere Plug-Ins.
Verwenden Sie die Option -w oder -W, aber nicht beide. Wenn Sie kein Passwort oder keine Passwort-Umgebungsvariable angeben, werden Sie von pmrep aufgefordert, das Passwort einzugeben.
-W
NIS_password_environment_
variable
Optional. Verwenden Sie dies zum Registrieren von Authentifizierungsmodul-Komponenten.
Passwort-Umgebungsvariable für externes Verzeichnis des Benutzers, der das Modul registriert. Wenn das Plug-In ein Authentifizierungsmodul enthält, müssen Sie das Benutzerpasswort des externen Verzeichnisses angeben, andernfalls schlägt die Registrierung fehl. Verwenden Sie diese Option nicht für andere Plug-Ins.
Verwenden Sie die Option -w oder -W, aber nicht beide. Wenn Sie kein Passwort oder keine Passwort-Umgebungsvariable angeben, werden Sie von pmrep aufgefordert, das Passwort einzugeben.
-k
-
Optional. Speichert das CRC der Plug-In-Bibliothek im Repository. Wenn der Repository Service das Modul lädt, führt dieses eine CRC-Prüfung in der Bibliothek aus.
-N
-
Registriert ein Plug-In. Erforderlich, wenn die folgenden Bedingungen gegeben sind:
  • - Sie führen ein PowerCenter-Upgrade aus.
  • - Das PowerCenter-Upgrade hat keine neue Repository-Version.
  • - Das Plug-In enthält aktualisierte Funktionen.
  • - Das Plug-In wird standardmäßig bei einer neuen PowerCenter-Installation registriert.

Registrieren eines Sicherheitsmoduls

Wenn Sie Benutzer und Passwörter für ein Repository mit einem externen Verzeichnisdienst verwalten möchten, müssen Sie das Sicherheitsmodul bei dem Repository registrieren. Verwenden Sie den Registerplugin-Befehl zum Registrieren des Sicherheits-Plug-Ins.

Beispiel

Sie verwalten PowerCenter für eine Organisation, die ein zentralisiertes LDAP NIS zur Benutzerauthentifizierung hat. Bei der Ausführung eines PowerCenter-Upgrades entscheiden Sie sich, LDAP für die Benutzerauthentifizierung zu verwenden. Das Upgrade installiert das LDAP-Sicherheitsmodul im Repository-Sicherheitsordner. Nachdem der Connect-Befehl eine Verbindung zum Repository hergestellt hat, führt der Administrator den pmrep-Befehl zum Registrieren des neuen externen Moduls bei dem Repository aus:
pmrep registerplugin -i security/ldap_authen.xml -l adminuser -w admnpass
Die Optionen -l für den Anmeldenamen und -w für das Anmelde-Passwort enthalten die gültigen NIS-Anmeldeinformationen für den Benutzer, der den pmrep-Befehl ausführt. Nach der Registrierung müssen Sie diesen Anmeldenamen und das Passwort für den Zugriff auf das Repository verwenden.
Die Option -i enthält den XML-Dateinamen, der das Sicherheitsmodul angibt.