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 Endpoint Configuration home page, click Help , then the Troubleshooting tab.
  2. Click Download Debug Package.

    A tanium-endpoint-configuration-support-[timestamp].zip file downloads to the local download directory.

  3. Attach the ZIP file to your Tanium Support case form or contact Tanium Support.

Tanium Client Management maintains logging information in the tanium-config.log file in the <Module Server>/services/endpoint-configuration-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 unblock 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. Select Block reinstallation 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. Select Soft uninstall to perform a soft uninstall, leaving some content in place; for example, logs and data. Clear the selection to perform a hard uninstall, removing everything tracked by the tool.
  7. Select Remove unreferenced dependencies 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.

  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. Select Reinstall Dependencies to reinstall any dependencies of the tool being installed.
  7. Select Unblock Tool to unblock reinstallation if it was previously blocked.

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 affects all Tanium solutions. Contact Tanium support before you uninstall Endpoint Configuration.

Endpoint Configuration is uninstalled with Client Management. For more information, see Uninstall Client Management.

Contact Tanium Support

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