After gettint the authentication credentials and downloading the MSI file, you can use the command line or user interface to configure the MSI file for agent installation.

Get authentication credentials and download the MSI file

  1. Log in using your Partner/Client credentials.
  2. Navigate to Setup > Downloads > Agent.
  3. In the Windows Agent MSI tile, click Instructions. Follow the instructions or continue with these instructions.
  4. Your authentication credentials are populated in the Syntax for command line argument example. Copy the values for the apiserver, key, and secret arguments.
  5. In the Windows Agent MSI tile, click Download and follow the download instructions.

Configure the MSI file using the command line

  1. Open the command window with administrator privileges.

  2. Using the authentication credentials from the Instructions, run the following command to install the agent with core functionality and all features enabled. See the following command examples for other installation options:

        msiexec.exe /i ".msi file path" /quiet WRAPPED_ARGUMENTS="/silent /apiserver={apiserver} /key={key} /secret={secret} "
        

    To connect using a proxy, without credentials:

        msiexec.exe /i ".msi file path" /quiet WRAPPED_ARGUMENTS="/silent /apiserver=apiserver /key=key /secret=Secret /proxyip=proxyIP /proxyport=proxyport"
        

    To connect using a proxy, using credentials:

        msiexec.exe /i ".msi file path" /quiet WRAPPED_ARGUMENTS="/silent /apiserver=apiserver /key=key /secret=Secret /proxyip=proxyIP /proxyport=proxyport /proto=http/https /proxyusername=<proxy_server_username> /proxypassword=<proxy_server_b64encoding_password>"
        

    Specify the features you want to enable if you do not want all features enabled by default. Supported feature command line arguments, comma-separated, include:

    • agent:RemoteConsole
    • agent:RemoteCommand
    • agent:PatchManagement
    • agent:Automation

The following command line example uses the feature argument to enable all features:

/features=agent:RemoteConsole,agent:RemoteCommand,agent:PatchManagement,agent:Automation

The following example installs the agent with RemoteConsole and RemoteCommand features, only:

/features=agent:RemoteConsole,agent:RemoteCommand

The following example installs the agent with the auto-monitoring option enabled:

/automonitoring=true

Configure the MSI file using the user interface

  1. Open the downloaded MSI file to start the MSI installation wizard.

  2. Enter the following parameters in the fields provided:

    ParameterRequiredDescription
    API Server NameyesClick Instructions in the Windows Agent MSI tile and copy the pre-populated apiserver argument value.
    Client KeyyesClick Instructions in the Windows Agent MSI tile and copy the pre-populated key argument value.
    Client SecretyesClick Instructions in the Windows Agent MSI tile and copy the pre-populated secret argument value.
    Proxy IPoptionalProxy IP address.
    Proxy PortoptionalProxy port number.
    FeaturesoptionalIf no features are entered, all agent features are enabled:
    • agent:RemoteConsole
    • agent:RemoteCommand
    • agent:PatchManagement
    • agent:Automation
    To enable specific features only, enter those features, separated by commas.
    AutomonitoringoptionalAutomatically monitors your resources. To enable, set auto-monitoring to true. Otherwise, do not specify.
  3. Click Install.