Falcon UI Inaccessible--Required Prerequisite to Installing or Upgrading Falcon in HDP 2.5 or later

[#1]

If you upgrade to or install HDP 2.5.0 or later without first installing the Berkeley DB file, you will get the error "Unable to initialize Falcon Client object. Cause : Could not authenticate, Authentication failed".

The information below has also been added to the Data Movement and Integration guide and other Hortonworks documentation.

Prerequisite to Installing or Upgrading Falcon

Starting with the HDP 2.5.0 release, customers must provide the free 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.

Following are both Ambari and manual instructions for downloading and installing the JAR.

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

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

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

[#2]

From the documentation: "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."

Can you please elaborate what it means? Does customer need to purchase Berkeley DB license from Oracle? If so, which edition and option of Berkeley DB is needed?

[#3]

The JAR is free. If you run the command in step 1 in this article, it'll download the necessary file for you. Or you can go to http://search.maven.org/remotecontent?filepath=com/sleepycat/je/5.0.73/je-5.0.73.jar and download it from there.