Installing a CDP

This topic describes how to use the GUI installation program to install a configuration distribution peer (CDP). During installation of a CDP, the installation program searches for and uses the configuration settings for the repository and BMC Atrium Single Sign-On. This topic includes the following sections:

Note

If you are installing a non-English version of the Operator Control Panel,  you must install it separately from the CDP. You must install the non-English OCP and CDP on separate Tomcat servers.

Before you begin

  • BMC Atrium Single Sign-On and the repository must be installed and running.
  • You must ensure that the target computer meets the minimum system requirements for your environment.
  • You must have completed the CDP-installation-worksheet.

  • You must be logged on as an administrator and have administrator rights for the computer on which you install the CDP.

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

  • Ensure that you have the lsb_release command in the /usr/bin directory and that you can run it. Use the steps for your operating system.

    • Red Hat Linux 7 machines:

      1. Verify that the lsb_release command is in the /usr/bin directory by running the following command:
        which lsb_release
        For example,
        [root@localHost ~]# which lsb_release
        If it is available, you will see the following response:
        /usr/bin/lsb_release
      2. If the command is available, verify that you can run it using the following command:
        lsb_release -d
        For example,
        [root@localHost ~]# lsb_release -d
        If it runs correctly, you will see a response similar to the following:
        Description: Red Hat Enterprise Linux Server release 7.0 (Maipo) 

        or...
        If the command is not available, copy it from a RHEL6 machine to the RHEL7 machine as follows:
        1. Navigate to the /usr/bin directory and run the scp command to copy the lsb_release command from the RHEL6 machine to the RHEL7 machine.
          scp lsb_release root@<rhel7MachineHostname/IPaddress>:/usr/bin/
        2. On the RHEL7 machine, repeat steps a and b to verify that the command is in the /usr/bin directory and that you can run it. 
    • SUSE Linux machines:

      1. Verify that the lsb_release command is in the /usr/bin directory by running the following command:
        which lsb_release
        For example,
        [root@localHost ~]# which lsb_release
        If it is available, you will see the following response:
        /usr/bin/lsb_release
      2. If the command is available, verify that you can run it using the following command:
        lsb_release -d
        For example,
        [root@localHost ~]# lsb_release -d
        If it runs correctly, you will see a response similar to the following:
        Description: SUSE Linux Enterprise Server 11 (x86_64)
        or....
        If the command is not available, download it from the internet or from your operating system vendor's website.
  • You must have exited all other programs. (% style="font-family: monospace;line-height: 1.4285715;" %)
Important

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

Related topics

Where to find more information

System requirements

Deployment-use-cases

Preparing-for-installation

CDP-installation-worksheet

Installing

Installing silently

Upgrading

If a problem occurs

Where to find more information

Troubleshooting-the-installation

Installation-log-files

To install a CDP

  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, and click Next.
  6. Using the installation worksheet, fill in the settings to install the CDP.
    The installation program verifies the communication with the repository. If it detects any invalid or conflicting information, the installation process halts and an error message describes the problem. The installation process resumes after you provide valid values.
  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.

Note

If you are using Internet Explorer 8.0 or later, then ensure that you add the URL for the BMC Atrium Orchestrator Grid Manager in the trusted sites of the browser.

Installation video

The following BMC Communities video (6:36) is part two of a series on how to install a basic setup of BMC Atrium Orchestrator Platform and Content on Windows. This video covers how to install the repository and a CDP. While the video demonstrates installing a specific product version, installations of other versions are similar.

icon-play.png https://youtu.be/0Kbn0-DI-6o

Verify the CDP installation

To ensure that the CDP was installed successfully, verify the CDP installation.

Adjust Default group permissions

After installing the primary CDP, the Default group has full access to the repository and to the grid, just as the AoAdmin group. Edit the Default group to remove the following permissions: Development Studio, Grid Administration, and Grid Management.

Warning

You must remove these permissions from the Default group so that all users do not have administrative permission. 

See Assigning-grid-permissions for instructions on how to remove permissions.

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

You can install any of the following:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*