Installing the TrueSight Server Automation Console and Network Shell (Windows)

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

The topic includes the following sections:

Before you begin
To install the TrueSight Server Automation Console and Network Shell
Where to go from here

Note

To install the TrueSight 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-TrueSight-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, ..\TSSA<version>-WIN64\Disk1\files\installers\rcp) to a different system and perform the installation there.
Before you install the TrueSight 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).
Click here for steps about updating the Windows Terminal 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 TrueSight 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
  or:
  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 TrueSight Server Automation Console and Network Shell

This example uses TrueSight Server Automation version 8.9.03.

	Step	Example screen
1	Navigate to the directory containing the installation files that you copied from the Application Server and run the installation program for the console (for example, ..\TSSA<version>-WIN64\Disk1\files\installers\rcp). Different installers are provided for 32-bit and 64-bit Windows. In this example, we are running the TSSACONSOLE89-SP3-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.
2	Ensure that you have closed all applications before you proceed. Click Next. The Review License Agreement window opens.
3	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.
4	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.
5	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 TrueSight Server Automation Console Upgrade Service check box, the TrueSight Server Automation Console Upgrade Service is not installed. This service is required for automatically upgrading the TrueSight Server Automation Console when you upgrade the Application Server. Click Next.
6	The window displays your selections. Click Install. The installer pre-analyzes your environment: Checks whether the platform on which you are trying to install the product is supported. If the platform check is successful, Microsoft Visual C++ 2015 Redistributable Update 3 is installed automatically. If the platform check fails, the installation program aborts installation with an error message. Also, the error message is added to the log file. The window displays installation progress, then displays a message when installation is complete. The console and Network Shell are installed on your machine.
7	If all operations are completed successfully, click Done to exit the wizard. If 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.
8	Start the console. To configure the console so that it connects to the default Application Server, click Options.
9	Click the Authentication Profiles tab and click Add. TrueSight Server Automation 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.
10	Enter the following information. Assign a name to the authentication profile. For example, you could assign a name such as QATeam or DevTeam. Enter the name or IP address (IPv4 or IPv6) of the default Application Server to which the client should connect. Enter an Authentication Port number to which the client should connect. The same port is used for all TrueSight Server Automation authentication mechanisms. The default Port is 9840. For more information about Console ports, see TrueSight-Server-Automation-ports. 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. Click OK.
11	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. Click Connect. The quick start page is the first page that is displayed once you log on the the Console. It introduces you to the main use cases of TrueSight Server Automation and allows you to execute them from a centralized UI immediately after installing the TrueSight Server Automation set up. For information about using the quick start page, see Quick-start-page. For general information about the UI of the Console, see Navigating-the-interface.