Using the GUI to install BMC Atrium Orchestrator content

This procedure describes how to use the GUI installation program to install content. During content installation, you can choose to install base and application adapters, modules, and run books.

This topic describes how to use the GUI installation program to install BMC Atrium Orchestrator Content.

Before you begin

Ensure that the following conditions are met before you begin installing the content:

  • You must have downloaded the content installation files from the BMC Electronic Product Distribution (EPD) website.
  • You must have the repository installed and running, as described in Installing the repository.
  • The computer from which you run the installation program must have network access to the repository computer.

Note

Ensure that you install BMC Atrium Orchestrator Content on 64-bit computers. For more information, see System-hardware-requirements.

Important

To install content packages earlier than version 20.15.01, complete the following steps:

  1. Navigate to the AO_HOME/tomcat/conf directory and edit the server.xml file.

  2. Look for the following line in the file and append the sslEnabledProtocols="TLSv1,TLSv1.1,SSLv2Hello" attribute to the line that starts with <Connector SSLEnabled="true".
     It should look like the following example:

    <Connector SSLEnabled="true" URIEncoding="UTF-8" clientAuth="false" maxThreads="150" port="28080" protocol="HTTP/1.1" scheme="https" secure="true" sslProtocol="TLS" sslEnabledProtocols="TLSv1,TLSv1.1,SSLv2Hello"/>
  3. Save the file.
  4. Restart the repository (Starting-and-stopping-product-components-and-services).
  5. Run the content installer as described on this page.

 

To install BMC Atrium Orchestrator content with the GUI installation

  1. Navigate to and start the installation program.
    • Windows: setup.cmd
    • Linux or Solaris: setup.sh
  2. On the Welcome to BMC Atrium Orchestrator panel, review the information and click Next.
  3. On the license agreement panel, select I agree to the terms of the license agreement; then click Next.
  4. On the Directory Selection panel, accept the default location, or click Browse to select a different location; then click Next.
  5. On the Installation Type panel, select Custom feature set, and click Next. 
    Do not select BSM Solutions unless you have purchased a BMC solution and have reviewed the applicable documentation for that solution.
  6. On the Repository Communications Settings panel, enter the repository settings, and click Next:
    • Web Server Protocol: Select https.
    • Host Name or IP Address: Enter the fully qualified domain name of the repository.
    • Web Server Port Number

    • RepositoryUser: Enter the user name of the account created in BMC Atrium Single Sign-On that you use to log on to the repository.

      Warning

      Do not enter the default BMC Atrium Single Sign-on account amadmin in the RepositoryUser field.

    • Repository Password: Enter the password that matches the specified user account.
  7. On the Adapter Feature Selection panel, select the adapters to install, and click Next:
    • To select all adapters, select Adapters.

    • To select all the adapters in a group, select Base Adapters, BMC application adapters, or Third party adapters.

      Note

      If you select existing application adapters or base adapters, they will be updated to the current version when you click Install.

  8. On the Module Feature Selection panel, select the run books and management modules and core modules to install, and click Next.
    • To select all modules, select Modules.
    • To select all the modules in a selected group, select Run books, Management modules or Core modules.
  9. On the Installation Preview panel, review the features, and then click Install.
  10. When the installation is finished, click Done.

Installation video

The following BMC Communities video (4:26) is part four 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 Content and verify that the content is in the repository. While the video demonstrates installing a specific product version, installations of other versions are similar.

icon-play.pnghttps://youtu.be/DRweYfa2YpQ

Content install log file

The BAO_content_install_log file contains the logs of the content installation, which you can use for troubleshooting installation problems.

When you install an adapter that does not have a corresponding module, the content installation program writes the following warning message to the log file:

LOG EVENT {Description=[Source roar folder does not exist for this adapter],
Detail=[Not all adapters have roar files so this may or may not be an error]} 

This warning message is informational and does not indicate that a problem occurred during the installation.

To troubleshoot problems that might have occurred during the installation, search for the BAO_content_install_log file for error messages.

 

 

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