Chapter 10. Workflow Manager Files
Several files are created during the process of designing a workflow. Other files must be created and available in a specified path in order to run a workflow job.
The following files are associated with workflow jobs:
workflow.xmlThis file is the definition of the workflow application. It is created when you input and save the workflow parameters. The file is saved to whatever location you specify in HDFS. The default file name is workflow.xml, but you can provide an alternative name when you initially save the file.
workflow.wfdraftThis is a draft file created when you save a non-validated workflow. The file is saved to the same location in HDFS as the associated
workflow.xmlfile. The default file name isworkflow.wfdraft, but you can provide an alternative name when you initially save the file./appdir/config-default.xmlThis file is in HDFS. It is optional and contains properties shared by all workflows.
/appdir/lib/files.jarIn HDFS
Each workflow can also have a
job.propertiesfile (not put into HDFS) for job-specific properties.
The following files are associated with coordinator jobs:
coordinator.xmlThis file is the definition of the coordinator application. It is created when you input and save the coordinator parameters. The file is saved to whatever location you specify in HDFS. The default file name is
coordinator.xml, but you can provide an alternative name when you initially save the file.coordinator.wfdraftThis is a draft file created when you save a non-validated coordinator. The file is saved to the same location in HDFS as the associated
coordinator.xmlfile. The default file name iscoordinator.wfdraft, but you can provide an alternative name when you initially save the file.coordinator.propertiesFor defining the job’s properties.
The following files are associated with bundle jobs:
bundle.xmlThis file is the definition of the bundle application. It is created when you input and save the bundle parameters. The file is saved to whatever location you specify in HDFS. The default file name is
bundle.xml, but you can provide an alternative name when you initially save the file.bundle.wfdraftThis is a draft file created when you save a non-validated bundle. The file is saved to the same location in HDFS as the associated
bundle.xmlfile. The default file name isbundle.wfdraft, but you can provide an alternative name when you initially save the file.
The following log files can assist with troubleshooting issues:
The
wfmanager-view.logfound under theambari-serverlog directory.Jobs successfully submitted to WFM so they have a job ID will have logs displayed in the WFM details tabs. The
wfmanager-view.logprovides additional information.Oozie logs, which are located at
/var/log/oozieby default.The location of the log file can be changed. If an exception occurs before successfully submitting a workflow, coordinator, or bundle job, a good place to debug is the Oozie logs.

