<div style="text-align: right; background-color: #f5f5f5; padding: 4px 12px; border-radius: 5px; display: inline-block; float: right; font-size: 1.4rem;">
Last Updated：2025/07/01
</div>
<br>
# 操作 Open OnDemand 與工作管理
[TOC]
## 登入 Open OnDemand
1. 請在您慣用的瀏覽器中，輸入以下任一網址以開啟 Open OnDemand 登入頁面：
- https://f1-stn01.nchc.org.tw/
- https://f1-stn02.nchc.org.tw/
2. 將看到以下登入介面，請輸入您於 **創進一號（F1）** 的 **主機帳號** 與 **密碼** 完成登入。
<font color="blue">➤ **若您忘記主機帳號，可前往 [iService 主機帳號查詢教學](https://man.twcc.ai/@f1-manual/iService)**</font>
:::danger
<i class="fa fa-exclamation-triangle" aria-hidden="true"></i> **注意：**
為確保安全性，**登入網頁會有時效限制**，若您登入過程中閒置時間過長或已完成登入後又重新登入，系統可能會出現錯誤提示`Bad Request`，此時請重新輸入網址（https://f1-stn01.nchc.org.tw/ 或 https://f1-stn02.nchc.org.tw/ ）後登入。
:::
<br>
---
<br>
## 檔案管理功能說明
使用者可透過瀏覽器方便地瀏覽與管理個人目錄內的檔案與資料夾。
1. 在 Open OnDemand 首頁上，點選上方選單 **Files → Home Directory**
2. 系統將開啟您的個人家目錄，並顯示目前目錄下的所有檔案與資料夾
可執行的操作功能包括：
- 檢視檔案與資料夾列表
- 目錄建議
- 修改檔案或資料夾名稱
- 編輯文字檔案
- 上傳檔案或目錄
- 下載檔案或目錄
- 複製或搬移檔案
- 在當前目錄中開啟終端機
<br>
---
<br>
## 透過 Open OnDemand 進入 Login Node
使用者可在瀏覽器中直接進入 Login Node，進行命令列操作與開發工作，無需額外安裝 `SSH` 工具。
1. 登入 Open OnDemand 首頁後，點選上方選單 **Clusters → f1-x86 選單**
<div align="center">
<img src="https://man.twcc.ai/_uploads/SyQD5dGvC.png"
width=70%" height="100%"/>
</div>
<br>
(2) 點選 f1-x86 將連線至 `f1-ilgn-vip.nchc.org.tw` 登入節點，即可開始操作。
<div align="center">
<img src="https://man.twcc.ai/_uploads/Sy-O9_MvA.png"
width=70%" height="100%"/>
</div>
<br>
<br>
---
<br>
## 建立 Slurm Job
Open OnDemand 提供圖形化的 Job Composer 工具，方便使用者建立、樣本管理、刪除與派送 Slurm 工作排程任務。
1. 開啟 Job Composer 工具，請點選主選單 **Jobs → Job Composer → New Job**
2. 開啟後將看到四種建立 Job 的選項 **Default Template、Template、Specified Path、Selected Job**
<br>
**（1）從 Default Template 建立 Job**
點選 **Default Template**，系統將建立一個預設的 Job：
<br>
**（2）從 Template 建立 Job**
- 點選 **Template**，系統將顯示內建樣本列表：
- 選擇合適的樣本（例如：`Hello World Job for x86`），右側會顯示樣本詳細資訊，點選 `Create New Job` 後即可產生新 Job。
**(3) 從 Specified Path 建立 Job**
若您已有 Job 目錄，可從指定路徑建立：
- 選擇目錄需要包含 script 檔案 （`Specified Path`）
- 輸入：
- **Source Path**：Job 來源目錄
- **Name**：Job 名稱
- **Script Name**：Batch script 檔名（如：`main_job.sh`）
- **Cluster**：選擇派送叢集（如 x86）
- 點選 `Save` 建立 Job
<font color="red">➤ 由於 Open OnDemand Job Composer 在使用指定路徑建立Job時，會將所選目錄中的所有檔案完整複製至目標目錄，為避免錯誤發生，請確保**該目錄下檔案(folder)不超過 1GB**，且**所指定的 script 檔案大小不得超過 65KB**。</font>
- 成功後，新建立的 Job 將出現在列表中：
<br>
**(4) 從 Selected Job 建立Job**
可從現有的 Job 中選擇並複製建立：
- 點選要複製的 Job
- 選擇 **「From Selected Job」** 建立新 Job
- 新 Job 將出現在列表中
<br>
---
<br>
## Job 工作管理
使用者可透過 Jobs 列表中的操作功能，進行 Job 的編輯、修改、提交（Submit）、停止（Stop）、刪除等管理操作。
**(1) 編輯 Job 設定**
- 點選 ==**Job Options**== 進行參數修改。
**(2) 修改 Job 參數**
- 進入 「Job Options」 畫面後，您可在此修改 Job 名稱、Cluster 目標節點、以及 Job Script 等欄位，編輯完成後請點選 **「Save」** 儲存設定
<font color="red">➤ **若目錄中包含多個 script，您可透過下拉選單選擇欲使用的 script 作為工作腳本。**</font>
**(3) 編輯 Submit Script**
- 在 Job 列表右側的 「Submit Script」 區塊中，點選 ==**Open Editor**== 可開啟內建編輯器
- 進入編輯器後，您可直接修改腳本內容，編輯完成後請點選 **「Save」** 儲存。
**(4) 提交 Job**
- 當所有參數設定與腳本皆確認無誤後，點選 **「Submit」** 即可提交工作至排程系統
**(5) 檢查 Job 狀態**
- 提交後，狀態將從 **「Not Submitted」** 轉為 **「Queued」** 或 **「Running」** 。
- 工作完成後，狀態將顯示為 **「Completed」**
**(6) 檢視輸出結果**
- 當 Job 完成後，您可於右下方的 Folder Contents 區塊中檢視執行所產生的 log 檔，點選檔案即可查看詳細輸出內容。
<br>
---
<br>
## Job Template 管理功能
使用者能快速建立可重複使用的樣版，提高作業效率，請依序點選
==**Jobs → Job Composer → Templates**== 進入樣版管理頁面，系統提供兩種方式建立新的樣版：
<br>
**(1) 建立全新樣版（New Template）**
- 點選 **New Template**，系統將開啟樣版設定，如下圖所示。
- 表格填寫完畢後按 **「Save」** 即可建立新樣版。
:::info
<i class="fa fa-exclamation-circle" aria-hidden="true"></i> **樣版設定欄位說明：**
| 欄位名稱 | 說明 |
|-|-|
| **Path** | 填寫 job script 所在目錄，系統將從此目錄複製 script 建立樣版，若未指定，將使用預設樣板 |
| **Name** | 輸入樣版的名稱，方便日後辨識與套用 |
| **Cluster** | 指定此樣版對應的叢集節點（例如 x86） |
| **Note** | 可選填註解，補充說明此樣版用途 |
:::
**(2) 複製既有樣版（Copy Template）**
- 在樣版列表中選取欲複製的樣版
- 點選 **Copy Template**
- 系統會自動將 Path 欄位帶入原樣版的路徑，使用者可視需求進行修改
- 依據需求更新其他欄位內容，最後點選 **Save** 完成樣版建立
<br>
---
<br>
## Active Job 查詢
讓使用者方便即時檢視目前正在執行的計算工作（Active Jobs），以便掌握任務狀態與資源使用情形。
(1) 點選上方選單 ==**Dashboard → Jobs → Active**==，進入 Active Jobs 頁面。
(2) 進入畫面後，系統將 **列出目前 F1 Cluster 上的所有作業清單**。若同時有大量作業執行中，頁面讀取速度可能稍慢，屬正常現象。
(3) 如僅需查看個人所提交的 Job，可點選右上角 All Jobs 選 **Your Jobs** 選項。
(4) 若需針對特定叢集進行篩選（如：f1-x86），可透過右上角的叢集選單進行切換。
(5) 點擊任務列表中對應的「`>`」符號，可展開查看該 Job 的詳細資訊
<div style="border-bottom: 1px solid #ccc; text-align: center; line-height: 0; margin: 2rem 0;"></div>
