pw sso register


The pw sso register command runs the BMC Atrium SSO web agent deployer (an authorization registration program) which registers Infrastructure Management with BMC Atrium SSO server.

The syntax for the command is as follows:

pw sso register

Integration configured during installation

The integration with Atrium SSO might have already been configured during installation. Check the configuration by running the pw sso config --list command. Change any of the configuration values by running the following command sequence.
Long form:

pw sso config <--am-pwd <password> --bppm-host <host> --enable --list <properties> --sso-host <host> --port <ssl port> --searcher-id <user name> --searcher-password <password>>
pw sso register

Short form:

pw sso config <-w <password> -s <host> -e -l <properties> -o <host> -p <ssl port> -i <user name> -q <password>>
pw sso register

Note

In the pw sso config command, use only those parameters whose properties must be changed.
You must unregister a deployed agent before making any configuration changes to the agent. You need to unregister the agent, make the configuration changes, and then register a new version of the agent. See pw-sso-unregister.

Example

Run the following command sequence on an unregistered agent to change the BMC Atrium SSO server:
Long form:

pw sso config --am-pwd SSOAdmin1 --sso-host proactivenet.sso.com
pw sso register

Short form:

pw sso config -w SSOAdmin1 -o proactivenet.sso.com
pw sso register

Integration not configured during installation

If you did not configure BMC Atrium SSO integration during installation, then run the following command sequence:
Long form:

pw sso config <--am-pwd <password> --bppm-host <host> --list -sso-host <host> --port <ssl port> --searcher-id <user name> --searcher-password <password>>
pw sso admin
pw sso register
pw sso load

Short form:

pw sso config <-w <password> -s <host> -l -o <host> -p <ssl port> -i <user name> -q <password>>
pw sso admin
pw sso register
pw sso load
Example

Long form:

pw sso config --admin AdminProactiveNet --am-pwd 12345678 --bppm-host bmc.bmc.com --enable --sso-host proactivenet.sso.com port 8336 --searcher-id bettyb --searcher-password betty1234 --list
pw sso admin
pw sso register
pw sso load

Short form:

pw sso config -a AdminProactiveNet -w 12345678 -s bmc.bmc.com -e -o proactivenet.sso.com port 8336 -i bettyb -q betty1234 -list
pw sso admin
pw sso register
pw sso load

Configuration changes

The command can also be used at any time to deploy Infrastructure Management with the changed configuration details.

Note

You must unregister a deployed agent before making any configuration changes to the agent. You need to unregister the agent, make the configuration changes, and then register a new version of the agent. See pw-sso-unregister.

Use the following syntax to change configuration on an unregistered agent:
Long form:

pw sso config <--am-pwd <password> --bppm-host <host> --list -sso-host <host> --port <ssl port> --searcher-id <user name> --searcher-password <password>>
pw sso register
pw sso load

Short form:

pw sso config <-w <password> -s <host> -list -o <host> -p <ssl port> -i <user name> -q <password>>
pw sso register
pw sso load
Example

Long form:

pw sso config --sso-host host.sso.com --searcher-id jsmith --searcher-password jon1234 --list
pw sso register
pw sso load

Short form:

pw sso config -o host.sso.com -i jsmith -q jon1234 -l
pw sso register
pw sso load

pw sso register return codes

Codes

Description

0

Success

1

General error

2

Usage

5

Unable to connect to BMC Atrium SSO server

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*