Installing the RSCD agent (Windows)

This topic provides instructions for installing an RSCD agent on a Microsoft Windows computer other than a replicated domain controller. This topic includes the following sections:

• • Before you begin
  • To install the RSCD agent
  • Where to go from here

To install on replicated domain controllers, see Installing-RSCD-agents-in-a-replicated-domain-controller-environment.

To perform a silent installation of an RSCD agent, see Using-silent-mode-to-install-an-RSCD-agent-Windows.

Before you begin

• Ensure that Microsoft Visual C++ 2015 Redistributable Update 3 or later is installed on the server.
  
  Microsoft Visual C++ 2015 Redistributable Update 3 or later can be installed automatically from Agent Installer Job - Options window and by using the prepackaged content in depot software. However, the depot software can be used only for upgrade scenario. For more information, see Agent-Installer-Job-Options and Upgrading-the-RSCD-Agent-using-an-Agent-Installer-Job. When you install Microsoft Visual C++ 2015 Redistributable Update 3 or later, the installer sets the Pending Reboot flag to True in the Windows registry.

  Note

  As a prerequisite to install Microsoft Visual C++ 2015 Redistributable Update 3 on Windows 2012 R2, you must have the following patches installed on your server:

  • KB2919442 (Required for 2919355)
  • KB2919355. This patch requires several other patches: clearcompressionflag.exe, KB2919355, KB2932046, KB2959977, KB2937592, KB2938439, and KB2934018. This are all available on the download page for KB2919355.

  For more information about the prerequisites for Microsoft Visual C++ 2015 Redistributable Update 3, refer to the Microsoft documentation here.

• The RSCD agent for Microsoft Windows requires that the Server service is running.
• For a server to provide information about Windows Group Policy objects, the file secedit.exe must be installed on the server, and it must be included in the server's executable path.
• If the server is a domain member or domain controller, confirm that the Net Logon service is enabled and running before installing the RSCD agent. The agent uses the Net Logon service to determine the domain and obtain information about the machine. If the server is not part of a Windows domain, the agent uses a different method for determining machine information. Additionally, the automation principal feature uses the Net Logon service to access domain user information so the automation principal can act as a domain user. Note: If you subsequently remove the agent computer from the domain, you must also remove the Net Logon dependency (via the registry) and restart the agent. Otherwise, the agent will not start.
• The patch analysis function of TrueSight Server Automation requires the Microsoft XML (MSXML) parser version 6.0 SP2 or later to be installed on the server on which the RSCD agent is installed. You can install the RSCD agent on a computer on which MSXML is not installed, but patch analysis does not function correctly until MSXML 6.0 SP2 or later is installed.
• If you are using Windows Terminal Services or Citrix Presentation Server to install or if you are installing on a Windows operating system, use one of the following methods to install:
  
  • Install in Install mode rather than Execute mode. For information, see Using-Install-mode-instead-of-Execute-mode.
  • Install using the Windows Add or Remove Programs utility.

To install the RSCD agent

You can install the agent using one of the following settings:

• Typical: Installs the agent using the following default settings:
  • RSCD agent installation folder. The default is C:\Program Files\BMC Software\BladeLogic\RSCD
  • Security preferences defined in the secure and exports configuration files
  • No security preferences defined in the users and users.local configuration files
  • Location of agent log files. The default is C:\Program Files\BMC Software\BladeLogic\RSCD
  • Secure log files (enabled)
  • Logging of remote keystrokes (enabled)
• Custom: Allows you to customize the default settings.

Step	Example screen
1	Extract the TSSA<version>-RSCDAgents.zip file that you downloaded from EPD to obtain the rscd folder. The folder contains separate installers for 32-bit and 64-bit Windows systems. Navigate to the windows_64 folder, which is inside the rscd folder, and run the RSCD<version>-WIN64.msi file. Click Run. The installation wizard is displayed. Click Next.
2	Accept the license agreement, and click Next. Configure the following Smart Agent parameters to connect to the Smart Hub for sending work requests, and click Next. Enable Smart Agent: Specify whether you want to enable the Smart Agent service. The service is enabled by default, which indicates that the Smart Agent is started automatically after installation. Smart Hub hostname: The name of the host where the Smart Hub is installed. Smart Hub port: The listener port of the Smart Hub. The default port is 443. Enroll as: The server is enrolled in the Application Server using this value. Specify one of the following identifiers to be used for the enrollment: <HOSTNAME>: Indicates the server host name. This is the default identifier. <SMARTHUB_PEER_IP>: Indicates the IP address of the server. A server might have multiple IP addresses. The IP address that is used for connecting to the Smart Hub is represented by this field. <SMARTHUB_PEER_FQDN>: Indicates the fully qualified domain name for the <SMARTHUB_PEER_IP>. <UUID>: Indicates a random UUID value. Use it to enroll the target server in the AWS public cloud data center. Enroll interval time (mins): The interval at which the server enrollment request is sent to the Smart Hub. The default interval is 15 minutes. Specify the interval in the range 1 - 360 minutes. Heartbeat interval time (mins): The interval at which the agent sends heartbeats to the Smart Hub for status updates. The default interval is 5 minutes. Specify the interval in the range 1 - 360 minutes. Access key: The access key that is configured for the Smart Hub. This key is used for authenticating with the Smart Hub. To obtain the access key, see Configuring the Smart Hub. Smart Hub polling interval time (sec): The interval (in seconds) at which the Smart Hub is polled for work requests. The default is 300 seconds. Tunnel feature: Specify whether you want to enable or disable (default) the Tunnel feature.
3	Select one of the following options, and click Next: Typical: Installs the agent with the default settings. Custom: Allows you to customize the default settings.
4	Click Install to begin the RSCD agent installation.
5	The installer checks whether Microsoft Visual C++ 2015 Redistributable is installed on the server. If this is not installed, the installation program aborts installation with an error message.
6	Select one of the following options for the BladeLogicRSCD user password, and click Next: Use random password: Installs the agent with a random password generated by the installer. Use specified password: Installs the agent with the password specified by you. You can change the password later by using the command or agentctl utility. For more information, see Changing-the-BladeLogicRSCD-account-password.
7	You can select the Show the Windows Installer log option to view a detailed report of the installation process.Click Finish to exit the wizard.

You can run the installer from the command line and provide the following properties to the command. These properties are used for enrolling targets in public cloud environments such as AWS:

For example,

Where to go from here

Installing-the-TrueSight-Server-Automation-Console-and-Network-Shell-Windows