pw cmadmin
The pw cmadmin commands support the use of the 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 Infrastructure Management with Administrator privileges
pw cmadmin enable
If you did not enable Central Monitoring Administration during the installation of the Central Server, run the pw cmadmin enable command from the Central Server to enable it.
Ensure that the Infrastructure Management 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 Central Server.
pw cmadmin registerChildServer
Run this command from a child BMC TrueSight Infrastructure Management 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 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 | Child Server is already registered with the specified Central Monitoring Administration. |
6 | Child Server is registered with another Central Monitoring Administration. |
pw cmadmin registerChildServer
This command, run from Central Monitoring Administration, registers a specified 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 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 Child Server computer |
-ChildPort=childPort | (Optional) Port number used by the Child Server Default: 80 |
-ChildUser=childUser | User name to log on to the Child Server |
-ChildPasswd=childPassword | Password to log on to the Child Server |
-ChildProtocol=http | https | (Optional) Protocol (http or https) to connect to the 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 | Child Server is already registered with the specified Central Monitoring Administration. |
8 | Child Server is registered with another Central Monitoring Administration. |
pw cmadmin deregisterChildServer
Run this command from a 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 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 | Child Server is already deregistered from the specified Central Monitoring Administration. |
6 | Child Server is registered with another Central Monitoring Administration. |
pw cmadmin deregisterChildServer
This command, run from Central Monitoring Administration, removes the registration of a specified 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 TrueSight Infrastructure Management 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 | Child Server is already deregistered from the specified Central Monitoring Administration. |
6 | Child Server is registered with another Central Monitoring Administration. |
7 | Child Server is not registered with the specified Central Monitoring Administration. |
8 | Child Server is registered with another Central Monitoring Administration. |