Installing the repository

This topic describes how to use the GUI installation to install the repository.


If you are using an external authentication service, you must have installed it before installing the repository. 

While installing the repository, the installer program requires the configuration settings for connecting to the authentication service.

Before you begin

  • If you are using the external Remedy Single Sign-On authentication system, you must have already installed it and it must be running.
  • You must have downloaded the installation files from the BMC Electronic Product Download (EPD) website.
  • You must ensure that the target computer meets the minimum system requirements for your environment.
  • You must have completed the installation worksheet for the repository.
  • You must be logged on as an administrator and have administrator rights on the computer where you will install the repository.
    • 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 exited all other programs.

To install the repository

  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. Using the completed installation worksheet, fill in the required settings for the repository.
    The installation program verifies the communication settings. If it detects any invalid or conflicting information, it halts the installation process and displays an error message describing the problem. It resumes the installation process after you provide valid values.
  6. 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.
  7. Click Install.
  8. 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.

After you install the repository, if you installed the embedded RSSO, a default local user aoadmin, default role AoAdmin, and realm BAOLocal are created in BMC Remedy Single Sign-On (RSSO). The user aoadmin is automatically added to the AoAdmin role. 

You can use the following URL and user credentials to log into the repository:

  • URL: http(s)://FullyQualifiedDomainName:repoWebServerPort/baorepo
  • User name: aoadmin 
  • Password: admin123 

You can use the following URL and user credentials to log into RSSO:

  • http(s)://FullyQualifiedDomainName:repoWebServerPort/rsso
    Note that this is the URL for the embedded RSSO instance on the repository. If you are accessing an external RSSO instance, use the URL for that instance. 
  • User name: Admin 
  • Password: RSSO#Admin#


  • If you are using Internet Explorer 8.0 or later, ensure that you add the URL for the BMC Atrium Orchestrator Repository in the trusted sites of the browser.
  • After you install all BMC Atrium Orchestrator components and verify that they are successfully installed, BMC recommends that you change the passwords. After you install all BMC Atrium Orchestrator components and verify that they are successfully installed, BMC recommends that you change the passwords. See Creating and managing local users and roles in Remedy Single Sign-On for details.
  • The aoadmin user must be assigned to the AoAdmin role for BMC Atrium Orchestrator to operate properly. Do not modify this assignment.
  • For instructions on changing the Remedy SSO administrator password, see Changing the RSSO administrator password .

Where to go from here

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

To ensure that the embedded RSSO was installed successfully, verify the embedded repository installation.

If you are using the embedded RSSO service, after installing your BAO components you must complete the steps in Configuring a fail-safe enterprise service bus after installation.

You can perform either of the following tasks: