Command Reference > pmrep Command Reference > UnregisterPlugin
  

UnregisterPlugin

Removes a plug-in from a repository. You can add and remove plug-ins to extend system functionality. A plug-in is a software module that introduces new repository metadata.
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 UnregisterPlugin command uses the following syntax:
unregisterplugin

-v <vendor_id>

-l <plug-in_id>

[-s (is security module)

 [-g (remove user-name-login mapping)]

 {-w <new_password> |

  -W <new_password_environment_variable>}]
The following table describes pmrep UnregisterPlugin options and arguments:
Option
Argument
Description
-v
vendor_id
Required. Identifies the security plug-in by vendor identification number. You define this number when you register the plug-in.
-l
plug-in_id
Required. Identifies the plug-in by identification number. You define this identification number when you register the plug-in.
-s
-
Optional. Indicates whether the module is an external security module.
-g
-
Optional. Applicable when registering an external security module.
Removes the association between user names and login names in the repository when you unregister an external security module. If you omit this option, you retain the association in the repository, but the Repository Manager does not display it anywhere.
Use this option when you are unregistering a security module.
-w
new_password
Required when the plug-in contains a security module.
Required if you do not use the -W option. You must use the -w or -W option, but not both.
Specifies a new password for the user running the UnregisterPlugin command. When you unregister an external authentication module, all user passwords reset to the values in the repository. You must enter a new password to access the repository.
-W
new_password_environment_
variable
Required when the plug-in contains a security module.
Required if you do not use the -w option. You must use the -w or -W option, but not both.
Specifies a new password environment variable for the user running the unregister command. When you unregister an external authentication module, all user passwords reset to the values in the repository. You must enter a new password to access the repository.

Unregistering an External Security Module

Use the UnregisterPlugin command to discontinue using an external security module with a repository. If you unregister the external security module, PowerCenter switches to repository authentication mode. All user passwords reset to the values in the repository instead of the values in the external directory. When you unregister the security module, you do not lose the mapping between the user names and the external security login names unless you enter the -g option. Use the mapping again if you register a new security module.
You must use the -w or -W option to create a new password when you unregister the security module.

Example

As an administrator, you decide to switch from the LDAP security module back to repository authentication. You remove the user name-login mapping. Any users that you added to the system under repository authentication can log in with their old user names and passwords. Any users you added to the repository under the LDAP security cannot log in until you enable their user names.