Pre-Upgrade Steps for Tez

Complete the following steps before you upgrade Tez with or without the Installer.

About this task

If you made any configuration changes that you want to carry over to the next version, you need to back up the configuration properties files:

Procedure

  1. Locate the files in the /opt/mapr/tez/tez-<version>/conf/ and /opt/mapr/tez/tez-<version>/tomcat/apache-tomcat-<version>/webapps/tez-ui/config/ directories.
  2. Copy the files to a location outside the installation directory.
  3. Delete the old /apps/tez directory on the file system layer.
    hadoop fs -rm -r /apps/tez
    After upgrading, you can reapply changes to the updated Tez installation using the backup.

Preserving the Tez Configuration

Starting from EEP 6.0.0, Tez assists you in preserving the user configuration.

Procedure

  • For a minor version update (for example, Tez-0.8-1803 to Tez-0.8-1808), the user configuration from a previous version is copied to a folder with an old version timestamp and also copied to a new version conf folder.
  • For a major version update (for example, Tez-0.8-1803 to Tez-0.9-1808), the user configuration from a previous version is only copied to a folder with an old version timestamp.
    • For upgrades from EEP 3.x to EEP 6.0.0, no additional steps are needed to preserve the user configuration.
    • For upgrades from EEP 4.0.0/4.1.0 to EEP 6.0.0, preserving the user configuration works only for configuration files (such as tez-site.xml and configs.js), but the Tomcat service is still present from the previous Tez version. As a precondition for upgrade from EEP 4.0.0/4.1.0, manually stop the Tomcat service and remove the tez-0.8/ directory.
    • For upgrades from EEP 4.1.1/5.0.0 to EEP 6.0.0, no additional steps are needed to preserve the user configuration.
    • For upgrades from EEP 3.x to EEP 6.0.0, no additional steps are needed to preserve the user configuration.
    • For upgrades from EEP 4.0.0/4.1.0 to EEP 6.0.0, preserving the user configuration works only for configuration files (such as tez-site.xml and configs.js), but the Tomcat service is still present from the previous Tez version. As a precondition for upgrade from EEP 4.0.0/4.1.0, manually stop the Tomcat service and remove the tez-0.8/ directory.
    • For upgrades from EEP 4.1.1/5.0.0 to EEP 6.0.0, you need to preserve the user configuration manually.