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).

Before you begin

  • You must have installed and completed any required configuration of the authentication system, the repository, and a configuration distribution peer (CDP).
    If you opted to install the embedded version of RSSO, it was set up during the installation. 
  • The repository, the primary CDP, and the authentication product must be running.
  • You must ensure that the target computer meets the minimum system requirements for your environment.
  • 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 administrator permissions. 
    • On Linux and Solaris, any non-root user with write permission to the /opt/bmc directory can perform the installation.
      On Linux and Solaris, the non-root user must also have permission to run the following commands:
      • dmidecode -t 1 | grep Manufacturer
      • lsb_release -d
  • If you are installing on a Windows computer, ensure that Data Execution Prevention (DEP) is configured to recognize the installation program executable (Configuring DEP on Windows computers).
  • If you are installing on a Linux computer, run the rngd service to ensure that the system has adequate entropy (Run the rngd service on Linux computers).
  • You must have added the specified peer to the grid, as described in Adding peers.
  • You must have exited all other programs.

To install an AP

  1. Navigate to and start the installation program for your operating system. See Performing the installation for the installation program names.
  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.

To verify the installation, see Verifying a peer or embedded RSSO installation.

Linux steps to support dmidecode

 If you are installing in a Linux environment, you must complete the following instructions after the installation.

  1. Add the path to the dmidecode executable location to the user's environment under which the BMC Atrium Orchestrator service is running.
    This supports running the dmidecode to gather operating system information by the Health dashboard.
    To do this, edit the .bashrc file located in the $HOME directory and add the path.
    For example, if the BMC Atrium Orchestrator service is running under a user account called "bao," edit bao's .bashrc file and add the following lines:

    set PATH=${PATH}:/usr/sbin
    export PATH

  2. As root user, run the following command to update permissions so that non-root users can run the dmidecode command: 
    chmod g+s /usr/sbin/dmidecode

  3. Restart the BMC Atrium Orchestrator service (see Starting and stopping product components and services).

Where to go from here

If you have not already done so, you can install any of the following: