bmc atrium orchestra tor 7.6.02 platform

Copyright 2004 -- 2012 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/or certain 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 Platform 7.6.02

Copyright 2004 - 2012 BladeLogic, Inc. BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. 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 is registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BladeLogic trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners. AS/400, Current, DB2, IBM, Informix, Netcool, Notes, Pointbase, and Tivoli are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. IT Infrastructure Library is a registered trademark of the Office of Government Commerce and is used here by BMC 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 other countries. 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 their respective 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 End User License agreement for the product and to the proprietary and restricted rights notices included in the product documentation. Restricted rights legend U.S. Government Restricted Rights to Computer Software. UNPUBLISHEDRIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time to time. 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, USA 713 918 8800 Customer Support: 800 537 1813 or contact your local support center


2

1. Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1 What's new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.1 Urgent issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.1.1 Upgrading server components from 7.6.02 to the latest service pack overwrites custom keystore files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.1.2 Out of memory heap dump generated by a grid peer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.1.3 Java for Mac OS X 10.6 Update 6 (1.6.0_29) prevents start of BMC Atrium Orchestrator Development Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.2 License entitlements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.3 Documentation updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.3.1 Documentation updates for April 19, 2012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.3.2 Documentation updates for December 21, 2011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.3.3 Documentation updates for September 22, 2011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4 Service packs and patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.1 Service Pack 4 for version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.1.1 Corrected issues in 7.6.02 SP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.1.2 Product updates for 7.6.02 SP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.1.3 Installing 7.6.02 SP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.2 Service Pack 3 for version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.2.1 Corrected issues in 7.6.02 SP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.2.2 Product updates for 7.6.02 SP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.2.3 Installing 7.6.02 SP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.3 Service Pack 2 for version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.3.1 Corrected issues in 7.6.02 SP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.3.2 Product updates in 7.6.02 SP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.3.3 Installing 7.6.02 SP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.4 Service Pack 1 for version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.4.1 Corrected issues in 7.6.02 SP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.4.2 Product update in 7.6.02 SP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.4.4.3 Installing 7.6.02 SP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.5 Version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.5.1 Corrected issues in version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.5.2 New and changed features in version 7.6.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.6 Future product changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 Key concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.1 BMC Atrium Orchestrator components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.2 Architecture overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3 End-to-end process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.1 Generate use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.1.1 Organizational target areas for interviews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.1.2 Typical use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.1.3 Sample use case - Apache Tomcat recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.1.4 Sample use case - Unresponsive device recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.2 Capture business metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.3 Prioritize use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.4 Develop formal designs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.5 Automate the workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.3.6 Prove automation savings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3 Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.1 Recommended installation environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2 Deployment use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2.1 Demonstration environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2.2 Multiple servers deployed at a single location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2.2.1 Basic production environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2.2.2 High availability for the CDP at a single location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2.2.3 High availability and fault tolerance for multiple servers at a single location . . . . . . . . 1.3.2.3 Multiple servers deployed at multiple locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2.3.1 Disaster recovery for multiple servers at multiple locations . . . . . . . . . . . . . . . . . . . . . 1.3.2.3.2 Spanned DMZ deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11 12 14 14 14 15 15 17 18 18 18 18 18 19 20 20 20 20 21 21 21 21 22 22 23 23 25 25 25 26 28 31 31 32 34 36 38 39 40 41 43 44 45 45 46 46 47 47 47 47 48 49 50 50 53 53 54


3

1.3.3 Minimum system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.4 Communications port requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.5 Communication paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.6 User permissions and rights requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.7 Dedicated IP address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.8 Time synchronization among component computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4 Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.1 Installation requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2 Preparing for installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.1 Installation process overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.1.1 Installation programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.1.2 BMC Atrium Orchestrator installation methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2 Installation worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.1 Access Manager installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.2 Repository installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.3 CDP installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.4 BMC Atrium Orchestrator Development Studio installation worksheet . . . . . . . . . . . . 1.4.2.2.5 AP installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.6 LAP installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.7 HA-CDP installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.2.8 BMC Atrium Orchestrator Operator Control Panel installation worksheet . . . . . . . . . . 1.4.2.2.9 Graphing server installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.3 Preparing to install the product components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.3.1 Obtaining the BMC Atrium Orchestrator product installation files . . . . . . . . . . . . . . . . 1.4.2.3.2 Configuring DEP on Windows computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.2.3.3 Secure communication among components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3 Using the GUI to install the BMC Atrium Orchestrator platform and content . . . . . . . . . . . . . . . . 1.4.3.1 Installing Access Manager and the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.1.1 Installing Access Manager and the repository at the same time . . . . . . . . . . . . . . . . . 1.4.3.1.2 Installing Access Manager only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.1.3 Installing the repository separate from Access Manager . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.2 Installing a CDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.3 Installing BMC Atrium Orchestrator Development Studio . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.4 Installing an AP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.5 Installing an LAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.6 Installing a CDP as an HA-CDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.7 Installing the BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . . 1.4.3.8 Installing the graphing server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.9 Installing BMC Atrium Orchestrator content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.3.9.1 Installing BMC Atrium Orchestrator content with the GUI installation . . . . . . . . . . . . . 1.4.4 Using command-line options to perform silent installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.1 Silent installation properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.1.1 Installation properties for platform options files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.1.2 Installation properties for content options files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.2 Creating an options file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.3 Executing a silent installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.4 Options file templates for silent installations and upgrades . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.4.1 Sample platform options file templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.4.4.2 Sample content options file templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.5 Verifying the success of the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.5.1 Viewing installation log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.5.2 Verifying the repository installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.5.3 Verifying a peer installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.5.4 Verifying the graphing server installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.6 Uninstalling the BMC Atrium Orchestrator platform components . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.6.1 How the program uninstalls components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.4.6.2 Using the GUI to uninstall BMC Atrium Orchestrator platform server components . . . . . . . 1.4.6.3 Using the GUI to uninstall BMC Atrium Orchestrator Development Studio . . . . . . . . . . . . . 1.4.6.4 Using a command line to uninstall platform components . . . . . . . . . . . . . . . . . . . . . . . . . . .

55 57 58 59 59 59 59 59 60 60 61 61 62 62 64 65 68 69 71 72 74 75 76 76 77 77 77 78 78 79 80 81 82 83 83 84 85 86 87 88 89 90 90 97 99 102 103 103 113 118 118 119 119 120 121 122 124 125 125


4

1.5 Upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.1 Supported upgrade paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.2 Upgrade roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3 Upgrade worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.1 Access Manager upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.2 Repository upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.3 CDP upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.4 BMC Atrium Orchestrator Development Studio upgrade worksheet . . . . . . . . . . . . . . . . . . 1.5.3.5 AP upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.6 LAP upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.7 HA-CDP upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.3.8 BMC Atrium Orchestrator Operator Control Panel upgrade worksheet . . . . . . . . . . . . . . . . 1.5.3.9 Graphing server upgrade worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.4 Product upgrades using the GUI installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.4.1 Upgrading Access Manager and the repository using the GUI installation . . . . . . . . . . . . . 1.5.4.2 Upgrading the CDP using the GUI installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.4.3 Upgrading BMC Atrium Orchestrator Development Studio using the GUI installation . . . . . 1.5.4.4 Upgrading an AP using the GUI installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.4.5 Upgrading an LAP using the GUI installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.4.6 Upgrading an HA-CDP using the GUI installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.5 Product upgrades using a silent installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.5.1 Creating options files for an upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.5.5.2 Executing a silent upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6 Integrating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.1 Types of integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2 Integration mechanisms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.1 Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.1.1 Adapter classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.1.2 Actor and monitor adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.2 Operations Actions Management modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.3 Web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.3.1 Security and permissions for web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.3.2 ORCA web service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.2.3.3 Legacy web service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.3 Example integration scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.3.1 Integration with BMC Remedy ITSM applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.3.1.1 BMC Remedy ITSM Change Management example integration scenario . . . . . . . . . 1.6.3.1.2 Implementing the BMC Remedy ITSM example integration example scenario . . . . . . 1.6.3.2 Integration with BMC BladeLogic Server Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.3.2.1 BMC BladeLogic Server Automation example integration scenario . . . . . . . . . . . . . . 1.6.3.2.2 Implementing the BMC BladeLogic Server Automation example integration scenario 1.6.4 Example implementation using ORCA web service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.4.1 ORCA web service example use case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.6.4.2 Implementation of ORCA example use case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7 Using BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7.1 Getting started with BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . 1.7.1.1 Logging on to BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . 1.7.1.2 Starting a workflow in BMC Atrium Orchestrator Operator Control Panel from a URL . . . . 1.7.1.3 To log off BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . . . . . 1.7.1.4 Opening a workflow in the BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . 1.7.2 Workflow execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7.2.1 Executing a workflow in Run to Completion mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7.2.2 BMC Atrium Orchestrator Operator Control Panel timeouts . . . . . . . . . . . . . . . . . . . . . . . . 1.7.2.3 Executing a workflow in step mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7.2.4 Increasing the maximum number of active workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7.3 Navigating BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.7.3.1 Screen tips for BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . 1.7.3.2 Workflow status indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8 Administering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

126 126 126 127 128 129 130 131 131 132 133 133 134 134 135 136 137 137 138 139 139 140 141 142 143 144 144 145 146 146 147 148 153 196 202 202 203 205 207 207 209 210 210 218 222 223 223 223 225 225 225 226 226 227 227 228 228 229 229


5

1.8.1 Logging on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 1.8.1.1 Logging on to Access Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 1.8.1.2 Logging on to Grid Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 1.8.2 Navigating the Grid Manager interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 1.8.2.1 Status tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 1.8.2.2 Manage tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 1.8.2.3 Administration tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 1.8.3 Starting and stopping product components and services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 1.8.3.1 Starting the CDP and Access Manager services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 1.8.3.2 Stopping the CDP and Access Manager services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 1.8.4 Configuring BMC Atrium Orchestrator for high availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 1.8.4.1 Overview of HA configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 1.8.4.2 High-availability configuration for Access Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 1.8.4.2.1 Configuring Access Manager for high availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 1.8.4.3 Configuring the repository to use an external database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 1.8.4.4 Working with HA-CDPs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 1.8.4.4.1 Peer ranking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 1.8.4.4.2 Editing peer ranking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 1.8.5 Managing grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 1.8.5.1 Working with grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 1.8.5.1.1 Creating grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 1.8.5.1.2 Changing and removing grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 1.8.5.1.3 Reviewing grid history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 1.8.5.1.4 Monitoring grid status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 1.8.5.1.5 Pausing and restarting a grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 1.8.5.2 Grid components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 1.8.5.2.1 Component status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 1.8.5.3 Processes status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 1.8.6 Managing peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 1.8.6.1 Adding peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 1.8.6.2 Changing peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 1.8.6.3 Removing peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 1.8.6.4 Starting and stopping peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 1.8.6.5 Manually creating peer configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 1.8.7 Managing users and user roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 1.8.7.1 Managing accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 1.8.7.2 Managing roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 1.8.7.2.1 BMC Atrium Orchestrator default roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 1.8.7.2.2 Working with roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 1.8.7.2.3 User roles and module permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 1.8.7.2.4 Assigning permissions to modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 1.8.8 Managing BMC Atrium Orchestrator security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 1.8.8.1 Using Access Manager to configure external SSO connections . . . . . . . . . . . . . . . . . . . . . 261 1.8.8.1.1 Editing the default SSO configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 1.8.8.1.2 Configuring an external SSO connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 1.8.8.1.3 Changing or deleting an external SSO connection configuration . . . . . . . . . . . . . . . . 263 1.8.8.1.4 Sample external SSO connection configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 1.8.8.1.5 Mapping external roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266 1.8.8.2 Configuring BMC Atrium Orchestrator to use HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 1.8.8.2.1 Configuring BMC Atrium Orchestrator Development Studio to communicate with a CDP over HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 1.8.8.2.2 Configuring BMC Atrium Orchestrator components to communicate with each other over HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 1.8.8.2.3 Disabling the HTTP port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 1.8.8.3 Using the Maintenance Tool to encrypt a password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 1.8.8.4 Specifying a keystore password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 1.8.8.5 Specifying a trust store password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 1.8.8.6 Encryption to secure files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 1.8.8.6.1 Disabling encryption of files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283


6

1.8.9 Managing modules on the grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.9.1 Activating modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.9.2 Deactivating modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.9.3 Viewing and editing active modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.10 Managing processes and schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.10.1 Executing a process on demand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.10.2 Terminating a process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.10.3 Adding a process schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.10.4 Editing a process schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.10.5 Deleting a process schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11 Managing adapters on the grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.1 Adapter configuration and enablement overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.2 Adding adapters to a grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.3 Enabling adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.4 Adapter status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.4.1 Starting and stopping an adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.5 Configuring adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.6 Upgrading adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.11.7 Removing adapters from a grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12 Managing content in the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.1 Repository overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.1.1 Repository Manager overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.1.2 Accessing Repository Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.2 Uploading a prepackaged adapter to the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.3 Implementing custom adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.4 Deleting content from the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.5 Downloading content from the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.6 Uploading content to the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.7 Transferring content between repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.7.1 Transferring content from the primary repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.12.7.2 Transferring content to the primary repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13 Managing metrics and audit records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.1 Audit records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.1.1 Audit records data store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.1.2 Audit table information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.1.3 Generating configuration reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.1.4 Reviewing audit information on the History tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.2 Grid performance metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.2.1 Grid performance data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.2.2 Collecting grid performance metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.2.3 Managing grid performance records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.2.4 Grid performance table information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.3 Managing process metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.3.1 Process metrics table information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.8.13.4 Generating process metrics reports by using the graphing server . . . . . . . . . . . . . . . . . . . 1.8.13.4.1 Metrics by DescriptionStatus - sample report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9 Developing workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.1 Navigating the interface with the Launch Pad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.1.1 Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.1.2 Library Manager overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.1.3 Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.1.4 Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.2 Configuring BMC Atrium Orchestrator Development Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.2.1 Before you configure a connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.2.2 Connecting to an environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.2.2.1 Troubleshooting connection problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.2.3 Disabling output parameter automapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.3 Creating the Hello World workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.3.1 Overview of creating the Hello World workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

283 284 285 285 286 287 287 288 289 289 290 291 291 292 292 293 293 294 295 295 296 296 296 297 297 298 299 299 300 300 301 302 302 302 303 304 304 305 306 306 306 308 310 310 311 312 315 315 316 316 316 317 318 318 318 319 320 321 321


7

1.9.3.2 Before you begin to create the Hello World workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 1.9.3.3 Creating a module and a process for the Hello World workflow . . . . . . . . . . . . . . . . . . . . . 322 1.9.3.4 Creating and configuring the Append utility for the Hello World workflow . . . . . . . . . . . . . . 323 1.9.3.5 Running the Hello World workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 1.9.4 Creating a directory workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 1.9.4.1 Overview of creating the workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 1.9.4.2 Before you begin to create a workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 1.9.4.3 Creating a module and a workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 1.9.4.4 Configuring the Start activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 1.9.4.5 Creating and configuring the first Assign activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 1.9.4.6 Creating and configuring the Call Adapter activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 1.9.4.7 Testing the workflow and gathering sample data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 1.9.4.8 Creating and configuring the second Assign activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 1.9.4.9 Configuring the End activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 1.9.4.10 Testing the workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 1.9.4.11 Creating the configuration items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 1.9.4.12 Importing utilities modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 1.9.4.13 Creating the connection details concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 1.9.4.14 Testing the Make connection details for Invoke Command workflow . . . . . . . . . . . . . . . . 353 1.9.4.15 Creating the Copy File workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 1.9.4.16 Creating the Copy Files in Directory workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 1.9.4.17 Testing the Copy Files in Directory process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 1.9.5 Using modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 1.9.5.1 Library Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 1.9.5.1.1 Importing modules from the repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 1.9.5.1.2 Importing modules from disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 1.9.5.1.3 Exporting modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 1.9.5.2 Creating modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 1.9.5.3 Using process directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 1.9.5.4 Creating rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 1.9.5.5 Creating schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 1.9.5.6 Configuration items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 1.9.5.6.1 Working with configuration items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 1.9.6 Process design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 1.9.6.1 Process types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 1.9.6.2 Process properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 1.9.6.3 Adding activities to a process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 1.9.6.4 Activity properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 1.9.6.4.1 Properties tab of the Activity Property panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 1.9.6.4.2 Logging tab of the Activity Property panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 1.9.6.4.3 Metadata tab of the Activity Property panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 1.9.6.5 Compensations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 1.9.6.6 Called processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 1.9.6.6.1 Using a called process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 1.9.6.6.2 Automapping context items with called process inputs and outputs . . . . . . . . . . . . . . 390 1.9.6.6.3 Called Process viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 1.9.6.6.4 Calling Process viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 1.9.6.7 Renaming a process or process directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 1.9.6.8 Operator processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 1.9.6.8.1 Using hyperlinks in processes exposed in the BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 1.9.6.9 WSDL to workflow process generation wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 1.9.6.10 Searching for processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 1.9.6.10.1 Using the Advanced Search Results window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 1.9.6.11 Generating process documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 1.9.6.12 Export the process module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 1.9.7 Using software configuration management systems when creating workflows . . . . . . . . . . . . . . 398 1.9.7.1 Software configuration management overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 1.9.7.2 Configuring BMC Atrium Orchestrator Development Studio to use CVS . . . . . . . . . . . . . . . 399


8

1.9.7.3 Configuring BMC Atrium Orchestrator Development Studio to use Subversion . . . . . . . . . 1.9.7.4 Configuring BMC Atrium Orchestrator Development Studio to use Perforce . . . . . . . . . . . . 1.9.8 Using a transform editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.1 Transform editors overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.2 Basic transform editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.2.1 Test frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.2.2 Select resource pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.2.3 Preview frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.2.4 Function sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.2.5 Basic transform editor functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.3 Advanced transform editor overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.3.1 XPath transform editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.8.3.2 XSLT transform editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9 Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.1 Start activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.1.1 Start activity properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.2 End activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.3 Assign activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.3.1 Creating an assign statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.3.2 Deleting a context with an assign statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4 Operator Dialog activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.1 String input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.2 Password input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.3 Numeric input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.4 Date input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.5 Boolean input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.6 List input with static values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.4.7 List input with dynamic values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.5 Switch activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.6 For activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.7 Spawn activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.8 Launch Job activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.9 Utility activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.9.1 Using date utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.9.2 Numeric utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.9.3 Using string type utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.10 Metrics activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.10.1 Collecting business metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.11 Pause activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.12 Script activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.12.1 Script parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.13 Call Adapter activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.14 Integration Mapping activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.14.1 Creating a new mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.14.2 Editing a mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.14.3 Updating a mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.9.15 Comment activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10 Context item overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10.1 Context Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10.1.1 Search for a context item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10.2 Dynamic contexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10.2.1 Dynamic context scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10.3 System parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.10.4 Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.11 Testing and debugging processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.11.1 Testing a process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.11.2 The debugger tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.11.2.1 Debugger view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.9.11.2.2 Execution Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

400 401 402 402 402 403 403 403 403 404 407 408 411 427 428 428 429 430 431 433 433 434 434 435 435 436 436 437 438 439 440 440 441 441 444 444 446 446 447 447 448 450 450 451 452 452 452 452 453 453 454 455 455 456 456 456 457 458 458


9

1.9.11.2.3 Test console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 1.9.11.2.4 Context Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 1.9.11.2.5 Debugger toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 1.9.11.3 Using the Breakpoint Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 1.9.12 Language enablement support for BMC Atrium Orchestrator . . . . . . . . . . . . . . . . . . . . . . . . . . 460 1.9.12.1 Limitations on using multibyte characters in BMC Atrium Orchestrator Development Studio . 461 1.9.12.2 Language enablement support for BMC Atrium Orchestrator adapters . . . . . . . . . . . . . . . 461 1.10 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 1.10.1 Troubleshooting the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 1.10.1.1 Configuring an alternate tmp directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 1.10.1.2 On Windows 2008 R2 and 64-bit Internet Explorer 8.0, the GUI does not function properly . . 463 1.10.2 Collecting diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 1.10.3 Working with logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 1.10.3.1 Understanding the log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 1.10.3.2 Viewing logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 1.10.3.3 Using the log files to troubleshoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 1.10.3.4 Sending troubleshooting logs to BMC Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 1.10.4 CDP server fails to start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 1.10.5 Graphing server fails to start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 1.10.6 Troubleshooting developing workflows in BMC Atrium Orchestrator Development Studio . . . . 473 1.10.6.1 Log files for troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 1.10.6.2 Impact of secure module configuration on existing processes . . . . . . . . . . . . . . . . . . . . . . 475 1.10.7 Troubleshooting problems in BMC Atrium Orchestrator Operator Control Panel . . . . . . . . . . . . 476 1.10.7.1 BMC Atrium Orchestrator Operator Control Panel fails to start . . . . . . . . . . . . . . . . . . . . . 476 1.10.7.2 No visible workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 1.10.7.3 Resolving failed workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 1.10.7.4 RSL error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 1.10.8 Reference material for troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 1.10.8.1 About failed workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 1.11 Known issues and workarounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 1.12 Support information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 1.13 Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481


10


HomeThis space contains information about the BMC Atrium Orchestrator 7.6.02 Platform release, which is part of: BMC Atrium Core 7.6 release BMC BladeLogic Automation Suite 8.2 release BMC Remedy IT Service Management Suite 7.6 release BMC ProactiveNet Performance Management Suite 8.6 release BMC Application Management Suite 2.2 release

Featured contentService Pack 3 (SP3) is unavailable and has been replaced by Service Pack 4 (SP4). Multiple grid support is being deprecated in future releases. See Future product changes for more information.

BMC is alerting users to a serious problem with an out of memory heap dump generated by a grid peer in version 7.6.02 Service Pack 3 (SP3) of the BMC Atrium Orchestrator Platform. This problem requires your immediate attention. Service Pack 4 resolves this issue. If you run BMC Atrium Orchestrator Development Studio on an Apple Mac computer, do not apply the latest Java updates. For more information about this issue, see the product alert that was issued on November 15, 2011. Service Pack 4 resolves this issue.

Where to startTo View information about the latest service pack or release Install the platform components Use BMC Atrium Orchestrator Development Studio to create workflows Run a workflow in a semi-automated mode Use Grid Manager to configure and manage the grid Use Repository Manager to manage adapters and modules See What's new Installing Developing workflows Using BMC Atrium Orchestrator Operator Control Panel Administering Administering

About BMC Atrium OrchestratorThe BMC Atrium Orchestrator product is an IT-process-automation platform that automates tasks across multiple functional areas, systems, and geographic locations. Built on a high-availability and high-performance grid architecture, BMC Atrium Orchestrator offers out of the box workflows, leveraging your existing systems to accelerate IT service execution across your enterprise. BMC Atrium Orchestrator can automate a variety of tasks, including:


11


Verifying, diagnosing, and fixing IT infrastructure failures Accelerating routine tasks, such as provisioning and decommissioning physical and virtual assets and IT services Synchronizing information between Service Desk and other IT management systems Orchestrating disaster recovery routines Recording configuration operations with change management systems By automating manual and repetitive IT tasks, BMC Atrium Orchestrator not only reduces operational costs, but also ensures compliance and adherence to best-practice standards.

This wiki space applies to the following BMC Atrium Orchestrator platform components: BMC Atrium Orchestrator platform server, which includes the following components: Configuration distribution peer (CDP) Grid Manager Access Manager Repository BMC Atrium Orchestrator Operator Control Panel BMC Atrium Orchestrator Development Studio

Export to PDF

Help

Recently updated pages

wiki_aum_platform_page_7602.png attached 1 min ago Recommended installation environment commented 6 mins ago Recommended installation environment updated 19 mins ago (view change) wiki_aum_platform_page_7602.xcf attached yesterday at 12:39 PM remedyMonitorAdapterWorking attached Apr 22, 2012 _remedyMonitorAdapterWorking updated Apr 22, 2012 (view change) remedyMonitorAdapterWorking.png attached Apr 22, 2012 More

What's newThis section provides information about what is new or changed in this space, including documentation updates, corrected issues, and enhancements. It also provides license entitlement information for the release.


12


Tip To stay informed of changes to this space, place a watch on this page. The following updates have been added since the release of the product: Date April 19, 2012 February 24, 2012 February 21, 2012 February 1, 2012 January 26, 2012 Title Documentation updates for April 19, 2012 Service Pack 4 for version 7.6.02 Summary New and updated information on several sections Various fixes and product updates

Flash: Out of memory heap dump generated by a grid Description of AMP-18247 peer Future product changes Service Pack 3 for version 7.6.02 Service Pack 3 (SP3) is unavailable and will be replaced by Service Pack 4 (SP4). Notice to deprecate support for multiple grids

November 15, 2011

Flash: Java for Mac OS X 10.6 Update 6 (1.6.0_29) prevents start of BMC Atrium Orchestrator Development Studio

Description of defect AMP-18018

September Documentation updates for September 22, 2011 16, 2011 August 26, Service Pack 2 2011 July 22, 2011 June 30, 2011 March 4, 2011 Flash: Upgrading server components from 7.6.02 to the latest service pack overwrites custom keystore files. Service Pack 1 Flash: Setting the logging level of the health component to DEBUG can prevent the peer and grid from restarting. This problem was resolved in SP1. February 23, 2011 Flash: A problem occurs when you install or upgrade the platform and the repository does not have Internet access. This problem was resolved in SP1. Urgent issues

Updated information about how to configure the platform to communicate with HTTPS Various fixes and product updates Workaround for defect INSTALL-1320

Various fixes and product updates Workaround for defect AMP-17538 and issue ISS03742358

Workaround for defect AMP-17509 and issue ISS03737933


13


License entitlements Documentation updates Service packs and patches Version 7.6.02 Future product changes

Urgent issuesThe following alerts have been issued since the release of the product: Date February 21, 2012 Title Flash: Out of memory heap dump generated by a grid peer This problem was resolved in SP4. Summary Description of AMP-18247 Description of defect AMP-18018

November Flash: Java for Mac OS X 10.6 Update 6 (1.6.0_29) prevents start 15, 2011 of BMC Atrium Orchestrator Development Studio This problem was resolved in SP4. July 22, 2011 March 4, 2011 Flash: Upgrading server components from 7.6.02 to the latest service pack overwrites custom keystore files. Flash: Setting the logging level of the health component to DEBUG can prevent the peer and grid from restarting. This problem was resolved in SP1. February 23, 2011 Flash: A problem occurs when you install or upgrade the platform and the repository does not have Internet access. This problem was resolved in SP1.

Workaround for defect INSTALL-1320 Workaround for defect AMP-17538 and issue ISS03742358 Workaround for defect AMP-17509 and issue ISS03737933

Upgrading server components from 7.6.02 to the latest service pack overwrites custom keystore filesDuring BMC Atrium Orchestrator Platform server upgrades from version 7.6.02 to the latest service pack, the installation program deletes all default and modified keystore (cacerts) files from the $AO_HOME/jvm/lib/security directory. Platform server components include Access Manager, the repository, BMC Atrium Orchestrator Development Studio, and all peers. The upgrade does not affect any keystore files stored outside of the jvm directory path. This issue has been assigned the ID INSTALL-1320. Note If you must upgrade the server components to version 7.6.02 service pack 1, 2, or 4, first back up all custom or modified keystore files to a location outside of the jvm directory path, such as your user home directory. Then, when the upgrade is finished, copy the backed-up keystore files to the following location on each BMC Atrium Orchestrator server component: $AO_HOME/jvm/lib/security.

Out of memory heap dump generated by a grid peer


14


Note Service pack 4 for version 7.6.02 of BMC Atrium Orchestrator solves this problem. BMC Software is alerting users to a serious problem in Service Pack 3 (SP3) for version 7.6.02 of the BMC Atrium Orchestrator Platform that requires immediate attention. A memory leak in SP3 has the potential to consume all available Java heap space. This condition is confirmed by a grid peer generating an out-of-memory heap dump file, and it occurs more quickly with small heap sizes (less than 2 GB).

Recommended actionDo not install BMC Atrium Orchestrator Platform 7.6.02 SP3. If you installed BMC Atrium Orchestrator Platform 7.6.02 SP3 into a production environment, contact BMC Software Customer Support at 800 537 1813 (United States or Canada) as soon as possible for assistance. This issue has been assigned the ID AMP-18247.

Java for Mac OS X 10.6 Update 6 (1.6.0_29) prevents start of BMC Atrium Orchestrator Development StudioNote Service pack 4 for version 7.6.02 of BMC Atrium Orchestrator solves this problem. The Mac OS X version of the BMC Atrium Orchestrator Development Studio application version 7.6.02 service pack 2 and earlier is not compatible with the Java for Mac OS X 10.6 Update 6 (1.6.0_29). If you upgrade to this version of Java on the computer where BMC Atrium Orchestrator Development Studio version 7.6.02 service pack 2 or earlier is installed, you cannot use the application. This issue has been assigned the ID AMP-18018.

Recommended actionInstall service pack 4 for version 7.6.02 before applying the Java for Mac OS X 10.6 Update 6 (1.6.0_29) on any Mac computer where BMC Atrium Orchestrator Development Studio is installed.

License entitlementsThis page lists the license entitlements for the BMC Atrium Orchestrator platform components:

BMC BladeLogic Automation Suite Base LicenseIncludes unlimited use of the following BMC Atrium Orchestrator core product components. Test and development licenses are provided at no additional cost: Repository Access Manger Grid Manager Metrics and Reporting Operations Actions Management Modules Operations Actions Utility Modules. Includes license rights to use the following BMC Atrium Orchestrator product components for configuration of an initial Orchestration environment as detailed here: One (1) Configuration Distribution Peer (CDP, a master peer/server that executes all workflows)


15


Three (3) Development Studio Licenses (the workflow authoring tool used to create and modify workflows) Five (5) Operator Control Panel (OCP) Licenses (the web-based user interface designed to monitor and manage workflows and/or for semi-automation mode) Application Adapters (the systems/interfaces/gateways/connectors used to talk to external applications) for BMC products.

BMC Atrium Orchestrator PlatformIncludes license rights to use the following BMC Atrium Orchestrator product components for configuration of an initial Orchestration environment as detailed here: One (1) Configuration Distribution Peer (CDP) [CDP = A master peer/server that executes all workflows], One (1) Activity Peer (AP) [AP = Slave peers/servers that can optionally be added to a grid to provide additional scalability and performance, as well as high-availability]for high-availability purposes, 3 Development Studio Licenses [Development Studio = workflow authoring tool used to create and modify workflows], 5 Operator Control Panel (OCP) Licenses [OCP = web-based user interface designed to monitor and manage workflows and/or for semi-automation mode], and Application Adapters [Adapter = an adapter is a system/interfaces/gateways/connectors used to talk to external applications] for BMC products. Includes unlimited use of the following BMC Atrium Orchestrator core product components including Repository, Access Manger, Grid Manager, Metrics and Reporting, Operations Actions Management Modules, and Operations Actions Utility Modules. Test and development licenses are provided at no additional cost.

BMC Atrium Orchestrator Platform Add-OnIncludes license rights to deploy one peer (CDP, AP, LAP) for every unit licensed; a peer can either be a Configuration Distribution Peer (CDP) [CDP = A CDP is a Master peer/server that executes all workflows] or an Activity Peer (AP) [AP = Slave peers/servers that can optionally be added to a grid to provide additional scalability and performance, as well as built-in load-balancing and high-availability], or a Light-Weight Activity Peer (LAP) [LAP = Slave peers/servers that can optionally be added to a grid to provide to accommodate network latencies and/or security topologies, and do not directly add incremental processing power] in combination with licensed adapters. Test and development license are provided at no additional cost.

BMC Atrium Orchestrator Development StudioIncludes license rights to use the Development Studio module [Development Studio is a workflow authoring tool used to create and modify workflows] for every user licensed. This component is licensed per named user.

BMC Atrium Orchestrator Operator Control PanelIncludes license rights to use the Operator Control Panel module [Operator Control Panel is a web-based UI designed for operator-based workflow execution used to create and modify workflows] for every user licensed. It enables operators to manually launch a workflow, follow its progress in a graphical view, and provide input as required. This component is licensed per named user.

BMC Atrium Orchestrator for Network Automation CoreIncludes license rights to use the following BMC Atrium Orchestrator product components for configuration of an initial Orchestration environment as detailed here: One (1) Configuration Distribution Peer (CDP) [CDP = master peer/server that executes all workflows] One (1) Activity Peer (AP) [AP = slave peer/server that can optionally be added to a grid to provide additional scalability and performance, as well as high-availability] for high-availability purposes 3 Development Studio Licenses [Development Studio = workflow authoring tool used to create and modify workflows] 5 Operator Control Panel (OCP) Licenses [OCP = web-based user interface designed to monitor and manage workflows and/or for semi-automation mode] Application Adapters [Adapter = system/interface/gateway/connector used to talk to external applications] for BMC products.


16


Includes unlimited use of the following BMC Atrium Orchestrator core product components. Test and development licenses are provided at no additional cost: Repository Access Manager Grid Manager Metrics and Reporting Operations Actions Management Modules Operations Actions Utility Modules

BMC Atrium Orchestrator for Network Automation Scalability PackIncludes license rights to deploy unlimited peers (CDP, AP, LAP) for use in combination with the number of network devices licensed; a peer can either be a Configuration Distribution Peer (CDP) [CDP = master peer/server that executes all workflows] or an Activity Peer (AP) [AP = slave peer/server that can optionally be added to a grid to provide additional scalability and performance, as well as built-in load-balancing and high-availability], or a Light-Weight Activity Peer (LAP) [LAP = slave peer/server that can optionally be added to a grid to provide to accommodate network latencies and/or security topologies, and do not directly add incremental processing power] in combination with licensed adapters. Includes unlimited Development Studio and Operator Control Panel users. Test and development license are provided at no additional cost.

BMC Atrium Orchestrator for Server Automation CoreIncludes license rights to use the following BMC Atrium Orchestrator product components for configuration of an initial Orchestration environment as detailed here: One (1) Configuration Distribution Peer (CDP) [CDP = master peer/server that executes all workflows] One (1) Activity Peer (AP) [AP = slave peer/server that can optionally be added to a grid to provide additional scalability and performance, as well as high-availability] for high-availability purposes 3 Development Studio Licenses [Development Studio = workflow authoring tool used to create and modify workflows] 5 Operator Control Panel (OCP) Licenses [OCP = web-based user interface designed to monitor and manage workflows and/or for semi-automation mode] Application Adapters [Adapter = system/interface/gateway/connector used to talk to external applications] for BMC products. Includes unlimited use of the following BMC Atrium Orchestrator core product components. Test and development licenses are provided at no additional cost: Repository Access Manager Grid Manager Metrics and Reporting Operations Actions Management Modules Operations Actions Utility Modules

BMC Atrium Orchestrator for Server Automation Scalability PackIncludes license rights to deploy unlimited peers (CDP, AP, LAP) for use in combination with the number of servers licensed; a peer can either be a Configuration Distribution Peer (CDP) [CDP = master peer/server that executes all workflows] or an Activity Peer (AP) [AP = slave peer/server that can optionally be added to a grid to provide additional scalability and performance, as well as built-in load-balancing and high-availability], or a Light-Weight Activity Peer (LAP) [LAP = slave peer/server that can optionally be added to a grid to provide to accommodate network latencies and/or security topologies, and do not directly add incremental processing power] in combination with licensed adapters. Includes unlimited Development Studio and Operator Control Panel users. Test and development license are provided at no additional cost.

Documentation updatesThis section contains information about documentation updates for BMC Atrium Orchestrator platform 7.6.02 that


17


are not tied to service packs and patches. Documentation updates for April 19, 2012 Documentation updates for December 21, 2011 Documentation updates for September 22, 2011

Documentation updates for April 19, 2012New sections were added during this update: End-to-end process Planning The topics under the following sections were updated: Key concepts Installing Integrating Administering Troubleshooting

Documentation updates for December 21, 2011New documentation topics are available at Generating process metrics reports by using the graphing server and Specifying a trust store password.

Documentation updates for September 22, 2011The topics under the following section were updated on September 22, 2011: Managing BMC Atrium Orchestrator security

Service packs and patchesThis section contains information about service packs and patches for BMC Atrium Orchestrator Platform 7.6.02. Service Pack 4 for version 7.6.02 Service Pack 3 for version 7.6.02 Service Pack 2 for version 7.6.02 Service Pack 1 for version 7.6.02

Service Pack 4 for version 7.6.02The pages in this section describe the corrected issues and product updates in BMC Atrium Orchestrator 7.6.02 SP4. Corrected issues in 7.6.02 SP4 Product updates for 7.6.02 SP4 Installing 7.6.02 SP4

Related topicsFuture product changes Obtaining the BMC Atrium Orchestrator product installation files Using the GUI to install the BMC Atrium Orchestrator platform and content


18


Using command-line options to perform silent installations

Corrected issues in 7.6.02 SP4This topic lists the issues that were identified in earlier versions of the BMC Atrium Orchestrator platform components and corrected in this service pack

bmc atrium orchestra tor 7.6.02 platform

Documents