pw blade


The pw blade commands support the integration of BMC ProactiveNet with BMC Server Automation.

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 blade setup

This command sets up the credentials on the BMC ProactiveNet Server for accessing BMC Server Automation from BMC ProactiveNet. This command stores the credentials on the BMC ProactiveNet Server, but it does not verify that the credentials are valid.

The credentials can be set up with or without the UDDI registry on the BMC ProactiveNet Server.

Syntax for pw blade setup command

pw blade setup [-use_uddi -uddiuser <uddi_user> -uddipass <uddi_password>] -host hostname [-port <port_number>] -user <user> -pass <password> -role <role>
Information
Example

Setting up credentials with the UDDI registry

pw blade setup -use_uddi -uddiuser admin -uddipass admin -host UDDISERVERHOSTNAME -port 8080 -user BLAdmin -pass bladelogic -role BLAdmins

Setting up credentials without the UDDI registry

pw blade setup -host BLADESERVERHOSTNAME -user BLAdmin -pass bladelogic -role BLAdmins

The following table describes the options for the pw blade setup connection command.

pw blade setup command options

Option

Description

-use_uddi

Specifies to use UDDI to connect to BMC Server Automation Web Services

-uddiuser uddi_user_name

User name to connect to the UDDI server, if using the UDDI registry

-uddipass uddi_password

Password to connect to the UDDI server, if using the UDDI registry

-host hostname

Host name or IP address of BMC Server Automation Web Services, or the UDDI Server if using the UDDI registry

-port port_number

Port number of BMC Server Automation Web Services, or the UDDI Server if using the UDDI registry

-user user_name

User name to connect to the BMC Server Automation Application Server

-pass password

Password to connect to the BMC Server Automation Application Server

-role role

Role in the BMC Server Automation Application Server to which the user account is associated

pw blade test

This command tests the credentials that were created by the pw blade setup command.

Syntax for pw blade test command

pw blade test

pw blade clear

This command deletes the credentials that were created by the pw blade setup command and breaks the connection between BMC ProactiveNet and the BMC Server Automation Application Server.

Warning

Note

To change the integration of BMC ProactiveNet with BMC Server Automation, you must first run the pw blade clear command, and then use the pw blade setup command to set up the credentials of the new integration.

Syntax for pw blade clear command

pw blade clear

pw blade create packages

This command creates BMC ProactiveNet Agent packages that can be deployed to the BMC Server Automation Application Server using BMC Server Automation. The packages do not enable the Integration Service on the BMC Server Automation Application Server.

Syntax for pw blade create packages command

pw blade create packages 

The BMC ProactiveNet Agent software is loaded into the BMC Server Automation depot under /Software/BMC/ProactiveNet as BMC_PN_Agent version_build_platform.

The packages are created in the BMC Server Automation depot under /Packages/BMC/ProactiveNet as BMC_PN_Agent_platform.

pw blade get_setup

This command displays the credentials and setup details that BMC ProactiveNet is using to access the BMC Server Automation Application Server.

Syntax for pw blade get_setup command

pw blade get_setup

The pw blade commands listed in the following sections must be used only when provisioning packages of components from the BMC ProactiveNet Central Monitoring repository to remote servers by using BMC Server Automation. For information about the provisioning process, see Creating-packages-for-provisioning.

pw blade auto_prov_prep

This command goes through the repository solutions in BMC ProactiveNet, and creates for each solution and each version, a new package in BMC Server Automation. You must run this command manually to populate all the packages from the repository to BMC Server Automation. If a package already exists in BMC Server Automation, it is not updated. For more information, see Creating-packages-for-provisioning.

Syntax for pw blade auto_prov_prep command for the base repository

pw blade auto_prov_prep -package Package.xml

Syntax for pw blade auto_prov_prep command for the extended repository

pw blade auto_prov_prep -package Package_Extended.xml

pw blade get_package_status

This command displays the status of the packages in BMC Server Automation. The status depends on the BLStatus.xml log file at installationDirectory\ProactiveNet\pw\pronto\logs. This XML file contains one entry for each combination of solution and version.

Syntax for pw blade get_package_status

pw blade get_package_status 

pw blade auto_create_job

This command creates BMC Server Automation jobs for packages that have already been defined.

Syntax for pw blade auto_create_job command

pw blade auto_create_job -package <packageFileName>.xml

pw blade auto_execute_job

This command run the existing BMC Server Automation batch and deployment jobs.

Syntax for pw blade auto_execute_job command

pw blade auto_execute_job -package <packageFileName>.xml

pw blade get_job_status

This command retrieves the status of the BMC Server Automation job that you specify.

Syntax for pw blade get_job_status command

pw blade get_job_status [-name <jobName>] [-runkey <runKey>] [-out <outFileName>]

pw blade update_sso_account

This command changes the default user name and password that are used to authenticate the BMC ProactiveNet Server to the BMC Atrium Single Sign-On (SSO) server. The default user name and password are required to create packages of the components in the BMC ProactiveNet Central Monitoring Repository and load them into BMC Server Automation when using BMC Atrium SSO with BMC ProactiveNet.

The updated user name and password are stored encrypted in the pronet.conf file. For more information about the BMC Atrium SSO system, see the BMC-Atrium-SSO-authentication.

Syntax for pw blade update_sso_account command

pw blade update_sso_account -user <userName> -pass <password>

pw blade command return codes

Code

Description

0

Successful execution of the command

1

Syntax error

>1

Execution error

Related topic

Integrating-with-BMC-Server-Automation

 

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

BMC ProactiveNet 9.6