index.html 48 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE html
  3. PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  4. <html lang="en-us" xml:lang="en-us">
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  7. <link rel="stylesheet" type="text/css" href="commonltr.css"/>
  8. <title>Oozie Editor and Dashboard</title>
  9. </head>
  10. <body id="topic_9"><a name="topic_9"><!-- --></a>
  11. <h1 class="title topictitle1">Oozie Editor and Dashboard </h1>
  12. <div class="body conbody">
  13. <p class="p">The Oozie Editor/Dashboard application allows you to define Oozie
  14. workflow, coordinator, and bundle applications, run workflow, coordinator, and bundle jobs,
  15. and view the status of jobs. For information about Oozie, see <a class="xref" href="http://archive.cloudera.com/cdh4/cdh/4/oozie/" target="_blank">Oozie Documentation</a>. </p>
  16. <div class="p">A <dfn class="term">workflow application</dfn> is a collection of actions arranged in
  17. a directed acyclic graph (DAG). It includes two types of nodes:<a name="topic_9__ul_fyv_mnr_2k"><!-- --></a><ul class="ul" id="topic_9__ul_fyv_mnr_2k">
  18. <li class="li">Control flow - start, end, fork, join, decision, and kill</li>
  19. <li class="li">Action - <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_lvq_ch3_zj">MapReduce</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_zrd_gh3_zj">Streaming</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_abl_hh3_zj">Java</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_tvm_3h3_zj">Pig</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_lxq_3h3_zj">Hive</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_xb5_3h3_zj">Sqoop</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_xvw_3h3_zj">Shell</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_tnz_3h3_zj">Ssh</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_qsc_jh3_zj">DistCp</a>, <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_hx4_lh3_zj">Fs</a>, and <a class="xref" href="jobsub#concept_gt5_bh3_zj__section_qjt_lh3_zj">Email</a>) <p class="p">In order to run DistCp, Streaming, Pig, Sqoop, and Hive
  20. jobs, Oozie must be configured to use the Oozie ShareLib. See Oozie Installation in <a class="xref" href="http://www.cloudera.com/content/cloudera-content/cloudera-docs/CDH4/latest/CDH4-Installation-Guide/CDH4-Installation-Guide.html" target="_blank">http://www.cloudera.com/content/cloudera-content/cloudera-docs/CDH4/latest/CDH4-Installation-Guide/CDH4-Installation-Guide.html</a>. </p>
  21. </li>
  22. </ul>
  23. </div>
  24. <p class="p">A <dfn class="term">coordinator application</dfn> allows you to define and execute
  25. recurrent and interdependent workflow jobs. The coordinator application defines the conditions
  26. under which the execution of workflows can occur. </p>
  27. <p class="p">A <dfn class="term">bundle application</dfn> allows you to batch a set of
  28. coordinator applications. </p>
  29. </div>
  30. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_1"><a name="topic_9_1"><!-- --></a>
  31. <h2 class="title topictitle2">Oozie Editor/Dashboard Installation and
  32. Configuration </h2>
  33. <div class="body conbody">
  34. <p class="p">Oozie Editor/Dashboard is one of the applications installed as part of
  35. Hue. <span class="ph">For information about installing and configuring Hue,
  36. see Hue Installation in <a class="xref" href="http://www.cloudera.com/content/cloudera-content/cloudera-docs/CDH4/latest/CDH4-Installation-Guide/CDH4-Installation-Guide.html" target="_blank">http://www.cloudera.com/content/cloudera-content/cloudera-docs/CDH4/latest/CDH4-Installation-Guide/CDH4-Installation-Guide.html</a>.</span></p>
  37. </div>
  38. </div>
  39. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_2"><a name="topic_9_2"><!-- --></a>
  40. <h2 class="title topictitle2">Starting Oozie Editor/Dashboard </h2>
  41. <div class="body conbody">
  42. <p class="p">Click the <strong class="ph b">Oozie Editor/Dashboard</strong> icon
  43. (<img class="image" src="/static/art/help/icon_oozie_24.png"/>) in the navigation bar at the top of the Hue browser page. <strong class="ph b">Oozie Editor/Dashboard</strong> opens with the following screens: </p>
  44. <ul class="ul">
  45. <li class="li"><a class="xref" href="#topic_9_6">Dashboard</a> - shows
  46. the running and completed workflow, coordinator, and bundle jobs and information about
  47. Oozie instrumentation and configuration. The screen is selected and opened to the
  48. Workflows page.</li>
  49. <li class="li"><a class="xref" href="#topic_9_7">Workflow Manager</a> - shows
  50. available workflows and allows you to create and import workflows.</li>
  51. <li class="li"><a class="xref" href="#topic_9_8">Coordinator Manager</a> - shows
  52. available coordinators and allows you to create coordinators.</li>
  53. <li class="li"><a class="xref" href="#concept_crd_ttp_wj">Bundle Manager</a> - shows available bundles and allows you to create bundles.</li>
  54. </ul>
  55. </div>
  56. </div>
  57. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_3"><a name="topic_9_3"><!-- --></a>
  58. <h2 class="title topictitle2">Installing Oozie Editor/Dashboard
  59. Examples </h2>
  60. <div class="body conbody">
  61. <div class="note note"><span class="notetitle"><img src="/static/art/help/note.jpg"/> 
  62. <b>Note</b>:</span> You must be a superuser to perform this task.</div>
  63. <a name="topic_9_3__ol_ugf_hjt_yj"><!-- --></a><ol class="ol" id="topic_9_3__ol_ugf_hjt_yj">
  64. <li class="li">Click <a name="topic_9_3__d104e102"><!-- --></a><img class="image" id="topic_9_3__d104e102" src="/static/art/help/quick_start.png"/>. The Quick Start Wizard opens.</li>
  65. <li class="li">Click <strong class="ph b">Step 2:
  66. Examples</strong>.</li>
  67. <li class="li">Click <strong class="ph b">Oozie Editor/Dashboard</strong>.</li>
  68. </ol>
  69. </div>
  70. </div>
  71. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_4"><a name="topic_9_4"><!-- --></a>
  72. <h2 class="title topictitle2">Filtering Lists in Oozie Editor/Dashboard </h2>
  73. <div class="body conbody">
  74. <p class="p">Many screens contain lists. When you type in the Filter field on
  75. screens, the lists are dynamically filtered to display only those rows containing text that
  76. matches the specified substring. </p>
  77. </div>
  78. </div>
  79. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_5"><a name="topic_9_5"><!-- --></a>
  80. <h2 class="title topictitle2">Permissions in Oozie Editor/Dashboard
  81. </h2>
  82. <div class="body conbody">
  83. <p class="p">In the Dashboard workflows, coordinators, and bundles can only be
  84. viewed, submitted, and modified by their owner or a superuser. </p>
  85. <p class="p">Editor permissions for performing actions on workflows, coordinators,
  86. and bundles are summarized in the following table: </p>
  87. <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" class="table" frame="hsides" border="1" rules="all">
  88. <thead class="thead" align="left">
  89. <tr class="row">
  90. <th class="entry" valign="top" width="33.33333333333333%" id="d15249e233">
  91. <p class="p"> <strong class="ph b">Action</strong>
  92. </p>
  93. </th>
  94. <th class="entry" valign="top" width="33.33333333333333%" id="d15249e242">
  95. <p class="p"> <strong class="ph b">Superuser or Owner</strong>
  96. </p>
  97. </th>
  98. <th class="entry" valign="top" width="33.33333333333333%" id="d15249e251">
  99. <p class="p"> <strong class="ph b">All</strong>
  100. </p>
  101. </th>
  102. </tr>
  103. </thead>
  104. <tbody class="tbody">
  105. <tr class="row">
  106. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e233 ">
  107. <p class="p">View </p>
  108. </td>
  109. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e242 ">
  110. <p class="p">Y </p>
  111. </td>
  112. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e251 ">
  113. <p class="p">Only if "Is shared" is set </p>
  114. </td>
  115. </tr>
  116. <tr class="row">
  117. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e233 ">
  118. <p class="p">Submit </p>
  119. </td>
  120. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e242 ">
  121. <p class="p">Y </p>
  122. </td>
  123. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e251 ">
  124. <p class="p">Only if "Is shared" is set </p>
  125. </td>
  126. </tr>
  127. <tr class="row">
  128. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e233 ">
  129. <p class="p">Modify </p>
  130. </td>
  131. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e242 ">
  132. <p class="p">Y </p>
  133. </td>
  134. <td class="entry" valign="top" width="33.33333333333333%" headers="d15249e251 ">
  135. <p class="p">N </p>
  136. </td>
  137. </tr>
  138. </tbody>
  139. </table>
  140. </div>
  141. </div>
  142. </div>
  143. <div class="topic concept nested1" id="concept_ms2_rzj_2k"><a name="concept_ms2_rzj_2k"><!-- --></a>
  144. <h2 class="title topictitle2">Deleting and Restoring Workflows, Coordinators, and Bundles</h2>
  145. <div class="body conbody">
  146. <p class="p">You can move workflows, coordinators, and bundles to the trash and later restore or
  147. permanently delete them.</p>
  148. <div class="section" id="concept_ms2_rzj_2k__section_bvz_wzj_2k"><a name="concept_ms2_rzj_2k__section_bvz_wzj_2k"><!-- --></a><h3 class="title sectiontitle">Deleting Workflows, Coordinators, and Bundles</h3>
  149. <a name="concept_ms2_rzj_2k__ol_wkz_yzj_2k"><!-- --></a><ol class="ol" id="concept_ms2_rzj_2k__ol_wkz_yzj_2k">
  150. <li class="li">In a Manager screen, check the checkbox next to one or more workflows, coordinators or
  151. bundles.</li>
  152. <li class="li" id="concept_ms2_rzj_2k__li_dty_3gr_2k"><a name="concept_ms2_rzj_2k__li_dty_3gr_2k"><!-- --></a>Choose one of the following:<ul class="ul">
  153. <li class="li"><span class="ph menucascade"><span class="ph uicontrol">Delete</span> &gt; <span class="ph uicontrol">Move to trash</span></span></li>
  154. <li class="li"><span class="ph menucascade"><span class="ph uicontrol">Delete</span> &gt; <span class="ph uicontrol">Delete forever</span></span></li>
  155. </ul>
  156. </li>
  157. </ol>
  158. </div>
  159. <div class="section" id="concept_ms2_rzj_2k__section_ecf_xzj_2k"><a name="concept_ms2_rzj_2k__section_ecf_xzj_2k"><!-- --></a><h3 class="title sectiontitle">Restoring Workflows, Coordinators, and Bundles</h3>
  160. <a name="concept_ms2_rzj_2k__ol_ujf_dbk_2k"><!-- --></a><ol class="ol" id="concept_ms2_rzj_2k__ol_ujf_dbk_2k">
  161. <li class="li" id="concept_ms2_rzj_2k__li_msc_mgr_2k"><a name="concept_ms2_rzj_2k__li_msc_mgr_2k"><!-- --></a>In a Manager screen, click <a name="concept_ms2_rzj_2k__image_e35_2bk_2k"><!-- --></a><img class="image" id="concept_ms2_rzj_2k__image_e35_2bk_2k" src="/static/art/help/trash.png"/>
  162. <strong class="ph b">Trash</strong>.</li>
  163. <li class="li">Check the checkbox next to one or more workflows, coordinators or bundles.</li>
  164. <li class="li" id="concept_ms2_rzj_2k__li_ndg_mgr_2k"><a name="concept_ms2_rzj_2k__li_ndg_mgr_2k"><!-- --></a>Click <span class="ph uicontrol">Restore</span>.</li>
  165. </ol>
  166. </div>
  167. </div>
  168. </div>
  169. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_6"><a name="topic_9_6"><!-- --></a>
  170. <h2 class="title topictitle2">Dashboard </h2>
  171. <div class="body conbody">
  172. <p class="p">The Dashboard shows a summary of the running and completed workflow,
  173. coordinator, and bundle jobs. </p>
  174. <p class="p">
  175. You can view jobs for a period up to the last 30 days.
  176. </p>
  177. <p class="p">
  178. You can filter the list by date (1, 7, 15, or 30 days) or status (Succeeded, Running, or Killed). The date and
  179. status buttons are toggles.
  180. </p>
  181. </div>
  182. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_6_1"><a name="topic_9_6_1"><!-- --></a>
  183. <h3 class="title topictitle3">Workflows</h3>
  184. <div class="body conbody">
  185. <p class="p">Click the <strong class="ph b">Workflows</strong> tab to view the running and completed workflow jobs for the filters you have
  186. specified.
  187. </p>
  188. <p class="p">Click a workflow row in the Running or Completed table to view detailed information about that workflow job.
  189. </p>
  190. <p class="p">In the left pane contains a link to the workflow and the variable values specified.<br/><a name="topic_9_6_1__image_xq2_stz_2k"><!-- --></a><img class="image" id="topic_9_6_1__image_xq2_stz_2k" src="/static/art/help/workflow.jpg"/><br/>
  191. </p>
  192. <p class="p">For the selected job, the following information is available in the right
  193. area. </p>
  194. <ul class="ul">
  195. <li class="li"><strong class="ph b">Graph</strong> tab shows the workflow
  196. DAG.</li>
  197. <li class="li">
  198. <strong class="ph b">Actions</strong> tab shows you details about the actions that
  199. make up the workflow.<a name="topic_9_6_1__ul_pgz_3nt_4j"><!-- --></a><ul class="ul" id="topic_9_6_1__ul_pgz_3nt_4j">
  200. <li class="li">Click the <strong class="ph b">Id</strong> link to see
  201. additional details about the action.</li>
  202. <li class="li">Click the <strong class="ph b">External Id</strong> link
  203. to view the job in the Job Browser.</li>
  204. </ul>
  205. </li>
  206. <li class="li"><strong class="ph b">Details</strong> tab shows job statistics
  207. including start and end times.</li>
  208. <li class="li"><strong class="ph b">Configuration</strong> tab shows selected
  209. job configuration settings.</li>
  210. <li class="li"><strong class="ph b">Logs</strong> tab shows log output
  211. generated by the workflow job.</li>
  212. <li class="li"><strong class="ph b">Definition</strong> tab shows the Oozie
  213. workflow definition, as it appears in the <samp class="ph codeph">workflow.xml</samp> file (also linked under the application path properties in the
  214. <strong class="ph b">Details</strong> tab and the <strong class="ph b">Configuration</strong> tab).</li>
  215. </ul>
  216. <p class="p">For each action in the workflow you can:</p>
  217. <a name="topic_9_6_1__ul_v4y_htz_2k"><!-- --></a><ul class="ul" id="topic_9_6_1__ul_v4y_htz_2k">
  218. <li class="li">
  219. <div class="p">Click the <a name="topic_9_6_1__image_u3d_ssz_2k"><!-- --></a><img class="image" id="topic_9_6_1__image_u3d_ssz_2k" src="/static/art/help/eye.png"/> icon to view the
  220. action screen, which contains:<a name="topic_9_6_1__ul_edm_5sz_2k"><!-- --></a><ul class="ul" id="topic_9_6_1__ul_edm_5sz_2k">
  221. <li class="li"><strong class="ph b">Details</strong> tab shows job statistics including start and end times.</li>
  222. <li class="li"><strong class="ph b">Configuration</strong> tab shows the action configuration settings.</li>
  223. <li class="li"><strong class="ph b">Child Jobs</strong> tab lists jobs generated by the action.</li>
  224. </ul>
  225. </div>
  226. </li>
  227. <li class="li">
  228. <p class="p">Click the <a name="topic_9_6_1__image_hwj_ktz_2k"><!-- --></a><img class="image" id="topic_9_6_1__image_hwj_ktz_2k" src="/static/art/help/log.png"/> icon to view the log
  229. in the Job Browser. </p>
  230. </li>
  231. </ul>
  232. </div>
  233. </div>
  234. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_6_2"><a name="topic_9_6_2"><!-- --></a>
  235. <h3 class="title topictitle3">Coordinators</h3>
  236. <div class="body conbody">
  237. <p class="p">Click the <strong class="ph b">Coordinators</strong> tab to view the running and completed coordinator jobs for the filters you have
  238. specified.
  239. </p>
  240. <p class="p">For the selected job, the following information is available.
  241. </p>
  242. <ul class="ul">
  243. <li class="li">The <strong class="ph b">Calendar</strong> tab shows the timestamp of the job. Click the timestamp
  244. to open the workflow DAG. </li>
  245. <li class="li">The <strong class="ph b">Actions</strong> tab shows you details about the actions that make up the coordinator.<a name="topic_9_6_2__ul_nld_3nt_4j"><!-- --></a><ul class="ul" id="topic_9_6_2__ul_nld_3nt_4j">
  246. <li class="li">Click the <strong class="ph b">Id</strong> link to see additional details about the
  247. action.</li>
  248. <li class="li">Click the <strong class="ph b">External Id</strong> link to view the job in the Job
  249. Browser.</li>
  250. </ul>
  251. </li>
  252. <li class="li">The <strong class="ph b">Configuration</strong> tab shows selected job configuration settings.</li>
  253. <li class="li">The <strong class="ph b">Logs</strong> tab shows log output generated by the coordinator.</li>
  254. <li class="li">The <strong class="ph b">Definition</strong> tab shows the Oozie coordinator definition, as it
  255. appears in the <samp class="ph codeph">coordinator.xml</samp> file (also linked under the
  256. <samp class="ph codeph">oozie.coord.application.path</samp> property in the
  257.  <strong class="ph b">Configuration</strong> tab).</li>
  258. </ul>
  259. </div>
  260. </div>
  261. <div class="topic concept nested2" id="concept_h1s_rtp_wj"><a name="concept_h1s_rtp_wj"><!-- --></a>
  262. <h3 class="title topictitle3">Bundles</h3>
  263. <div class="body conbody">
  264. <p class="p">Click the <strong class="ph b">Bundles</strong> tab to view the
  265. running and completed bundle jobs for the filters you have specified. </p>
  266. </div>
  267. </div>
  268. <div class="topic concept nested2" id="concept_hvm_5vd_2k"><a name="concept_hvm_5vd_2k"><!-- --></a>
  269. <h3 class="title topictitle3">Oozie</h3>
  270. <div class="body conbody">
  271. <p class="p">The Oozie tab provides subtabs that give you access to Oozie instrumentation and
  272. configuration settings.</p>
  273. <div class="section" id="concept_hvm_5vd_2k__section_rbd_fwd_2k"><a name="concept_hvm_5vd_2k__section_rbd_fwd_2k"><!-- --></a><h4 class="title sectiontitle">Instrumentation</h4>
  274. <p class="p">For information on the instrumentation metrics supported by Oozie, see <a class="xref" href="http://oozie.apache.org/docs/3.3.0/AG_Monitoring.html" target="_blank">Oozie Monitoring</a>.</p>
  275. </div>
  276. <div class="section" id="concept_hvm_5vd_2k__section_zlh_cwd_2k"><a name="concept_hvm_5vd_2k__section_zlh_cwd_2k"><!-- --></a><h4 class="title sectiontitle">Configuration</h4>
  277. <p class="p">For information on the configuration properties supported by Oozie, see <a class="xref" href="http://oozie.apache.org/docs/3.3.0/AG_Install.html#Oozie_Configuration" target="_blank">Oozie Configuration</a>.</p>
  278. </div>
  279. </div>
  280. </div>
  281. </div>
  282. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_7"><a name="topic_9_7"><!-- --></a>
  283. <h2 class="title topictitle2">Workflow Manager
  284. </h2>
  285. <div class="body conbody">
  286. <p class="p">In Workflow Manager you create Oozie workflows and submit them for
  287. execution. </p>
  288. <p class="p">
  289. Click the <strong class="ph b">Workflows</strong> tab to open the Workflow Manager.
  290. </p>
  291. <p class="p">
  292. Each row shows a workflow: its name, description, timestamp of its last modification. It also shows:
  293. </p>
  294. <ul class="ul">
  295. <li class="li"><strong class="ph b">Steps</strong> - the number of steps in the
  296. workflow execution path. This is the number of execution steps between the start and end
  297. of the workflow. This will not necessarily be the same as the number of actions in the
  298. workflow, if there are control flow nodes in the control path.</li>
  299. <li class="li"><strong class="ph b">Status</strong> - who can run the
  300. workflow. <strong class="ph b">shared</strong> means users other than the owner can
  301. access the workflow. <strong class="ph b">personal</strong> means only the owner can
  302. modify or submit the workflow. The default is personal.</li>
  303. <li class="li"><strong class="ph b">Owner</strong> - the user that created the
  304. workflow.</li>
  305. </ul>
  306. <p class="p">
  307. In Workflow Editor you edit workflows that include MapReduce, Streaming, Java, Pig, Hive, Sqoop, Shell, Ssh,
  308. DistCp, Fs, Email, Sub-workflow, and Generic actions. You can configure these actions in the Workflow Editor, or
  309. you can import job designs from Job Designer to be used as actions in your workflow. For information about
  310. defining workflows, see the
  311. <a class="xref" href="http://archive.cloudera.com/cdh4/cdh/4/oozie/WorkflowFunctionalSpec.html" target="_blank">Workflow
  312. Specification</a>.
  313. </p>
  314. </div>
  315. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_2"><a name="topic_9_7_2"><!-- --></a>
  316. <h3 class="title topictitle3">Opening a Workflow</h3>
  317. <div class="body conbody">
  318. <p class="p">To open a workflow, in Workflow Manager, click the workflow. Proceed
  319. with <a class="xref" href="#topic_9_7_7">Editing a Workflow</a>.
  320. </p>
  321. </div>
  322. </div>
  323. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_3"><a name="topic_9_7_3"><!-- --></a>
  324. <h3 class="title topictitle3">Creating a Workflow</h3>
  325. <div class="body conbody">
  326. <ol class="ol">
  327. <li class="li">Click the <strong class="ph b">Create</strong> button at the top right.</li>
  328. <li class="li">In the Name field, type a name.</li>
  329. <li class="li">Check the <span class="ph uicontrol">Is shared</span> checkbox to allow all users to access the
  330. workflow.</li>
  331. <li class="li">Click <strong class="ph b">advanced</strong> to specify the
  332. deployment directory or a job.xml file.</li>
  333. <li class="li">Click <strong class="ph b">Save</strong>. The Workflow Editor opens. Proceed with <a class="xref" href="#topic_9_7_7">Editing a Workflow</a>.</li>
  334. </ol>
  335. </div>
  336. </div>
  337. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_4"><a name="topic_9_7_4"><!-- --></a>
  338. <h3 class="title topictitle3">Importing a Workflow</h3>
  339. <div class="body conbody">
  340. <ol class="ol">
  341. <li class="li">Click the <strong class="ph b">Import</strong> button at the top right.</li>
  342. <li class="li">In the Name field, type a name.</li>
  343. <li class="li">In the <strong class="ph b">Local workflow.xml file</strong> field, click <strong class="ph b">Choose File</strong> and
  344. select a workflow file.</li>
  345. <li class="li">Click <strong class="ph b">advanced</strong> to specify whether the workflow is shared, the
  346. deployment directory, or a job.xml file.</li>
  347. <li class="li">Click <strong class="ph b">Save</strong>. The Workflow Editor opens. Proceed with <a class="xref" href="#topic_9_7_7">Editing a Workflow</a>.</li>
  348. </ol>
  349. </div>
  350. </div>
  351. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_5"><a name="topic_9_7_5"><!-- --></a>
  352. <h3 class="title topictitle3">Submitting a Workflow</h3>
  353. <div class="body conbody">
  354. <p class="p">To submit a workflow for execution, do one of the following:
  355. </p>
  356. <ul class="ul">
  357. <li class="li">In the Workflow Manager, click the radio button next to the workflow, and
  358. click the <strong class="ph b">Submit</strong> button.</li>
  359. <li class="li">In the Workflow Editor, click the <strong class="ph b">Submit</strong> button.</li>
  360. </ul>
  361. <p class="p">The workflow job is submitted and the Dashboard displays the workflow job.
  362. </p>
  363. <p class="p">To view the output of the job, click
  364. <img class="image" src="/static/art/help/log.png"/>
  365. <strong class="ph b">View the logs</strong>.
  366. </p>
  367. <div class="section"><h4 class="title sectiontitle">Suspending a Running Job</h4>
  368. <p class="p"> In the pane on the left, click the <strong class="ph b">Suspend</strong> button.
  369. </p>
  370. <ol class="ol">
  371. <li class="li">Verify that you want to suspend the job.</li>
  372. </ol>
  373. </div>
  374. <div class="section"><h4 class="title sectiontitle">Resuming a Suspended Job</h4>
  375. <p class="p"> In the pane on the left, click the <strong class="ph b">Resume</strong> button.
  376. </p>
  377. <ol class="ol">
  378. <li class="li">Verify that you want to resume the job.</li>
  379. </ol>
  380. </div>
  381. <div class="section"><h4 class="title sectiontitle">Rerunning a Workflow</h4>
  382. <p class="p"> In the pane on the left, click the <strong class="ph b">Rerun</strong> button.
  383. </p>
  384. <ol class="ol">
  385. <li class="li">Check the checkboxes next to the actions to rerun.</li>
  386. <li class="li">Specify required variables.</li>
  387. <li class="li">Click <strong class="ph b">Submit</strong>.</li>
  388. </ol>
  389. </div>
  390. </div>
  391. </div>
  392. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_6"><a name="topic_9_7_6"><!-- --></a>
  393. <h3 class="title topictitle3">Scheduling a Workflow</h3>
  394. <div class="body conbody">
  395. <p class="p">To schedule a workflow for recurring execution, do one of the following:
  396. </p>
  397. <ul class="ul">
  398. <li class="li">In the Workflow Manager, check the checkbox next to the workflow
  399. and click the <strong class="ph b">Schedule</strong> button.</li>
  400. <li class="li">In the Workflow Editor, click the <strong class="ph b">Schedule</strong> button.</li>
  401. </ul>
  402. <p class="p" id="topic_9_7_6__p_102"><a name="topic_9_7_6__p_102"><!-- --></a>
  403. A coordinator is created and opened in the Coordinator Editor. Proceed
  404. with <a class="xref" href="#topic_9_8_4">Editing a Coordinator</a>.
  405. </p>
  406. </div>
  407. </div>
  408. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_7"><a name="topic_9_7_7"><!-- --></a>
  409. <h3 class="title topictitle3">Editing a Workflow</h3>
  410. <div class="body conbody">
  411. <p class="p">In the Workflow Editor you can easily perform operations on Oozie action and control nodes.
  412. </p>
  413. <div class="section"><h4 class="title sectiontitle">Action Nodes</h4>
  414. <p class="p"> The Workflow Editor supports dragging and dropping action nodes. As you move the action over other actions
  415. and forks, highlights indicate active areas. If there are actions in the workflow, the active areas are the
  416. actions themselves and the areas above and below the actions. If you drop an action on an existing action, a
  417. fork and join is added to the workflow.
  418. </p>
  419. <ul class="ul">
  420. <li class="li">Add actions to the workflow by clicking an action <a name="topic_9_7_7__image_kpj_dnt_4j"><!-- --></a><img class="image" id="topic_9_7_7__image_kpj_dnt_4j" src="/static/art/help/action.png"/> button and drop the action on the workflow. The Edit Node
  421. screen displays. <a name="topic_9_7_7__ol_l3q_dnt_4j"><!-- --></a><ol class="ol" id="topic_9_7_7__ol_l3q_dnt_4j">
  422. <li class="li">Set the action properties and click <strong class="ph b">Done</strong>. Each action in a workflow must have a
  423. unique name.</li>
  424. </ol>
  425. </li>
  426. </ul>
  427. <ul class="ul">
  428. <li class="li">Copy an action by clicking the <img class="image" src="/static/art/help/copy.png"/>
  429. <strong class="ph b">Copy</strong> button.</li>
  430. </ul>
  431. <a name="topic_9_7_7__ol_bjq_r55_yj"><!-- --></a><ol class="ol" id="topic_9_7_7__ol_bjq_r55_yj">
  432. <li class="li">The action is opened in the Edit Node screen.</li>
  433. <li class="li">Edit the action properties and click <strong class="ph b">Done</strong>. The action is added to the end of the
  434. workflow.</li>
  435. </ol>
  436. <ul class="ul">
  437. <li class="li">Delete an action by clicking the <img class="image" src="/static/art/help/trash.png"/> button.</li>
  438. <li class="li">Edit an action by clicking the <img class="image" src="/static/art/help/edit.png"/> button.</li>
  439. <li class="li">Change the position of an action by left-clicking and dragging an action
  440. to a new location.</li>
  441. </ul>
  442. </div>
  443. <div class="section"><h4 class="title sectiontitle">Control Nodes</h4>
  444. <ul class="ul">
  445. <li class="li">Create a fork and join by dropping an action on top of another
  446. action.</li>
  447. <li class="li">Remove a fork and join by dragging a forked action and dropping it above
  448. the fork.</li>
  449. <li class="li">Convert a fork to a decision by clicking the <img class="image" src="/static/art/help/convert.png"/>
  450. button.</li>
  451. <li class="li">To edit a decision: <a name="topic_9_7_7__ol_dcc_fnt_4j"><!-- --></a><ol class="ol" id="topic_9_7_7__ol_dcc_fnt_4j">
  452. <li class="li">Click the <a name="topic_9_7_7__image_lcc_fnt_4j"><!-- --></a><img class="image" id="topic_9_7_7__image_lcc_fnt_4j" src="/static/art/help/edit.png"/> button.</li>
  453. <li class="li">Fill in the predicates that determine which action to
  454. perform and select the default action from the drop-down list.</li>
  455. <li class="li">Click <strong class="ph b">Done</strong>.</li>
  456. </ol>
  457. </li>
  458. </ul>
  459. </div>
  460. </div>
  461. </div>
  462. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_8"><a name="topic_9_7_8"><!-- --></a>
  463. <h3 class="title topictitle3">Uploading Workflow Files</h3>
  464. <div class="body conbody">
  465. <p class="p">In the Workflow Editor, click the <strong class="ph b">Upload</strong>
  466. button. </p>
  467. <p class="p">The workspace of the workflow is opened in the File Browser
  468. application. Follow the procedure in <a class="xref" href="filebrowser.html#topic_6_3_4">Uploading Files</a> to upload the files. You must put JAR files in a
  469. <span class="ph filepath">lib</span> directory in the
  470. workspace.</p>
  471. </div>
  472. </div>
  473. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_9"><a name="topic_9_7_9"><!-- --></a>
  474. <h3 class="title topictitle3">Editing Workflow Properties</h3>
  475. <div class="body conbody">
  476. <ol class="ol">
  477. <li class="li">In the Workflow Editor, click the link under the Name or Description fields
  478. in the left pane.</li>
  479. <li class="li">To share the workflow with all users, check the <strong class="ph b">Is shared</strong> checkbox.</li>
  480. <li class="li">To set advanced execution options, click <strong class="ph b">advanced</strong> and edit the
  481. deployment directory, add parameters and job properties, or specify a
  482. job.xml file.</li>
  483. <li class="li">Click <strong class="ph b">Save</strong>.</li>
  484. </ol>
  485. </div>
  486. </div>
  487. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_7_10"><a name="topic_9_7_10"><!-- --></a>
  488. <h3 class="title topictitle3">Displaying the History of a Workflow</h3>
  489. <div class="body conbody">
  490. <ol class="ol">
  491. <li class="li">Click the <strong class="ph b">Dashboard</strong> tab.</li>
  492. <li class="li">Click the <strong class="ph b">Workflows</strong> tab. </li>
  493. <li class="li">Click a workflow.</li>
  494. <li class="li">Click the <strong class="ph b">Actions</strong> tab.</li>
  495. </ol>
  496. </div>
  497. </div>
  498. </div>
  499. <div class="topic concept nested1" xml:lang="en-US" lang="en-US" id="topic_9_8"><a name="topic_9_8"><!-- --></a>
  500. <h2 class="title topictitle2">Coordinator Manager
  501. </h2>
  502. <div class="body conbody">
  503. <p class="p">
  504. In Coordinator Manager you create Oozie coordinator applications and submit them for execution.
  505. </p>
  506. <p class="p">
  507. Click the <strong class="ph b">Coordinators</strong> tab to open the Coordinator Manager.
  508. </p>
  509. <p class="p">
  510. Each row shows a coordinator: its name, description, timestamp of its last modification. It also shows:
  511. </p>
  512. <ul class="ul">
  513. <li class="li"><strong class="ph b">Workflow</strong> - the workflow that will
  514. be run by the coordinator.</li>
  515. <li class="li"><strong class="ph b">Frequency</strong> - how often the workflow
  516. referenced by the coordinator will be run.</li>
  517. <li class="li"><strong class="ph b">Status</strong> - who can run the
  518. coordinator. <strong class="ph b">shared</strong> means users other than the owner can
  519. access the workflow. <strong class="ph b">personal</strong> means only the owner can
  520. modify or submit the workflow. The default is personal.</li>
  521. <li class="li"><strong class="ph b">Owner</strong> - the user that created the
  522. coordinator.</li>
  523. </ul>
  524. <p class="p">
  525. In Coordinator Editor, you edit coordinators and the datasets required by the coordinators. For information
  526. about defining coordinators and datasets, see the
  527. <a class="xref" href="http://archive.cloudera.com/cdh4/cdh/4/oozie/CoordinatorFunctionalSpec.html" target="_blank">Coordinator
  528. Specification</a>.
  529. </p>
  530. </div>
  531. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_1"><a name="topic_9_8_1"><!-- --></a>
  532. <h3 class="title topictitle3">Opening a Coordinator</h3>
  533. <div class="body conbody">
  534. <p class="p">To open a coordinator, in Coordinator Manager, click the coordinator. Proceed with
  535. <a class="xref" href="#topic_9_8_4">Editing a Coordinator</a>.
  536. </p>
  537. </div>
  538. </div>
  539. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_2"><a name="topic_9_8_2"><!-- --></a>
  540. <h3 class="title topictitle3">Creating a Coordinator</h3>
  541. <div class="body conbody">
  542. <p class="p">To create a coordinator, in Coordinator Manager:
  543. </p>
  544. <ol class="ol">
  545. <li class="li">Click the <strong class="ph b">Create</strong> button at the top right. The Coordinator wizard
  546. opens. Proceed with <a class="xref" href="#topic_9_8_4">Editing a
  547. Coordinator</a>.</li>
  548. </ol>
  549. </div>
  550. </div>
  551. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_3"><a name="topic_9_8_3"><!-- --></a>
  552. <h3 class="title topictitle3">Submitting a Coordinator</h3>
  553. <div class="body conbody">
  554. <p class="p" id="topic_9_8_3__p_110"><a name="topic_9_8_3__p_110"><!-- --></a> To submit a coordinator for execution, check the checkbox
  555. next to the coordinator and click the <strong class="ph b">Submit</strong> button. </p>
  556. </div>
  557. </div>
  558. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_4"><a name="topic_9_8_4"><!-- --></a>
  559. <h3 class="title topictitle3">Editing a Coordinator</h3>
  560. <div class="body conbody">
  561. <p class="p">In the Coordinator Editor you specify coordinator properties and the datasets
  562. on which the workflow scheduled by the coordinator will operate by stepping through
  563. screens in a wizard. <span class="ph" id="topic_9_8_4__wizard"><a name="topic_9_8_4__wizard"><!-- --></a>You can also advance to particular steps and revisit
  564. steps by clicking the Step "tabs" above the screens. The following instructions walk you
  565. through the wizard. </span></p>
  566. <ol class="ol">
  567. <li class="li">Type a name, select the workflow, check the <strong class="ph b">Is shared
  568. checkbox</strong> to share the job, and click <strong class="ph b">Next</strong>. If
  569. the Coordinator Editor was opened after scheduling a workflow, the workflow will be
  570. set.</li>
  571. <li class="li">Select how many times the coordinator will run for each specified
  572. unit, the start and end times of the coordinator, the timezone of the start and end
  573. times, and click <strong class="ph b">Next</strong>. <span class="ph">Times must be expressed as
  574. UTC times. For example, to run at 10 pm PST, specify a start time of 6 am UTC of the
  575. following day (+8 hours) and set the Timezone field to America/Los_Angeles.</span></li>
  576. <li class="li">Click <strong class="ph b">Add</strong> to select an input dataset and click <strong class="ph b">Next</strong>. If no
  577. datasets exist, follow the procedure in <a class="xref" href="#topic_9_8_5">Creating a Dataset</a>.</li>
  578. <li class="li">Click <strong class="ph b">Add</strong> to select an output dataset. Click <strong class="ph b">Save coordinator</strong>
  579. or click <strong class="ph b">Next</strong> to specify advanced settings.</li>
  580. <li class="li">To share the coordinator with all users, check the <strong class="ph b">Is</strong><strong class="ph b"> shared</strong>
  581. checkbox.</li>
  582. <li class="li">Fill in parameters to pass to Oozie, properties that determine how long a
  583. coordinator will wait before timing out, how many coordinators can run and
  584. wait concurrently, and the coordinator execution policy.</li>
  585. <li class="li" id="topic_9_8_4__li_120"><a name="topic_9_8_4__li_120"><!-- --></a>Click <strong class="ph b">Save coordinator</strong>.</li>
  586. </ol>
  587. </div>
  588. </div>
  589. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_5"><a name="topic_9_8_5"><!-- --></a>
  590. <h3 class="title topictitle3">Creating a Dataset</h3>
  591. <div class="body conbody">
  592. <ol class="ol">
  593. <li class="li">In the Coordinator Editor, do one of the following: <a name="topic_9_8_5__ul_ynh_gnt_4j"><!-- --></a><ul class="ul" id="topic_9_8_5__ul_ynh_gnt_4j">
  594. <li class="li">Click <strong class="ph b">here</strong> in the Inputs or
  595. Outputs pane at the top of the editor.</li>
  596. <li class="li">In the pane at the left, click the <strong class="ph b">Create new</strong> link. Proceed with <a class="xref" href="#topic_9_8_7">Editing a
  597. Dataset</a>.</li>
  598. </ul>
  599. </li>
  600. </ol>
  601. </div>
  602. </div>
  603. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_6"><a name="topic_9_8_6"><!-- --></a>
  604. <h3 class="title topictitle3">Displaying Datasets</h3>
  605. <div class="body conbody">
  606. <ol class="ol">
  607. <li class="li">In the Coordinator Editor, click <strong class="ph b">Show existing</strong> in pane at the
  608. left.</li>
  609. <li class="li" id="topic_9_8_6__li_121"><a name="topic_9_8_6__li_121"><!-- --></a>To edit a dataset, click the dataset name in the Existing
  610. datasets table. Proceed with <a class="xref" href="#topic_9_8_7">Editing
  611. a Dataset</a>.</li>
  612. </ol>
  613. </div>
  614. </div>
  615. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_7"><a name="topic_9_8_7"><!-- --></a>
  616. <h3 class="title topictitle3">Editing a Dataset</h3>
  617. <div class="body conbody">
  618. <ol class="ol">
  619. <li class="li">Type a name for the dataset.</li>
  620. <li class="li">In the Start and Frequency fields, specify when and how often the dataset
  621. will be available.</li>
  622. <li class="li">In the URI field, specify a URI template for the location of the
  623. dataset. To construct URIs and URI paths containing dates and timestamps, you can
  624. specify the variables <samp class="ph codeph">${YEAR}</samp><samp class="ph codeph">,$</samp><samp class="ph codeph">{MONTH},${DAY},${HOUR},${MINUTE}</samp>. For example:<samp class="ph codeph">
  625. hdfs://foo:9000/usr/app/stats/${YEAR}/${MONTH}/data</samp>.</li>
  626. <li class="li">In the Instance field, click a button to choose a default, single, or range
  627. of data instances. For example, if frequency==DAY, a window of the last
  628. rolling 5 days (not including today) would be expressed as start: -5 and
  629. end: -1. Check the advanced checkbox to display a field where you can
  630. specify a coordinator <a class="xref" href="http://archive.cloudera.com/cdh4/cdh/4/oozie/CoordinatorFunctionalSpec.html" target="_blank">EL function</a>.</li>
  631. <li class="li">Specify the timezone of the start date.</li>
  632. <li class="li">In the Done flag field, specify the flag that identifies when input datasets
  633. are no longer ready.</li>
  634. </ol>
  635. </div>
  636. </div>
  637. <div class="topic concept nested2" xml:lang="en-US" lang="en-US" id="topic_9_8_8"><a name="topic_9_8_8"><!-- --></a>
  638. <h3 class="title topictitle3">Displaying the History of a Coordinator</h3>
  639. <div class="body conbody">
  640. <ol class="ol">
  641. <li class="li">Click the <strong class="ph b">Dashboard</strong> tab.</li>
  642. <li class="li">Click the <strong class="ph b">Coordinators</strong> tab. </li>
  643. <li class="li">Click a coordinator.</li>
  644. <li class="li">Click the <strong class="ph b">Actions</strong> tab.</li>
  645. </ol>
  646. </div>
  647. </div>
  648. </div>
  649. <div class="topic concept nested1" id="concept_crd_ttp_wj"><a name="concept_crd_ttp_wj"><!-- --></a>
  650. <h2 class="title topictitle2">Bundle Manager</h2>
  651. <div class="body conbody">
  652. <p class="p">In Bundle Manager you create Oozie bundle applications and submit them
  653. for execution. </p>
  654. <p class="p">Click the <strong class="ph b">Bundle</strong> tab to open the
  655. Bundle Manager. </p>
  656. <p class="p">Each row shows a bundle: its name, description, timestamp of its last
  657. modification. It also shows: </p>
  658. <a name="concept_crd_ttp_wj__ul_skt_5kj_2k"><!-- --></a><ul class="ul" id="concept_crd_ttp_wj__ul_skt_5kj_2k">
  659. <li class="li"><strong class="ph b">Coordinators</strong> - the coordinators
  660. that will be run by the bundle.</li>
  661. <li class="li"><strong class="ph b">Kick off</strong> - the UTC time when the
  662. coordinators referenced by the bundle will be started. </li>
  663. <li class="li"><strong class="ph b">Status</strong> - who can run the bundle.
  664. <strong class="ph b">shared</strong> means users other than the owner can access the
  665. workflow. <strong class="ph b">personal</strong> means only the owner can modify or
  666. submit the workflow. The default is personal.</li>
  667. <li class="li"><strong class="ph b">Owner</strong> - the user that created the
  668. bundle.</li>
  669. </ul>
  670. <p class="p">For information about defining bundles, see the <a class="xref" href="http://archive.cloudera.com/cdh4/cdh/4/oozie/BundleFunctionalSpec.html" target="_blank"> Bundle
  671. Specification</a>.</p>
  672. </div>
  673. <div class="topic concept nested2" id="concept_t5k_wqj_2k"><a name="concept_t5k_wqj_2k"><!-- --></a>
  674. <h3 class="title topictitle3">Opening a Bundle</h3>
  675. <div class="body conbody">
  676. <p class="p">To open a bundle, in Bundle Manager, click the bundle. Proceed with
  677. <a class="xref" href="#concept_ur1_gmj_2k">Editing a Bundle</a>. </p>
  678. </div>
  679. </div>
  680. <div class="topic concept nested2" id="concept_rvt_gmj_2k"><a name="concept_rvt_gmj_2k"><!-- --></a>
  681. <h3 class="title topictitle3">Creating a Bundle</h3>
  682. <div class="body conbody">
  683. <a name="concept_rvt_gmj_2k__ol_wgk_jmj_2k"><!-- --></a><ol class="ol" id="concept_rvt_gmj_2k__ol_wgk_jmj_2k">
  684. <li class="li">Click the <strong class="ph b">Create</strong> button at the
  685. top right.</li>
  686. <li class="li">In the Name field, type a name.</li>
  687. <li class="li">In the Kick off time field, choose a kick off time. </li>
  688. <li class="li">Check the <span class="ph uicontrol">Is
  689. shared</span> checkbox to allow all users to access the workflow.</li>
  690. <li class="li">Click <strong class="ph b">Save</strong>. The Bundle Editor
  691. opens. Proceed with <a class="xref" href="#concept_ur1_gmj_2k">Editing a Bundle</a>.</li>
  692. </ol>
  693. </div>
  694. </div>
  695. <div class="topic concept nested2" id="concept_fcd_1rj_2k"><a name="concept_fcd_1rj_2k"><!-- --></a>
  696. <h3 class="title topictitle3">Submitting a Bundle</h3>
  697. <div class="body conbody">
  698. <p class="p">To submit a bundle for execution, check the checkbox next to the
  699. bundle and click the <strong class="ph b">Submit</strong> button. </p>
  700. </div>
  701. </div>
  702. <div class="topic concept nested2" id="concept_ur1_gmj_2k"><a name="concept_ur1_gmj_2k"><!-- --></a>
  703. <h3 class="title topictitle3">Editing a Bundle</h3>
  704. <div class="body conbody">
  705. <p class="p">In the Bundle Editor, you specify properties by stepping through
  706. screens in a wizard. <span class="ph">You can also advance to particular steps and revisit
  707. steps by clicking the Step "tabs" above the screens. The following instructions walk you
  708. through the wizard. </span>
  709. </p>
  710. <a name="concept_ur1_gmj_2k__ol_evj_rmj_2k"><!-- --></a><ol class="ol" id="concept_ur1_gmj_2k__ol_evj_rmj_2k">
  711. <li class="li">Click <strong class="ph b">Add</strong> to select a
  712. coordinator that the bundle will kick off.</li>
  713. <li class="li">Choose the kick off time. The time must be expressed as a UTC
  714. time. For example, to run at 10 pm PST, specify a start time of 6 am UTC of the
  715. following day (+8 hours).</li>
  716. <li class="li">To share the bundle with all users, check the <strong class="ph b">Is shared</strong> checkbox.</li>
  717. <li class="li">Click <strong class="ph b">Next</strong> to specify advanced
  718. settings or click <strong class="ph b">Save bundle</strong>.</li>
  719. <li class="li">Fill in parameters to pass to Oozie.</li>
  720. <li class="li">Click <strong class="ph b">Save bundle</strong>.</li>
  721. </ol>
  722. </div>
  723. </div>
  724. </div>
  725. <div class="topic concept nested1" id="concept_alh_gqj_2k"><a name="concept_alh_gqj_2k"><!-- --></a>
  726. <h2 class="title topictitle2">Displaying the History of a Bundle</h2>
  727. <div class="body conbody">
  728. <a name="concept_alh_gqj_2k__ol_rdg_hqj_2k"><!-- --></a><ol class="ol" id="concept_alh_gqj_2k__ol_rdg_hqj_2k">
  729. <li class="li">Click the <strong class="ph b">Dashboard</strong> tab.</li>
  730. <li class="li">Click the <strong class="ph b">Bundles</strong> tab. </li>
  731. <li class="li">Click a bundle.</li>
  732. <li class="li">Click the <strong class="ph b">Actions</strong> tab.</li>
  733. </ol>
  734. </div>
  735. </div>
  736. </body>
  737. </html>