Installing Tanium Connect

Use the Tanium Solutions page to install Connect and choose either automatic or manual configuration:

  • Automatic configuration with default settings (Tanium Core Platform 7.4.2 or later only): Connect is installed with any required dependencies and other selected products. After installation, the Tanium Server automatically configures the recommended default settings. This option is the best practice for most deployments. For more information about the automatic configuration for Connect, see Import and configure Connect with default settings.
  • Manual configuration with custom settings: After installing Connect, you must manually configure required settings. Select this option only if Connect requires settings that differ from the recommended default settings. For more information, see Import and configure Connect with custom settings.

Before you begin

Import and configure Connect with default settings

When you import Connect with automatic configuration, the Connect service account is set to the account that you used to import the module.

To import Connect and configure default settings, be sure to select the Apply Tanium recommended configurations check box while performing the steps in Tanium Console User Guide: Manage Tanium modules. After the import, verify that the correct version is installed: see Verify Connect version.

Import and configure Connect with custom settings

To import Connect without automatically configuring default settings, be sure to clear the Apply Tanium recommended configurations check box while performing the steps in Tanium Console User Guide: Manage Tanium modules. After the import, verify that the correct version is installed: see Verify Connect version.

Configure service account

The service account is a user that runs several background processes for Connect. This user requires the Connect Service Account role.

For more information about Connect permissions, see User role requirements.

  1. From the Main menu, click Connect to open the Connect Home page.
  2. Click Settings and open the Service Account tab.
  3. Update the service account settings and click Save.

Configure settings

You can optionally configure the following settings for Connect in the General Settings tab of the Connect Settings:

Connection Run Log Expiration

Number of days before connection run logs are removed

Connect Service Log Level

Log level for the Connect service logs

Default Workbench Timezone

Time zone that is used by default by the Connect workbench

Allow Connections to Internal IPs

Allow anyone to run connections to IP addresses on an internal network. For more information, see Test connections.

Multiple Processes

Allow connections to run simultaneously. For more information, see Test connections.

Memory Ceiling

Maximum memory for the node process to run connections, specified in GB.

Upgrade Connect

Before you upgrade Connect, you must back up your <Tanium Module Server>\services\connect-files\config\connect.db file in case you need to revert to a previous version of Connect. The support package is the easiest way to obtain a backup of the Connect database. For more information, see Collect logs.

For the steps to upgrade Connect, see Tanium Console User Guide: Manage Tanium modules. After the upgrade, verify that the correct version is installed: see Verify Connect version.

If you are upgrading from a version prior to Connect 4.12, you must Configure service account immediately after you upgrade. Verify that any previously created connections are still working correctly.

Verify Connect version

After you import or upgrade Connect, verify that the correct version is installed:

  1. Refresh your browser.
  2. From the Main menu, click Connect to open the Connect Home page.
  3. To display version information, click Info Info.

Troubleshoot problems

If you experience problems with installing Connect, see Troubleshooting.

What to do next

See Getting started for more information about using Connect.