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 the BMC Server Automation Console and Network Shell (Windows)

This topic provides instructions for installing the BMC Server Automation Console and Network Shell on Microsoft Windows. The console is the graphical user interface to the BMC Server Automation servers. Network Shell is a required prerequisite of the console.


This topic applies to versions 8.6 and later, even though the screenshots and examples are taken from 8.7.00.

  The topic includes the following sections:


To install the BMC Server Automation Console, you can use the installation wizard in the user interface or silent mode. You cannot use console mode. To use the installation wizard, follow the steps below. To perform a silent installation of the console, see Using silent mode to install the BMC Server Automation Console (Windows).

Before you begin

  • BMC recommends that you do not install the console on the same system as the Application Server. Copy the files from the Application Server installation (for example, ..\BBSA<version>-WIN64\Disk1\files\installers\rcp) to a different system and perform the installation there.
  • Before you install the BMC Server Automation Console, ensure that port 12333 (TCP) is not being used. Installation of the console requires use of this port; if it is already in use, the installation fails.
  • Update the Windows Terminal Services Server Settings for temporary folders. (In Windows Server 2008 R2 and later versions, Terminal Services is renamed to Remote Desktop Services).

    To update the Windows Terminal Services (or Remote Desktop Services) configuration perform either of the following steps:

    Server settings method

    1. On the computer where you are installing the BMC Server Automation Console, select Start > Run.
    2. For Open, enter gpedit.msc, and then click OK.
    3. Navigate to the Temporary folders policies:
      Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services >Remote Desktop Session Host > Temporary folders
      Computer Configuration > Administrative Templates > Windows Components > Terminal Services > Terminal Server > Temporary folders
    4. Set the Properties of Do not delete temp folder upon exit to Enabled and then click OK.
    5. Set the Properties of Do not use temporary folders per session to Enabled and then click OK.
    6. Restart the computer.
      If the settings do not take effect, use the Registry Editor (regedit):

    Registry editor method

    1. Click Start > Run and enter regedit.
    2. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server.
    3. Set the DeleteTempDirsOnExit and the PerSessionTempDir values to 0.
    4. Restart the computer.

    Note: The installation program uses temporary folders to preserve the install log. Usually, you can perform this update only one time; you do not need to update the configuration every time you install. However, if your Server Settings are different from those needed for installation, after you finish installing the console you can change the settings back to their previous settings.

To install the BMC BladeLogic Server Automation Console and Network Shell

 StepExample screen

Navigate to the directory containing the installation files that you copied from the Application Server and run the installation program for the console. Different installers are provided for 32-bit and 64-bit Windows.

In this example, we are running the BBSACONSOLE87-WIN64 file on the Windows machine on which you plan to install the console.

Select a language to use for the installation and click OK

The installer extracts the installation files, and the Introduction window opens.


Ensure that you have closed all applications before you proceed.

Click Next.

The Review License Agreement window opens.


Read the End User License Agreement (EULA) and select I agree to the terms of the license agreement if you wish to proceed.

Click Next.

The Directory Selection window opens.


The default installation location for the console is C:\Program Files\BMC Software\BladeLogic. Click Next to use the default location.

Alternatively, you can click Browse to change the installation location.


A window opens in which you can select components to install. By default, all components are selected.

The Network Shell is automatically installed when you install the console.

Note: If you clear the BMC Server Automation Console Upgrade Service check box, the BMC Server Automation Console Upgrade Service is not installed. This service is required for automatically upgrading the BMC Server Automation Console when you upgrade the Application Server.

Click Next.


The window displays your selections.

Click Install.

The window displays installation progress, then displays a message when installation is complete.

The console and Network Shell are installed on your machine.

If all operations are completed successfully, click Done to exit the wizard.


In case you encountered any errors while installing you can click View Log to view a detailed report of the installation.

Tip: BMC recommends that you save a copy of the log, before you contact technical support for further assistance. You can also find more information about resolving common issues in Troubleshooting the unified product installer.

If all operations are completed successfully, click Done to exit the wizard.


Start the console.

To configure the console so that it connects to the default Application Server, click Options.


Click on the Authentication Profiles tab and click Add.

BSA clients use authentication profiles to facilitate single sign-on feature. You must create an Authentication profile before you start using the Console. For more information about why we use Authentication Profiles, see System capabilities related to security.


Enter the following information.

  1. Assign a name to the authentication profile. For example, you could assign a name such as QATeam or DevTeam.
  2. Enter the name or IP address (IPv4 or IPv6) of the default Application Server to which the client should connect.
  3. Enter an Authentication Port number to which the client should connect. The same port is used for all BMC Server Automation authentication mechanisms. The default Port is 9840. For more information about Console ports, see BMC Server Automation ports.
  4. Select any one authentication mechanism for the authentication profile:

    • Secure Remote Password.
    • AD/Kerberos Single Sign-on.
    • Domain Authentication.
    • LDAP.
    • RSA SecurID Authentication.
    • Public Key Infrastructure Authentication.
    In this walkthrough we will use the Secure Remote Password mechanism. For information about implementing the other authentication mechanisms, see Implementing authentication
  5. Click OK.


You can now log on the the Console using the BLAdmin user that is created while installing the default Application Server node, see step 10.

The quick start page is the first page that is displayed once you log on the the BSA Console. It introduces you to the main use cases of BMC Server Automation and allows you to execute them from a centralized UI immediately after installing the BSA set up. For information about using the quick start page, see Quick start page.

For general information about the UI of the BSA Console, see Navigating the interface.

Where to go from here

Configuring after installation

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