Perform the following procedure to upload installers for rule files and agent packages to a Carbon Black App Control server.

Procedure

  1. Log in to the Carbon Black User Exchange and locate the new rules file and agent installer packages. Links to these packages are found on the Documentation & Downloads area for Carbon Black App Control on the User Exchange.
  2. Download the rules file installer and the agent installer packages for each OS platform in your environment to a file system that is on or accessible to your Carbon Black App Control server. These files are named as follows:
    • Rules file installer – RulesInstaller.exe
    • Windows agent installer – WindowsHostPackageInstaller.exe
    • Linux agent installer – LinuxHostPackageInstaller.exe
    • macOS agent installer – MacHostPackageInstaller.exe

  3. Log into your Carbon Black App Control server using an account that has Manage system configuration permissions.
  4. In the console menu, click on the configuration (gear) icon and click Update Agent / Rule Versions.
  5. To install a new rules file on the server, drag the RulesInstaller.exe file from your download folder into the target zone on the Update Agent / Rule Versions page, or click Select a file to find the file by using a browser
    Important: If you are updating the rules file, do not attempt to simultaneously upload any agent files. Each file upload must be complete before the next one is started.

    When the upload begins, the server checks to see whether the package is correctly signed. If it is, it is installed on the server. Messages report on each stage of the progress (or failure) of the upload and installation.

  6. When the rules upload is complete, repeat the file drag-and-drop or selection process for each agent installer package to upload to your server.
    Important:
    • Do not simultaneously upload multiple agent files. Each file upload must be complete before the next one is started. The server restarts after each upload. A success message appears when the new agent installer package is available.
    • Remain on the Update Agent / Rule Version page while uploads are proceeding. You can go to other pages, but since the server is restarted after the upload, activity on another page can be interrupted at an unpredictable point.
  7. After you have finished uploading rules files and agent installers to a server:
    1. f you are setting up a new server, set up the policies to control your agents. See "Creating and Configuring Policies" in the Carbon Black App Control User Guide.
    2. Choose a policy assignment method. See Assigning Endpoints to a Policy.
    3. Install agents on endpoints. See:
    4. If you are uploading new agent installers or rules files on an existing server, begin upgrading agents according to the upgrade plan appropriate to your site. See Upgrading Agents on Endpoints.

What to do next

Note: If you are using Unified Management to manage multiple Carbon Black App Control servers, you must upload new rule and agent packages to each server separately. The management server does not broadcast these packages to the managed servers.