## Instructions for Upgrade Compatibility Tool

Issue(s) addressed by this utility (PW-16856):
If the UpperFilters registry value has items listed in the wrong order,
DataKeeper may encounter severe issues.

---

Utility Description:
This utility MUST be run prior to upgrading DataKeeper. It is also recommended to run this utility any time a significant system change is made, or a new driver is installed. This utility checks system configuration to ensure that it is compatible with the new version of DataKeeper. If the configuration is incorrect, it will attempt to correct it.

---

AFFECTED ENVIRONMENTS:

- Any Windows System upgrading to DataKeeper v8.11.0 or v10.0.0

---

Usage Instructions

1. Download the utility

   This utility can be found on the SIOS FTP site at the following location:
   https://ftp.us.sios.com/pickup/PW-17108-Upgrade-Compat-Utility

2. Verify the download

   Use the following command to verify product downloads using md5sum:

   # certutil -hashfile UpgradeCompatTool.ps1 MD5

   This outputs the md5sum for the downloaded file which can be compared to the contents of the UpgradeCompatTool.ps1.md5 file.

   NOTE: Alternative download methods can be used but must include all files
   for the version of the utility being used. Once the download is complete
   a verification of the md5sum should be performed.

3. Run the Utility as an Administrator

   This can be done in a variety of ways. We recommend running Powershell as an administrator, and running
   the tool from there. To do this, run the following:

   # <PathToTool>\UpgradeCompatTool.ps1

4. Check the output
   If the utility displays a "Status: Success" message, you may proceed with your upgrade/install
   of DataKeeper. If the utility does not display a "Status: Success" or displays a "Status: FAILED", DO NOT proceed with the upgrade, and contact support to assist with remediation.

(NOTE) This utility must be run on all DataKeeper systems in a cluster prior to DataKeeper being upgraded.

---

Additional Options:

-Console - Utility will run in the console, instead of a GUI.

-DryRun - Utility will not make any changes. It will report the changes it would need to make.

-NoLog - Utility will not log any messages to the event viewer.