bao 20.11.02 application adapters space

Copyright 2009 -- 2011 BladeLogic, Inc. BMC, BMC Software, the BMC logos, and other BMC marks are trademarks or registered trademarks of BMC Software, Inc. in the U.S. and/orcertain other countries. BladeLogic and the BladeLogic logo are trademarks or registered trademarks of BladeLogic, Inc. in the U.S. and/or certain other countries. All other trademarks

or registered trademarks are the property of their respective owners. BMC Software Confidential.1

BMC Atrium Orchestrator Application Adapters 20.11.02



Copyright 2009 - 2011 BladeLogic, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registeredwith the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. Allother BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in othercountries. All other trademarks or registered trademarks are the property of their respective owners.

BladeLogic and the BladeLogic logo are the exclusive properties of BladeLogic, Inc. The BladeLogic trademark isregistered with the U.S. Patent and Trademark Office, and may be registered or pending registration in othercountries. All other BladeLogic trademarks, service marks, and logos may be registered or pending registration inthe U.S. or in other countries. All other trademarks or registered trademarks are the property of their respectiveowners.

ADD APP ADAPTER LICENSE INFORMATION

IT Infrastructure Library is a registered trademark of the Office of Government Commerce and is used here byBMC Software, Inc., under license from and with the permission of OGC.

ITIL is a Registered Trade Mark of the Office of Government Commerce in the United Kingdom and othercountries.

Linux is the registered trademark of Linus Torvalds.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of theirrespective owners.

SAP is a trademark or registered trademark of SAP AG in Germany and in several other countries.

UNIX is the registered trademark of The Open Group in the US and other countries.

The information included in this documentation is the proprietary and confidential information of BMC Software, Inc.,its affiliates, or licensors. Your use of this information is subject to the terms and conditions of the applicable EndUser License agreement for the product and to the proprietary and restricted rights notices included in the productdocumentation.

Restricted rights legendU.S. Government Restricted Rights to Computer Software. UNPUBLISHEDRIGHTS RESERVED UNDER THECOPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer softwareby the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time totime. Contractor/Manufacturer is BMC SOFTWARE INC, 2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA.Any contract notices should be sent to this address.

BMC Software Inc.2101 CityWest Blvd, Houston TX 77042-2827, USA713 918 8800Customer Support: 800 537 1813 or contact your local support center



1. Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161.1 What's new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

1.1.1 License entitlements for BMC Atrium Orchestrator Application Adapters . . . . . . . . . . . . . . . . . . 171.1.2 Version 20.11.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

1.1.2.1 Enhancements in version 20.11.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181.1.2.1.1 Introducing the BMC Atrium Orchestrator Application Adapter for DELL Advanced

Infrastructure Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.1.2.1.2 Introducing the BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . . 191.1.2.1.3 Introducing the BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet

Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.1.2.1.4 Changes to BMC Atrium Orchestrator Application Adapter for VMware Infrastructure . . . 201.1.2.1.5 Changes to BMC Atrium Orchestrator Application Adapter for BMC BladeLogic Network

Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201.1.2.1.6 Changes to BMC Atrium Orchestrator Application Adapter for Amazon EC2 . . . . . . . 211.1.2.1.7 Changes to BMC Atrium Orchestrator Application Adapter for HP Operations Manager . 211.1.2.1.8 Changes to BMC Atrium Orchestrator Application Adapter for HP Service Manager . 211.1.2.1.9 Changes to BMC Atrium Orchestrator Application Adapters for HP AssetCenter, HPServiceCenter, NetApp Rapid Cloning Utility, VMware vCloud, BMC BladeLogic Network

Automation, and VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211.1.2.1.10 Changes to BMC Atrium Orchestrator Application Adapter for Service-now . . . . . . . 221.1.2.1.11 Changes to BMC Atrium Orchestrator Application Adapter for Microsoft Active Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

1.1.2.2 Corrected problems in version 20.11.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221.1.3 Documentation updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.1.3.1 Documentation updates for December 12, 2011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231.1.4 Product alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.1.4.1 BMC BladeLogic Server Automation adapter fails to start when configured to use the CLI tunnel interface (ADAPTER-5102) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.2 Key concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241.2.1 Adapter overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241.2.2 Adapter module lifecycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

1.3 Working with Grid Manager and BMC Atrium Orchestrator Development Studio . . . . . . . . . . . . . . . . . 261.3.1 Importing a module from the repository to BMC Atrium Orchestrator Development Studio . . . . . 261.3.2 Enabling an adapter on a peer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271.3.3 Exporting the adapter module to the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271.3.4 Activating a module on the grid manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

1.4 Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281.4.1 Recommended installation environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291.4.2 Installation paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291.4.3 Using the GUI to install BMC Atrium Orchestrator content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301.4.4 Using command-line options to install BMC Atrium Orchestrator content . . . . . . . . . . . . . . . . . . 31

1.4.4.1 Silent installation properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311.4.4.2 Installation properties for content options files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321.4.4.3 Sample content options file templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341.4.4.4 Creating an options file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391.4.4.5 Executing a silent installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

1.5 BMC Atrium Orchestrator Application Adapter for Amazon EC2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411.5.1 Peer synchronization required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411.5.2 Configuring the BMC Atrium Orchestrator Application Adapter for Amazon EC2 adapter . . . . . . 421.5.3 BMC Atrium Orchestrator Application Adapter for Amazon EC2 module . . . . . . . . . . . . . . . . . . . 46

1.5.3.1 Top-level processes for the BMC Atrium Orchestrator Application Adapter for Amazon EC2 . . 461.5.3.2 Setup_Validation directory for BMC Atrium Orchestrator Application Adapter for Amazon EC2

directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471.5.3.3 Utilities directory for the BMC Atrium Orchestrator Application Adapter for Amazon EC2 . . 471.5.3.4 v1.0 directory for the BMC Atrium Orchestrator Application Adapter for Amazon EC2 . . . . 471.5.3.5 Adapter_Actions directory for the BMC Atrium Orchestrator Application Adapter for Amazon



EC2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491.5.4 Actor adapter requests and responses for the BMC Atrium Orchestrator Application Adapter for

Amazon EC2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501.5.4.1 Amazon EC2 actor adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501.5.4.2 Adapter requests and responses for Security Group operations . . . . . . . . . . . . . . . . . . . . . 52

1.5.4.2.1 Request and response for Revoke Security Group Ingress operation . . . . . . . . . . . . 531.5.4.2.2 Request and response for Delete Security Group operation . . . . . . . . . . . . . . . . . . . . 571.5.4.2.3 Request and response for Authorize Security Group Ingress operation . . . . . . . . . . . 591.5.4.2.4 Request and response for Create Security Group operation . . . . . . . . . . . . . . . . . . . . 631.5.4.2.5 Request and response for Describe Security Groups operation . . . . . . . . . . . . . . . . . 65

1.5.4.3 Adapter requests and responses for Elastic IP Address operations . . . . . . . . . . . . . . . . . . 671.5.4.3.1 Request and response for the Allocate Address operation . . . . . . . . . . . . . . . . . . . . . 671.5.4.3.2 Request and response for the Associate Address operation . . . . . . . . . . . . . . . . . . . . 701.5.4.3.3 Request and response for the Disassociate Address operation . . . . . . . . . . . . . . . . . 721.5.4.3.4 Request and response for Describe Addresses operation . . . . . . . . . . . . . . . . . . . . . 741.5.4.3.5 Request and response for the Release Address operation . . . . . . . . . . . . . . . . . . . . . 76

1.5.4.4 Adapter requests and responses for Instance operations . . . . . . . . . . . . . . . . . . . . . . . . . . 781.5.4.4.1 Request and response for Describe Instances operation . . . . . . . . . . . . . . . . . . . . . . 781.5.4.4.2 Request and response for the Stop Instances operation . . . . . . . . . . . . . . . . . . . . . . . 821.5.4.4.3 Request and response for the Describe Instance Attribute operation . . . . . . . . . . . . . 841.5.4.4.4 Request and response for the Terminate Instances operation . . . . . . . . . . . . . . . . . . 871.5.4.4.5 Request and response for the Reset Instance Attribute operation . . . . . . . . . . . . . . . 901.5.4.4.6 Request and response for the Run Instances operation . . . . . . . . . . . . . . . . . . . . . . . 921.5.4.4.7 Request and response for the Start Instances operation . . . . . . . . . . . . . . . . . . . . . . 1001.5.4.4.8 Request and response for the Reboot Instances operation . . . . . . . . . . . . . . . . . . . . 1031.5.4.4.9 Request and response for the Modify Instance Attribute operation . . . . . . . . . . . . . . . 105

1.5.4.5 Adapter request and response for the Amazon Machine Image operations . . . . . . . . . . . . 1081.5.4.5.1 Request and response for the Deregister Image operation . . . . . . . . . . . . . . . . . . . . . 1081.5.4.5.2 Request and response for the Describe Images operation . . . . . . . . . . . . . . . . . . . . . 1101.5.4.5.3 Request and response for the Modify Image Attribute operation . . . . . . . . . . . . . . . . 1131.5.4.5.4 Request and response for the Reset Image Attribute operation . . . . . . . . . . . . . . . . . 1161.5.4.5.5 Request and response for the Create Image operation . . . . . . . . . . . . . . . . . . . . . . . . 1181.5.4.5.6 Request and response for the Describe Image Attribute operation . . . . . . . . . . . . . . . 1211.5.4.5.7 Request and response for the Register Image operation . . . . . . . . . . . . . . . . . . . . . . 124

1.5.4.6 Adapter requests and responses for Monitoring operations . . . . . . . . . . . . . . . . . . . . . . . . 1281.5.4.6.1 Request and response for the Unmonitor Instances operation . . . . . . . . . . . . . . . . . . 1281.5.4.6.2 Request and response for Monitor Instances operation . . . . . . . . . . . . . . . . . . . . . . . 130

1.5.4.7 Adapter requests and responses for the Utility operation . . . . . . . . . . . . . . . . . . . . . . . . . . 1321.5.4.7.1 Request and response for the Get Console Output operation . . . . . . . . . . . . . . . . . . . 132

1.5.4.8 Adapter requests and responses for Elastic Block Store operations . . . . . . . . . . . . . . . . . . 1351.5.4.8.1 Request and response for the Create Snapshot operation . . . . . . . . . . . . . . . . . . . . . 1351.5.4.8.2 Request and response for the Create Volume operation . . . . . . . . . . . . . . . . . . . . . . 1371.5.4.8.3 Request and response for the Describe Snapshots operation . . . . . . . . . . . . . . . . . . 1401.5.4.8.4 Request and response for the Delete Snapshot operation . . . . . . . . . . . . . . . . . . . . . 1431.5.4.8.5 Request and response for the Describe Snapshot Attribute operation . . . . . . . . . . . . 1451.5.4.8.6 Request and response for the Modify Snapshot Attribute operation . . . . . . . . . . . . . . 1471.5.4.8.7 Request and response for the Describe Volumes operation . . . . . . . . . . . . . . . . . . . . 1501.5.4.8.8 Request and response for the Attach Volume operation . . . . . . . . . . . . . . . . . . . . . . . 1531.5.4.8.9 Request and response for the Detach Volume operation . . . . . . . . . . . . . . . . . . . . . . 1551.5.4.8.10 Request and response for the Reset Snapshot Attribute operation . . . . . . . . . . . . . 1581.5.4.8.11 Request and response for the Delete Volume operation . . . . . . . . . . . . . . . . . . . . . . 160

1.5.4.9 Adapter requests and responses for the Windows operations . . . . . . . . . . . . . . . . . . . . . . . 1621.5.4.9.1 Request and response for the Cancel Bundle Task operation . . . . . . . . . . . . . . . . . . 1621.5.4.9.2 Request and response for the Describe Bundle Tasks operation . . . . . . . . . . . . . . . . 1641.5.4.9.3 Request and response for the Bundle Instance operation . . . . . . . . . . . . . . . . . . . . . . 1671.5.4.9.4 Request and response for the Get Password Data operation . . . . . . . . . . . . . . . . . . . 170

1.5.4.10 Adapter request and response for the Regions and Availability Zones operations . . . . . . 1731.5.4.10.1 Request and response for the Describe Availability Zones operation . . . . . . . . . . . . 1731.5.4.10.2 Request and response for the Describe Regions operation . . . . . . . . . . . . . . . . . . . 175



1.5.4.11 Adapter requests and responses for Key pair operations . . . . . . . . . . . . . . . . . . . . . . . . . 1771.5.4.11.1 Request and response for the Create Key Pair operation . . . . . . . . . . . . . . . . . . . . . 1771.5.4.11.2 Request and response for the Delete Key Pair operation . . . . . . . . . . . . . . . . . . . . . 1801.5.4.11.3 Request and response for the Describe Key Pairs operation . . . . . . . . . . . . . . . . . . 182

1.5.5 EBS Storage Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1841.5.5.1 Storage Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

1.6 BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1851.6.1 Configuring the BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . . . . . . . . . . 1861.6.2 BMC Atrium Orchestrator Application Adapter for Amazon S3 module . . . . . . . . . . . . . . . . . . . . 188

1.6.2.1 Adapter_Actions directory for the BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

1.6.2.2 Setup_Validation directory for the BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

1.6.2.3 Utilities directory for BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . . 1891.6.2.4 v1.0 directory for the BMC Atrium Orchestrator Application Adapter for Amazon S3 . . . . . 189

1.6.3 BMC Atrium Orchestrator Application Adapter for Amazon S3 actor adapter requests and responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

1.6.3.1 Adapter requests and responses for the Bucket operations . . . . . . . . . . . . . . . . . . . . . . . . 1891.6.3.1.1 Create Bucket operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1901.6.3.1.2 Delete Bucket operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1911.6.3.1.3 List Bucket Contents operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

1.6.3.2 Adapter requests and responses for the Object operations . . . . . . . . . . . . . . . . . . . . . . . . . 1951.6.3.2.1 Put Object Inline operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1951.6.3.2.2 Delete Object operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1971.6.3.2.3 Put Object operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

1.6.3.3 Adapter requests and responses for the Service operation . . . . . . . . . . . . . . . . . . . . . . . . . 2001.6.3.3.1 List All My Buckets operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

1.7 BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . 2021.7.1 Pre-requisites for the BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . 2021.7.2 Configuring the BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . 2031.7.3 BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB module . . . . . . . . . . . . . . 209

1.7.3.1 Top-level processes for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB 209

1.7.3.1.1 Create Items process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

1.7.3.1.2 Delete Items process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

1.7.3.1.3 Find Items process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

1.7.3.1.4 Update Items process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

1.7.3.1.5 Get Versions process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

1.7.3.2 SetupValidation directory for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

1.7.3.3 Utilities directory for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . 226

1.7.3.3.1 Extract From Items process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

1.7.3.3.2 Set Default Adapter Name process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

1.7.3.3.3 Unsupported Class Type Error process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

1.7.3.3.4 Unsupported Delete Criteria Error process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

1.7.3.3.5 Unsupported Entity Error process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

1.7.3.3.6 Version Error Reporting process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228



1.7.3.3.7 ConfigurationItem - Create Instance process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

1.7.3.3.8 ConfigurationItem - Delete Instance process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

1.7.3.4 v2.0 - ConfigurationItem processes for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

1.7.3.4.1 Create CI Instance process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2331.7.3.4.2 Create Relation Instance process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2351.7.3.4.3 Delete Instance By Instance Name process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 2381.7.3.4.4 Delete Instance By InstanceId process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2391.7.3.4.5 Delete Instance By Reconciliation Identity process for v2.0 . . . . . . . . . . . . . . . . . . . . 2401.7.3.4.6 Find Instance process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2411.7.3.4.7 Update Instance process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

1.7.3.5 v2.0 - GraphQuery process for BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

1.7.3.5.1 Graph Query process for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481.7.3.6 v7.5 - ConfigurationItem processes for BMC Atrium Orchestrator Application Adapter for BMC

Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2511.7.3.6.1 Create CI Instance process for v7.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521.7.3.6.2 Delete Instance By Instance Name process for v7.5 . . . . . . . . . . . . . . . . . . . . . . . . . . 2541.7.3.6.3 Delete Instance By InstanceId process for v7.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2551.7.3.6.4 Delete Instance By Reconciliation Identity process for v7.5 . . . . . . . . . . . . . . . . . . . . 2561.7.3.6.5 Find Instance process for v7.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2571.7.3.6.6 Update Instance process for v7.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

1.7.4 BMC Atrium Orchestrator features for BMC Atrium CMDB Classes with parameter mapping . . . 2641.7.4.1 CI classes with mapped parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2641.7.4.2 Relationship classes with mapped parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2641.7.4.3 Enum Value parameter mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2641.7.4.4 Time Value parameter mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

1.7.5 BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB requests and responses for v2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

1.7.5.1 Adapter request and response for the create-instance operation for v2.0 . . . . . . . . . . . . . . 2661.7.5.2 Adapter request and response for the create-relation-instance operation for v2.0 . . . . . . . 2711.7.5.3 Adapter request and response for the delete-instance operation for v2.0 . . . . . . . . . . . . . . 2771.7.5.4 Adapter request and response for the get-instances operation for v2.0 . . . . . . . . . . . . . . . 2811.7.5.5 Adapter request and response for the set-instance operation for v2.0 . . . . . . . . . . . . . . . . 289

1.7.6 BMC Atrium Orchestrator Application Adapter for BMC Atrium CMDB requests and responses for v7.5 and v7.6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

1.7.6.1 Adapter request and response for the create-instance operation for v7.5 and 7.6 . . . . . . . 2961.7.6.2 Adapter request and response for the delete-instance operation for v7.5 and 7.6 . . . . . . . 2981.7.6.3 Adapter request and response for the get-instances operation for v7.5 and 7.6 . . . . . . . . . 3001.7.6.4 Adapter request and response for the set-instance operation for v7.5 and 7.6 . . . . . . . . . . 305

1.8 BMC Atrium Orchestrator Application Adapter for BMC Event Manager . . . . . . . . . . . . . . . . . . . . . . . 3071.8.1 BMC Atrium Orchestrator actor adapter for BMC Event Manager . . . . . . . . . . . . . . . . . . . . . . . . 3071.8.2 Supported versions of BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3081.8.3 Configuring the BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . . . . . . . . . . . . 3081.8.4 BMC Atrium Orchestrator Application Adapter for BEM module . . . . . . . . . . . . . . . . . . . . . . . . . 312

1.8.4.1 Top-level processes for BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . 3121.8.4.1.1 Process inputs for BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . 3121.8.4.1.2 Create Items process for BMC Atrium Orchestrator Application Adapter for BEM . . . 3131.8.4.1.3 Find Items process for BMC Atrium Orchestrator Application Adapter for BEM . . . . . 3151.8.4.1.4 Perform Operations process for BMC Atrium Orchestrator Application Adapter for BEM . 3151.8.4.1.5 Update Items process for BMC Atrium Orchestrator Application Adapter for BEM . . . 316

1.8.4.2 SetupValidation directory for BMC Atrium Orchestrator Application Adapter for BEM . . . . 3171.8.4.3 Utilities directory for BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . . . . 3171.8.4.4 Version directories for BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . . . 317

1.8.5 Actor adapter requests and responses for BMC Atrium Orchestrator Application Adapter for BEM . 318



1.8.5.1 Adapter request and response for the Create operation for BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

1.8.5.1.1 Create Event operation for BMC Atrium Orchestrator Application Adapter for BEM . . 3181.8.5.2 Adapter requests and responses for the Maintenance Mode operations for BMC Atrium

Orchestrator Application Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3221.8.5.2.1 Disable Event Reporting operation for BMC Atrium Orchestrator Application Adapter for

BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3221.8.5.2.2 Resume Event Reporting operation for BMC Atrium Orchestrator Application Adapter for

BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3231.8.5.3 Adapter requests and responses for the Retrieve operations for BMC Atrium Orchestrator

Application Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3241.8.5.3.1 Retrieve Events operation for BMC Atrium Orchestrator Application Adapter for BEM . . . 3251.8.5.3.2 Retrieve Event by Date operation for BMC Atrium Orchestrator Application Adapter for

BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3291.8.5.3.3 Retrieve Events by Component operation for BMC Atrium Orchestrator Application

Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3321.8.5.3.4 Retrieve Events by ID operation for BMC Atrium Orchestrator Application Adapter for

BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3361.8.5.4 Adapter requests and responses for the Update operations for BMC Atrium Orchestrator

Application Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3391.8.5.4.1 Update Event operation for BMC Atrium Orchestrator Application Adapter for BEM . 3391.8.5.4.2 Acknowledge Event operation for BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3431.8.5.4.3 Annotate Event operation for BMC Atrium Orchestrator Application Adapter for BEM . . . 3441.8.5.4.4 Assign Event operation for BMC Atrium Orchestrator Application Adapter for BEM . . 3461.8.5.4.5 Close Event operation for BMC Atrium Orchestrator Application Adapter for BEM . . . 3481.8.5.4.6 Reopen Event operation for BMC Atrium Orchestrator Application Adapter for BEM . 3501.8.5.4.7 Set Event Priority operation for BMC Atrium Orchestrator Application Adapter for BEM . 3521.8.5.4.8 Set Action Result operation for BMC Atrium Orchestrator Application Adapter for BEM . 354

1.8.6 BMC Atrium Orchestrator Monitor Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3571.8.6.1 Setting up events for the BMC Atrium Orchestrator Monitor Adapter for BEM . . . . . . . . . . 3581.8.6.2 Propagating events from the cells to the gateway for the BMC Atrium Orchestrator Monitor

Adapter for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3591.8.6.3 Module configuration for BMC Event Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3591.8.6.4 Propagation rules for the maintenance mode for the BMC Atrium Orchestrator Monitor Adapter

for BEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3601.8.6.5 BMC Atrium Orchestrator Monitor Adapter for BEM Event . . . . . . . . . . . . . . . . . . . . . . . . . 360

1.8.7 Troubleshooting specific to BMC Atrium Orchestrator Application Adapter for BEM . . . . . . . . . . 3611.9 BMC Atrium Orchestrator Application Adapter for BMC BladeLogic Network Automation . . . . . . . . . . 361

1.9.1 Supported versions of BMC BladeLogic Network Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . 3621.9.2 Configuring the BMC BladeLogic Network Automation adapter . . . . . . . . . . . . . . . . . . . . . . . . . . 3621.9.3 BMC BladeLogic Network Automation application adapter module . . . . . . . . . . . . . . . . . . . . . . . 366

1.9.3.1 Top-level processes for the BMC BladeLogic Network Automation adapter . . . . . . . . . . . . 3661.9.3.2 Setup Validation directory for the BMC BladeLogic Network Automation adapter . . . . . . . . 3681.9.3.3 Utilities directory for the BMC BladeLogic Network Automation adapter . . . . . . . . . . . . . . . 3681.9.3.4 Version directories for the BMC BladeLogic Network Automation adapter . . . . . . . . . . . . . 368

1.9.3.4.1 Process inputs for the BMC Atrium Orchestrator Application Adapter for BMC BladeLogic Network Automation module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

1.9.4 Actor adapter requests and responses for the BMC Atrium Orchestrator application adapter for BMC BladeLogic Network Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

1.9.4.1 Authentication Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3711.9.4.1.1 Request and response for the Login operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3711.9.4.1.2 Request and response for the Logout operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

1.9.4.2 Device Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3741.9.4.2.1 Request and response for the Get Devices operation . . . . . . . . . . . . . . . . . . . . . . . . . 374



1.9.4.2.2 Request and response for the Get Configuration operation . . . . . . . . . . . . . . . . . . . . 3841.9.4.2.3 Request and response for the Add Device operation . . . . . . . . . . . . . . . . . . . . . . . . . 3871.9.4.2.4 Request and response for the Delete Device operation . . . . . . . . . . . . . . . . . . . . . . . 394

1.9.4.3 Report Service operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3951.9.4.3.1 Request and response for the Send Job Summary Report Email operation . . . . . . . . 395

1.9.4.4 Job Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3981.9.4.4.1 Request and response for the Job Approval or Job Rejection operation . . . . . . . . . . 3991.9.4.4.2 Request and response for the Retrieve Job Status by JobID operation . . . . . . . . . . . 401

1.9.4.5 Span Action Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4031.9.4.5.1 Request and response for the Device Rollback or Merge By Config Type operation . 4041.9.4.5.2 Request and response for the Merge Compliant All Assigned operation . . . . . . . . . . 4101.9.4.5.3 Request and response for the Merge Compliant By Rule operation . . . . . . . . . . . . . . 4151.9.4.5.4 Request and response for the Merge Compliant By Rule Set operation . . . . . . . . . . . 4201.9.4.5.5 Request and response for the Merge By Adhoc Template operation . . . . . . . . . . . . . 4251.9.4.5.6 Request and response for the Merge By Template Group operation . . . . . . . . . . . . . 4301.9.4.5.7 Request and response for the Perform Backup operation . . . . . . . . . . . . . . . . . . . . . . 4351.9.4.5.8 Request and response for the Perform Custom Action operation . . . . . . . . . . . . . . . . 4401.9.4.5.9 Request and response for the Commit operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4461.9.4.5.10 Request and response for the Mark as Trusted by Config Date operation . . . . . . . . 4511.9.4.5.11 Request and response for Restore By Template Group operation . . . . . . . . . . . . . . 4561.9.4.5.12 Request and response for the Get Span Action Results operations . . . . . . . . . . . . . 461

1.9.4.6 Events service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4631.9.4.6.1 Request and response for the Log Events operation . . . . . . . . . . . . . . . . . . . . . . . . . 463

1.9.4.7 Substitution Parameter Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4661.9.4.7.1 Request and response for the Add Substitution Parameter operation . . . . . . . . . . . . 4661.9.4.7.2 Request and response for the Modify Substitution Parameter operation . . . . . . . . . . 4691.9.4.7.3 Request and response for the Get Substitution Parameter by Name operation . . . . . 471

1.9.4.8 Template Group Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4721.9.4.8.1 Request and response for the Modify Template Group operation . . . . . . . . . . . . . . . . 4721.9.4.8.2 Request and response for the Get Template Group By Name operation . . . . . . . . . . 476

1.9.4.9 Job Approval Type Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4791.9.4.9.1 Request and response for the Get Job Approval Types operation . . . . . . . . . . . . . . . 479

1.9.4.10 Group Service operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4801.9.4.10.1 Request and response for the Get Simple Groups operation . . . . . . . . . . . . . . . . . . 480

1.9.4.11 Predefined Jobs operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4841.9.4.11.1 Request and response for the Get All Predefined Job Names operation . . . . . . . . . 4851.9.4.11.2 Request and response for the Get Predefined Job Names operation . . . . . . . . . . . . 4861.9.4.11.3 Request and response for the Get Predefined Job Parameter Types operation . . . . 4871.9.4.11.4 Request and response for the Submit Job operation . . . . . . . . . . . . . . . . . . . . . . . . 4901.9.4.11.5 Request and response for the Validate Predefined Job Parameters operation . . . . . 4961.9.4.11.6 Request and response for the Get All Shared Runtime Parameters operation . . . . . 499

1.9.4.12 Firewall Service operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5001.9.4.12.1 Request and response for the Get All Firewall Rules operation . . . . . . . . . . . . . . . . 5001.9.4.12.2 Request and response for the Overwrite Firewall Rules operation . . . . . . . . . . . . . . 503

1.9.5 Troubleshooting specific to BMC Atrium Orchestrator Application Adapter for BMC BladeLogic Network Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508

1.10 BMC Atrium Orchestrator Application Adapter for BMC BladeLogic Server Automation . . . . . . . . . . 5091.10.1 Getting started with the BMC BladeLogic Server Automation adapter . . . . . . . . . . . . . . . . . . . . 510

1.10.1.1 Prerequisites for the BMC BladeLogic Server Automation adapter . . . . . . . . . . . . . . . . . . 5101.10.1.2 Supported versions of BMC BladeLogic Server Automation . . . . . . . . . . . . . . . . . . . . . . . 5101.10.1.3 Configuring the BMC Atrium Orchestrator Application Adapter for BMC BladeLogic Server

Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5111.10.1.3.1 Adapter configuration samples and elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5121.10.1.3.2 Setting up authentication for BMC BladeLogic SSO . . . . . . . . . . . . . . . . . . . . . . . . . 519

1.10.2 Application adapter module for the BMC BladeLogic Server Automation adapter . . . . . . . . . . . 5231.10.2.1 Setup Validation directory for BMC BladeLogic Server Automation adapter . . . . . . . . . . . 5231.10.2.2 Version directories for the BMC BladeLogic Server Automation adapter . . . . . . . . . . . . . 5231.10.2.3 Utilities directory for the BMC BladeLogic Server Automation adapter . . . . . . . . . . . . . . . 5231.10.2.4 Working with the BMC BladeLogic Server Automation adapter module . . . . . . . . . . . . . . 523



1.10.2.4.1 How to create a BMC BladeLogic Deploy Job that deploys a BMC BladeLogic Package 524

1.10.2.5 Executing NSH commands and scripts using the BMC BladeLogic Server Automation adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

1.10.2.6 Modifying the command timeout for the BMC BladeLogic Server Automation adapter . . . 5301.10.3 Actor adapter requests and responses for the BMC BladeLogic Server Automation adapter . . 530

1.10.3.1 Supported adapter request formats for the BMC BladeLogic Server Automation adapter 5311.10.3.2 Actor adapter requests and responses for executing BLCLI commands . . . . . . . . . . . . . . 5311.10.3.3 Actor adapter requests and responses for executing scripts and commands on NSH . . . 5371.10.3.4 Actor adapter requests and responses for executing Jython scripts . . . . . . . . . . . . . . . . . 5421.10.3.5 Actor adapter request and response with different command formats . . . . . . . . . . . . . . . . 5451.10.3.6 Actor adapter requests and responses using the BladeLogic Web Services interface . . . 549

1.10.4 Troubleshooting the BMC BladeLogic Server Automation adapter . . . . . . . . . . . . . . . . . . . . . . 5521.10.4.1 Configuration errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5521.10.4.2 Executing any operation in an Oracle Solaris environment creates a core dump file . . . . 5521.10.4.3 Persistent connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553

1.10.4.3.1 Lifespan of a cached connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5531.11 BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . 554

1.11.1 BMC Atrium Orchestrator actor adapter for BMC ProactiveNet Performance Manager . . . . . . 5541.11.2 Supported versions of BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . 5551.11.3 Configuring the BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance

Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5551.11.4 BMC ProactiveNet Performance Manager application adapter module . . . . . . . . . . . . . . . . . . . 559

1.11.4.1 SetupValidation directory for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

1.11.4.2 Version directory for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

1.11.4.3 Top-level processes for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

1.11.4.3.1 Create Items process for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

1.11.4.3.2 Find Items process for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

1.11.4.3.3 Perform Operations process for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

1.11.4.3.4 Update Items process for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

1.11.4.4 Process inputs for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564

1.11.4.5 Utilities directory for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

1.11.5 Actor adapter requests and responses for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

1.11.5.1 Adapter request and response for the Create operation for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . 565

1.11.5.1.1 Create Event operation for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

1.11.5.2 Adapter requests and responses for the Maintenance Mode operations for BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . 569

1.11.5.2.1 Disable Event Reporting operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5701.11.5.2.2 Resume Event Reporting operation for BMC Atrium Orchestrator Application Adapter for

BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5711.11.5.3 Adapter requests and responses for the Retrieve operations for BMC Atrium Orchestrator

Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . 5721.11.5.3.1 Retrieve Events operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5731.11.5.3.2 Retrieve Event by Date operation for BMC Atrium Orchestrator Application Adapter for

BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5781.11.5.3.3 Retrieve Events by Component operation for BMC Atrium Orchestrator Application



Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5811.11.5.3.4 Retrieve Events by ID operation for BMC Atrium Orchestrator Application Adapter for

BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5851.11.5.4 Adapter requests and responses for the Update operations for BMC Atrium Orchestrator

Application Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . 5881.11.5.4.1 Update Event operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5881.11.5.4.2 Acknowledge Event operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5921.11.5.4.3 Annotate Event operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5941.11.5.4.4 Assign Event operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5961.11.5.4.5 Close Event operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5981.11.5.4.6 Reopen Event operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6001.11.5.4.7 Set Event Priority operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6021.11.5.4.8 Set Action Result operation for BMC Atrium Orchestrator Application Adapter for BMC

ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6041.11.6 BMC Atrium Orchestrator Monitor Adapter for BMC ProactiveNet Performance Manager . . . . 608

1.11.6.1 Setting up events for the BMC Atrium Orchestrator Monitor Adapter for the BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

1.11.6.2 Propagating events from the cells to the gateway for the BMC Atrium Orchestrator Monitor Adapter for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609

1.11.6.3 Module configuration for BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . 6101.11.6.4 Propagation rules for the maintenance mode for BMC Atrium Orchestrator Monitor Adapter for

BMC ProactiveNet Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6101.11.6.5 BMC Atrium Orchestrator Monitor Adapter for BMC ProactiveNet Performance Manager event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

1.11.7 Troubleshooting specific to BMC Atrium Orchestrator Application Adapter for BMC ProactiveNet Performanance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

1.12 BMC Atrium Orchestrator application adapter for BMC Remedy AR System . . . . . . . . . . . . . . . . . . . 6121.12.1 Using the Integration Mapping Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6121.12.2 Supported versions for the BMC Remedy AR System adapter . . . . . . . . . . . . . . . . . . . . . . . . . 6121.12.3 Configuring the BMC Atrium Orchestrator Application Adapter for BMC Remedy System . . . . 6121.12.4 BMC Remedy AR System application adapter module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624

1.12.4.1 Top-level processes for the BMC Remedy AR System adapter . . . . . . . . . . . . . . . . . . . . 6241.12.4.1.1 Create Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6251.12.4.1.2 Delete Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6271.12.4.1.3 Find Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6281.12.4.1.4 Query Update Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6301.12.4.1.5 Update Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6321.12.4.1.6 Query Server Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634

1.12.4.2 Version directories for the BMC Remedy AR System adapter . . . . . . . . . . . . . . . . . . . . . . 6351.12.4.2.1 Delete Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6351.12.4.2.2 Get Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6361.12.4.2.3 Get Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6381.12.4.2.4 Insert Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6391.12.4.2.5 Query Update Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6401.12.4.2.6 Reset Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6421.12.4.2.7 Update Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6431.12.4.2.8 Batch Insert Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6441.12.4.2.9 Batch Delete Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6461.12.4.2.10 Batch Update Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6471.12.4.2.11 Batch Query Update Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

1.12.4.3 Utilities directory for the BMC Remedy AR System adapter . . . . . . . . . . . . . . . . . . . . . . . 6501.12.4.3.1 Translate Keys to Remedy IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650



1.12.4.4 Setup Validation directory for the BMC Remedy AR System adapter . . . . . . . . . . . . . . . . 6521.12.5 Actor adapter requests and responses for the BMC Atrium Orchestrator application adapter for

Remedy AR System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6521.12.5.1 Peer mapping feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6521.12.5.2 Actor adapter requests for the BMC Atrium Orchestrator application adapter for Remedy AR

System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6521.12.5.2.1 Adapter request and response with schema-retrieve . . . . . . . . . . . . . . . . . . . . . . . . 6531.12.5.2.2 Adapter request and response with set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6551.12.5.2.3 Adapter request and response with update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6561.12.5.2.4 Adapter request and response with get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6581.12.5.2.5 Adapter request and response with query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6601.12.5.2.6 Adapter request and response with query-update . . . . . . . . . . . . . . . . . . . . . . . . . . . 6641.12.5.2.7 Adapter request and response with delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6661.12.5.2.8 Adapter request and response with reset-cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6671.12.5.2.9 Adapter request and response with attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . 667

1.12.6 BMC Remedy AR System monitor adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6691.12.6.1 Configure a Notify Filter in BMC Remedy AR System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6701.12.6.2 Adapter event for the BMC Remedy AR System monitor adapter . . . . . . . . . . . . . . . . . . . 670

1.13 BMC Atrium Orchestrator Application Adapter for Solaris Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6711.13.1 Supported version of Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6711.13.2 Configuring the BMC Atrium Orchestrator Application Adapter for Solaris Zones . . . . . . . . . . . 6721.13.3 BMC Atrium Orchestrator Application Adapter for Solaris Zones module . . . . . . . . . . . . . . . . . 676

1.13.3.1 Top-level processes for the BMC Atrium Orchestrator Application Adapter for Solaris Zones 6761.13.3.2 SetupValidation directory for the BMC Atrium Orchestrator Application Adapter for Solaris

Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6771.13.3.3 Utilities directory for the BMC Atrium Orchestrator Application Adapter for Solaris Zones 6771.13.3.4 v10.4 directory for the BMC Atrium Orchestrator Application Adapter for Solaris Zones . . 677

1.13.4 Actor adapter requests and responses for the BMC Atrium Orchestrator Application Adapter for Solaris Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678

1.13.4.1 Adapter requests and responses for the Basic Zone operations . . . . . . . . . . . . . . . . . . . . 6791.13.4.1.1 Request and response for the Boot Zone operation . . . . . . . . . . . . . . . . . . . . . . . . . 6791.13.4.1.2 Request and response for the Reboot Zone operation . . . . . . . . . . . . . . . . . . . . . . . 6811.13.4.1.3 Request and response for the Install Zone operation . . . . . . . . . . . . . . . . . . . . . . . . 6831.13.4.1.4 Request and response for the Uninstall Zone operation . . . . . . . . . . . . . . . . . . . . . . 6851.13.4.1.5 Request and response for the Halt Zone operation . . . . . . . . . . . . . . . . . . . . . . . . . . 6871.13.4.1.6 Request and response for the Ready Zone operation . . . . . . . . . . . . . . . . . . . . . . . . 689

1.13.4.2 Adapter request and response for the Advanced Zone operation . . . . . . . . . . . . . . . . . . . 6911.13.4.2.1 Adapter request and response for the Advanced Zone operation . . . . . . . . . . . . . . . 691

1.13.4.3 Adapter requests and responses for the Configure Zone operations . . . . . . . . . . . . . . . . 6931.13.4.3.1 Request and response for the Create Zone operation . . . . . . . . . . . . . . . . . . . . . . . 6941.13.4.3.2 Request and response for the Create Zone With Custom Settings operation . . . . . . 6961.13.4.3.3 Request and response for the Create Zone From Template operation . . . . . . . . . . . 7041.13.4.3.4 Request and response for the Clone Zone operation . . . . . . . . . . . . . . . . . . . . . . . . 7061.13.4.3.5 Request and response for the Retrieve Zone Configuration operation . . . . . . . . . . . 7091.13.4.3.6 Request and response for the Update Zone Configuration operation . . . . . . . . . . . . 7111.13.4.3.7 Request and response for the Delete Zone operation . . . . . . . . . . . . . . . . . . . . . . . . 724

1.14 BMC Atrium Orchestrator Application Adapter for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . 7261.14.1 Getting started with the BMC Atrium Orchestrator Application Adapter for VMware Infrastructure . 727

1.14.1.1 Supported versions of VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7271.14.1.2 Prerequisites for the BMC Atrium Orchestrator application adapter for VMware Infrastructure 7271.14.1.3 Configuring the BMC Atrium Orchestrator application adapter for VMware Infrastructure 728

1.14.1.3.1 Configuring the VMware Infrastructure actor adapter . . . . . . . . . . . . . . . . . . . . . . . . 7281.14.1.3.2 Configuring the VMware Infrastructure event monitor adapter . . . . . . . . . . . . . . . . . 7301.14.1.3.3 Configuring the VMware Infrastructure SNMP monitor adapter . . . . . . . . . . . . . . . . 734

1.14.2 BMC Atrium Orchestrator Application Adapter for VMware Infrastructure module . . . . . . . . . . . 7361.14.2.1 Top-level processes for the VMware Infrastructure adapter . . . . . . . . . . . . . . . . . . . . . . . 736



1.14.2.2 SetupValidation directory for the VMware Infrastructure adapter . . . . . . . . . . . . . . . . . . . 7361.14.2.3 Utilities directory for the VMware Infrastructure adapter . . . . . . . . . . . . . . . . . . . . . . . . . . 7361.14.2.4 Version directories for the VMware Infrastructure adapter . . . . . . . . . . . . . . . . . . . . . . . . . 741

1.14.2.4.1 Process Inputs for the VMware Infrastructure adapter module . . . . . . . . . . . . . . . . . 7411.14.2.5 VMWare home page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742

1.14.3 Actor adapter requests and responses for the VMware Infrastructure adapter . . . . . . . . . . . . . 7431.14.3.1 Adapter requests and responses for Basic VM operations . . . . . . . . . . . . . . . . . . . . . . . . 753

1.14.3.1.1 Request and response for the Power_On_VM operation . . . . . . . . . . . . . . . . . . . . . 7531.14.3.1.2 Request and response for the Power_Off_VM operation . . . . . . . . . . . . . . . . . . . . . 7551.14.3.1.3 Request and response for the Suspend_VM operation . . . . . . . . . . . . . . . . . . . . . . . 7571.14.3.1.4 Request and response for the Resume_VM operation . . . . . . . . . . . . . . . . . . . . . . . 7591.14.3.1.5 Request and response for the Reset_VM operation . . . . . . . . . . . . . . . . . . . . . . . . . 7611.14.3.1.6 Request and response for the Restart_Guest_OS operation . . . . . . . . . . . . . . . . . . 7631.14.3.1.7 Request and response for the Shut_Down_Guest_OS operation . . . . . . . . . . . . . . . 765

1.14.3.2 Adapter requests and responses for Advanced VM operations . . . . . . . . . . . . . . . . . . . . . 7661.14.3.2.1 Request and response for the Create_VM_Snapshot operation . . . . . . . . . . . . . . . . 7671.14.3.2.2 Request and response for the Revert_VM_Snapshot operation . . . . . . . . . . . . . . . . 7691.14.3.2.3 Request and response for the Move_Virtual_Disk operation . . . . . . . . . . . . . . . . . . 7711.14.3.2.4 Request and response for the Validate_VM_Migration operation . . . . . . . . . . . . . . . 7731.14.3.2.5 Request and response for the Migrate_VM operation . . . . . . . . . . . . . . . . . . . . . . . . 7761.14.3.2.6 Request and response for the Relocate_VM operation . . . . . . . . . . . . . . . . . . . . . . . 7781.14.3.2.7 Request and response for the Acquire_Mks_Ticket operation . . . . . . . . . . . . . . . . . 7821.14.3.2.8 Request and response for the Retrieve_VM_File_Info operation . . . . . . . . . . . . . . . 7841.14.3.2.9 Request and response for the Update_VM_Snapshot operation . . . . . . . . . . . . . . . 7881.14.3.2.10 Request and response for the Delete_VM_Snapshot operation . . . . . . . . . . . . . . . 790

1.14.3.3 Adapter requests and responses for Configure VM operations . . . . . . . . . . . . . . . . . . . . . 7921.14.3.3.1 Request and response for the Create_VM operation . . . . . . . . . . . . . . . . . . . . . . . . 7931.14.3.3.2 Request and response for the Create_VM_With_Custom_Settings operation . . . . . 7961.14.3.3.3 Request and response for the Clone_VM operation . . . . . . . . . . . . . . . . . . . . . . . . . 8051.14.3.3.4 Request and response for the Clone_VM_With_Custom_Settings operation . . . . . . 8081.14.3.3.5 Request and response for the Add_Hard_Disk operation . . . . . . . . . . . . . . . . . . . . . 8181.14.3.3.6 Request and response for the Retrieve_VM_Configuration operation . . . . . . . . . . . 8211.14.3.3.7 Request and response for the Add_Ethernet_Adapter operation . . . . . . . . . . . . . . . 8321.14.3.3.8 Request and response for the Add_CD_ROM operation . . . . . . . . . . . . . . . . . . . . . 8361.14.3.3.9 Request and response for the Retrieve_CPU_Configuration operation . . . . . . . . . . 8391.14.3.3.10 Request and response for the Retrieve_Memory_Configuration operation . . . . . . . 8411.14.3.3.11 Request and response for the Retrieve_Hard_Disk_Configuration operation . . . . . 8441.14.3.3.12 Request and response for the Retrieve_CD_ROM_Configuration operation . . . . . 8461.14.3.3.13 Request and response for the Retrieve_Ethernet_Adapter_Configuration operation . . 8501.14.3.3.14 Request and response for the Update_CD_ROM_Configuration operation . . . . . . 8531.14.3.3.15 Request and response for the Update_VM_Configuration operation . . . . . . . . . . . 8551.14.3.3.16 Request and response for the Update_CPU_Configuration operation . . . . . . . . . . 8651.14.3.3.17 Request and response for the Update_Memory_Configuration operation . . . . . . . 8671.14.3.3.18 Request and response for the Update_Ethernet_Adapter_Configuration operation . . . 8691.14.3.3.19 Request and response for the Update_Hard_Disk_Configuration operation . . . . . . 8741.14.3.3.20 Request and response for the Delete_VM operation . . . . . . . . . . . . . . . . . . . . . . . . 8771.14.3.3.21 Request and response for the Remove_Hard_Disk operation . . . . . . . . . . . . . . . . 8791.14.3.3.22 Request and response for the Remove_Ethernet_Adapter operation . . . . . . . . . . . 8811.14.3.3.23 Request and response for the Remove_CD_ROM operation . . . . . . . . . . . . . . . . . 8831.14.3.3.24 Request and response for the Export_VM_As_OVF_Template operation . . . . . . . 8861.14.3.3.25 Request and response for the Import_OVF_Template_As_VM operation . . . . . . . 888

1.14.3.4 Adapter requests and responses for Monitor VM operations . . . . . . . . . . . . . . . . . . . . . . . 8911.14.3.4.1 Request and response for the Retrieve_VM_CPU_Usage operation . . . . . . . . . . . . 8911.14.3.4.2 Request and response for the Retrieve_VM_Disk_Usage operation . . . . . . . . . . . . 8931.14.3.4.3 Request and response for the Retrieve_VM_Memory_Usage operation . . . . . . . . . 8961.14.3.4.4 Request and response for the Retrieve_VM_Network_Usage operation . . . . . . . . . 8991.14.3.4.5 Request and response for the Retrieve_VM_Status operation . . . . . . . . . . . . . . . . . 902



1.14.3.4.6 Request and response for the Retrieve_Task_Status operation . . . . . . . . . . . . . . . . 9041.14.3.4.7 Request and response for the Retrieve_VM_Alarm_List operation . . . . . . . . . . . . . . 9071.14.3.4.8 Request and response for the Delete_VM_Alarm operation . . . . . . . . . . . . . . . . . . . 911

1.14.3.5 Adapter requests and responses for Host operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9121.14.3.5.1 Request and response for the Create_Host operation . . . . . . . . . . . . . . . . . . . . . . . 9131.14.3.5.2 Request and response for the Add_Host_To_Cluster operation . . . . . . . . . . . . . . . . 9151.14.3.5.3 Request and response for the Add_Virtual_Switch operation . . . . . . . . . . . . . . . . . . 9181.14.3.5.4 Request and response for the Add_Virtual_NIC operation . . . . . . . . . . . . . . . . . . . . 9211.14.3.5.5 Request and response for the Add_Port_Group operation . . . . . . . . . . . . . . . . . . . . 9231.14.3.5.6 Request and response for the Add_NAS_Datastore operation . . . . . . . . . . . . . . . . . 9261.14.3.5.7 Request and response for the Add_Vmfs_Datastore operation . . . . . . . . . . . . . . . . 9281.14.3.5.8 Request and response for the Add_Internet_Scsi_Send_Targets operation . . . . . . 9301.14.3.5.9 Request and response for the Move_Host_To_Cluster operation . . . . . . . . . . . . . . . 9321.14.3.5.10 Request and response for the Retrieve_Host_Configuration operation . . . . . . . . . 9341.14.3.5.11 Request and response for the Retrieve_Host_DVS_Configuration operation . . . . . 9381.14.3.5.12 Request and response for the Retrieve_Host_Network_Configuration operation . . 9411.14.3.5.13 Request and response for the Retrieve_Host_Datastore_Configuration operation . 9471.14.3.5.14 Request and response for the Retrieve_Virtual_Switch_Configuration operation . . 9491.14.3.5.15 Request and response for the Retrieve_Virtual_NIC_Configuration operation . . . . 9531.14.3.5.16 Request and response for the Retrieve_Port_Group_Configuration operation . . . . 9561.14.3.5.17 Request and response for the Retrieve_Available_Disks_For_Vmfs operation . . . 9591.14.3.5.18 Request and response for the Retrieve_Host_CPU_Usage operation . . . . . . . . . . 9621.14.3.5.19 Request and response for the Retrieve_Host_Memory_Usage operation . . . . . . . 9641.14.3.5.20 Request and response for the Retrieve_ESX_Hosts operation . . . . . . . . . . . . . . . . 9661.14.3.5.21 Request and response for the Retrieve_Host_Scsi_Topology operation . . . . . . . . 9691.14.3.5.22 Request and response for the Rescan_Hba operation . . . . . . . . . . . . . . . . . . . . . . 9731.14.3.5.23 Request and response for the Rescan_All_Hba operation . . . . . . . . . . . . . . . . . . . 9741.14.3.5.24 Request and response for the Update_Host_Network_Configuration operation . . . 9761.14.3.5.25 Request and response for the Extend_Vmfs_Datastore operation . . . . . . . . . . . . . 9841.14.3.5.26 Request and response for the Update_Software_Internet_Scsi_Enabled operation . . 9871.14.3.5.27 Request and response for the Update_Internet_Scsi_Name operation . . . . . . . . . 9881.14.3.5.28 Request and response for the Remove_Host_From_Cluster operation . . . . . . . . . 9901.14.3.5.29 Request and response for the Remove_Virtual_Switch operation . . . . . . . . . . . . . 9921.14.3.5.30 Request and response for the Remove_Virtual_NIC operation . . . . . . . . . . . . . . . . 9941.14.3.5.31 Request and response for the Remove_Port_Group operation . . . . . . . . . . . . . . . 9961.14.3.5.32 Request and response for the Remove_Datastore operation . . . . . . . . . . . . . . . . . 9981.14.3.5.33 Request and response for the Enter_Maintenance_Mode operation . . . . . . . . . . . 10001.14.3.5.34 Request and response for the Exit_Maintenance_Mode operation . . . . . . . . . . . . . 1002

1.14.3.6 Adapter requests and responses for Datastore operations . . . . . . . . . . . . . . . . . . . . . . . . 10041.14.3.6.1 Request and response for the Retrieve_Datastore_List operation . . . . . . . . . . . . . . 10041.14.3.6.2 Request and response for the Retrieve_Datastore_Virtual_Machines operation . . . 10081.14.3.6.3 Request and response for the Retrieve_Vmfs_Datastore_Storage_Controller operation 1010

1.14.3.7 Adapter requests and responses for Cluster operations . . . . . . . . . . . . . . . . . . . . . . . . . . 10131.14.3.7.1 Request and response for the Retrieve_Cluster_Configuration operation . . . . . . . . 10131.14.3.7.2 Request and response for the Retrieve_Cluster_Datastore_Configuration operation . . . 10191.14.3.7.3 Request and response for the Retrieve_Clusters operation . . . . . . . . . . . . . . . . . . . 10211.14.3.7.4 Request and response for the Update_Cluster_DRS_Configuration operation . . . . 1029

1.14.3.8 Adapter requests and responses for Datacenter operations . . . . . . . . . . . . . . . . . . . . . . . 10341.14.3.8.1 Request and response for the Retrieve_Datacenters operation . . . . . . . . . . . . . . . . 1034

1.14.3.9 Adapter requests and responses for Folder operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 10401.14.3.9.1 Request and response for the Create_Folder operation . . . . . . . . . . . . . . . . . . . . . . 10401.14.3.9.2 Request and response for the Retrieve_Folders operation . . . . . . . . . . . . . . . . . . . . 10421.14.3.9.3 Request and response for the Destroy_Folder operation . . . . . . . . . . . . . . . . . . . . . 1050

1.14.3.10 Adapter requests and responses for Discovery operations . . . . . . . . . . . . . . . . . . . . . . . 10521.14.3.10.1 Request and response for the Retrieve_MOB_Reference_By_Display_Name operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052



1.14.3.10.2 Request and response for the Retrieve_Display_Name_By_MOB_Reference operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1054

1.14.3.11 Adapter requests and responses for the Resource Pool operation . . . . . . . . . . . . . . . . . 10561.14.3.11.1 Request and response for the Retrieve_Resource_Pool_Children operation . . . . . 1056

1.14.3.12 Adapter requests and responses for the Basic vApp operations . . . . . . . . . . . . . . . . . . . 10601.14.3.12.1 Request and response for the Power_On_VApp operation . . . . . . . . . . . . . . . . . . . 10601.14.3.12.2 Request and response for the Power_Off_VApp operation . . . . . . . . . . . . . . . . . . . 10611.14.3.12.3 Request and response for the Unregister_VApp operation . . . . . . . . . . . . . . . . . . . 1063

1.14.3.13 Adapter requests and responses for the VApp Configuration operations . . . . . . . . . . . . 10651.14.3.13.1 Request and response for the Export_VApp_As_OVF_Template operation . . . . . . 10651.14.3.13.2 Request and response for the Import_OVF_Template_As_VApp operation . . . . . . 10671.14.3.13.3 Request and response for the Create VApp operation . . . . . . . . . . . . . . . . . . . . . . 10701.14.3.13.4 Request and response for the Clone_VApp operation . . . . . . . . . . . . . . . . . . . . . . 10731.14.3.13.5 Request and response for the Update_VApp_Configuration operation . . . . . . . . . . 1078

1.14.4 Monitor adapter events for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10821.14.4.1 Event monitor adapter for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082

1.14.4.1.1 Supported event types for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . 10821.14.4.1.2 Event monitor adapter events for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . 1083

1.14.4.2 SNMP monitor adapter for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10861.14.4.2.1 SNMP monitor adapter event for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . 1086

1.14.5 Adapter request elements for VMware Infrastructure adapter . . . . . . . . . . . . . . . . . . . . . . . . . . 10901.14.5.1 Guest operating system identifiers for VMware Infrastructure . . . . . . . . . . . . . . . . . . . . . . 10901.14.5.2 spec for vApp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10911.14.5.3 property-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10951.14.5.4 product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10961.14.5.5 ovf-section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10971.14.5.6 ip-assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10981.14.5.7 address-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10981.14.5.8 console-ip-route-config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10991.14.5.9 device-change-list for removing devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1099

1.14.5.9.1 Removing a hard disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10991.14.5.9.2 Removing a CD ROM drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11001.14.5.9.3 Removing an ethernet adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1100

1.14.5.10 device-change-list for updating devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11011.14.5.10.1 Updating a SCSI controller configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11011.14.5.10.2 Updating an ethernet adapter configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1101

1.14.5.11 ip-route-config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11021.14.5.12 cpu-feature-mask-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11021.14.5.13 cpu-allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11031.14.5.14 console-vnic-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11051.14.5.15 device-change-list for adding devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1106

1.14.5.15.1 Adding a SCSI controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11061.14.5.15.2 Adding a virtual disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11071.14.5.15.3 Adding a PCI Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11081.14.5.15.4 Adding an ethernet adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11081.14.5.15.5 Adding a CD ROM drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1109

1.14.5.16 location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11101.14.5.17 spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11111.14.5.18 vnic-list . . .

bao 20.11.02 application adapters space

Documents

bladelogic trademarks

allother bmc trademarks

bmc software logo

bmc marks

bmc logos

bmc software confidential

trademarks of theirrespective

bladelogic logo