Ensuring BMC Server Automation 8.2 compatibility with BMC Cloud Lifecycle Management 2.1.x

The BMC Server Automation version 8.2.00 schema file for Representational State Transfer (REST) request and response formats includes new attributes that are incompatible with BMC Cloud Lifecycle Management 2.1.x.

To ensure that BMC Server Automation 8.2.00 is compatible with BMC Cloud Lifecycle Management 2.1.x, after you install BMC Server Automation 8.2.00, take one of the following actions:

  • Specify the REST schema version 8.1.02 in a parameter for each REST call to the Application Server. This method lets each application use its own version of REST to communicate with BMC Server Automation. Using this method is important if a you have more than one application using REST to communicate with BMC Server Automation. See Specifying the REST version 8.1.02 in the REST call to the Application Server.

Setting the REST version 8.1.02 schema as the default

To set the REST version 8.1.02 schema as the default schema version to use for REST request and responses, you can use BMC Application Server Administration (blasadmin) attributes.

The following table lists the attributes:

blasadmin attribute

Description

RestAssetAttributesUseInternalNames

If set to true, the response for any REST GET call on an asset has the internal name of the asset attributes.
If set to false, the display name of the assest attributes is used. The default is true.

DefaultRestVersion

Default REST schema version to use for consuming or generating REST request and responses. Specify a BMC Server Automation version (for example, 8.1.02 or 8.2). The default value is blank, which specifies use of the latest BMC Server Automation schema for processing REST calls.

To set blasadmin attributes to use the version 8.1.02 schema file for REST

  1. Start the blasadmin utility. See Starting the Application Server Administration console.
  2. Enter the following commands:

    set AppServer RestAssetAttributesUseInternalNames false
    set AppServer DefaultRestVersion 8.1.02
  3. Restart the Application Server. See Starting, stopping, and restarting Application Servers.

Specifying the REST version 8.1.02 in the REST call to the Application Server

To specify the REST schema version 8.1.02 in a REST call to the Application Server, use the version query parameter. This parameter is optional. However, if included in the call, the version parameter overrides the default REST schema version set in the DefaultRestVersion BMC Application Server Administration (blasadmin) attribute.

For example, the following REST GET call to fetch Server groups returns the response that is compatible with BMC Server Automation version 8.1.02 REST schema:
https://<AppServerName>:9843/group/Servers/?username=BLAdmin&password=&role=BLAdmins&version=8.1.02

Was this page helpful? Yes No Submitting... Thank you

Comments