Skip to Content

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. 

    Warning

    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.

    Warning

    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>.msi is 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:
      msiexec /I RSCD2002-WIN32.msi /QB /L*V C:\rscd.log REBOOT=ReallySuppress INSTALLDIR="C:\Program Files\RSCD" KEYLOGS=0 MAPUSER=Administrator RSCDPORT=4400

      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:

      The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
      Configure the following properties to use the Smart Agent capabilities. 

      Property

      Description

      SMARTHUB_HOSTNAME

      Specify the host name of the system where the Smart Hub is installed. For example, "smarthubprod1.bmc.com"

      SMARTHUB_PORT

      Specify the listener port of the Smart Hub. The default port is 443.

      ENROLL_INTERVAL_MIN

      Specify the interval for enrolling the agent. The default interval is 15 minutes. The interval range can be 1 - 360 minutes.

      ENROLL_AS

      Shows the predefined identifier that is used for enrolling the server. 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.
      • "<SMARTHUB_PEER_FQDN>": Indicates the fully qualified domain name of the Smart Hub IP address.
      • NEW IN 20.02.01 <UUID>: Indicates the UUID value that is generated for the server.
        Note: Use this identifier for enrolling servers in the public cloud, such as AWS.

      Also, you can specify a combination of "<HOSTNAME>.domain" or free text, such as "smartagent.domain."

      NEW IN 20.02.01 Conversion operators

      You can use the following conversion operators with any of the predefined identifiers to change their casing:

      • <UPPER>: Changes to upper case characters.
      • <LOWER>: Changes to lower case characters.

      You can also use any free text along with the identifiers.

      Examples:

      Identifier

      Sample enrolled value

      <HOST_NAME>

      oracle_prod2

      <SMARTHUB_PEER_FQDN>

      oracle_prod2.bmc.com

      <HOSTNAME><UPPER>

      ORACLE_PROD2

      <HOSTNAME>.dev.bmc.com<UPPER>

      ORACLE_PROD2.DEV.BMC.COM

      <UPPER><SMARTHUB_PEER_FQDN>

      ORACLE_PROD2.BMC.COM

      RHEL-db-prod1.prod.bmc.com<UPPER>

      RHEL-DB-PROD1.PROD.BMC.COM

      <LOWER>RHEL-db-prod1.prod.bmc.com

      rhel-db-prod1.prod.bmc.com

      <UPPER>

      Error msg : Unable to set enroll_as value from : <UPPER>

      <UPPER><HOSTNAME><LOWER>

      ORACLE_PROD2

      Note: If both the operators are provided, <UPPER> will have precedence over <LOWER>.

      HEARTBEAT_INTERVAL_MIN

      Specify the interval at which the Smart Agent sends heartbeats to the Smart Hub for status updates. The default interval is five minutes. The interval range can be 1 - 360 minutes.

      SMARTAGENT_SERVICE

      Indicates whether the Smart Agent service is enabled. When the service is enabled, the Smart Agent is started automatically after installation.

      • For new installation, the default value is set to 1, which indicates that the Smart Agent service is enabled.
      • For upgrade, the default value is set to 0, which indicates that the Smart Agent service is disabled. The Agent is not started automatically after the upgrade.

      To change the default settings, you can change the property value as required.

      ACCESS_KEY

      Specify the access key that is generated after registering the Smart Hub in the Application Server. For more information, see Configuring-the-Smart-Hub-and-Smart-Hub-Gateway.

      SERVER_PROP_STR DEPRECATED IN 21.02

      Comma-separated list of server properties of type String. This property is deprecated in version 21.02. Use the SERVER_PROP_LIST property instead.
      Note: For 21.02.01 and earlier versions, enter the property names and their value in upper case characters only.

      SERVER_PROP_INT DEPRECATED IN 21.02

      Comma-separated list of server properties of type Integer. This property is deprecated in version 21.02. Use the SERVER_PROP_LIST property instead.
      Note: For 21.02.01 and earlier versions, enter the property names and their values in upper case characters only.

      SERVER_PROP_BOOL DEPRECATED IN 21.02

      Comma-separated list of server properties of type Boolean. This property is deprecated in version 21.02. Use the SERVER_PROP_LIST property instead.
      Note: For 21.02.01 and earlier versions, enter the property names and their values in upper case characters only.

      SERVER_PROP_LIST

      NEW IN 21.02

      The list of server properties that you want to configure. For 21.02.01 and earlier versions, enter the property names and their values in upper case characters only.
      Note: The SERVER_PROP_LIST parameter supports custom server properties in addition to predefined ones. By including them in the  SERVER_PROP_LIST  variable, you can define and assign custom properties during agent installation. These properties will be registered with the agent and can be used for automation, reporting, and policy enforcement.
      For example: SERVER_PROP_LIST="CUSTOM:Location=DC1,CUSTOM:Environment=Prod"

      WM_INTERVAL_SEC NEW IN 20.02.01

      Specify the interval (in seconds) at which the Smart Hub is polled for work requests. The default is 300 seconds.

      TUNNEL_ENABLE NEW IN 20.02.01

      A Boolean value that indicates whether the tunnel feature is enabled. By default, it is disabled.

      TUNNEL_IDLE_TIMEOUT_MIN NEW IN 20.02.01

      The idle connection timeout in minutes. The default is 720 minutes.

      CLOUD_ACCOUNT

      Specify the cloud account to which the server belongs.

      CLOUD_REGION

      Specify the cloud region where the server is located.

      CLOUD_RESOURCE_NAME

      Specify the cloud resource name for the server.

      CLOUD_RESOURCE_ID

      Specify the cloud resource identifier for the server.

      CLOUD_VPC

      Specify the cloud VPC where the cloud is located.



      AUTO_USP_ENABLED NEW IN 21.02

      A Boolean value (true or false) that indicates whether the Auto USP feature is enabled. By default, it is enabled. If you want to disable this feature, add this property and specify its value as false.

      AUTO_USP_INTERVAL_H NEW IN 21.02

      The interval (in hours) at which the server properties are validated to detect a change. The default interval is two hours.

      CONFIG_POLICY_ENABLEDNEW IN 21.02

      A Boolean value (true or false) that indicates whether the Configuration Policy feature is enabled. By default, it is enabled. If you want to disable this feature, add this property and specify its value as false.

      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, <CUSTOM_PROPERTY> "
      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*

TrueSight Server Automation 21.3