DataHub v10 Upgrade Best Practices
Before you upgrade please review the best practices below to ensure a smooth upgrade process.
Before you start work, be sure you confirm that you are on a supported operating system, and that you consider other connected applications, and always follow your company's change management policies and practices. If you have a complex installation, consider testing on another machine before upgrading a production system. If you need a temporary license to facilitate that testing please contact us.
Step 1: Make sure you have a license for version 10.
DataHub licenses include a version number as part of the product code. It should have a “v10” in the license number if it works with version 10. Users on support can request a free upgrade. If you are unsure if your license is on support or would like to check on the upgrade pricing please contact us.
Step 2: Backup your configuration and install the new version
We are now ready to install the new version. If you do not have the installer you can download the latest version.
Next we can backup the configuration folder.
- Open the DataHub Service Manager
- Copy the path for the Configuration Folder. The default config path is C:\Users\[USERNAME]\AppData\Roaming\Cogent DataHub
- Open Windows Explorer and paste in this path.
- Make a copy of the entire “Cogent DataHub” folder and save it to a convenient location. This contains all the configuration files and the license and will act as the backup configuration folder.
Now that we have a backup you need to Exit the DataHub application or Stop the DataHub service.
Run the installer. It will prompt you that you have a version already installed and ask if you would like to uninstall. Click Yes and it will remove the old version and install the latest version.
Once finished you can run the DataHub and check your configuration. The expectation is everything is fine and the backup configuration folder is not needed. If the configuration does not match what was there before the upgrade, replace the “Cogent Datahub” folder that is currently at the path used in step 2 above with the backup configuration folder.
Of course if you have any unexpected behavior after upgrading please contact our support team.