After you upgrade your Pentaho products to version 9.3, you may need to perform a few of the following optional tasks depending on your Pentaho configuration.
If you previously customized any items from the default Pentaho setup, you may have to merge your customizations into Pentaho 9.3 versions of those items.
If you link to specific documentation articles in your Pentaho configuration, you need to update the default documentation version in those links.
If you are interested in a centralized data mart for your PDI job or PDI transformation logs, you can install DI Ops Mart.
If you use Hadoop clusters with your Pentaho products, you must re-install the drivers.
If you use plugins with your Pentaho products, you must re-apply the plugins.
If you want to encrypt passwords currently stored as plain text in configuration files, you must set up your upgraded 9.3 Pentaho Server for password encryption.
The Pentaho Upgrade Installer generates a post-install report containing a list of items you may have customized from the default Pentaho setup. This postInstallConfigReport.txt file is generated from the CSV file you may have updated during the upgrade process. See Specify customized items to to address after upgrading for instructions.
The CSV file is used to generate post-upgrade versions of the listed items separately from the existing versions of these items.
Address customizations with post-upgrade versions
Perform the following steps to address your customizations with Pentaho 9.3 versions of items listed in the post-install report:
Navigate to the <root installation directory>/Pentaho__Installation directory.
Open the postInstallConfigReport.txt file in a text editor.This report contains the following sections:
These config files need merged
These config files were not updated by the upgrade, but were changed pre-upgrade
These config files were not found in the upgrade
These config files were identical to the upgraded files
For each item listed in the
These config files need mergedsection of the post-install report, open both the existing version and the version with the .merge.post_upgrade extension to compare their differences.
Verify the differences between the item's two versions and perform one of the following actions:
If the upgrade process changes are minor, such as a single date change, then retain your existing version by deleting the post-upgrade version.
If your existing content and the Pentaho 9.3 changes both apply for your setup, then merge the differences of the two versions into one item with the same name as the existing version.
If your existing content can be overwritten by the upgrade process changes, then replace the existing version with the post-upgrade version.
Update the default documentation version link
Navigate to the pentaho/server/pentaho-server/pentaho-solutions/system directory and open the pentaho.xml file with any text editor.
Modify the following
<documentation-url>line and replace the previous documentation value with the current documentation value:
Save and close the file.
Install Ops Mart
If you installed an Ops Mart as part of the previous Pentaho 7.x or 8.x upgrade, you do not have to reinstall it. If you are interested in installing and using DI Ops Mart, see Install DI Ops Mart.
Install drivers for your Hadoop clusters
If you use Hadoop clusters with your Pentaho products, after upgrading to version 9.3, you must install the drivers for the Hadoop clusters you want to access. To conserve memory and storage resources, these drivers are not automatically installed for your upgraded version 9.3 Pentaho products. You can install the specific drivers manually or through the PDI client. For instructions, see Set up the Pentaho Server to connect to a Hadoop cluster.