Unsupported content


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Installing an AP

The AP accepts and executes workflows and hosts external application adapters, providing both the core workflow engine and a web container. This topic describes how to use the GUI installation program to install an activity peer (AP) and how to add the peer to the grid. You must add the peer to the grid before you install it.

Before you begin

  • You must have installed BMC Atrium Single Sign-On, repository and a configuration distribution peer.
  • You must have completed the AP installation worksheet and you must have added the specified peer to the grid, as described in Adding peers.
  • You must be logged on as an administrator and have administrator rights on the computer on which you install the AP.

    On Microsoft Windows, you must have the administrator permissions.
    On Linux and Solaris, you must have the root permissions or log on as a root user. 

  • If you are installing on a Windows computer, ensure that DEP is configured to recognize the installation program executable (Configuring DEP on Windows computers).
  • If you are installing on a Linux computer, ensure that the system has adequate entropy. For details, see the Atrium Single Sign-On Prerequisites for installation page or the following Knowledge Article: KA000066336.
  • You must have exited all other programs.


You must install BMC Atrium Single Sign-On and all BMC Atrium Orchestrator Platform server components on a same domain. 

To install an AP

  1. Navigate to and start one of the following installation programs:
    • Windows: setup.cmd
    • UNIX: setup.sh
  2. On the splash screen, select the language in which to view the installation program, and click OK.
  3. On the Welcome to BMC Atrium Orchestrator panel, review the information and click Next.
  4. On the license agreement panel, select I agree to the terms of the license agreement; then click Next.
  5. On the Installation Type panel, select Install new Orchestrator components; then click Next.
  6. Using the AP installation worksheet, fill in the settings for the AP component.

    The installation program validates communication with the grid and the CDP Communications Setting panel shows the connection success or failure message.
  7. Review the information on the Installation Choices Summary panel, and click Copy Text to Clipboard to copy the summary of the connection details for further use.
  8. Click Install.
  9. On the Installation Summary panel, perform one of the following actions:
    • To exit the installation program, click Done.
    • To review the BAO_install_log.txt file, click View Log, and then click Done to exit the installation program.

Where to go from here

If you have not already done so, you can install BMC Atrium Orchestrator Development Studio, or any of the following peers:

Related topics

Preparing for installation
Troubleshooting the installation
Deployment use cases

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