Introduction to Upgrading the Denodo Platform¶
The process of upgrading to a new major version of the Denodo Platform involves installing the new version in a separate computer - or in a different directory of the same computer - and transferring the metadata and settings from the version 7.0 or 6.0, to the new installation. The same applies to the Solution Manager.
To upgrade from Denodo Platform 5.5 or earlier, you have to transfer the metadata and settings to the version 6.0 and from 6.0 to 8.0 (see below the section Upgrading from Denodo Platform 5.5 or Earlier).
All the steps of this upgrade guide apply for upgrading from Denodo 6.0 and from 7.0, unless it is mentioned explicitly. That is, on several occasions, you will find sentences like If in Denodo 7.0, you enabled the feature… and unless explicitly mentioned, this also applies for when you are upgrading from Denodo 6.0.
This guide discusses the upgrade of the component Solution Manager. This component was added in Denodo 7.0 so if you are upgrading from Denodo 6.0, ignore these fragments.
Major Steps in the Upgrade Process¶
The process of upgrading to the Denodo Platform 8.0 consists of six steps:
Do not start the upgrade if you cannot install the latest update of the version you run now (i.e. 6.0 or 7.0). These updates add a feature to make compatible the metadata of the versions 7.0 and 6.0, with 8.0.
Step 1. In the current installation of the Denodo Platform and the Solution Manager, install the latest update.
Step 2. Install the Denodo Platform 8.0 and the Solution Manager 8.0 and install their latest update.
Step 3. In the new installation, change some settings. E.g. enable the cache if it was enabled in the previous version.
Step 4. Export the settings and metadata of all the components of the Denodo Platform, including the Solution Manager.
Step 5. Import the settings and metadata into the new version.
Step 6. Test the upgraded version.
Running Both Versions in the Same Computer¶
You can install the Denodo Platform 8.0 in the same computer as the current Denodo installation but they have to be installed on a different directory. For example, you can have
/opt/denodo/denodo-platform-8.0. In this scenario, choose one of these options:
Only run one version of the Denodo Platform at the same time. E.g., you can start either Virtual DataPort version 8.0 or a previous version, but not both at the same time because, with the default configuration, both versions listen to connections on the same ports.
Or configure the new installation or the old one to use different ports to listen to connections. If they use different ports, they can run simultaneously on the same host.
If both versions run simultaneously, you need to be mindful of the requirements of CPU, memory and disk of both versions.
In addition, the new version will not use the default ports, which for external users can be an issue due to they expect Denodo to listen on the port 9999 for JDBC connections, 19443 for HTTPS, etc.
Upgrading from Denodo Platform 5.5 or Earlier¶
Upgrading to the Denodo Platform 8.0 directly from the Denodo Platform 5.5 or earlier is unsupported.
Upgrading from Denodo Platform 5.5¶
To upgrade from Denodo Platform 5.5, you have to transfer the settings and metadata to the Denodo Platform 6.0, and from the version 6.0 to 8.0. That is:
Install the Denodo Platform 6.0 and its latest update.
Follow the process described in the Migration Guide of Denodo Platform 6.0. You will transfer the settings and metadata from version 5.5 to 6.0.
Install the Denodo Platform 8.0 and its latest update.
Follow the process described in this guide.