Troubleshooting Endpoint Configuration

To collect and send information to Tanium for troubleshooting, and other relevant information.

Collect logs

The information is saved as a ZIP file that you can download with your browser.

  1. From the Client Management home page, click Help , then the Troubleshooting tab.
  2. Click Download Debug Package.
    A tanium-client-management-support.zip file downloads to the local download directory.
  3. Attach the ZIP file to your Tanium Support case form or send it to your Technical Account Manager (TAM).

Tanium Client Management maintains logging information in the client-management.log file in the \Program Files\Tanium\Tanium Module Server\services\client-management-files directory.

Block or unblock tools from installing on an endpoint

To block or unblock the installation of one or more tools on an endpoint that is included in an Endpoint Configuration manifest, distribute the Endpoint Configuration - Block Tool or Endpoint Configuration - Unblock Tool package.

Block the installation of a tool

  1. Target the endpoints on which you want to block tool installation.
  2. Click Deploy Action.
  3. (Windows) Select the Endpoint Configuration - Block Tool [Windows] package.
  4. (Non-Windows) Select the Endpoint Configuration - Block Tool [Non-Windows] package.
  5. Choose a tool from the dropdown, or provide a manual tool name.

Unblock the installation a tool

  1. Target the endpoints on which you want to block tool installation.
  2. Click Deploy Action.
  3. (Windows) Select the Endpoint Configuration - Unblock Tool [Windows] package.
  4. (Non-Windows) Select the Endpoint Configuration - Unblock Tool [Non-Windows] package.
  5. Choose a tool from the dropdown, or provide a manual tool name.

Uninstall one or more tools installed by Endpoint Configuration.

To uninstall one or more tools on an endpoint that was installed by Endpoint Configuration, distribute the Endpoint Configuration - Uninstall Tool package.

  1. Target the endpoints on which you want to uninstall a tool.
  2. Click Deploy Action.
  3. (Windows) Select the Endpoint Configuration - Uninstall Tool [Windows] package.
  4. (Non-Windows) Select the Endpoint Configuration - Uninstall Tool [Non-Windows] package.
  5. Set the Block reinstallation parameter to block the reinstallation of the tool. If unset, the tool will be installed on the endpoint the next time the Endpoint Configuration tools installation is performed.
  6. Set the Soft uninstall parameter to perform a soft uninstall, leaving some content in place; for example, logs and data. Uncheck to perform a hard uninstall, removing everything tracked by the tool.
  7. Set the Remove unreferenced dependencies parameter to remove any additional unreferenced tools that were a dependency of the tool being removed.

Reinstall one or more tools installed by Endpoint Configuration.

To reinstall one or more tools on an endpoint that was installed by Endpoint Configuration, distribute the Endpoint Configuration - Reinstall Tool package. The most recent version of the targeted tooling is installed.

Before you attempt to reinstall a tool, ensure that the tool is not blocked on the endpoint.

  1. Target the endpoints on which you want to reinstall a tool.
  2. Click Deploy Action.
  3. (Windows) Select the Endpoint Configuration - Reinstall Tool [Windows] package.
  4. (Non-Windows) Select the Endpoint Configuration - Reinstall Tool [Non-Windows] package.
  5. Choose a tool from the dropdown, or provide a manual tool name.
  6. Set Reinstall Dependencies to reinstall any dependencies of the tool being installed.

Each Tanium solution features a ToolName -- Tools Cache [1] package. These packages define how all the files that an endpoint downloads are loaded into the Tanium Server cache. These packages should never be manually deployed to endpoints.

Uninstall Endpoint Configuration

Uninstalling Endpoint Configuration impacts all Tanium solutions. Contact Tanium support before you uninstall Endpoint Configuration.

  1. From the Main menu, click Tanium Solutions.
  2. In the Tanium Content section, select the Endpoint Configuration row.
  3. Click Uninstall Solution. Click Uninstall to complete the process.

Contact Tanium Support

To contact Tanium Support for help, send an email to [email protected].

Last updated: 10/19/2020 3:44 PM | Feedback