Data Movement and Integration
Also available as:
PDF
loading table of contents...

Chapter 4. Prerequisite to Installing or Upgrading Falcon

Starting with the HDP 2.5.0 release, customers must provide the Berkeley DB JAR file, under the Oracle license, as part of a Falcon installation or upgrade. This applies to Ambari express or rolling upgrades, to manual upgrades, and to all installations of HDP 2.5.0 or later, if you are using the Falcon service.

The following instructions describe how to download and install the Berkeley DB JAR file for both an Ambari installation and a manual installation from the command line.

Ambari Install or Upgrade of Falcon

If you are using the Falcon service, the following steps must be performed on all Ambari server hosts on the cluster, prior to installing or upgrading to HDP 2.5.0 or later.

To access the full installation or upgrade instructions for the Ambari version to which you are upgrading, go to the Hortonworks documentation website.

You must have administrator privileges on all Ambari servers to perform this task.

Steps

  1. Download the required Berkeley DB implementation file.

    wget -O je-5.0.73.jar http://search.maven.org/remotecontent?filepath=com/sleepycat/je/5.0.73/je-5.0.73.jar

    See the GNU documentation for details about the wget command options.

    [Important]Important

    If you are using SLES 12, you must include the --no-check-certificate option with the wget command, for example: wget --no-check-certificate -O.

    [Tip]Tip

    If you get a certificate verification error message or a message stating “common name doesn’t match requested host name”, you might need to include the --no-check-certificate option with the wget command.

  2. Log in to the Ambari server with administrator privileges.

    su – root

  3. Copy the file to the Ambari server share folder.

    cp je-5.0.73.jar /usr/share/

  4. Set permissions on the file to owner=read/write, group=read, other=read.

    chmod 644 /usr/share/je-5.0.73.jar

  5. Configure the Ambari server to use the Berkeley DB driver.

    ambari-server setup --jdbc-db=bdb --jdbc-driver=/usr/share/je-5.0.73.jar

  6. Restart the Ambari server.

    ambari-server restart

  7. Restart the Falcon service from the Ambari UI.

    You need to have administrator privileges in Ambari to restart a service.

    1. In the Ambari web UI, click the Services tab and select the Falcon service in the left Services pane.

    2. From the Falcon Summary page, click Service Actions > Restart All.

    3. Click Confirm Restart All.

When the service is available, the Falcon status displays as Started on the Summary page.

Manual Install or Upgrade of Falcon

If you are using the Falcon service, the following steps must be performed on all Falcon server hosts on the cluster, prior to installing or upgrading to HDP 2.5.0 or later.

To access the full installation or upgrade instructions for the HDP version to which you are upgrading, go to the Hortonworks documentation website.

You must have administrator privileges on the Falcon server to perform this task.

Steps

  1. Log in to the Falcon server as user falcon.

    su - falcon

  2. Download the required Berkeley DB implementation file.

    wget –O je-5.0.73.jar http://search.maven.org/remotecontent?filepath=com/sleepycat/je/5.0.73/je-5.0.73.jar

    See the GNU documentation for details about the wgetcommand options.

    [Important]Important

    If you are using SLES 12, you must include the --no-check-certificate option with the wget command, for example: wget --no-check-certificate -O.

    [Tip]Tip

    If you get a certificate verification error message or a message stating “common name doesn’t match requested host name”, you might need to include the --no-check-certificate option with the wget command.

  3. Copy the file to the Falcon library folder.

    cp je-5.0.73.jar /usr/hdp/<version>/falcon/webapp/falcon/WEB-INF/lib

  4. Set permissions on the file to owner=read/write, group=read, other=read.

    chmod 644 /usr/hdp/<version>/falcon/webapp/falcon/WEB-INF/lib/je-5.0.73.jar