Workflow Management
Also available as:
loading table of contents...

Validate and Save a Workflow

Workflow validation checks that the XML is correctly coded for the workflow. It does not check if the workflow will succeed when run.

During the validation process, the workflow is also saved.

About This Task

When you save a workflow, you assign a name to the workflow application file. That name is not the same name that is automatically assigned to the workflow job that you view in the dashboard. If you want the file name and the job name to match, you must change the default name in the Name field on the design workspace.

Each workflow file must have a unique name within a single directory. If you want to save a workflow into a directory that already contains a workflow of the same name, you must either rename the workflow, add the file to a subdirectory, or overwrite the file during the save procedure.

You can save valid workflows or invalid workflows as drafts. The default name for a saved workflow is always "workflow.xml.draft" for a draft workflow that is not validated or "workflow.xml" for a valid workflow. You can change the workflow file name during the save operation.


  1. Click the Validate icon on the workspace Action Menu.

  2. Click Browse to select an HDFS directory in which to save the workflow file.


    If the File Browser window opens but does not display a directory list, you might have lost network connectivity or the required data node might be unresponsive.

  3. Navigate to the directory you want, click on the directory name, and expand the directory.

  4. Optional: If a workflow file already exists in the directory:

    1. To overwrite the existing file, click Select, check Overwrite in the Save Workflow dialog box, and then click Validate.

    2. To keep the existing file and the new workflow file, in the Selected Path field, append a new name for the file or append a new subdirectory to the path, click Select, and then click Validate.


      The workflow file must use the .xml extension.

      Figure 4.7. Example of saving a workflow to a new directory

      After validation, the new directory is created and contains the renamed workflow.

  5. Select the Execution Settings you want to use.

  6. Enter any Custom Job Properties you want to use.

  7. Click Validate.

More Information

Apache Workflow Job Properties