Open OnDemand User'sGuide

TSUBAME Computing Services, Global Scientific Information and Computing Center
2024-10-10

Open OnDemand User's Guide

Table of contents

1. Introduction

3

1.1. Overview of Open OnDemand3

2. How to login

42.1. Get a TSUBAME account4

2.2. How to login to Open OnDemand4

3. Operation of Open OnDemand8

3.1. Screen layout and menu bar

8

3.2. Interactive Apps

12

Revision History

20- 2/20 -2024-10-10

Open OnDemand User's Guide

1. Introduction
This document describes Open OnDemand implemented in TSUBAME4.0.
Open OnDemand makes it easier than ever to use TSUBAME.

1.1. Overview of Open OnDemand
Open OnDemand (OOD) is a web browser-based portal site that makes supercomputers readily available.
Conventional supercomputers require terminal-based command operations using SSH, knowledge of public key cryptography, and SSH key creation
and registration.
Open OnDemand is web-based, so that making it easy for anyone to start using a supercomputer.

- 3/20 -2024-10-10

Open OnDemand User's Guide

2. How to login
2.1. Get a TSUBAME account
A TSUBAME account is required to use Open OnDemand.
If you do not have an account, please apply for one here.

2.2. How to login to Open OnDemand
2.2.1. 1 TSUBAME password setting in TSUBAME Portal
Before using Open OnDemand, please set your TSUBAME password on TSUBAME Portal.
Please refer to here for TSUBAME password setting on TSUBAME portal.

2.2.2. 2 Login to Open OnDemand
When you use Open OnDemand, access below using Web browser.
https://ood.t4.gsic.titech.ac.jp/

Enter your TSUBAME account and TSUBAME password in Username and Password, respectively, and press Sign In.

An e-mail with an access code will be sent to your e-mail address registered on the TSUBAME Portal.

- 4/20 -2024-10-10

Open OnDemand User's Guide

Copy the number in the Access code, paste it into the space below, and press Submit.

Info
After a certain period of time, the access code will become invalid. In this case, press "resend code" to reissue the access code.

After successful login, the dashboard will appear.

- 5/20 -2024-10-10

Open OnDemand User's Guide

If you see the error shown below or cannot log in, please access the URL on the top page or dashboard.

OOD Top pagehttps://ood.t4.gsic.titech.ac.jp/- 6/20 -2024-10-10

Open OnDemand User's GuideOOD Dashboard
https://ood.t4.gsic.titech.ac.jp/pun/sys/dashboard- 7/20 -2024-10-10

Open OnDemand User's Guide

3. Operation of Open OnDemandThis section describes how to use Open OnDemand.

3.1. Screen layout and menu bar
This section explains how to use the menu bar at the top of the screen.

3.1.1. File operations
Select Home Directory from Files on the menu bar to display TSUBAME's home directory.

Standard file operations can be performed from the buttons on the screen.

- 8/20 -2024-10-10

Open OnDemand User's Guide

ButtonOperation

Description

Open in Terminal

Terminal

Open TSUBAME terminal with a new tab

RefreshRefreshRefresh directory

New File

File

Create new file

New Directory

Directory

Create new directory

UploadUploadUpload a file

Download

Download

Download selected file(s)Copy/Move

Copy/Move

Copy/Move selected file(s)DeleteDeleteDelete selected files(s)Change directry

Directory

Change directory↑DirectoryMove up to the parent directory

Copy pathPath

Copy current directory's path

3.1.2. Login to TSUBAME
Selecting "Clusters > TSUBAME cluster Shell Access", you can login to TSUBAME with. Multiple terminals can be opened.

- 9/20 -2024-10-10

Open OnDemand User's Guide

To log out of TSUBAME and exit the terminal, type exit and close the browser tab.

Tips
The terminal will automatically disconnect after a certain period of inactivity. Please click here for a workaround. Session suddenly disconnected whileworking on TSUBAME4.0

3.1.3. Interactive Apps
For Interactive Apps, lease refer to 3.2. Interactive Apps.

- 10/20 -2024-10-10

Open OnDemand User's Guide

3.1.4. Sessions
My Interactive Sessions can display own sessions.

Press Delete for each session to exit the session.

Tips
When the browser is narrower, the My Interactive Sessions string in the menu bar disappears, leaving only the icon display.

3.1.5. Help and RestartPress Help for manual display and refresh.

If you have problems with Open OnDemand, try Restart Web Server first.

- 11/20 -2024-10-10

Open OnDemand User's Guide

3.1.6. Logout
To log out of Open OnDemand, press Log Out on the menu bar.

Warnning
If you close your browser without pressing Log Out, your Open OnDemand session will remain open for a certain amount of time. If you close your browser
without pressing Log Out, your Open OnDemand session will remain for a certain period of time, which may cause problems when you try to log in to Open
OnDemand again.

3.2. Interactive Apps
The following three Interactive Apps are available for Open OnDemand in TSUBAME4.0.
• TSUBAME Desktop (xfce)• Jupyter• code serverInteractive Apps are further divided into two types according to execution type.
• Use normal compute nodes• Use a dedicated queue for interactive jobs (* interactive is included in the name)
Differences by execution type are as follows
Execution type

Use normal compute

Use Interactive job queue

nodes
Mode of Use

onerousFree on-campus use , onerous

Resource typeselectable

Interactive job queue only (Assigned resources number of physical CPU cores 24 cores,
96GB memory, 1MIG, but up to 12 people share the same resources.)

Number of nodes

selectable

1 node only

Premium Options

available

not available

Reservingavailable

not available

Below are the instructions for using Interactive Apps.

InfoThe screenshots shown here are for "TSUBAME Desktop (xfce)".
There is no difference in the settings depending on the application, so please read them accordingly.

- 12/20 -2024-10-10

Open OnDemand User's Guide

3.2.1. Selecting the application/execution type
From Pinned Apps at the bottom center of the screen, click the icon for the application you wish to use.

Go to the environment setting screen.

3.2.2. Environment setting
Set up the environment items and click the Launch button. The request is submitted as a job.

- 13/20 -2024-10-10

Open OnDemand User's Guide

Catption

ItemDescription

Select resouce type

Resource type

Select required resource type

Number of Request resources

numberRequired node number

TSUBAME group

group

Select TSUBAME group

Maximum run time(hh:mm:ss)

durationSet the maximum value for the scheduled usage time (can be terminated midway)

Priority Option

priority

Priority

Reservation Number (AR ID)

ARIDSpecify the reservation number (AR ID) when using a reservation

Info
When using Interactive job queue, "TSUBAME group" and "Maximum run time" can only be set.

Info
Interactive job queue is available free of charge only for intramural users (tgz-edu) and access card users.
To use Interactive job queue free of charge, please specify “Free” in the “TSUBAME group” field.
Please note that if you specify a group, you will be charged for the target group.

Tips
The only resource types for which reservations can be used are node_f, node_h, node_q, and node_o.

- 14/20 -2024-10-10

Open OnDemand User's Guide

3.2.3. Launching Applications
The request is submitted as a job, and when the specified resource is allocated, the session is set to Running.
If it is Queued, it is waiting to be executed, so wait a while before checking the status.

Once the session is Running, click “Launch app name” to launch the application.

InfoCompression” and ‘Image Quality’ are only displayed in TSUBAME Desktop (xfce).

InfoPressing View Only (Share-able Link) opens a copy of the X desktop in a new tab.
You will not be able to control the screen, but you will see a mirrored display of the previous desktop.
By sending the URL of this tab via e-mail or other means, you can simply share or monitor the screen.

- 15/20 -2024-10-10

Open OnDemand User's Guide

Below are the initial screens of each application (there is no difference depending on the execution type).
Please refer to the official website for details on how to use these applications.

- 16/20 -2024-10-10

Open OnDemand User's Guide• TSUBAME Desktop (xfce)

official website : https://www.xfce.org/?lang=en• Jupyterofficial website : https://jupyter.org/- 17/20 -2024-10-10

Open OnDemand User's Guide• code server

official website : https://coder.com/docs/code-server

3.2.4. Deleting a session
To exit the X desktop, close the browser tab and Delete the session from the session list. Once closed, the session will be marked as Completed.
The session will also be marked as Completed when the specified usage time has elapsed.
Sessions that have been marked as Completed will be automatically deleted from the list after a certain period of time.
If you want to delete a session immediately, press Delete.

- 18/20 -2024-10-10

Open OnDemand User's Guide- 19/20 -2024-10-10

Open OnDemand User's Guide

Revision History
Date

Change2024/05/02

First edition

2024/09/11

Add code server- 20/20 -2024-10-10