This is the documentation for CDH 5.1.x. Documentation for other versions is available at Cloudera Documentation.

Upgrading Whirr

  Note:

To see which version of Whirr is shipping in CDH 5, check the Version and Packaging Information. For important information on new and changed components, see the CDH 5 Release Notes.

Upgrading Whirr from CDH 4 to CDH 5

To upgrade Whirr from CDH 4, uninstall the CDH 4 version, modify the properties file, and install the CDH 5 version. Proceed as follows.

  Note:

If you have already performed the steps to uninstall CDH 4 and all components, as described under Upgrading from CDH 4 to CDH 5, you can skip Step 1 below and proceed with installing the new CDH 5 version of Whirr.

Step 1: Remove Whirr

  1. Stop the Whirr proxy. Kill the hadoop-proxy.sh process by pressing Control-C.
  2. Destroy the Cluster. Whirr clusters are normally short-lived. If you have a running cluster, destroy it: see Destroying a cluster.
  3. Uninstall the CDH 4 version of Whirr:

    On Red Hat-compatible systems: 

    $ sudo yum remove whirr

    On SLES systems: 

    $ sudo zypper remove whirr

    On Ubuntu and Debian systems: 

    sudo apt-get remove whirr
  4. Update the Properties File.

    Edit the configuration file, called hadoop.properties in these instructions, and save it.

    • For Hadoop, configure the following properties as shown:
      • For MRv1: 
        whirr.env.repo=cdh5
whirr.hadoop.install-function=install_cdh_hadoop
whirr.hadoop.configure-function=configure_cdh_hadoop
      • For YARN: see Defining a Cluster.
    • For HBase, configure the following properties as shown: 
      whirr.env.repo=cdh5
whirr.hadoop.install-function=install_cdh_hadoop
whirr.hadoop.configure-function=configure_cdh_hadoop
whirr.hbase.install-function=install_cdh_hbase
whirr.hbase.configure-function=configure_cdh_hbase
whirr.zookeeper.install-function=install_cdh_zookeeper
whirr.zookeeper.configure-function=configure_cdh_zookeeper
    • For ZooKeeper, configure the following properties as shown: 
      whirr.env.repo=cdh5
whirr.zookeeper.install-function=install_cdh_zookeeper
whirr.zookeeper.configure-function=configure_cdh_zookeeper

    See Defining a Whirr Cluster for a sample file.

      Important:

    If you are upgrading from Whirr version 0.3.0, and are using an explicit image (AMI), make sure it comes from one of the supplied Whirr recipe files.

Step 2: Install the new Version

See the next section, Installing Whirr.

The upgrade is now complete. For more information, see Defining a Whirr Cluster, Launching a Cluster, and Viewing the Whirr Documentation.

Upgrading Whirr from an Earlier CDH 5 Release to the Latest CDH 5 Release

Step 1: Stop the Whirr proxy.

Kill the hadoop-proxy.sh process by pressing Control-C.

Step 2: Destroy the Cluster.

Whirr clusters are normally short-lived. If you have a running cluster, destroy it: see Destroying a cluster.

Step 3: Install the New Version of Whirr

See Installing Whirr.

The upgrade is now complete. For more information, see Launching a Cluster ,and Viewing the Whirr Documentation.

Page generated September 3, 2015.