# 操作Open OnDemand與工作管理
[TOC]
## 1. 登入Open OnDemand
:::success
在您習慣的瀏覽器上輸入 https://f1-stn01.nchc.org.tw/ or https://f1-stn02.nchc.org.tw/ 連結,將看到以下登入畫面,請輸入您在F1的主機帳號與密碼進行登入。
++若忘記主機帳號可至[iService中查詢主機帳號](https://man.twcc.ai/@f1-manual/iService)++

提醒:
為了安全登入網頁有時效性,如果你閒置過久未登入,或是已完成用戶登入又重新嘗試登入,系統可能會出現Bad Request 的錯誤訊息,如果你遇到此訊息請重新輸入 https://f1-stn01.nchc.org.tw/ or https://f1-stn02.nchc.org.tw/ 連結。
:::
## 2. 檔案管理
:::success
Open OnDemand 提供Web檔案管理員,在首頁點選Files > Home Directory。

你將看到你的家目錄與檔案,你可以在檔案管理使用以下功能:
· 檔案列表。
· 目錄建立。
· 修改檔案名稱。
· 編輯文字檔。
· 上傳檔案或目錄。
· 下載檔案或目錄。
· 拷貝/搬移 檔案。
· 在所在目錄啟動終端機。

:::
## 3. 透過Open OnDemand進入 Login node
:::success
(1) Open OnDemand 提供Web終端機讓使用者登入Login node進行操作,請點選 首頁 \> Cluster,畫面將出現 f1-x86 的選單。

(2) 點選 f1-x86 將進入f1-ilgn-vip.nchc.org.tw登入節點,如下畫面:

:::
## 4. 建立 Slurm Job
:::success
Job Composer 是一個Job的管理工具,提供Job建立、樣本管理、刪除與派送,請點選Jobs > Job composer > New Job 去建立Job。

建立一個新的Job(如下畫面所示),你將可以從Default Template, Template, Specified Path 和 Selected Job 來建立。

(1) 從Default Template建立Job
你可以直接點選Default Template 建立新的Job, 如下畫面出現新Job。

(2) 從Template建立Job
點選Template後將出現以下畫面,可以看到本系統提供的Job樣本列表,你可以從列表中選擇適合樣本,當你點選每一個樣本時,右邊的視窗同步會顯示該樣本的資訊,這裡我們點選 Hello World Job for x86 樣本。

在Create New”Hello World Job for x86”視窗,可以修改你的Job Name,接著按Create New Job 按扭則可建立Job,一個新的Job 將從這個樣本被建立,畫面將回到Job 列表。

(3) 從Specified Path建立Job
你可以選擇一個已存在的Job的目錄來建立一個Job,選擇的目錄需要包含script檔案(例如 main_job.sh),點選Specified Path後將出現以下畫面。在Source Path 輸入Job 來源目錄,在Name 指定Job 名稱,在Script Name 填入batch script 檔案名稱 (例如 main_job.sh),在 Cluster 是指定派送到 x86 的計算節點 ,最後按Save按鈕建立Job。
<font color="red"> 當使用者指定路徑創建job時,因OOD_job composer 的內建行為會copy 所有檔案到指定目錄下。所以被指定目錄下的檔案(folder)不能超過1G,其script 檔案不能超過65KB</font>

你將從Job 列表中看到新建立的Job,如下圖所示:

(4) 從Selected Job建立Job
你可以從Job列表中選擇一個已存在的Job 去建立一個新的Job,首先在列表中點選要複製的Job,然後點選Selected Job去建立Job。

新的Job將出現在列表中,如以下畫面:

:::
## 5. Job 管理
在 Jobs 列表中你可以選擇一個 Job來管理你的Job,像是編輯、修改、刪除、Submit、Stop...等。
:::success
(1) 首先,按 Job Options 進行修改參數。

(2) 下圖為進入Job Options的畫面,你可以在此修改名稱、Cluster和 Job Script …等欄位,編輯完後按 Save 儲存。
<font color="red">
補充說明:若你的目錄中有多個 script,那妳可以在下拉式選單中更換你的script</font>

(3) 在 JOB 列表的右下角Submit Script視窗中 Open Editor 按鈕可以讓你編輯你的submit script。

· 點選Open Editor之後將出現以下編輯畫面,在這裡你可以編輯你的 script,編輯完成按Save 按扭儲存檔案。

(4) 當你一切就緒後,你可以按Submit來執行Job。

(5) Submit後的狀態將從 Not Submitted 變成 Queued/Running。
(6) Job 完成後狀態會變成 Completed,此時,你可以在右下視窗的Folder Contents 看到output log 檔,點選檔案就能觀看log。

:::
## 6. Job Template
你可以在Job Template 裡將Job建立新樣版,方便日後重覆套用。
點選Jobs > Job Composer > Templates 進入Job 樣版管理,有兩個方式可以建立新的樣版。

:::success
(1) New Template
點選 New Template 將出現以下表格。

| 欄位名稱 | 說明 |
|-|-|
| Path | 填寫Job script 所在目錄,OOD將會從這裡複製,如果你沒指定目錄,系統將用內建的job script。 |
| Name | 指定樣版名稱 |
| Cluster | 指定此Job 派送到 x86 的計算節點 |
| Note | 填寫註解 |
表格填寫完畢後按 Save 建立新樣版。
(2) Copy Template
請先選擇要copy 的template,然後點選 Copy Template,New Template表格的Path欄位將自動帶入選擇的樣版所在目錄,如下圖所示:

表格填寫完畢後按 Save 建立新樣版。
:::
## 7. Active Job
:::success
(1) 查看Active Job 可以點選Dashboard > Jobs > Activate。

(2) Active Job 視窗(如下畫面)會列出F1 Cluster所有的Job。如果Active Jobs 多的話,網頁顯示可能會比較慢。

(3) 你可以在畫面右上角選擇只顯示你的Job。

(4) 你可以在畫面右上角選擇 f1-x86。

(5) 點選 \> 符號可以看Job 的更多細節。


:::