Upgrading Map

Before you begin

In Map 3.8, the steps required to configure the service account are no longer necessary due to the adoption of the System User service, which performs these tasks automatically. Additionally, the Map database is migrated to RDB in this release. Consequently, after upgrading to Map 3.8, it might take time for the database migration to complete and for RBAC privileges and other updates to sync properly. This could lead to issues and error messages when you first query the Tanium Console. These issues usually resolve on their own after a few minutes, but could take up to an hour or longer depending on system resources and the amount of data to migrate.

• Read the release notes.
• Review the Map requirements.

Back up Map data

If you have existing applications and maps, you might want to take screen shots or export data before upgrading. The data that you collect is not importable into Map 3, but the information might be useful to refer to after your upgrade.

• Download applications and criteria. From the Defined Applications page, click Download Catalog button. The resulting JSON file contains your applications and their criteria.

• Export a CSV file that contains all endpoint and connection data that is used to draw the map. From each individual graphical map, click Export.

• Export question data to help you build custom questions with valuable information. From each individual graphical map, click the red icon to View Tanium Question Information.

Remove Map 1.x and 2.x tools from endpoints

Map tools are not upgraded when you install Map 3.x. You must uninstall the Map tools from your endpoints before you install Map 3.x.

1. Disable the Map scheduled actions by setting the action group to no computers.
   1. From the Main menu, click Administration > Actions > Action Groups.
   2. Click the Tanium Map action group.
   3. In the Computer Groups section, clear the checkboxes for any selected computer groups and choose the No computers computer group.
   4. Click Save.
2. Create a targeting question for the endpoints from which you want to remove Map tools. Because the action to remove tools is specific to the operating system, target Windows, Linux, and Mac systems separately.

3. Deploy the Map - Remove Tools [Windows|Linux|Mac] action. Make sure the question is re-issued and has sufficient expiration time (such as 2 months).
   For the Remove ignored files option:

   • Checked: Remove the entire Tools\Map directory, including the Map database and logs.
   • Unchecked (default): Removes most Map endpoint files (such as Python-based tools, version file), but leaves the map.db file, application catalog, and logs. Use this option if you might re-install Map at some point in the future or if you do not want to lose historical data.