Upgrade Mahout

About this task

Before you upgrade, verify that the MapR cluster version supports the version of Mahout that you want to upgrade to. See the Interoperability Matrix.

NOTE: If you installed Mahout with the MapR Installer, use the latest version of the MapR Installer to perform the upgrade.

Procedure

Update repositories or download packages.

MapR's rpm and deb repositories always contain the Mahout version recommended for the latest release of the MapR core. You can connect to an internet repository or prepare a local repository with any version of Mahout that you need. For more details on setting up repositories, see Installing MapR Software. You can also manually download packages to install. Packages are available in the following locations:

Repository
MapR 5.x Ecosystem Repository (for repository install)	`http://package.mapr.com/releases/ecosystem-5.x`
All Ecosystem Packages (for manual install)	`http://package.mapr.com/releases/ecosystem-all/`

If you plan to install from a repository, update the repository cache on each node where Mahout is installed.
RedHat and CentOS
```
yum clean all
```
On Ubuntu
```
apt-get update
```
To preserve custom configurations, create a backup of the configuration files on all nodes where Mahout is installed. Configuration files are located in /opt/mapr/mahout/mahout-<version>/conf/.
Use one of the following methods to upgrade the Mahout package.
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 the latest version.
- On RedHat and CentOS:
  yum upgrade mapr-mahout
- On Ubuntu:
  apt-get install mapr-mahout
To keep a prior version and install a newer version:
Mahout installs into separate directories named after the version, such as /opt/mapr/mahout/mahout-<version>/, so the files for multiple Mahout 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.
- On RedHat / CentOS:
  
  Download the RPM package file from http://package.mapr.com/releases/ecosystem-all/
  
  Install the package with rpm.
  rpm -i --force mapr-mahout-<version>.rpm
- On Ubuntu:
  This process is not supported on Ubuntu, because apt-get and dpkg cannot manage multiple versions of a package with the same name.
Migrate custom configuration settings from the previous version of Mahout into the new configuration files in the conf directory (/opt/mapr/mahout/mahout-<version>/conf/).