Using the Oozie Client

Scenario

This section describes how to use the Oozie client in an O&M scenario or service scenario.

Prerequisites

• The client has been installed in a directory, for example, /opt/client. The client directory in the following operations is only an example. Change it based on site requirements.

• Service component users have been created by the MRS cluster administrator. In security mode, machine-machine users need to download the keytab file. A human-machine user must change the password upon the first login.

Using the Oozie Client

1. Log in to the node where the client is installed as the client installation user.
2. Run the following command to switch to the client installation directory (change it to the actual installation directory):

   cd /opt/client

3. Run the following command to configure environment variables:

   source bigdata_env

4. Check the cluster authentication mode.
   • If the cluster is in security mode, run the following command to authenticate the user: exampleUser indicates the name of the user who submits tasks.

     kinit exampleUser

   • If the cluster is in normal mode, go to 5.

5. Perform the following operations to configure Hue:
   1. Configure the Spark environment (skip this step if no Spark task is involved):

      hdfs dfs -put /opt/client/Spark/spark/jars/*.jar /user/oozie/share/lib/spark/

      When the JAR package in the HDFS directory /user/oozie/share changes, you need to restart the Oozie service.

   2. Upload the Oozie configuration file and JAR package to HDFS.

      hdfs dfs -mkdir /user/exampleUser

      hdfs dfs -put -f /opt/client/Oozie/oozie-client-*/examples /user/exampleUser/

      

      • exampleUser indicates the name of the user who submits tasks.
      • After creating the /user/exampleUser/ directory and uploading files in /opt/client/Oozie/oozie-client-*/examples to the directory, ensure that the directory, all files in the directory, and subdirectories have permission 755. Otherwise, exceptions may occur when the Oozie client is used to submit tasks.
      • If the user who submits the task and other files except job.properties are not changed, client installation directory Oozie/oozie-client-*/examples can be repeatedly used after being uploaded to HDFS.
      • Resolve the JAR file conflict between Spark and Yarn about Jetty.

        hdfs dfs -rm -f /user/oozie/share/lib/spark/jetty-all-9.2.22.v20170606.jar

      • In normal mode, if Permission denied is displayed during the upload, run the following commands:

        su - omm

        source /opt/client/bigdata_env

        hdfs dfs -chmod -R 777 /user/oozie

        exit