Skip to content

Commit 9f5d1a8

Browse files
committed
docs(sessions): document number-of-sessions option moving into the start button dropdown
Part of the recent main-branch docs catch-up plan (Work Item 8). FR-2324 (#6045) moved the "number of session" input out of the launcher form's Resource allocation step and into the Launch button's dropdown menu ("Launch Multiple Sessions" entry) on the Confirm and Launch step. Single-click on Launch starts one session by default. Changes in session_page.md + sessions_all.md across all 4 languages: - Resource allocation step: removed the legacy "if set greater than 1" bullet about NumberOfSessions. - Confirm and Launch step: documented the Launch button's more (...) dropdown with the "Launch Multiple Sessions" entry and the inline Number-of-sessions input. - Quota :::note about per-keypair concurrency limits. Updated in all 4 languages (en/ko/ja/th) with UI labels verified against resources/i18n. Icon wording corrected to more (`...`) / ellipsis. Screenshot session_start_dropdown.png flagged with TODO.
1 parent ddf7a30 commit 9f5d1a8

8 files changed

Lines changed: 116 additions & 19 deletions

File tree

packages/backend.ai-webui-docs/src/en/session_page/session_page.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,4 +38,12 @@ Additional columns can be shown or specific ones hidden by clicking the 'Setting
3838
From Backend.AI Manager v26.2.0, you can view the detailed scheduling history for each session from the
3939
session detail panel. This helps you understand scheduling decisions, delays, and failures. For more details,
4040
refer to [Session Scheduling History](#session-scheduling-history).
41+
:::
42+
43+
:::note
44+
The **Launch** button on the session launcher creates one session by default.
45+
To launch several sessions with the same configuration in one go, click the
46+
more (`...`) icon next to the **Launch** button to open its dropdown menu and
47+
select **Launch Multiple Sessions**. See [Confirm and Launch](#confirm-and-launch)
48+
for details.
4149
:::

packages/backend.ai-webui-docs/src/en/sessions_all/sessions_all.md

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -145,14 +145,15 @@ refer to the following:
145145
matrix/vector computations involved in machine learning. AI accelerators speed
146146
up training / inference algorithms by orders of magnitude, reducing running
147147
times from weeks to days.
148-
* Sessions: Session is a unit of computational environment that is created
149-
according to a specified environment and resources. If this value is set to a
150-
value greater than 1, multiple sessions corresponding to the resource set above
151-
are created. If there are not enough resources available, requests to create
152-
sessions that cannot be created are put on the waiting queue.
153-
154148
![](../images/launch_session_resource_2.png)
155149

150+
:::note
151+
The **Number of sessions** option is no longer set in this form. To launch
152+
multiple sessions with the same configuration, use the start button's
153+
dropdown menu on the **Confirm and Launch** step. See
154+
[Confirm and Launch](#confirm-and-launch) for details.
155+
:::
156+
156157
* Select Agent: Select the agent to be assigned. By default, the agent is automatically selected
157158
by the scheduler. The agent selector displays the actual amount of available resources for each agent.
158159
Currently, this feature is only supported in single-node, single-container environments.
@@ -228,11 +229,27 @@ If you are done with the network setting, click the 'Next' button below, or
228229
On the last page, users could view information of session(s) to create,
229230
such as environment itself, allocated resources, mount information,
230231
environment variables set on the previous pages, preopen ports, etc.,
231-
Review the settings, users could launch the session by clicking 'Launch' button.
232+
Review the settings, users could launch the session by clicking the 'Launch' button.
232233
Click the 'Edit' button located at the top right of each card to redirect to relevant page.
233234

234235
![](../images/launch_session_confirm.png)
235236

237+
To launch more than one session at once with the same configuration, click the
238+
more (`...`) icon next to the 'Launch' button to open its dropdown menu and
239+
select **Launch Multiple Sessions**. A dialog appears where you can set the
240+
**Number of sessions** to create; each session is created independently with
241+
the resources shown on the form. The single-click 'Launch' action still starts
242+
one session by default.
243+
244+
![](../images/session_start_dropdown.png)
245+
<!-- TODO: Capture screenshot of the start button dropdown showing "Launch Multiple Sessions" -->
246+
247+
:::note
248+
Concurrent session launch is capped by the system; if the requested total
249+
exceeds your remaining session quota, a warning is shown and some sessions may
250+
be queued until resources become available.
251+
:::
252+
236253
If there is an issue with the settings, an error message will be displayed as follows.
237254
Users can edit their settings when this happens.
238255

packages/backend.ai-webui-docs/src/ja/session_page/session_page.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,3 +35,10 @@ Backend.AIにおける`セッション`は、ユーザーが割り当てられ
3535
:::tip
3636
Backend.AI Manager v26.2.0以降では、セッション詳細パネルから各セッションの詳細なスケジューリング履歴を確認できます。これにより、スケジューリングの決定、遅延、失敗の原因を把握できます。詳細については、[セッションスケジューリング履歴](#session-scheduling-history)を参照してください。
3737
:::
38+
39+
:::note
40+
セッションランチャーの**ローンチ**ボタンは、既定で 1 つのセッションを作成します。
41+
同一の設定で複数のセッションを一度に起動するには、**ローンチ**ボタンの隣にある
42+
その他(`...`)アイコンをクリックしてドロップダウンメニューを開き、**複数セッションを起動**
43+
を選択します。詳細は[確認と起動](#confirm-and-launch)セクションを参照してください。
44+
:::

packages/backend.ai-webui-docs/src/ja/sessions_all/sessions_all.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -137,12 +137,15 @@ Backend.AI WebUIで最もよく利用されるページは、「セッション
137137
* AIアクセラレータ: AIアクセラレータ(GPUまたはNPU)は、機械学習に関わる行列/ベクトル演算に適しています。
138138
AIアクセラレータは、トレーニング/推論アルゴリズムを桁違いに高速化し、
139139
実行時間を数週間から数日に短縮します。
140-
* セッション: セッションは、指定された実行環境とリソースに従って作成される計算環境の単位です。
141-
この値を1より大きい値に設定すると、上記のリソースセットに対応する複数のセッションが作成されます。
142-
十分なリソースがない場合、作成できないセッションの作成要求は待機キューに追加されます。
143-
144140
![](../images/launch_session_resource_2.png)
145141

142+
:::note
143+
**セッション数**オプションはこのフォームでは設定しなくなりました。同一の設定で
144+
複数のセッションを一度に起動するには、**確認と起動**ステップにあるスタート
145+
ボタンのドロップダウンメニューを使用します。詳細は[確認と起動](#confirm-and-launch)
146+
セクションを参照してください。
147+
:::
148+
146149
* エージェントの選択: 割り当てるエージェントを選択します。既定では、エージェントはスケジューラーによって自動的に選択されます。
147150
エージェントセレクターには、各エージェントで実際に利用可能なリソース量が表示されます。
148151
現在、この機能はシングルノード、シングルコンテナ環境でのみサポートされています。
@@ -220,6 +223,21 @@ Backend.AI WebUIで最もよく利用されるページは、「セッション
220223

221224
![](../images/launch_session_confirm.png)
222225

226+
同一の設定で複数のセッションを一度に起動するには、「ローンチ」ボタンの隣にある
227+
その他(`...`)アイコンをクリックしてドロップダウンメニューを開き、
228+
**複数セッションを起動**を選択します。ダイアログが表示され、作成する**セッション数**
229+
設定できます。各セッションはフォームに表示されたリソースで独立して作成されます。
230+
「ローンチ」ボタンを単にクリックした場合は、既定で 1 つのセッションのみが起動します。
231+
232+
![](../images/session_start_dropdown.png)
233+
<!-- TODO: Capture screenshot of the start button dropdown showing "複数セッションを起動" -->
234+
235+
:::note
236+
同時セッション起動はシステムによって制限されます。要求された合計が残りのセッション
237+
クォータを超えると警告が表示され、一部のセッションはリソースが確保されるまで
238+
キューに入る可能性があります。
239+
:::
240+
223241
設定に問題がある場合は、次のようにエラーメッセージが表示されます。
224242
この場合、ユーザーは設定を編集できます。
225243

packages/backend.ai-webui-docs/src/ko/session_page/session_page.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,3 +34,9 @@ Backend.AI에서 `세션(session)`은 사용자가 할당된 자원을 사용하
3434
:::tip
3535
Backend.AI Manager v26.2.0부터 세션 상세 정보 패널에서 각 세션의 상세 스케줄링 기록을 확인할 수 있습니다. 이를 통해 스케줄링 결정, 지연, 실패 등을 파악할 수 있습니다. 자세한 내용은 [세션 스케줄링 기록](#session-scheduling-history)을 참고하세요.
3636
:::
37+
38+
:::note
39+
세션 런처의 **시작** 버튼은 기본적으로 한 개의 세션을 생성합니다. 동일한 설정으로
40+
여러 세션을 한 번에 시작하려면 시작 버튼의 드롭다운 메뉴를 열고 **복수 세션 동시 시작**
41+
을 선택합니다. 자세한 내용은 [검토 및 시작](#confirm-and-launch) 섹션을 참고하세요.
42+
:::

packages/backend.ai-webui-docs/src/ko/sessions_all/sessions_all.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,10 +89,14 @@ Backend.AI WebUI 에서 가장 많이 방문하게 될 페이지는 세션 페
8989
* 메모리: 컴퓨터 메모리는 임시 저장 영역입니다. 중앙 처리 장치 (CPU)에 필요한 데이터와 명령들을 보관하는 역할을 합니다. 머신 러닝 워크로드를 처리할 때 GPU를 연산 장치로 사용하는 경우, GPU 메모리의 두 배 이상의 메모리를 할당해야 합니다. 그렇지 않으면 GPU의 유휴 시간이 증가하여 성능이 저하됩니다.
9090
* 공유 메모리: 연산 세션에 할당할 공유 메모리의 용량 (GB). RAM에 설정된 메모리 중 일부를 떼어 공유 메모리로 사용합니다. 따라서, RAM에 지정된 양보다 클 수 없습니다.
9191
* AI 가속기: AI 가속기 (GPU 및 NPU)는 기계 학습과 관련된 행렬 / 벡터 계산에 적합합니다. AI 가속기는 훈련 및 인퍼런스 알고리즘을 몇 배나 가속화하여 기계 학습 워크로드의 실행 시간을 몇 주에서 며칠로 줄입니다.
92-
* 세션: 세션은 지정된 환경과 자원에 따라 생성되는 계산 환경 단위입니다. 이 값을 1보다 큰 값으로 설정하면 위의 자원 설정을 이용한 여러 세션이 지정한 값만큼 동시에 생성됩니다. 세션 시작 요청 시 사용 가능한 자원이 충분하지 않은 경우, 생성하지 못한 세션 시작 요청들은 생성 대기열에 추가됩니다.
93-
9492
![](../images/launch_session_resource_2.png)
9593

94+
:::note
95+
**세션 개수** 옵션은 더 이상 이 폼에서 설정하지 않습니다. 동일한 설정으로 여러
96+
세션을 한 번에 시작하려면 **검토 및 시작** 단계에서 시작 버튼의 드롭다운 메뉴를
97+
사용합니다. 자세한 내용은 [검토 및 시작](#confirm-and-launch) 섹션을 참고하세요.
98+
:::
99+
96100
* 에이전트 선택: 사용자는 할당할 에이전트를 직접 선택할 수 있습니다. 기본적으로는 스케줄러가 에이전트를 자동으로 선택합니다. 에이전트 선택기에서는 각 에이전트의 실제 사용 가능한 자원 양을 확인할 수 있습니다. 현재 이 기능은 단일 노드, 단일 컨테이너 환경에서만 지원됩니다.
97101
* 클러스터 모드: 클러스터 모드를 사용하면 여러 연산 세션을 한 번에 생성할 수 있습니다. 자세한 내용은 [Backend.AI 클러스터 연산 세션 개요](#backendai-cluster-compute-session)를 참고하세요.
98102

@@ -148,6 +152,21 @@ Backend.AI WebUI 에서 가장 많이 방문하게 될 페이지는 세션 페
148152

149153
![](../images/launch_session_confirm.png)
150154

155+
동일한 설정으로 여러 세션을 한 번에 시작하려면 '시작' 버튼 옆의 더보기(`...`)
156+
아이콘을 클릭하여 드롭다운 메뉴를 열고 **복수 세션 동시 시작**을 선택합니다.
157+
대화 상자가 표시되며, 여기서 생성할 **세션 개수**를 설정할 수 있습니다. 각 세션은
158+
폼에 표시된 자원으로 독립적으로 생성됩니다. '시작' 버튼을 단순히 클릭하면 기본
159+
값으로 한 개의 세션만 시작됩니다.
160+
161+
![](../images/session_start_dropdown.png)
162+
<!-- TODO: Capture screenshot of the start button dropdown showing "복수 세션 동시 시작" -->
163+
164+
:::note
165+
동시 세션 생성은 시스템 정책에 의해 제한됩니다. 요청한 총 세션 수가 남은 동시 세션
166+
할당량을 초과하는 경우 경고가 표시되며, 일부 세션은 자원이 확보될 때까지 대기 상태로
167+
유지될 수 있습니다.
168+
:::
169+
151170
설정에 문제가 있는 경우, 다음과 같이 오류가 표시됩니다. 설정을 수정하려면 '수정' 버튼을 클릭하십시오.
152171

153172
![](../images/launch_session_error_card.png)

packages/backend.ai-webui-docs/src/th/session_page/session_page.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,3 +34,10 @@
3434
:::tip
3535
ตั้งแต่ Backend.AI Manager v26.2.0 เป็นต้นไป สามารถดูประวัติการจัดตารางโดยละเอียดสำหรับแต่ละเซสชันได้จากแผงรายละเอียดเซสชัน ฟีเจอร์นี้ช่วยให้เข้าใจการตัดสินใจในการจัดตาราง ความล่าช้า และความล้มเหลว สำหรับรายละเอียดเพิ่มเติม โปรดดูที่[ประวัติการจัดตารางเซสชัน](#session-scheduling-history)
3636
:::
37+
38+
:::note
39+
ปุ่ม **เริ่ม** ที่ตัวเริ่มเซสชันจะสร้างเพียงหนึ่งเซสชันตามค่าเริ่มต้น
40+
หากต้องการเริ่มหลายเซสชันด้วยการตั้งค่าเดียวกันในคราวเดียว ให้เปิดเมนูดรอปดาวน์
41+
ของปุ่มเริ่มแล้วเลือก **เริ่มหลายเซสชัน** ดูรายละเอียดได้ที่
42+
[ยืนยันและเปิดใช้งาน](#confirm-and-launch)
43+
:::

packages/backend.ai-webui-docs/src/th/sessions_all/sessions_all.md

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -127,14 +127,15 @@
127127
หน่วยความจำ GPU มิฉะนั้น เวลาว่างของ GPU จะเพิ่มขึ้น ส่งผลให้ประสิทธิภาพลดลง
128128
* หน่วยความจำที่แชร์: ปริมาณหน่วยความจำที่แชร์ในหน่วย GB ที่จะจัดสรรสำหรับเซสชันการคำนวณ หน่วยความจำที่แชร์จะใช้บางส่วนของหน่วยความจำที่ตั้งค่าใน RAM ดังนั้นจึงไม่สามารถมากกว่าปริมาณที่ระบุใน RAM ได้
129129
* AI Accelerator: AI accelerator (GPU หรือ NPU) เหมาะสำหรับการคำนวณเมทริกซ์/เวกเตอร์ที่เกี่ยวข้องกับการเรียนรู้ของเครื่อง AI accelerator เร่งความเร็วอัลกอริธึมการฝึกอบรม / การอนุมานโดยมาก ทำให้เวลาในการประมวลผลลดลงจากหลายสัปดาห์เหลือไม่กี่วัน
130-
* เซสชัน (Sessions): เซสชันเป็นหน่วยของสภาพแวดล้อมการคำนวณที่ถูกสร้างขึ้น
131-
ตามสภาพแวดล้อมและทรัพยากรที่ระบุ หากค่านี้ถูกตั้งค่าเป็นค่า
132-
ที่มากกว่า 1 จะมีการสร้างเซสชันหลายรายการตามชุดทรัพยากรที่ตั้งค่าไว้ข้างต้น
133-
หากมีทรัพยากรที่พร้อมใช้งานไม่เพียงพอ คำขอสร้างเซสชันที่ไม่สามารถสร้างได้
134-
จะถูกใส่ไว้ในคิวรอ
135-
136130
![](../images/launch_session_resource_2.png)
137131

132+
:::note
133+
ตัวเลือก **จำนวนเซสชัน** ไม่ได้ถูกตั้งค่าในฟอร์มนี้อีกต่อไป หากต้องการเริ่ม
134+
หลายเซสชันด้วยการตั้งค่าเดียวกันในคราวเดียว ให้ใช้เมนูดรอปดาวน์ของปุ่มเริ่ม
135+
ในขั้นตอน **ยืนยันและเปิดใช้งาน** ดูรายละเอียดได้ที่ส่วน
136+
[ยืนยันและเปิดใช้งาน](#confirm-and-launch)
137+
:::
138+
138139
* เลือกเอเจนต์ (Select Agent): เลือกเอเจนต์ที่จะมอบหมายให้ โดยค่าเริ่มต้น เอเจนต์จะถูกเลือกโดยอัตโนมัติ
139140
โดยตัวจัดตาราง ตัวเลือกเอเจนต์จะแสดงปริมาณทรัพยากรที่ใช้งานได้จริงสำหรับแต่ละเอเจนต์
140141
ปัจจุบัน ฟีเจอร์นี้รองรับเฉพาะในสภาพแวดล้อมโหนดเดียว คอนเทนเนอร์เดียวเท่านั้น
@@ -215,6 +216,20 @@
215216

216217
![](../images/launch_session_confirm.png)
217218

219+
หากต้องการเริ่มหลายเซสชันพร้อมกันด้วยการตั้งค่าเดียวกัน ให้คลิกไอคอนเพิ่มเติม (`...`)
220+
ถัดจากปุ่ม 'Launch' เพื่อเปิดเมนูดรอปดาวน์ แล้วเลือก **เริ่มหลายเซสชัน**
221+
กล่องโต้ตอบจะปรากฏขึ้นเพื่อให้คุณกำหนด **จำนวนเซสชัน** ที่จะสร้าง โดยแต่ละเซสชัน
222+
ถูกสร้างขึ้นอย่างอิสระด้วยทรัพยากรที่แสดงในฟอร์ม การคลิกปุ่ม 'Launch' เพียงครั้งเดียว
223+
จะเริ่มเซสชันเพียงหนึ่งเซสชันตามค่าเริ่มต้น
224+
225+
![](../images/session_start_dropdown.png)
226+
<!-- TODO: Capture screenshot of the start button dropdown showing "เริ่มหลายเซสชัน" -->
227+
228+
:::note
229+
การเปิดเซสชันพร้อมกันถูกจำกัดโดยระบบ หากจำนวนรวมที่ขอเกินโควตาเซสชันที่เหลืออยู่
230+
จะมีคำเตือนปรากฏขึ้นและบางเซสชันอาจถูกจัดคิวจนกว่าจะมีทรัพยากรพร้อมใช้งาน
231+
:::
232+
218233
หากมีปัญหากับการตั้งค่า จะมีข้อความแสดงข้อผิดพลาดปรากฏขึ้นดังต่อไปนี้
219234
ผู้ใช้สามารถแก้ไขการตั้งค่าของตนได้เมื่อสิ่งนี้เกิดขึ้น
220235

0 commit comments

Comments
 (0)