index.html 49 KB

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