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

Submitting and Executing a Workflow

When you submit a workflow, a validation is performed on the workflow. You cannot submit an invalid workflow.

Prerequisites

A workflow must be valid before you can submit it.

About This Task

When you submit a workflow, the workflow is first saved. You can save workflows to a new directory or overwrite an existing workflow.

[Tip]Tip

When you save a workflow, the name you assign is given only to the workflow application file. It does not automatically match the name displayed for the workflow job in the dashboard. WFM assigns to the workflow job the name you enter in the Name filed in the design workspace. If you want the job name and the application file name to match, you must assign the same name in the Name field and to the application file.

Once it is saved, the workflow is available to execute as a job; the job does not automatically execute when the workflow is submitted. You must execute a job separately.

See the following content to learn how to submit and execute workflows.

Submit and Execute an Existing Workflow
Submit and Execute a New Workflow
Execute a Submitted Workflow

Submit and Execute an Existing Workflow

You can submit and execute a workflow at the same time.

Steps

  1. Create a workflow or import a workflow into the workspace.

  2. Click the Submit icon on the workspace Action Menu.

    If the workflow is valid, the Submit Workflow dialog box displays.

    If the workflow is invalid, error messages display. You must resolve the identified issues before you can submit the workflow.

  3. Choose one of the following:

    • To submit and execute a new workflow:

      1. Click Browse and navigate to the directory in which you want to save the workflow.

      2. Click on the directory name, and ensure that the name displays in the Selected Path field.

      3. Click Select.

    • To submit and execute an existing workflow:

      1. Check Overwrite to save the workflow to an existing directory.

        If you don not check Overwrite, you get an error stating that the workflow path already exists.

  4. Check Run on Submit to execute the workflow job automatically when submission is complete.

  5. Click Submit.

    A message displays stating that the workflow is saved and providing the job ID.

  6. Make note of the job ID and then click Close.

  7. Verify that the job is running:

    1. Click Dashboard in the Workflow Manager Action Bar.

    2. In the Dashboard, locate the job and verify that the Status is Running.

Submit and Execute a New Workflow

You can submit and execute a workflow at the same time. The workflow must be valid before you can submit it. When you submit the workflow, the workflow file is saved in a location you select. You can save workflow files to any location for which you have access permissions.

Prerequisites

Ensure you have access permissions to the location in which you want to save the workflow.

Steps

  1. Create a workflow or import a workflow into the workspace.

  2. Click the Submit icon on the workspace Action Menu.

    If the workflow is valid, the Submit Workflow dialog box displays.

    If the workflow is invalid, error messages display. You must resolve the identified errors before you can submit the workflow.

  3. Click Browse and navigate to the directory in which you want to save the workflow.

  4. Click on the directory name and ensure that the name displays in the Selected Path field.

  5. Click Select and Close.

  6. Optional: Check Overwrite to replace an existing file of the same name in the same path.

    [Tip]Tip

    If you saved the workflow prior to submitting it, then you must select Overwrite or you get an error.

  7. Optional: Check Run on Submit if you want to execute the workflow job automatically when submission is complete.

  8. Click Submit.

    A message displays stating that the workflow is saved and providing the job ID.

    [Tip]Tip

    If a message displays stating that the job cannot be saved or executed, go to the Ambari UI to see if any services need to be restarted.

  9. Make note of the job ID and then click Close.

  10. Verify that the job is running:

    1. Click Dashboard in the Workflow Manager Action Bar.

    2. In the Dashboard, locate the job and verify that the Status is Running.

      You can locate the job by name or by job ID.

Execute a Submitted Workflow

If you submit a workflow without executing it, you can execute the workflow job any time from the Dashboard.

Steps

  1. Click Dashboard in the Workflow Manager Action Bar.

  2. In the Dashboard, locate the job you want to execute, click the (Action) icon, and then click the (Start) icon.

    The Status changes from Prep to Running.