Installing the cli tools on a Windows™ system

The trc_cli_setup.exe file is required to install the controller component on a Windows™ system.

Before you begin

For more information about how to obtain the Windows™ component installation files, see Install the Remote Control components. Choose the appropriate method for obtaining the file.

Procedure

  1. Run the trc_cli_setup.exe file.
  2. On the file download window, select Run or Save
    Run
    Select Run to start the installation.
    1. Click Next at the welcome screen.
    2. Accept the license agreement, click Next.
    3. Accept or change the location for the installation files, click Next.
    4. On the server address screen type in the information and click Next:
      Server host name
      Enter the IP address or server name of the Remote Control server.
      Use secure connections (https)
      Select https to use secure connections to contact the server.
      Advanced settings
      Click Advanced settings for more configuration settings.
      Server port
      Enter the port number that the server is listening on.
      Server context
      Enter a value for the server context. For example, trc.
      Use a FIPS certified cryptographic provider
      Select Use a FIPS certified cryptographic provider for installing FIPS-compliant tools.
      Enable NIST SP800-131A compliance (Enables FIPS)
      Select Enable NIST SP800-131A compliance (Enables FIPS) for installing NIST SP800-131A compliant tools.
    5. On the Proxy settings panel, if you are not using a proxy server click Next.
      • If you are using a Proxy, select Use a proxy server or a Remote Control Gateway. Type in the relevant information
        1. Type in the IP address or host name for the proxy server.
        2. Type in the port that proxy server is listening on.
        3. Select Use an HTTP proxy or Use a Remote Control Gateway.
        4. Select Proxy requires authentication and enter the user ID and password for authenticating to the proxy server.The user ID and password are automatically encrypted when the target starts. For more information about the automatic passphrase encryption, see the BigFix® Remote Control Administrator's Guide.
          Note: The CLI is unable to automatically encrypt the proxy credentials when the CLI is installed stand-alone, without the target and when the CLI is run by a standard user. If you use the CLI that is included in the target package, the proxy credentials are automatically encrypted by the target. You must restart the target after you edit the settings in the registry or configuration file. When you use the stand-alone CLI tools, you must run the CLI once from an Administrator Command Prompt in a Windows operating system or when logged in as root in Linux.
        5. Click Next.
    6. Accept the default port or type in a value, click Next
    7. Click Install.
    8. Click Finish.
    Save
    Select Save to save the trc_cli_setup.exe file to a specific location.
    Note: Run this executable file to install the command-line software.

Results

The following executable files are in the selected directory.
wrc.exe
Use this tool to start a remote control session with a target.
wrcmdpcr.exe
Use this tool to run a command on a target and see the output from the command on the computer that you issue the command from.
For more information about using the command line tools, see theBigFix® Remote Control Controller User's Guide