If you installed Oozie with the MapR Installer, use the latest version of the MapR Installer to perform the upgrade.
This page contains the following topics describing how to upgrade Oozie in the MapR distribution for Apache Hadoop:
Before you upgrade, make sure that the version of the MapR core software on your cluster supports the version of Oozie that you want to upgrade to. See the Ecosystem Support Matrix.
1. Update Repositories
deb repositories always contain the Oozie version recommended for the release of the MapR core associated with that repository. You can connect to an internet repository or prepare a local repository with any version of Oozie you need. You can also manually download packages.
If you plan to install from a repository, complete the following steps each node where Oozie is installed:
- Verify that the repository is configured correctly. See Preparing Packages and Repositories for information about setting up your ecosystem repository.
Update the repository cacheOn RedHat and CentOS...
yum clean allOn Ubuntu...
Before upgrading the Oozie software, you may need to complete the following steps:
- Stop any jobs or coordinators that are in a RUNNING or SUSPENDED state.
Stop the Oozie service:
- Back up Oozie configuration files and save them in a temporary directory. If you have changed configuration properties on your current installation of Oozie, you probably want to apply those changes to the updated version after you upgrade the software. Configuration properties are located in
- For upgrades to Oozie 4.1-1601 or below:
oozie.service.ActionService.executor.ext.classesin the oozie-site.xml (/opt/mapr/oozie/oozie-<version>/conf/oozie-site.xml).
Remove the old shared libraries and examples directories:
3. Upgrading the Software
Use one of the following methods to upgrade the Oozie component:
To upgrade with a package manager
After configuring repositories so that the version you want to install is available, you can use a package manager to install from the repository.
To keep a prior version and install a newer version (manual installation)
Oozie installs into separate directories named after the version, such as
/opt/mapr/oozie/oozie-<version>/, so the files for multiple versions can co-exist.
To keep the prior version when installing a new version, you must manually install the package file for the new version.
Perform the following steps:
- Download the RPM package files for
- Install the package with
dpkgcannot manage multiple versions of a package with the same name.
4. After Upgrading the Software
After you have upgrade the Oozie software packages, you may need to complete the following additional steps:
- Add customized properties from the configuration files that you saved before the upgrade to the files in the new Oozie conf directory:
For upgrades from Oozie 4.0.x to Oozie 4.2.0, run the following command to upgrade the database schema:
When you upgrade the core MapR version on a cluster that already has Oozie installed, a packaging error results in Oozie building its WAR file with an incorrect version of
maprfs.jar. To work around this issue, run the
oozie-setup.shscript to rebuild the WAR file with the correct JARs:
- If your Oozie installation is configured to use a MySQL or Oracle database:
Copy the JDBC driver jar file to the following directory:
Run the following command to upgrade the database schema:
This step is not required if you ran this command in step 2.
oozie-setup.shscript to add the driver jar file to the Oozie WAR file:
For Oozie 4.1-1506 or lower and Oozie 4.2.0 -1510 or lower:
As of Oozie 4.1.0-1601 and Oozie 4.2.0-1601:
Verify the status of the Oozie service and start it manually if necessary:
- Start any Oozie coordinators that you stopped before the upgrade.
As of Oozie 4.1.0-1601 and Oozie 4.2.0-1601, if the
oozie.service.WorkflowAppService.system.libpathproperty in oozie-site.xml does not use the default value (/oozie/share/), you must run perform the following steps to update the shared libraries:
Based on the cluster MapReduce mode, run one of the following commands to copy the new Oozie shared libraries to MapR-FS:
Cluster MapReduce Mode Command YARN Classic
Run the following command to update the Oozie classpath with the new shared libraries: