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
-
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. - Copy the files to a location outside the installation directory.
-
Delete the old
/apps/tez
directory on the file system layer.
After upgrading, you can reapply changes to the updated Tez installation using the backup.hadoop fs -rm -r /apps/tez
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
toTez-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 versionconf
folder. -
For a major version update (for example,
Tez-0.8-1803
toTez-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
andconfigs.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 thetez-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
andconfigs.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 thetez-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.