How to upgrade the Splunk App for Microsoft Exchange

The commands that appear in this topic are for use on PowerShell. If you use *nix, substitute PowerShell commands with *nix counterparts. If you use different directories for Splunk Enterprise and deployment server, substitute the directories that appear here with your specific directories.

Upgrade overview

The following supported upgrade scenarios are available for the Splunk App for Microsoft Exchange:

• From version 3.2.x to this version.

Upgrade tips

From version 3.2.x to this version

When you upgrade the Splunk App for Microsoft Exchange to the latest version, note the following:

• The Splunk Add-ons for Microsoft Exchange, Microsoft Active Directory, and Windows DNS have changed significantly. They have new names (TA-Microsoft-Exchange*/TA-Windows-Exchange-IIS, TA-Microsoft-AD, and TA-Microsoft-DNS) and improved function. Instead of an add-on for each version of Windows or Exchange, the add-ons now support all versions of Windows and Exchange that Splunk Enterprise supports.
• Instead of coming packaged with the Splunk App for Microsoft Exchange, all of these add-ons are now available as separate downloads on Splunkbase.
• You must remove the existing add-ons and download and install the new add-ons.
• The Splunk Add-ons for Microsoft Active Directory and Windows DNS must be installed on all search heads and indexers in the deployment.
• The Splunk Add-ons for Microsoft Exchange replace the suite of individual add-ons that came with the Splunk App for Microsoft Exchange installation package. For more information about the updated Splunk Add-on for Microsoft Exchange, see Download and configure the Splunk Add-on for Microsoft Exchange.
• For more information about the Splunk Add-ons for Microsoft Active Directory and Windows DNS, see About the Splunk Add-on for Microsoft Active Directory and About the Splunk Add-on for Windows DNS.

See Upgrade from version 3.2.x for the upgrade procedure.

Troubleshoot permissions issues after an upgrade

When you upgrade the Splunk App for Microsoft Exchange to version 3.1.x, the app installs a new user role, exchange-admin. The Splunk user that uses the Splunk App for Microsoft Exchange must have this role, otherwise the app will not function correctly.

If, during the first time process, you see that the app does not find any data and you know that the data exists (such as in the case of an upgrade), be sure to add the exchange-admin role to the user that uses the app, as described in the troubleshooting page.