Deploying clients by using a Fixlet

Deploy client computers from the BigFix console by running the Install BigFix Clients with Client Deploy Tool Fixlet. This Fixlet cannot be imported into a custom site. You must use it from the BES Support site.

To deploy the clients from the console, perform the following steps:

  1. Log in to the BigFix console.
  2. Open the Fixlets and Tasks icon in the Domain Panel.
  3. In the search bar, enter Client Deploy Tool.
  4. Select the Fixlet named Install BigFix Clients with Client Deploy Tool.
  5. In the Description tab, you must:
    • Select all the operating systems associated to the client computers that you want to deploy. Select the client version that you want to deploy.
    • Enter the credentials needed to access the computer on which you installed the Client Deploy Tool. These credentials are required only if you installed the Client Deploy Tool on a Windows system. Specify either a domain administrator account with all necessary permissions or any administrator account with full local administrative permissions on the Client Deploy Tool computer.
    • Enter the following required information for the client computers that you want to deploy:
      Computers
      Enter the client computer names by using one of the following options:
      • The list of host names of the client computers.
      • The list of IP addresses of the client computers.
      • The IP address range of the client computers.
      If you specify a range of IP addresses, use the following format:
      192.0.2.1-20
      Username
      The user ID needed for the connection. For example, Administrator on Windows systems or root on Linux systems.
      Password
      The password associated to the user ID of the client computers.
      Note: In the Computers text box, you can specify more than one line by pressing Enter at the end of each line.
      Note: For each line, you have the possibility to enter the specific credentials associated to the client computers.
    • Select the Show advanced settings check box.

      (Optional) In the "Custom Settings" section, add a list of custom client settings to apply to each client that will be deployed by the Client Deploy Tool.

      You can input these settings in either a table or a text box. If you use the table, add a row for each setting, then enter its name and value in the respective columns. If you use the text box, add a new line for each setting, then enter its name and value in the format "name=value".

      (Optional) In the "Proxy Settings" section, if the clients to be deployed must communicate through a proxy, enter the following information:
      Address
      The host name that is used to reach the proxy.
      Port
      The port that is used to communicate with the proxy.
      Username
      The user name that is used to authenticate with the proxy if the proxy requires authentication.
      Password
      The password that is used to authenticate with the proxy if the proxy requires authentication.
  6. Click Take Action.
  7. On the Target tab, select one or more devices, which are target computers on which you installed the Client Deploy Tool instances.
  8. Click OK.
  9. Verify the status and the exit code of the Fixlet. The exit code 0 represents the Success status.
Note: When running the Fixlet, depending on the operating systems that you selected in the Description tab of the Fixlet, the platform-specific packages are cached on the BigFix server and downloaded only on the client computers where the Client Deploy Tool is installed. Packages are downloaded only if they are not found; they are not overwritten each time you run the Fixlet.
Note:

If you deploy old BigFix client versions, such as 9.1 and 9.2, or any other version older than the Client Deploy Tool version installed using the Install BigFix Clients with Client Deploy Tool Fixlet, the locally installed Client Deploy Tool user interface might no longer work.

This known issue is caused by the BESClientsCatalog.xml file level that is replaced with the version deployed by the Fixlet. To solve this known issue, manually run again the Fixlet to deploy the latest client version and the latest valid BESClientsCatalog.xml catalog file will be replaced again.

It is highly recommended to use the Fixlet instead of the locally installed Client Deploy Tool user interface to deploy the clients.