Skip to Content

bppmr_config command

The bppmr_config command enables you to register BMC TrueSight Infrastructure Management Server with BMC TrueSight Report Engine, for enabling performance data collection. 

Warning

Note

If you register the BMC ProactivceNet Server with Sybase database, by default the value of -dbname will be storm_serverName.

 

The available options for the bppmr_config command are:

  • add

  • edit

  • list

  • unregister

Options for the bppmr_config command

option

Syntax

add

Registers a BMC ProactiveNet server with a BMC TrueSight Report Engine.

Warning

Note

  • If you have unregistered the BMC TrueSight Infrastructure Management Server, you can use this command to re-register the BMC TrueSight Infrastructure Management Server.
  • You can only register one BMC TrueSight Infrastructure Management Server with a BMC TrueSight Report Engine. Make sure you specify the correct BMC TrueSight Infrastructure Management Server logical name.
  • If the command exceeds 256 bytes, the Bourne shell (sh) does not accept the rest of the characters. This can cause the command to fail. Instead, use the Bourne Again Shell (bash).

Syntax for Oracle or Sybase databases:

bppmr_config.bat register -add -server bppmServer -dbtype OracleOrSybase -dbhost
bppmServerDatabaseHost -dbport bppmServerDatabaseport -dbname Oracle databaseName or SID -dbuser
bppmServerDatabaseusername -dbpassword bppmServerDatabasepassword -cellname bppmCellName

Example for Windows

bppmr_config.bat  register -add -server vm-w23-rds1536.bmc.com -dbtype ORACLE
-dbhost vm-w28-rds1627 -dbport 1521 -dbname BMCPDS -dbuser pnet -dbpassword pnet -cellname bppmCellName

Example for Solaris\Linux

./bppmr_config.sh  register -add -server vm-w23-rds1536.bmc.com -dbtype SYBASE
-dbhost vm-w28-rds1627 -dbport 2638 -dbuser dba -dbpassword pronet -cellname bppmCellName

Syntax for Oracle RAC setup:

bppmr_config.bat register -add -server bppmServer -dbtype RAC -dburl connectionURL -dbuser
bppmServerDatabaseusername -dbpassword bppmServerDatabasepassword  -cellname bppmCellName

Example for Windows

bppmr_config.bat register -add -server abc.bmc.com -dbtype RAC -dburl "(DESCRIPTION = (ADDRESS_LIST =(ADDRESS = (PROTOCOL = TCP)(HOST =vm-w28-rds1627)
(PORT = 1521)) ) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = bmcpds) ) )" -dbuser pnet -dbpassword pnet
-cellname bppmCellName 

Example for Solaris\Linux

./bppmr_config.sh register -add -server abc.bmc.com -dbtype RAC -dburl "(DESCRIPTION = (ADDRESS_LIST =(ADDRESS = (PROTOCOL = TCP)(HOST =vm-w28-rds1627)
(PORT = 1521)) ) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = bmcpds) ) )" -dbuser pnet -dbpassword pnet
-cellname bppmCellName

edit

Modifies a registered BMC TrueSight Infrastructure Management Server by providing the serverid of the server you want to modify

Warning

Note

You cannot edit a server that is already been unregistered.

Syntax for Oracle or Sybase databases:

bppmr_config.bat register -edit -server bppmServer -dbtype OracleOrSybase -dbhost
bppmServerDatabaseHost -dbport bppmServerDatabaseport -dbname Oracle databaseName or SID
-dbuser bppmServerDatabaseusername -dbpassword bppmServerDatabasepassword
-serverId serverIdRegitered -cellname bppmCellName

Example for Windows

bppmr_config.bat register -edit -server vm-w23-rds1536.bmc.com -dbtype ORACLE
-dbhost vm-w28-rds1627 -dbport 1521 -dbname BMCPDS -dbuser pnet -dbpassword pnet -serverId 1 -cellname bppmCellName

Example for Solaris/Linux

./bppmr_config.sh register -edit -server vm-w23-rds1536.bmc.com -dbtype ORACLE
-dbhost vm-w28-rds1627 -dbport 1521 -dbname BMCPDS -dbuser pnet -dbpassword pnet -serverId 1 -cellname bppmCellName

Syntax for Oracle RAC setup:

bppmr_config.bat register -edit -server bppmServer -dbtype RAC -dbuser
bppmServerDatabaseusername -dbpassword bppmServerDatabasepassword -dburl connectionURL
-serverId serverId -cellname bppmCellName

Example for Windows

bppmr_config.bat register -edit -server abc.bmc.com -dbtype RAC -dbuser pnet -dbpassword pnet
-dburl "(DESCRIPTION = (ADDRESS_LIST =(ADDRESS = (PROTOCOL = TCP)(HOST =vm-w28-rds1627)
(PORT = 1521)) ) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = bmcpds) ) )" -serverId 1 -cellname bppmCellName

Example for Solaris/Linux

./bppmr_config.sh register -add -server abc.bmc.com -dbtype RAC -dbuser pnet
-dbpassword pnet -dburl "(DESCRIPTION = (ADDRESS_LIST =(ADDRESS = (PROTOCOL = TCP)
(HOST =vm-w28-rds1627)(PORT = 1521)) ) (CONNECT_DATA = (SERVER = DEDICATED)
(SERVICE_NAME = bmcpds) ) )" -serverId 1 -cellname bppmCellName

list

Lists all available BMC TrueSight Infrastructure Management Servers and wheather they are registered
or unregistered by indicating Active status for registered servers, or Inactive status for unregistered servers.
Syntax for Windows:

bppmr_config.bat register -list 

Syntax for Solaris/Linux:

./bppmr_config.sh register -list

Unregister

Unregisters BMC TrueSight Infrastructure Management Server from a BMC TrueSight Report Engine. After executing the command, the application prompts you to confirm.

Error
Warning

After you unregister a BMC TrueSight Infrastructure Management Server, the configuration, rate, or stats data cannot be accessed. Even if you register the same BMC TrueSight Infrastructure Management Server again, the previous configuration, rate, or stats data does not get linked to the newly registered server.

Syntax for windows:

bppmr_config.bat unregister -server hostnameOfBPPMserverAlreadyRegistered

Example

bppmr_config.bat unregister -server vm-w28-rds1627

Syntax for Solaris/Linux:

./bppmr_config.sh unregister -server hostnameOfBPPMserverAlreadyRegistered

Example

./bppmr_config.sh unregister -server vm-w23-rds1536.bmc.com

 

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

BMC TrueSight Reporting 9.6