Using silent mode to install an RSCD agent (Windows)

To perform an unattended installation of the RSCD agent on a Microsoft Windows computer, use silent mode.

To install the agent on multiple computers, you can use an Agent Installer Job or the Unified Agent Installer. See Running-the-Unified-Agent-Installer.

Before you begin

  • Ensure that Microsoft Visual C++ 2015 Redistributable Update 3 is installed on the server. 

    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.

    Microsoft Visual C++ 2015 Redistributable Update 3 can be installed automatically from Agent Installer Job - Options window and by using the 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.

  • The RSCD agent for Microsoft Windows requires that the Server service is running in order to function correctly.
  • 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.

To install the RSCD agent in silent mode

  1. Copy the installation program (RSCD<version-platform>.msi) to the Windows system where you plan to install the agent.
  2. Change the directory to the location where the installer resides.
  3. At the command prompt, enter the command:
    msiexec /I RSCD<version-platform>.msi /QN <PROPERTY=value> <PROPERTY=value>
    where:
    • RSCD<version-platform>.msiis the name of the agent installer.
    • /QN— Sets the user interface level to no UI. Optionally, you can use /QB to display a progress bar for the installation.
    • (Optional)/L*V <logLocation> — Logs information about the installation to the file you specify.

    • <PROPERTY=value>— Specifies a property that overrides the default installation settings.

      Example: To install the RSCD Agent on a domain controller
      msiexec /I RSCD2002-WIN32.msi /QB /L*V C:\rscd.log REBOOT=ReallySuppress INSTALLDIR="C:\Program Files\RSCD" KEYLOGS=0 MAPUSER=Administrator RSCDPORT=4400 BLADELOGICDCUSERPASSWORD=admin123

      This example specifies that:

      • The installation displays a progress bar but no UI.
      • Information about the installation is logged to C:\rscd.log.
      • Any need for reboot will be suppressed and handled by the installer.
      • The installation location is changed from the default to: C:\Program Files\RSCD.
      • Keystroke logging is disabled.
      • All client connections to the server are mapped to the local user called Administrator and run with Administrator permissions.
      • The RSCD port is changed from the default to 4400.
      Example: Install the RSCD agent on a non-domain controller
      msiexec /I RSCD2002-WIN32.msi /QB /L*V C:\rscd.log REBOOT=ReallySuppress INSTALLDIR="C:\Program Files\RSCD" KEYLOGS=0 MAPUSER=Administrator RSCDPORT=4400 BLADELOGICUSERPASSWORD=admin123

      This example specifies that:

      • The installation displays a progress bar but no UI.
      • Information about the installation is logged to C:\rscd.log.
      • Any need for reboot will be suppressed and handled by the installer.
      • The installation location is changed from the default to: C:\Program Files\RSCD.
      • Keystroke logging is disabled.
      • All client connections to the server are mapped to the local user called Administrator and run with Administrator permissions.
      • The RSCD port is changed from the default to 4400.

      You can specify one or more of the following properties:

      Property

      Description

      REBOOT

      The REBOOT property, set to the ReallySuppress value, is necessary to ensure that you are not prompted to reboot the host computer towards the end of the silent installation.

      INSTALLDIR

      The target location for the RSCD installation. The default is: C:\Program Files\BMC Software\BladeLogic\RSCD. Enclose the path in double quotation marks (" ").

      EXPORTSFILE

      Specifies the location of a file to use as the exports file for the RSCD agent. The installation renames the specified file to exports and puts it in the RSCD agent configuration file directory. The installation does not overwrite an existing file, if found. In addition, you cannot edit the specified file in the installation program GUI. For details about the exports configuration file, see Configuring-the-exports-file.

      Specify the full path to a file. The file name can contain Windows path variables (for example, %temp%); however, the file must reside on the local file system of the computer on which you are installing the agent.

      KEYLOGS

      Enables or disables use of keystroke logs for nexec commands. Keystroke logs capture log information from remote commands run on the agent using nexec. The logs are also periodically rolled and digitally signed as they are rolled.

      Values: 1 (enable) or 0 (disable). The default is 1.

      LOGFILEDIR

      Location of agent log files. The default is: C:\Program Files\BMC Software\BladeLogic\RSCD.

      MAPUSER

      The account of a local user. If you specify a value for this property, the exports file is modified to force the agent to impersonate the specified user for all activities. By default, the property is not set and no user mapping is created.

      RSCDPORT

      Sets the RSCD port number in rscd entry of the agent's secure file. The default port is 4750.

      SECUREFILE

      Specifies the location of a file to use as the secure file for the RSCD agent. The installation renames the specified file to secure and puts it in the RSCD agent configuration file directory. The installation does not overwrite an existing file, if found. In addition, you cannot edit the specified file in the installation program GUI. For details about the secure file, see Configuring-the-secure-file.

      Specify the full path to a file. The file name can contain Windows path variables (for example, %temp%); however, the file must reside on the local file system of the computer on which you are installing the agent.

      SECURELOGS

      Enables or disables use of secure (digitally signed) logs for the RSCD agent. Secure agent logs have message authentication codes and sequence numbers assigned to the current log and digitally signed rolled logs.

      Values: 1 (enable) or 0 (disable). The default is 1.

      USERSLOCALFILE

      Specifies the location of a file to use as the users.local file for the RSCD agent. The installation renames the specified file to users.local and puts it in the RSCD agent configuration file directory. The installation does not overwrite an existing file, if found. In addition, you cannot edit the specified file in the installation program GUI. For details about the users.local configuration file, see Configuring-the-users-or-users-local-files.

      Specify the full path to a file. The file name can contain Windows path variables (for example, %temp%); however, the file must reside on the local file system of the computer on which you are installing the agent.

      EXPORTSFILETEXT

      Set this parameter to modify the exports file content. For example, to allow access only from appserver1 and appserver2 hosts, use this value: "appserver1,appserver2 rw" For more information about configuring the Exports file, see Configuring-the-exports-file.

      BLADELOGICDCUSERPASSWORD

      (Mandatory when installing the RSCD agent on a domain controller)

      Set the password for the BladeLogicRSCDDC user.

      You can change the password later by using the chapw command or the agentctl utility. For more information, see Changing-the-BladeLogicRSCDDC-account-password-on-domain-controllers.

      BLADELOGICUSERPASSWORD

      Set the password for the BladeLogicRSCD user. 

      If you don't set the password, a random password is generated. You can change the password later by using the chapw command or the agentctl utility. For more information, see Changing-the-BladeLogicRSCD-account-password.

      NEW IN 23.4 MAP_TO_SYSTEM_USER_ONLY

      Enables or disables the exclusive mapping of all roles/users to the SYSTEM user on the server. For more information, see Impersonation-and-privilege-mapping.

      Values: 1 (enable) or 0 (disable). The default is 0.

      Configure the following properties to use the Smart Agent capabilities. 

      Example of configured Smart Agent properties
      AUTOSTART_AGENT=1
      EXPORTSFILETEXT="*rw,user=root"
      SMARTHUB_HOSTNAME="abc.bmc.com"
      SMARTHUB_PORT=10443
      ENROLL_INTERVAL_MIN=1
      ENROLL_AS="<HOSTNAME>.bmc.com<UPPER>"
      HEARTBEAT_INTERVAL_MIN=5
      SMARTAGENT_SERVICE=1
      ACCESS_KEY="azywdWJsaWNfa2V5IjoiLS0tLS1CRUdJTiBQVUJMSUMgS0VZ
      LS0tLS1cclxuTUlJQklqQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FROEFNSUlCQ
      2dLQ0FRRUExSDc5THdmcG5DNm5ZVTNHVTRFb1xyXG5qdERzQjczdzF3dEE4VmV
      CR1FZd1o0NVloK3FrRiszYmN0RDVabGQxdVA2cWRWZWppTzRXMXRTWmxRTXBLb
      tttXHJcbnJIMGdyc3dXNG91S1E2azFTdzY2SWZWTU5BKzI5Qk5oFdZYy9xbzk3
      eW5HSzJLNm41a2tzc2dCM0RONGRcclxuN1FJREFRQUJcclxuLS0tLS1FTkQgUF
      VCTElDIEtFWS0tLS0tXHJcbiIsImluZnJhX2lkIjoiQjgzMzNFQUIwQjUzM0RDR=="
      SERVER_PROP_LIST="CLOUD_PROVIDER, CLOUD_ACCOUNT, CLOUD_REGION,
      CLOUD_RESOURCE_ID, CLOUD_RESOURCE_NAME, CLOUD_VPC"
      CLOUD_PROVIDER="AWS"
      CLOUD_REGION="MUMBAI"
      CLOUD_RESOURCE_ID="123"
      CLOUD_ACCOUNT="BMC-TEST"
      CLOUD_RESOURCE_NAME=""
      CLOUD_VPC="VPC0"
      TUNNEL_ENABLE="true"
      Example to specify Smart Agent properties

      Enter the following command at the command prompt:

      msiexec /I RSCD2002-WIN32.msi /QB /L*V C:\rscd.log REBOOT=ReallySuppress
      INSTALLDIR="C:\Program Files\RSCD" KEYLOGS=0 MAPUSER=Administrator RSCDPORT=4400
      SMARTHUB_HOSTNAME=prodsmarthub.bmc.com SMARTHUB_PORT=8443
      SERVER_PROP_LIST="CLOUD_PROVIDER, CLOUD_ACCOUNT,CLOUD_REGION" CLOUD_PROVIDER="AWS" CLOUD_ACCOUNT="123456789012" CLOUD_REGION="US-EAST-1"
      ACCESS_KEY="The Smart Hub access key" 

      This example specifies that:

      • The installation displays a progress bar but no UI.
      • Information about the installation is logged to C:\rscd.log.
      • Any need for reboot will be suppressed and handled by the installer.
      • The installation location is changed from the default to: C:\Program Files\RSCD.
      • Keystroke logging is disabled.
      • All client connections to the server are mapped to the local user called Administrator and run with Administrator permissions.
      • The RSCD port is changed from the default to 4400.
      • The Smart Hub host name is configured as prodsmarthub.bmc.com.
      • The Smart Hub port is changed from default (443) to 8443.
      • The following server properties of type string and their values will be passed to the installer: CLOUD_PROVIDER, CLOUD_ACCOUNT, CLOUD_REGION
      • The specified Smart Hub access key will be passed to the installer.

 

 

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