Ambari Upgrade Guide
Also available as:
PDF

Set Current HDP Version

  1. Restart all services from Ambari. One by one, browse to each Service in Ambari Web, and in the Service Actions menu select Restart All. On the client-only services, such as Tez, Pig, or Sqoop, select Refresh Configs.

  2. After all the services are confirmed to be started and healthy, go to the command line on the Ambari Server and run the following to finalize the upgrade, which will move the current version to the new version.

    ambari-server set-current --cluster-name=$CLUSTERNAME --version-display-name=$VERSION_NAME
    Ambari Admin login: admin      
    Ambari Admin password: *****

    where $CLUSTERNAME is the name of your cluster and $VERSION_NAME is the version name for the HDP version you just upgraded to (for example: HDP-2.3.0.0).

  3. Set the stack version in Ambari.

    ambari-server stop
    ambari-server upgradestack HDP-2.3     
    ambari-server start
    [Important]Important

    You must copy the Oracle JDBC driver JAR into the Ambari Server library directory.

    cp /var/lib/ambari-server/resources/ojdbc6.jar /usr/lib/ambari-server

    Otherwise, you will see an error in ambari-server.log when running upgradestack:

     29 Sep 2015 10:51:29,225 ERROR main DBAccessorImpl:102-
    Error while creating database accessor
    java.lang.ClassNotFoundException:oracle.jdbc.driver.OracleDriver

    After copying the Oracle JDBC drive JAR in place, re-run the upgradestack command.

  4. If your cluster includes Kafka, browse to Services > Kafka and from the Service Actions menu, select Restart All. After Kafka has started, select Run Service Check. Confirm the check passes.

  5. If your cluster includes Ranger: Use the "Step 2" upgrade catalog you downloaded in the Update Service Configurations section and run the helper:

    python upgradeHelper.py --hostname $HOSTNAME --user $USERNAME --password $PASSWORD --clustername $CLUSTERNAME --fromStack $FROMSTACK --toStack $TOSTACK --upgradeCatalog UpgradeCatalog_2.2_to_2.3_step2.json update-configs [config-type]