The Oozie Editor/Dashboard application allows you to define Oozie workflow and coordinator applications, run workflow and coordinator jobs, and view the status of jobs.
A workflow application is a collection of actions arranged in a directed acyclic graph (DAG). It includes control flow nodes (start, end, fork, join, and kill) and action nodes (MapReduce, Pig, streaming, or Java actions). The current release does not support the decision control flow node and the fs and Oozie sub-workflow action nodes.
A coordinator application allows you to define and execute recurrent and interdependent workflow jobs. The coordinator application defines the conditions under which the execution of workflows can occur.
Oozie Editor/Dashboard is one of the applications that is installed as part of Hue. For more information about installing Hue, see Hue Installation. For information about Oozie, see http://archive.cloudera.com/cdh4/cdh/4/oozie/.
| Note: In order to run streaming or Pig jobs as part of a workflow, Oozie must be configured to use the Oozie ShareLib. If this is not the case, Pig and streaming actions will not run. See Hue Installation for more information. |
To start Oozie Editor/Dashboard, click the Oozie Editor/Dashboard icon (
) in the navigation bar at the top of the Hue browser page. Oozie Editor/Dashboard opens with the following screens:
The Dashboard, Workflows, Coordinators, and History screens contain lists of workflows, coordinators, and jobs. When you type in the Filter field on these screens, the lists are dynamically filtered to display only those rows containing text that matches the specified substring.
In the Dashboard workflows and coordinators can only be viewed, submitted, and modified by its owner or a superuser.
Editor permissions for performing actions on workflows and coordinators are summarized in the following table:
| Action | Superuser or Owner |
All |
|---|---|---|
| View | Y | Only if "Is shared" is set |
| Submit | Y | Only if "Is shared" is set |
| Modify | Y | N |
Oozie Dashboard shows a summary of the running and completed workflow and coordinator jobs.
You can view jobs for a period up to the last 30 days.
You can filter the list by date (1, 7, 15, or 30 days) or status (Succeeded, Running, or Killed). The date and status buttons are toggles.
Click the Workflows tab to view the running and completed workflows for the filters you have specified.
Click a workflow row in the Running or Completed table to view detailed information about that workflow.
For the selected workflow, the following tabs and information is available.
Click the Coordinators tab to view the running and completed coordinator jobs for the filters you have specified.
For the selected coordinator, the following tabs and information is available.
The Workflow Editor is where you create or edit Oozie workflows and submit them for execution. The Workflow Editor comes with several preinstalled sample workflows.
In Workflow Editor, you can create workflows that include MapReduce, Pig, streaming, and Java actions. You can create these actions in the Workflow Editor, or you can import job designs from Job Designer to be used as actions in your workflow.
Click the Workflows tab to open the Workflow editor.
The main page of the workflow editor shows the current set of workflow designs.
Each row shows a workflow design: its name, description, timestamp of its last modification. It also shows:
To open a workflow, click the workflow. Proceed with Editing a Workflow.
To create a workflow:
In the workflow editor you can add and delete actions, clone actions, create and remove fork and join control nodes, and move actions as follows:
button.
buttons.
buttons in the same direction twice.To submit a workflow for execution, click the radio button next to the workflow and click the Submit button in the center of the Action Chooser.
To schedule a workflow for recurring execution, click the radio button next to the workflow and click the Schedule button in the center of the Action Chooser. A coordinator is created and opened in the coordinator editor.
The Coordinator Editor is where you create or edit Oozie coordinator applications and submit them for execution. The Workflow Editor contains one preinstalled sample coordinator.
To open a coordinator, click the coordinator. Proceed with Editing a Coordinator.
To create a coordinator:
| Note: Most workflows require either an input dataset, an output dataset, or both. |
In the coordinator editor you specify coordinator properties and the datasets on which the workflow scheduled by the coordinator will operate as follows:
${YEAR},${MONTH},${DAY},${HOUR},${MINUTE}
to construct URIs and URI paths containing dates and timestamps. For example:
hdfs://foo:9000/usr/app/stats/${YEAR}/${MONTH}/data
To submit a coordinator for execution, click the radio button next to the coordinator and click the Submit button.
The Submissions History is where you view the history of workflow and coordinator jobs. Clicking a link in the Name column opens the workflow or coordinator in an editor. Clicking a link in the Submission Id column opens the job in the Dashboard.