RegisterPlugin
Registers an external plug-in to a repository. Registering a plug-in adds its functionality to the repository. Use the RegisterPlugin command to update existing plug-ins.
When you use this command, the Repository Service must be running in exclusive mode. You can configure the Repository Service to run in exclusive mode in the Administrator tool or you can use the infacmd UpdateRepositoryService command.
The RegisterPlugin command uses the following 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)]
The following table describes pmrep RegisterPlugin options and arguments:
Option | Argument | Description |
|---|
-i | input_registration_file_name_or_ path | Required. Name or path of the registration file for the plug-in. |
-e | - | Optional. Update an existing plug-in. Not applicable for authentication modules. |
-l | NIS login | Optional. Registers security module components. Provide the NIS login of the user registering an external security module. If the plug-in contains an authentication module, you must supply the external login name, or the registration fails. This login becomes the administrator user name in the repository. Do not use this option for other plug-ins. |
-w | NIS password | Optional. Use to register authentication module components. External directory password of the user registering the module. If the plug-in contains an authentication module, you must supply the user password from the external directory or the registration fails. Do not use this option for other plug-ins. Use the -w or -W option, but not both. If you do not supply a password or password environment variable, pmrep prompts you for a password. |
-W | NIS_password_environment_ variable | Optional. Use to register authentication module components. External directory password environment variable of the user registering the module. If the plug-in contains an authentication module you must supply the user password from the external directory or the registration fails. Do not use this option for other plug-ins. Use the -w or -W option, but not both. If you do not supply a password or password environment variable, pmrep prompts you for a password. |
-k | - | Optional. Stores the CRC of the plug-in library in the repository. When the Repository Service loads the module, it checks the library against the CRC. |
-N | - | Registers a plug-in. Required when the following conditions are true: - - You upgrade PowerCenter.
- - The PowerCenter upgrade does not have a new repository version.
- - The plug-in contains updated functionality.
- - The plug-in is registered by default with a new PowerCenter installation.
For information about plug-ins that you need to register when you upgrade, see the PowerCenter Release Guide. |
Registering a Security Module
If you want to use an external directory service to maintain users and passwords for a repository, you must register the security module with the repository. Use the Registerplugin command to register the security plug-in.
Example
You administer PowerCenter for an organization that has a centralized LDAP NIS for user authentication. When you upgrade PowerCenter, you decide to use the LDAP for user authentication. The upgrade installs the LDAP security module in the repository security folder. After connecting to the repository with the Connect command, the administrator runs the pmrep command to register the new external module with the repository:
pmrep registerplugin -i security/ldap_authen.xml -l adminuser -w admnpass
The -l login name and -w login password options contain the valid NIS login information for the user running the pmrep command. After registration, you must use this login name and password to access the repository.
The -i option contains the XML file name that describes the security module.