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>.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. Click on this message for details.
     This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.Configure the following properties to use the Smart Agent capabilities. 

     NEW IN 20.02.01 

     Configure the following properties to enroll the targets that are provisioned in the public cloud.

     The following server properties are available out-of-the-box:

     You can also define custom properties.

     Example:

     In the following example, CLOUD_IPV6_ADDR_CNT, CLOUD_IS_PROD, CLOUD_VOLUME_CNT, and CLOUD_HAS_PUB_IP are custom properties and remaining are the out-of-the-box properties.

     WM_INTERVAL_SEC=5
     TUNNEL_ENABLE=true
     TUNNEL_IDLE_TIMEOUT_MIN=240
     
     #Server properties lists
     SERVER_PROP_STR="CLOUD_PROVIDER,CLOUD_ACCOUNT,CLOUD_REGION"
     SERVER_PROP_INT="CLOUD_IPV6_ADDR_CNT,CLOUD_VOLUME_CNT"
     SERVER_PROP_BOOL="CLOUD_IS_PROD,CLOUD_HAS_PUB_IP"
     
     #Individual server properties values
     CLOUD_PROVIDER="AWS"
     CLOUD_ACCOUNT="123456789012"
     CLOUD_REGION="us-east-1"
     CLOUD_IPV6_ADDR_CNT=2
     CLOUD_VOLUME_CNT=4
     CLOUD_IS_PROD=true
     CLOUD_HAS_PUB_IP=false

     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_STR="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.