pw cmadmin
The pw cmadmin commands support the use of the BMC ProactiveNet Central Monitoring Administration console.
The following users have permissions to run this command:
- On UNIX and Linux: root user
- On Microsoft Windows: users belonging to the Administrators group
- All users of BMC ProactiveNet with Administrator privileges
pw cmadmin enable
If you did not enable Central Monitoring Administration during the installation of the BMC ProactiveNet Central Server, run the pw cmadmin enable command from the BMC ProactiveNet Central Server to enable it.
Ensure that the BMC ProactiveNet Central Monitoring Repository is installed before you enable Central Monitoring Administration. If you did not install the Central Monitoring Repository during the regular installation process, you can install it by using the pw repository update command. For information about the pw repository update command, see pw-repository-update.
Syntax for pw cmadmin enable command
After running the pw cmadmin enable command, restart the BMC ProactiveNet Central Server.
pw cmadmin registerChildServer (from the child server)
Run this command from a child BMC ProactiveNet Server to register the child server with a specified Central Monitoring Administration.
Syntax for pw cmadmin registerChildServer command (from the child server)
-cmaUser=<cmaUser> -cmaPasswd=<cmaPassword> [-cmaProtocol=http|https]
The following table describes the options to register a BMC ProactiveNet Child Server with a Central Monitoring Administration.
pw cmadmin registerChildServer command options (from the child server)
Option | Description |
|---|---|
-cmaHost=cmaHost | Host name or IP address of the Central Monitoring Administration computer |
-cmaPort=cmaPort | (Optional) Port number used by the Central Monitoring Administration. Default: 80 |
-cmaUser=cmaUser | User name to log on to Central Monitoring Administration |
-cmaPasswd=cmaPassword | Password to log on to Central Monitoring Administration |
-cmaProtocol=http | https | (Optional) Protocol (http or https) to connect to the Central Monitoring Administration. Default: http |
The following table lists the return codes for the pw cmadmin registerChildServer command.
pw cmadmin registerChildServer return codes (from the child server)
Code | Description |
|---|---|
0 | Successful execution of command |
1 | Input validation failed |
2 | User does not have privileges to run this command |
3 | Failure in executing the command |
4 | An exception has occurred. |
5 | BMC ProactiveNet Child Server is already registered with the specified Central Monitoring Administration. |
6 | BMC ProactiveNet Child Server is registered with another Central Monitoring Administration. |
pw cmadmin registerChildServer (from Central Monitoring Administration)
This command, run from Central Monitoring Administration, registers a specified BMC ProactiveNet Child Server with Central Monitoring Administration.
Syntax for pw cmadmin registerChildServer command (from Central Monitoring Administration)
-ChildUser=<childUser> -ChildPasswd=<childPassword> [-ChildProtocol=http|https]
The following table describes the options to register a specified BMC ProactiveNet Child Server from Central Monitoring Administration.
pw cmadmin registerChildServer command options (from Central Monitoring Administration)
Option | Description |
|---|---|
-ChildHost=childHost | Host name or IP address of the BMC ProactiveNet Child Server computer |
-ChildPort=childPort | (Optional) Port number used by the BMC ProactiveNet Child Server Default: 80 |
-ChildUser=childUser | User name to log on to the BMC ProactiveNet Child Server |
-ChildPasswd=childPassword | Password to log on to the BMC ProactiveNet Child Server |
-ChildProtocol=http | https | (Optional) Protocol (http or https) to connect to the BMC ProactiveNet Child Server.Default: http |
The following table lists the return codes for the pw cmadmin registerChildServer command.
pw cmadmin registerChildServer return codes (from Central Monitoring Administration)
Code | Description |
|---|---|
0 | Successful execution of command |
1 | Input validation failed |
2 | User does not have privileges to run this command |
3 | Failure in executing the command |
4 | An exception has occurred. |
7 | BMC ProactiveNet Child Server is already registered with the specified Central Monitoring Administration. |
8 | BMC ProactiveNet Child Server is registered with another Central Monitoring Administration. |
pw cmadmin deregisterChildServer (from the child server)
Run this command from a BMC ProactiveNet Child Server to remove the child server registration from a specified Central Monitoring Administration.
Syntax for pw cmadmin deregisterChildServer command (from the child server)
-cmaUser=<cmaUser> -cmaPasswd=<cmaPassword> [-cmaProtocol=http|https]
The following table describes the options to remove a BMC ProactiveNet Child Server from a Central Monitoring Administration.
pw cmadmin deregisterChildServer command options (from the child server)
Option | Description |
|---|---|
-cmaHost=cmaHost | Host name or IP address of the Central Monitoring Administration computer |
-cmaPort=cmaPort | (Optional) Port number used by Central Monitoring Administration. Default: 80 |
-cmaUser=cmaUser | User name to log on to Central Monitoring Administration |
-cmaPasswd=cmaPassword | Password to log on to Central Monitoring Administration |
-cmaProtocol=http | https | (Optional) Protocol (http or https) to connect to Central Monitoring Administration. Default: http |
The following table lists the return codes for the pw cmadmin deregisterChildServer command.
pw cmadmin deregisterChildServer return codes (from the child server)
Code | Description |
|---|---|
0 | Successful execution of command |
1 | Input validation failed |
2 | User does not have privileges to run this command |
3 | Failure in executing the command |
4 | An exception has occurred. |
5 | BMC ProactiveNet Child Server is already deregistered from the specified Central Monitoring Administration. |
6 | BMC ProactiveNet Child Server is registered with another Central Monitoring Administration. |
pw cmadmin deregisterChildServer (from Central Monitoring Administration)
This command, run from Central Monitoring Administration, removes the registration of a specified BMC ProactiveNet Child Server from Central Monitoring Administration.
Syntax for pw cmadmin deregisterChildServer command (from Central Monitoring Administration)
-ChildUser=<childUser> -ChildPasswd=<childPassword> [-ChildProtocol=http|https]
The following table describes the options to remove a specified child BMC ProactiveNet Server from Central Monitoring Administration.
pw cmadmin deregisterChildServer command options (from Central Monitoring Administration)
Option | Description |
|---|---|
-ChildHost=childHost | Host name or IP address of the Central Monitoring Administration computer |
-ChildPort=childPort | (Optional) Port number used by Central Monitoring Administration. Default: 80 |
-ChildUser=childUser | User name to log on to Central Monitoring Administration |
-ChildPasswd=childPassword | Password to log on to Central Monitoring Administration |
-ChildProtocol=http | https | (Optional) Protocol (http or https) to connect to Central Monitoring Administration. Default: http |
The following table lists the return codes for the pw cmadmin deregisterChildServer command.
pw cmadmin deregisterChildServer return codes (from Central Monitoring Administration)
Code | Description |
|---|---|
0 | Successful execution of command |
1 | Input validation failed |
2 | User does not have privileges to run this command |
3 | Failure in executing the command |
4 | An exception has occurred. |
5 | BMC ProactiveNet Child Server is already deregistered from the specified Central Monitoring Administration. |
6 | BMC ProactiveNet Child Server is registered with another Central Monitoring Administration. |
7 | BMC ProactiveNet Child Server is not registered with the specified Central Monitoring Administration. |
8 | BMC ProactiveNet Child Server is registered with another Central Monitoring Administration. |