TSUBAME Portal User's
Guide

TSUBAME Computing Services, Global Scientific Information and Computing Center
2024-09-30

TSUBAME Portal User's Guide

Table of contents

1. Introduction

4

1.1. How to access4

1.2. E-mail4

1.3. Screen layout

4

2. User registration

6

2.1. Register a user in the university

6

3. Login to the TSUBAME portal

8

3.1. Login via the Tokyo Tech portal (Tokyo Tech users only)

8

3.2. Login using one-time URL

8

4. Agreement to the Terms of Use

94.1. List of Terms of Use

94.2. Agreement to the Terms of Use

10

5. Management of user information

11

5.1. User information

11

5.2. SSH public key registration

12

5.3. How to set TSUBAME password

13

6. Management of TSUBAME group15

6.1. Create a group15

6.2. TSUBAME main use field setting

17

6.3. Managing group members

17

7. Management of payment codes27

7.1. Payment code availability period

27

7.2. Payment code expiration date27

7.3. Approval by the budget manager (Confirmation)

28

7.4. Set payment code to group

32

8. Management of TSUBAME points

34

8.1. Points available for purchase and validity period

35

8.2. Point purchase35

8.3. Check point purchase history

35

8.4. Check point usage

36

9. Compute Nodes Reservation

38

9.1. Node reservation method

38

9.2. Cancel reservation

41

9.3. Check reservations

43

9.4. How to use reserved nodes46- 2/71 -2024-09-30

TSUBAME Portal User's Guide

10. Management of Group Disk

48

10.1. Group disk capacity48

10.2. The validity period of the group disk

49

10.3. Increase or decrease group disk capacity49

10.4. Confirmation of group disk usage52

11. Check usage54

11.1. Check job status

54

11.2. Job search options

56

12. Management of TSUBAME usage report

57

12.1. Submit usage report

57

12.2. View and update usage reports

60

13. Application Activation

63

14. Application Distribution for Labs

66

15. Subscription

67

16. Web application funtion

69

Appendix.

70

Appendix.1. Query70

Appendix.2. Site information

70

Revision history71- 3/71 -2024-09-30

TSUBAME Portal User's Guide

1. Introduction
This document describes how to operate the portal site, which is the first thing you need to know when using TSUBAME 4.0.
The TSUBAME Portal allows you to manage user authentication, user groups and TSUBAME points for the use of various computing resources.

Info
In this manual, portal refers to the TSUBAME Portal, except where it is explicitly indicated as the Tokyo Tech Portal below.

1.1. How to access
The portal can be connected at the following URL
https://portal.t4.gsic.titech.ac.jp
Make sure it is protected by SSL.
Access to the portal requires a TSUBAME account in advance. To create an account, please click here.

1.2. E-mailThe portal uses e-mail to authenticate and authorise users and for various notifications. All e-mails are digitally signed with S/MIME fromportal@t4.gsic.titech.ac.jp . Please do not open emails that are not digitally signed or that have been improperly digitally signed, as they are

dangerous.

1.3. Screen layout
The portal's screens consist of a header, a menu and an operation screen.

- 4/71 -2024-09-30

TSUBAME Portal User's Guide

No.

Name

Description(1)

Header

A logout button and a language switch button are located.
The language can be selected between Japanese and English.

(2)

Side Menu

A list of functions is displayed. Select the menu for the function you want to use and theoperating screen will move to the screen for that function.

(3)

Operation screen

This is the area where operations are performed for the functions selected in the side menu.
The top page displays announcements from the Global Scientific Information and Computing
Center(GSIC).

- 5/71 -2024-09-30

TSUBAME Portal User's Guide

2. User registration
In order to use TSUBAME, you need to obtain an account. Students, faculty, and staff enrolled at Tokyo Tech can automatically obtain an accountthrough the Tokyo Tech Portal. Other off-campus users and those with special status at Tokyo Tech will have their accounts created and notified by
the person in charge at the Global Scientific Information and Computing Center(GSIC). For more information, please see How to apply for a TSUBAME
account in TSUBAME Computation Service.

2.1. Register a user in the university
After login to Tokyo Tech Portal, access to the portal using menu.
If an account has not been obtained in the past, you will automatically be redirected to the Create Account screen. If you have already registered foruse, the top screen of the portal will be displayed.

The information already registered on the Tokyo Tech Portal will be automatically entered in your account registration details.Fill in the blanks andclick the "Confirm Application Details" button. Fields marked with * are required fields.
Click the "Confirm Registration" button to display the "Confirm New Application" page.
After confirming the contents, please press the "Apply" button. Your application will be reviewed and if it passes the review, your account will be
registered.

- 6/71 -2024-09-30

TSUBAME Portal User's Guide

If the GSIC staff determines that approval is required, the GSIC staff will decide whether or not to approve the application, and if approved, theapplication will be registered.

Note
As described in Getting Accounts page, holders of an access card have to submit certificates to GSIC to make your account approved.

When an account is registered on the portal, an email notification is sent to the user informing them that their registration is complete and providing alogin name. After receiving the email notification, the user can access the login screen of the portal and enter the account name to log in.

- 7/71 -2024-09-30

TSUBAME Portal User's Guide

3. Login to the TSUBAME portal
There are two ways to login to the portal: via the Tokyo Tech portal (Tokyo Tech users only) or using a one-time URL.

3.1. Login via the Tokyo Tech portal (Tokyo Tech users only)
You can log in to the TSUBAME portal via the TSUBAME portal link on Tokyo Tech portal.

3.2. Login using one-time URL
When you access the portal, the "Login" page is displayed.

Enter your login name in "TSUBAME Login Name" and click the "Send Mail" button. An email with a one-time login URL will be delivered to the email
address registered in the TSUBAME portal.
The emails are from portal@t4.gsic.titech.ac.jp and have a digital signature. Please check that the sender is correct before using the URL in theemail.

- 8/71 -2024-09-30

TSUBAME Portal User's Guide

4. Agreement to the Terms of Use
To use TSUBAME 4.0, you may need to agree to the terms. The terms of use have an application start date, and if you do not agree with the terms
even after the application start date, some of the portal functions related to paid services will be deactivated.

4.1. List of Terms of Use
If you have unsolicited terms and conditions, a list of terms and conditions will be displayed immediately after logging into the system. You can checkthe contents of the terms of use by selecting the link for the terms of use.

By selecting each term from the list, you can see the details.

- 9/71 -2024-09-30

TSUBAME Portal User's Guide

4.2. Agreement to the Terms of Use

After confirming the terms and conditions, select the "Agree" button or the "Ignore" button.

Warning
If the contract application start date is reached without consenting to the terms of service, TSUBAME group points cannot be purchased, group disk
capacity can be changed, and node reservation operations will be disabled. If you log in to the TSUBAME portal and agree to the terms and conditions thatyou have not agreed to, the restriction will be eliminated.

- 10/71 -2024-09-30

TSUBAME Portal User's Guide

5. Management of user information
In this part, you can manage user information registered to TSUBAME. You need to prepare before using TSUBAME for the first time.

5.1. User information
Log in to the system and select "Change user information" link from the side menu, the "User information change" page will be displayed.

In this screen, you can refer / edit information on "user."- 11/71 -2024-09-30

TSUBAME Portal User's Guide

5.2. SSH public key registration
Warning• Please secure your SSH private key, with setting the passphrase to lock them.
• Do not register SSH public key corresponding to the private key which is not made by you, or is not managed correctly, such as the public key of otherpeople.

Info
TSUBAME4.0 login node cannot connect with RSA key (SHA-1) which has short key length. ecdsa key or ed25519 key is recommended for SSH key pair.

To access the login node, you need to upload the SSH public key used for login. Please prepare an SSH public key in advance. See the FAQ below for
how to create an SSH public key.
• How to create an SSH key pair in Linux/Mac/Windows(Cygwin/OpenSSH)• I'm using PuTTY(MobaXterm), What do we need to register at SSH public key in TSUBAME portal?
From the side menu, choose "Add SSH public key."

Copy and paste the contents of the public key with text and click "Add" button, or upload the file from "SSH public key file" and click "Upload".

- 12/71 -2024-09-30

TSUBAME Portal User's Guide

Warning• The file you need to paste or upload is an SSH public key. Never specify an SSH private key.
• The SSH public key registered by this function is additionally registered in the TSUBAME public key list. Already registered public key is not invalidated.
• In order to delete a registered public key, please login to TSUBAME, then edit .ssh/authorized_keys under the home directory, and delete it.

When the "Upload" button is clicked, the SSH public key is set and SSH login to TSUBAME is enabled.

5.3. How to set TSUBAME password
Set passwords here for TSUBAME storage (Fast Storage Area, Big Storage Area, and Home Directory) to be used for CIFS access from terminals
within the university.

Info
The TSUBAME password is used for the following purposes. If you do not use it for these purposes, you do not need to set a password.
- Use of Open OnDemand- CIFS access from on-campus terminals- ssh access from On-campus exercise room terminals

Login to the TSUBAME portal and choose "Password setting" from the side menu, the "Password setting" page will be displayed.

- 13/71 -2024-09-30

TSUBAME Portal User's Guide

If you enter a new password here and click "Register", the password will be set.
The password conditions are as follows.
• String length : 8 to 63 letters• It must contain at least 3 types of alphabet capital letters, alphabet lowercase letters, numbers and symbols.
• The following character strings can be used for the password.
• Uppercase Latin alphabet: A to Z
• Lowercase Latin alphabet: a to z
• Numbers: 0 to 9
• Symbolic letters: #.$*_-=• Do not include any three consecutive letters included in the numeric part of login name, surname, name, HPCI account name, HPCI-ID.
• It should not be an easy-to-guess character string such as English words.
• Do not use the same letters consecutively three times or more.
• Do not use the same character more than half the password length.
You can also change the password in the same way.

- 14/71 -2024-09-30

TSUBAME Portal User's Guide

6. Management of TSUBAME group
You can create a group in TSUBAME and manage members and resources. Users must be associated with a group to use paid services.
To perform basic operations, choose "Manage your group" from the side menu to show the "Groups list" page.

6.1. Create a group
Tips
TSUBAME group can be created only by Tokyo Tech users.

Click "Group creation" to show the "New TSUBAME group addition" page.

- 15/71 -2024-09-30

TSUBAME Portal User's Guide

Enter the necessary information and click the "Add" to create the group.
Items to enter when creating a group are as follows.
Item

Description

Group manager

The account name of the administrator when creating the group is displayed.
When creating a group, the creator is set as the group administrator.

Group division

Select the classification of the group to be created from the pulldown.

Group nameEnter the group name. The group name prefix is set automatically by the selected group classification.

Comment

Optionally provide comments about the group to be created.

The group name length is limited to 32 characters, including the prefix depending on the selected group division. The following character types areallowed for the group name. (Multi-byte characters and blanks can not be used.)• Uppercase alphabet: A ~ Z• Lowercase alphabet: a ~ z• Numbers: 0 ~ 9• Symbolic character: _-- 16/71 -2024-09-30

TSUBAME Portal User's Guide

6.2. TSUBAME main use field setting
Warning
You cannot use the "Point purchase" feature without setting the main use field.

The main use field can be selected on the "TSUBAME group details" page.

After selecting the appropriate field from the combo box displayed as "Please set the field of use" in the "Main use field" item on the "TSUBAME groupdetails", and click "Setting" to set the Main use field.

6.3. Managing group members
グループ構成者の管理は、「TSUBAMEグループ詳細」画面にて行います。この画面は、左のメニューバーの「所属グループ管理」を選択、所属グ
ループ一覧画面の対象グループ「詳細表示」リンクを選択することで表示されます。

- 17/71 -2024-09-30

TSUBAME Portal User's Guide

Tips
Only group managers can manage group members.

6.3.1. Invite group members
Group members can be invited from the "Members information" menu on the "TSUBAME group details" page.

When you click "User addition" at the bottom of the "TSUBAME group detailed" page, the "TSUBAME group invitation of users" page will be displayed.

- 18/71 -2024-09-30

TSUBAME Portal User's Guide

Add the account of the member you want to add to the group and click "Search".
The items listed in "TSUBAME group invitation of users" are as follows.
Item

Description

Login nameEnter the login name of the user you want to invite and search for by exact match.

BrowseSpecify a file in which account names are separated by line feeds then click "Search".

SearchSearch for the user corresponding to the specified login name and display the results in the search result column.

Search result

Display a list of users found by the search.
A checkbox will appear in the leftmost column, so check the boxes for the users you wish to invite.

Invite checked users

Invite users who have the checkbox ON in the search result to the group.

Click the checkboxes of users you want to invite from the search results at the bottom of the page. By clicking "Invite the selected user", an invitation
email will be sent to the selected user. When users accept the invitation, they are added to the list of group members.

- 19/71 -2024-09-30

TSUBAME Portal User's Guide

6.3.2. Join the group
Users who are invited to join the group will receive an invitation email, as shown below.
このメールは送信専用メールアドレスから配信されています。
問い合わせは https://www.t4.gsic.titech.ac.jp/contact-t4 にお送りください。
山田太郎 様
東工大 様より、TSUBAMEグループ tga-group001 への参加を招待されております。
次のステップに従って、グループに参加するかどうかをお選びください。
1. TSUBAMEポータルにログインする
2. 下記のURLをクリックして、表示される画面に従って設定する
https://portal.t4.gsic.titech.ac.jp/t4po/invitegroup/RexUtqeiYlDhVCoTnSK2GSvTw921biJo8-n5sJQ3cAm2
上記URLの有効期限は1週間です。
有効期限が切れた場合や、誤って不参加を選択した場合には、グループの管理者に連絡して再招待を依頼してください。
----This mail is sent from send-only address.
For inquiry, please visit https://www.t4.gsic.titech.ac.jp/en/contact-t4 .
To 山田太郎
You have been invided to join the TSUBAME group tga-group001 from 東工大 .
Please follow the steps to choose whether or not to join the group.
1. Log in to the TSUBAME portal
2. Click the following link and follow the instruction
https://portal.t4.gsic.titech.ac.jp/t4po/invitegroup/RexUtqeiYlDhVCoTnSK2GSvTw921biJo8-n5sJQ3cAm2
This URL is valid for one week.
If the link is expired, or you declined by mistake, ask the group manager to resend the invitation.
-TSUBAME計算サービス / TSUBAME Computing Services
https://www.t4.gsic.titech.ac.jp
https://portal.t4.gsic.titech.ac.jp

When you click on the URL in the invitation email, the "Grup invitation approval page" will be displayed. Agree to the contents of the two checkboxeson the approval page, check the boxes and click the "Participate".

6.3.3. Remove a member from a group
Log in to the TSUBAME portal and select "Manage your group" from the side menu to show the "Groups list" page. Click on the "Detailed display" linkof the group whose group members you want to delete, and go to the "TSUBAME group details" page. The current group members are displayed in alist at the bottom of the page. Click the checkboxes of the users you want to delete and click "User deletion".

- 20/71 -2024-09-30

TSUBAME Portal User's Guide

A confirmation dialog box will be displayed. Click "OK" to delete the user from the group.

An email will be sent to the deleted user.

6.3.4. Appointment of Group manager
A Group manager can be appointed from the Members information menu on the "TSUBAME group details" page to delegate part of authority andresponsibility for the group.

Tips
The contents that the Group manager can manage are as follows• Compute node reservation• Manage group disks• Manage group members• Purchase points• Purchase applications

After selecting the group member you want to promote to the Group manager, click the "Group Manager appointment". The specified group member
will be promoted to the Group manager.

- 21/71 -2024-09-30

TSUBAME Portal User's Guide

6.3.5. Application for change of Group manager
When changing the Group manager to another user, the new Group manager must agree to the transfer. Approval by GSIC is also required.
On the "TSUBAME roup Details" page, check that the current Group manager is yourself.

Click the "Manager change" on the right-hand side, and you will be taken to the "TSUBAME group manager change" page.

- 22/71 -2024-09-30

TSUBAME Portal User's Guide

Select the login name of the new Group manager and click the "Change" to proceed to the confirmation page.

- 23/71 -2024-09-30

TSUBAME Portal User's Guide

After reading the cautionary notes, click the checkbox that confirms your agreement, followed by "Group manager change." If there is something youneed to tell GSIC or the new Group manager, do so in the relevant text box. Click "Group manager change" and the following approval request email
will be sent to the new Group manager candidate.
このメールは送信専用メールアドレスから配信されています。
問い合わせは https://www.t4.gsic.titech.ac.jp/contact-t4 にお送りください。
東工大太郎 様グループtga-group001 のグループ管理者変更の承認を下記のURLより行ってください。

- 24/71 -2024-09-30

TSUBAME Portal User's Guide

https://portal.t4.gsic.titech.ac.jp/ptl/changemanager/gyNAjoAp9F0tKjWm9ke-IQomtOFhuhXv-b9q22ypnzBy----This mail is sent from send-only address.
For inquiry, please visit https://www.t4.gsic.titech.ac.jp/en/contact-t4 .
To 東工大太郎
Please approve the change of the group manager of the group tga-group001 from the URL below.

https://portal.t4.gsic.titech.ac.jp/ptl/changemanager/gyNAjoAp9F0tKjWm9ke-IQomtOFhuhXv-b9q22ypnzBy-TSUBAME計算サービス / TSUBAME Computing Services
https://www.t4.gsic.titech.ac.jp
https://portal.t4.gsic.titech.ac.jp

The user designated as the new Group manager can click the URL in the email to open the "TSUBAME group manager change" page.

- 25/71 -2024-09-30

TSUBAME Portal User's Guide

After reading the cautionary notes, click the checkbox that confirms your agreement, followed by "Group manager change" to complete theapplication. After approval by GSIC, authority will be transferred from the current Group manager to the new Group manager.

Tips
In the following cases, authority is transferred immediately after approval by the new group manager:• the Tokyo Tech IC card type of the new Group manager is staff (full time or part time).
• the Tokyo Tech IC card type of the new Group manager is other than the above and following conditions are met• The new group manager has an active payment code for the current fiscal year and is the budget manager of that payment code
• The target group has not purchased any points during the current fiscal year.

- 26/71 -2024-09-30

TSUBAME Portal User's Guide

7. Management of payment codes
Tips
This function is provided only for Tokyo Tech users.

A Payment code is required to purchase TSUBAME points required for using paid services.

Warning
Payment codes are only required for the Group manager.
The only payment codes that can be set for a group are those applied for by the group manager.
Payment codes applied by anyone other than the Group manager cannot be used.
Students cannot manage payment codes other than the budgets for which they are responsible.

7.1. Payment code availability period
There is a billing deadline that depends on the budget category. We restrict new purchases of TSUBAME points close to the deadline to ensure thebilling process (e.g., totaling) is completed in time.
If your budget category is other than Institutional Operating Expense Funds(法人運営費) or Donations for Education and Research(奨学寄附金), thepayment code can only be used within a new billable period that satisfies the following criteria:• Is within a research period• Is before the date described below:• If the last billable date is set and is the last day of the month, the last day of the previous month prior to the last billable date.
• If the last billable date is set and is not the last day of the month, the last day of the month two months before the last billable date.
• If the last billable date is not set, the same date above calculated using the end of the research period instead.
• Is before December 31st of every fiscal year

Warning
Regarding Institutional Operating Expense Funds and Donations for Education and Research, purchases of TSUBAME Points from January to March will
be paid from the same budget for the following year.

7.2. Payment code expiration date
All payment codes will become invalid at the end of the fiscal year.
From mid-March, we will begin accepting applications for payment codes for the following fiscal year. Payment codes applied for in advance will beheld until the start date of the next fiscal year, following approval by GSIC and the budget supervisor (required if the budget manager is different). The
code will become available from the start date of the new fiscal year and can then be assigned to groups, used to purchase points, etc.

- 27/71 -2024-09-30

TSUBAME Portal User's Guide

April 2019

Mid March 2020

April 2020

Fisical year 2019

paymento code
(For FY2019)

Usage period

Payment code
(For FY 2019)

Fisical year 2020

Can not carry forward to
the following year
prior application period

Usage period

When applications for payment codes for the next fiscal year become available, a checkbox for the next fiscal year will appear at the year of use on
the "New payment code application" screen. If you want to apply for a payment code for the following fiscal year in advance, click the checkbox.

7.3. Approval by the budget manager (Confirmation)
Info
Grants-in-Aid for Scientific Research(科研費) has four different budget codes for each category, and TSUBAME's computer usage fee is classified as"Others(その他)". (Correnponding to "Facility and equipment usage fee in the research organization(研究機関内の施設・設備使用料)" in the Table ofexpense categories shared by ministries and agencies(府省共通経費取扱区分表))
Please note that applications for payment codes for expenses other than "Others(その他)" will be rejected as an incorrect expense category.

The process for payment code application is as follows.

- 28/71 -2024-09-30

TSUBAME Portal User's Guide

Net Payment code
application

rejection

Confirmation and approvalof System Administrator

Approval
rejection[Budget manager] NO
Approval of application(Confirmation)

Are the applicant andthe budget manager
the same person

YES
Approval
Payment code
unavailable

Payment code
available

You can use the "Payment code control" screen by choosing "Manage payment code" from the side menu.

Click the "New payment code request" to show the "Request for payment code" screen.

- 29/71 -2024-09-30

TSUBAME Portal User's Guide- 30/71 -2024-09-30

TSUBAME Portal User's Guide

The following items are to be completed:
Item

Description

Payment code

Enter the payment code, if necessary.
If you specify "Auto" in the radio button, the name of the payment code combined with the "Budget Name" will be
generated automatically. When "Input" is specified, any payment code can be specified in the text box.

Budget classification

Please select the category of the budget to be applied for.(reference:学内予算の種類について Limited to Tokyo
Tech)

Budget code

Please follow the steps below to obtain the budget code and budget name for your payment code application

Budget name・Log in to "新物品等請求システム"・Select "予算管理"
・Select "予算執行状況確認"
・Select "CSV作成"
・ranscribe "予算コード"(Budget Code) (32 digits) and "予算名称"(Budget Name) in the output CSV file.
Please use the above method to obtain the budget code because the number of digits in the budget code is large
and the beginning and end of the code may be cut off when copying and pasting the display on the system.

Badget department

Chose one from pulldown menu.

Comment

Enter any comments you need to manage your payment code.

Research period

Depending on the budget category, you may be required to enter a research period. If the research period start dateis earlier than the current fiscal year, enter April 1 of the current fiscal year as the start date. The start date of theresearch period cannot be earlier than the first day (April 1) of the corresponding fiscal year.

Last date of available

You can specify the date by when the billing should be complete. This field is used to calculate the Payment code

billing processing

availability period, and the end of the research period is used if this field is left blank.

Person responsible for

Please enter the budget manager's TSUBAME login name.

budgetOther contact

This will be used following unsuccessful attempts to contact the payment code manager.

Please be careful not to make mistakes in the part transcribed from the Purchase Request System. Applications that cannot be confirmed as
containing correct information will be rejected. Enter the required items and click "Request."
After the application, the person in charge of GSIC will confirm the application contents and decide whether to approve or reject it. After this approval,
if the budget manager and the payment code applicant are not the same person, a payment code confirmation request email will be sent to thebudget manager. Once approval by the budget manager is complete, the payment code will be available. If the budget manager and the applicant are
the same, the payment code can be used following approval by the person in charge of GSIC.

Tips
In many cases, approval of payment codes is stalled because the budget manager's addendum is not processed. If your payment code approval is taking
a long time, please check with your budget manager first.

7.3.1. Approval by the budget manager (Confirmation)
If the applicant for a payment code does not match the budget holder, an email will be sent to the budget holder requesting approval of the payment
code application after GSIC has processed the application.

- 31/71 -2024-09-30

TSUBAME Portal User's Guide

The requested payment code cannot be used until the payment code application is approved in one of the following ways
• When you use the link in the email
a. log in to TSUBAME portal, and go to the URL in the email.
• If the login screen of TSUBAME portal is displayed, please log in and then move to the URL on the email again.
• If the URL is displayed as invalid, please check if the URL is not split in the mailer. If you still can't use it, please use the following method toapprove directly from TSUBAME portal Check the information on the screen, and select approve or reject.
b. Review the information on the screen and select Approve or Reject.
• If you want to approve directly from TSUBAME Portal
a. Login to TSUBAME portal
b. Click "Budget code usage request for approval" in the "Charging Management" group on the left side menu.
c. Check the contents on the screen, and select "Approve" or "Reject".

7.4. Set payment code to group
Warning
The only payment codes that can be set for a group are those applied for by the group manager.
Payment codes applied by anyone other than the Group manager cannot be used.

You can set the payment code to a group on the "TSUBAME group details" page. You can reach the screen by selecting "Manage your group" in themenu bar on the left, followed by "Detailed display" for the target group on the "Groups list page."

Click "Payment Code Setting" in "TSUBAME group details" to show the "Payment code setting" page, where you can see the list of applicable payment
codes.

- 32/71 -2024-09-30

TSUBAME Portal User's Guide

Click the checkbox of the payment code to be used by the group followed by "Assign to payment code."
If you want to cancel the assignment, select the payment code you wish to cancel and click "Cancel assigned payment code."

Tips
Payment codes applied for the next fiscal year update can be assigned to groups from April 1 of the new fiscal year.

- 33/71 -2024-09-30

TSUBAME Portal User's Guide

8. Management of TSUBAME points
Tips
This function is provided only for groups with payment codes. If the group does not have a payment code, set the payment code to the group in advance.

TSUBAME points are used as compensation when using paid services such as computation and group disks. Points can be purchased from a prespecified payment code or assigned by the department in charge.
Operations related to TSUBAME points are performed on the "TSUBAME group details" page. This page is displayed by selecting "Manage your group"in the menu bar on the left, and selecting the "Detailed Display" link for the target group on the Group list page.

Select "Details display" link for the group you want to manage points for, and "TSUBAME group details" will be displayed. Operations related to points
can be performed from the TSUBAME point menu on this page.

- 34/71 -2024-09-30

TSUBAME Portal User's Guide

8.1. Points available for purchase and validity period
In general, no new points can be purchased from January 1 to March 31 due to the terms of the payment code availability period. However, newpoints can be purchased from Institutional Operating Expense Funds (法人運営費) and Donations for Education and Research (奨学寄附金) even inthat period. In this case, please note that the expenses are deducted from the same budget for the next fiscal year.
TSUBAME points are valid only within the fiscal year of purchase. Remaining points will be invalidated the following year. (cf. 東京工業大学学術国際
情報センターTSUBAME4.0スーパーコンピュータ利用料の課金等に関する取扱い 第7条)

8.2. Point purchase
Tips
Points can be purchased only by the group manager and the member who has purchasing privilege.

Click the "Point purchase" on the "TSUBAME group details" page to move to the "Purchase of TSUBAME point chase" page.

On the "Purchase TSUBAME point" page, specify the payment code and additional quantity and click the "Purchase".

When the "OK" button on the confirmation dialog is pressed, the specified quantity of points is purchased and the points are credited to the group.

8.3. Check point purchase history
Click "Purchase" on the "TSUBAME group details" page to move to the "Purchase TSUBAME point" page. You can display the purchase history for the
specified period (fiscal year) in "Display year."

The purchase history is displayed below the TSUBAME point purchase history section.

- 35/71 -2024-09-30

TSUBAME Portal User's Guide

8.4. Check point usage
Click "Utilization status confirmation" on the "TSUBAME group details" page to show the "Utilization status confirmation" page.

On the "Utilization status confirmation" page, you can refer to the total points used in each month.
On the "TSUBAME group details" page, click "Usage details confirmation" in the "Use options" section to move to the "Usage details confirmation"screen.

On the "Usage details confirmation" screen, you can check the point purchase history for each month by payment code.

- 36/71 -2024-09-30

TSUBAME Portal User's Guide- 37/71 -2024-09-30

TSUBAME Portal User's Guide

9. Compute Nodes Reservation
9.1. Node reservation method
Select "Manage your group" from the side menu, followed by "Detailed Display" of the point group to be used, and "configuration" button of the "nodereservation option to use" section to open the "Node reservation setting" page.
Use the "Node Reservation" section at the bottom of this "Node Reservation" page to reserve compute nodes.

ノード予約設定
名称

説明

PeriodSpecify the start/end date and time of the reservation.

Time(hour)

You can specify the duration by hour.

Day

You can specify the duration by the number of days.

Resources

Specify the number of nodes to reserve.

Comment

Optional comment field to leave description.

Confirm Reservation

Check the system whether the requested reservation is available.

By clicking "Confirm Reservation," the following confirmation dialog will be displayed. Check the reservation period and point consumption displayedin the dialog and click "Accept the above, reserve" to complete the reservation.

- 38/71 -2024-09-30

TSUBAME Portal User's Guide

After the reservation is completed, it may take a few minutes before the reservation data appearing in the list.
To search the existing reservation, you can display the reservation information by specifying the search condition from the "Reservation node search
condition" in the same screen and clicking "Search."- 39/71 -2024-09-30

TSUBAME Portal User's Guide

Following options are available for searching:
Item

Description

AR ID

The ID number of the reservation.

Node

The number of reserved nodes.

CPU

The number of CPU cores of the reserved node.

GPU

The number of GPUs of reserved nodes.

Time(h)The duration of the reservation in hour.

reservation

The date and time when the reservation was made.

START

Start date and time of the reservation.

END

End date and time of the reservation.

STATE

The status of the reserved node.

Enter search criteria and press the "Search" button to display the following list of search results.
This list represents one reservation per line.

- 40/71 -2024-09-30

TSUBAME Portal User's Guide

Colors in the reserved node list:
Color

Description

Light yellow

The state within 5 minutes after reservation.
In this state, cancellation is possible, all points at the time of reservation are returned.

Light green

The reserved node that has exceeded 5 minutes after reservation and has not reached 24 hours before the start.
In this state, cancellation is possible, half points at the time of reservation will be returned.

Light blue

The reserved node in the state within 24 hours before the start.
In this state, it can not be canceled.

Bluethe reserved node that is currently in operation.
In this state, it can not be canceled.

Reserved node list display items
Item

Descrption

AR ID

Indicates the ID number of the reserved node.

Node

Indicates the number of reserved nodes.

CPU

Shows the number of CPU cores in the reserved node.

GPU

Indicates the number of GPUs of reserved nodes.

Time(h)Indicates the utilization time of the reserved node.

STATE

Indicates the reserved node status.
r: Running / w: Waiting / E: Stopping / W: Preparing / d: Deleting

Reservation dateSpecify the date and time when the node reservation was made.

Start

The start date and time of the reserved node.

End

The end date and time of the reserved node.

POINT

The point of the reserved node.

9.2. Cancel reservation
Select "Manage your group" from the side menu, followed by "Detailed Display" of the point group to be used, and "Cancel" button of the "nodereservation option to use" to open the "Reserved node Cancel" page.
By using "Reserved node search" in this "Reserved node cancel" page, you can see the list of reservation that can be canceled at that time. Select thecheckbox of the reservation to cancel, and click "Cancel reservation" to cancel the reservation.

- 41/71 -2024-09-30

TSUBAME Portal User's Guide

Info
The reservation can be canceled even after the reservation slot starts. Please release the slot for other users if you no longer need the slot because of theearly completion of your experiments.

Info
TSUBAME points will be returned depending of when the reservation is canceled.
TimingReturn Rate

Within 5min after reservation is made

100%

More than 24h before the reservation slot starts

80%

Before the reservation slot starts

50%

After the reservation slot starts

50%(Only for remaining time)- 42/71 -2024-09-30

TSUBAME Portal User's Guide

Item

Description

SearchSearch for a reserved node that can be canceled.

SelectSelect the reservation node to cancel.

AR ID

Indicates the ID number of the reserved node.

Node

Indicates the number of reserved nodes.

CPU

Shows the number of CPU cores in the reserved node.

GPU

Indicates the number of GPUs of reserved nodes.

Time(h)Indicates the utilization time of the reserved node.

STATE

Indicates the reserved node status.
r: Running / w: Waiting / E: Stopping / W: Preparing / d: Deleting

Reservation dateSpecify the date and time when the node reservation was made.

Start

Indicates the start date and time of the reserved node.

End

Indicates the end date and time of the reserved node.

POINT

Indicates the point of the reserved node.

Cancel reservation

Cancel the reservation node whose check box is checked.

9.3. Check reservations
Select "Reserved node list" from the side menu to open the "Reserved node list" page.
In this screen, the reservation information of the group selected in "Group selection" in the upper right of the page will be displayed.

- 43/71 -2024-09-30

TSUBAME Portal User's Guide

名称

説明

Node

Indicates the total number of nodes of the current reserved node.

Reservation time(h)Indicates the current total reservation time.

Point of use

Displays the currently active node and the total number of points on reserved nodes 24 hours before the start.

(provisional point)

If there is a cancelable node in the reserved node, it indicates the temporary point total of the reservation node.

In the following GUI, specify conditions for searching for reserved nodes.

- 44/71 -2024-09-30

TSUBAME Portal User's Guide

Item

Description

Fiscal year

Specify the fiscal year range to be searched.

Range

User or GroupAR ID

Specify the ID number of the reserved node.

Node

Specify the number of reserved nodes.

CPU

Specify the number of CPU cores of the reserved node.

GPU

Specify the number of GPUs of reserved nodes.

Time(h)Specify the set time for using reserved nodes.

Reservation

Specify the date and time when the node reservation was made.

START

The reserved node specifies the start date and time.

END

The reserved node specifies the end date and time.

STATE

Specify the status of the reserved node.

Search Button

We search based on specified condition contents.

- 45/71 -2024-09-30

TSUBAME Portal User's Guide

Colors in the reserved node list:
Color

Description

Light yellow

The state within 5 minutes after reservation.
In this state, cancellation is possible, all points at the time of reservation are returned.

Light green

The reserved node that has exceeded 5 minutes after reservation and has not reached 24 hours before the start.
In this state, cancellation is possible, half points at the time of reservation will be returned.

Light blue

The reserved node in the state within 24 hours before the start.
In this state, it can not be canceled.

Bluethe reserved node that is currently in operation.
In this state, it can not be canceled.

The reserved node list items:
Item

Descrption

AR ID

Indicates the ID number of the reserved node.

Node

Indicates the number of reserved nodes.

CPU

Shows the number of CPU cores in the reserved node.

GPU

Indicates the number of GPUs of reserved nodes.

Time(h)Indicates the utilization time of the reserved node.

STATE

Indicates the reserved node status.
r: Running / w: Waiting / E: Stopping / W: Preparing / d: Deleting

Reservation dateSpecify the date and time when the node reservation was made.

Start

Indicates the start date and time of the reserved node.

End

Indicates the end date and time of the reserved node.

POINT

Indicates the point of the reserved node.

To check the availability of node reservation for the current month, use t4-user-info compute ars on the login node. For more detail, please refer to
TSUBAME4.0 User's Guide.

9.4. How to use reserved nodes
Reserved nodes can be used by submitting a job with its AR ID specified with the -ar option of qsub before the reservation starts and during thereservation period.

- 46/71 -2024-09-30

TSUBAME Portal User's Guide

For the details, please refer to TSUBAME4.0 User's Guide for details.

Info
Just reserving a node does not make it possible to SSH into the reserved node. To log in directly to a compute node via SSH, use submit job with f_node.

- 47/71 -2024-09-30

TSUBAME Portal User's Guide

10. Management of Group Disk
The group disk is purchased using the points by the group manager, and all group member can access the shared storage freely.
Group disk is managed on the "TSUBAME group details" page. This page is reached by selecting "Manage your group" in the menu bar on the left andselecting the "Detailed Display" link for the target group on the Group List page.

Group disk operations can be performed from the usage option menu on the "TSUBAME Group Details" page.

10.1. Group disk capacity
The capacity of the group disk is limited by both total file size and the number of files (inodes) under them. For each 1TB unit of file size purchase,
2,000,000 inodes will become available.
The amount of space that can be stored on a group disk is limited by both the absolute size of the files stored under it and the number of files(inodes).

- 48/71 -2024-09-30

TSUBAME Portal User's Guide

Available sizes and Number of files that can be saved(inode) depend on the storage used.
For more information on the different group disk areas and how to use them, see Group Disk.
Storage area

PATH

Group disk capacity

Available sizes

settingHigh-speed storage area

Number of files that can besaved(inode)/gs/fs100GB unit

MAX 3TB

2,000,000 / 1TB/gs/bs1TB unit

MAX 100TB

2,000,000 / 1TB(SSD)
Large-scale (Big) storage
area (HDD)

10.2. The validity period of the group disk
The group disk status is reset once at the end of the fiscal year, and all group disks are in a grace state that can only be read and deleted.
The grace state lasts until mid-April, and unpurchased group disk space will become inaccessible after the grace period ends. It is necessary topurchase the group disk for the current fiscal year to continue using.
Also, group disk data will be deleted at any time after the grace period.

10.3. Increase or decrease group disk capacity
Warning
The group disk capacity can be set only by the group manager.

Group disks can be increase or decrease from the group disk setting button in the "Use options" section in the group details page.

- 49/71 -2024-09-30

TSUBAME Portal User's Guide

In the "Group disk capacity" section, the current setting and usage of the group disk button are available. Click "Resize" button for the storage whose
capacity you want to change, and the capacity change dialog will be displayed.

- 50/71 -2024-09-30

TSUBAME Portal User's Guide[ High-speed storage area ]- 51/71 -2024-09-30

TSUBAME Portal User's Guide[ Large-scale (Big) storage area ]Change the group disk size value in the size field on the dialog. After the change, click "Accept the above, change" button in the capacity change
dialog to change the capacity from the current month.
When increasing the capacity, the required points from the specified month to the end of the year are deducted.
When reducing the capacity, points for the reduced capacity from the following month to the end of the fiscal year will be returned to the group.

Tips
In the following cases, the group disk capacity cannot be set.
• Insufficient points to increase capacity.
• The current disk usage exceeds the specified capacity after reduction.
In addition, depending on the monthly set capacity, actual usage may exceed the set capacity.
Please note that access restrictions will be applied if this condition persists.
For details, please refer to What to do when group disk usage is exceeded.

10.4. Confirmation of group disk usage
Group disk usage can be checked from the Group Disk Settings button under Usage Options on the Group Details screen.

- 52/71 -2024-09-30

TSUBAME Portal User's Guide

The size/number of nodes in use/allocated for each storage path can be viewed.

Tips
Since the capacity setting of the group disk is done on a monthly basis, if the storage space reserved is smaller than that of the previous month, the size/
inode count in use may exceed the reserved size.
If this condition persists, access restrictions will be applied, so please check at the beginning of each month to see if the excess has occurred.
For details, please refer to What to do when the group disk usage exceeds the reserved size.

- 53/71 -2024-09-30

TSUBAME Portal User's Guide

11. Check usage
In the portal, you can check the processing status of jobs submitted in the past.

11.1. Check job status
Select "Job List" Link in the side menu to display the "Job List" page.

Enter search conditions and click "Search" button to display information about jobs that match the search conditions.

- 54/71 -2024-09-30

TSUBAME Portal User's Guide

Tips
In the TSUBAME portal, you can check whether the submitted job is being processed, completed, or settled.
For jobs submitted to the reservation, points are collected at the time of the reservation, and the reservation ID is displayed in the ARID column and points
are not displayed.

Check the checkbox at the left of the job search results, and the information on selected jobs is displayed at the bottom. You can compare the job
information side by side.

Tips
When a job is submitted, the maximum consumption points of that job are deducted in advance, referring to the job options specified by the user. This
state is called "Provisional holding of points (Provisional points)."
After the completion of the job, points are recalculated based on the actual consumption. If it is smaller than the temporarily held point, the difference isreturned and reflected in the system.

- 55/71 -2024-09-30

TSUBAME Portal User's Guide

11.2. Job search options
Items that can be specified by search options as follows.
Item

Description

Fiscal year

Specify the fiscal year of the time when the job was executed.

Search target

Specify the search range of the job submitter.
When "user" is selected, it searches for the job executed by the current logged-in user.
If you wish to search by group, select another group in the "Group selection" list box on the upper right of the screen andthen specify other conditions.

AR ID

Specify the ID number of the node reservation.

JOB ID

Specify the ID number of the submission job.

JOB_NAME

Search by job file name specified at job submission.
Partial matching of character strings is also possible.

STATUSYou can search according to job status.
You can select either "in process" or "end" and search by status letters of each.

SUBMIT

Specify the time when the job was submitted.

START

Specify the time when the job was started.

END

Specify the time when the job ended.

WALL(sec)

Specify the job execution time specified by the user when executing the job.

RU_WALL(sec)Specify the time actually consumed by the job.

PRIORITY

Specify the priority of the job. The priority is one of 0, 1, and 2.

CPU(sec)

Specify the CPU time consumed by the job.

MEM(GB)

Specify the memory consumed by the job in units of GB.

POINT

Specify the number of points consumed by job execution.

- 56/71 -2024-09-30

TSUBAME Portal User's Guide

12. Management of TSUBAME usage report
TSUBAME users are required to report their research results from TSUBAME for each group.
To manage usage reports, use the "Usage Reports" page. Select "Management your group" from the side menu, select "Detail Display" for the target
group, and click "Usage Report" button on the group details page.

Tips
The "Usage Report" button may not be displayed depending on the group type.

12.1. Submit usage report
There are two ways to report usage: "individual report" and "bulk report." Select according to the type of report and the number of reports.

- 57/71 -2024-09-30

TSUBAME Portal User's Guide

12.1.1. Submit individual reports
Select "Individual Report" in the "Usage Report" menu.
The input page is displayed.

- 58/71 -2024-09-30

TSUBAME Portal User's Guide

Usage report submission: Operating method of individual report
Name

Description

Kind (Type)

Select the type of report from peer-reviewed articles, non-reviewed articles, oral presentations, etc.

Contents

Fill in the content of the usage report to be submitted.
Please enter within 500 characters.

Attachment fileSpecify the file attached to the usage report to be submitted.

After entering the necessary items, click "Regist" button to complete the report.

12.1.2. Submit reports in bulk
Select "bulk report" in the "Usage Report" menu. An input form is displayed.

- 59/71 -2024-09-30

TSUBAME Portal User's Guide

Fill in the "bulk report form" in the form of one report per line. Blank lines are ignored.
After entering, select the "Read report" button. Read the information entered in the batch report form. The read contents are displayed in tabular form
below the batch registration form.
Check the contents entered in the bulk report form to be registered in the system. Items that are not checked will not be registered in the system even
if you click "Regist" button. For each report item, select the type of report from among peer-reviewed papers, non-peer-reviewed papers, and oralpresentations.
Finally, click "Register this content" button to register the checked report.

12.2. View and update usage reports
In the "usage report reference update" screen, you can check the details of the reported usage report, update it, and download the attached file.
A list of reported usage reports is displayed at the bottom of the "Submit Usage Report" page.

- 60/71 -2024-09-30

TSUBAME Portal User's Guide

Select the link in the content column to view and edit the reported content.

- 61/71 -2024-09-30

TSUBAME Portal User's Guide

An icon is displayed in the attachment column for reports with attached files. Click to see the attached file. After checking the contents, update,delete, change or delete the attached file as necessary.

Warning
Accepted usage reports will be locked and become unchangeable. Please contact us if you need to modify it.

- 62/71 -2024-09-30

TSUBAME Portal User's Guide

13. Application Activation
If you use commercial applications, you need to purchase the application to activate in the usage option menu on the "TSUBAME Group Details" page.
Click "Setting" button in "Application Use" option.

Click "Purchase" button on the application you want, select the end month of the period you want to use, then click "Buy" button.

- 63/71 -2024-09-30

TSUBAME Portal User's Guide

You can see purhasing history in the list of purchased applications on the "TSUBAME Group Details" page.

- 64/71 -2024-09-30

TSUBAME Portal User's Guide

Purchased applications are available from the time of the purchase operation until the end of the specified month.

Info
Application activation requires a purchase operation for each account. For example, if you purchase Matehmatica, only that account can use
Mathematica.
If you are not authorized to use that application, it will be grayed out and cannot be selected- 65/71 -2024-09-30

TSUBAME Portal User's Guide

14. Application Distribution for Labs
Not available on the portal menu.
For more details: Application Distribution- 66/71 -2024-09-30

TSUBAME Portal User's Guide

15. Subscription
To apply for a subscription for a computing node, click the "Purchase" button under "Subscription Purchase" (fixed-use purchase) from the Group
Details screen.

Clicking the button displays a dialog box for specifying the period of use.
Enter the number of nodes you wish to use and the period for which you wish to use them, and click the "Purchase" button to apply for a subscription
purchase.
Subscribed computing nodes will be available after the system administrator has configured the usage settings on the start date of each month.
For more details like purchase deadline, please refer to Subscription.

Purchased node subscription services are displayed in the "Application Purchase List" at the bottom of the group details.

- 67/71 -2024-09-30

TSUBAME Portal User's Guide- 68/71 -2024-09-30

TSUBAME Portal User's Guide

16. Web application funtion
In TSUBAME4.0, the Web application function of TSUBAME3.0 was replaced with Open OnDemand.
For more details about Open OnDemand, please refer to Open OnDemand manual.

- 69/71 -2024-09-30

TSUBAME Portal User's Guide

Appendix.
Appendix.1. Query
For information on where to send application forms for new use and other inquiries, please refer to the website of GSIC, Tokyo Institute of Technology
URL：http://www.t4.gsic.titech.ac.jp/en

Appendix.2. Site information
TSUBAME Portal
URL: https://portal.t4.gsic.titech.ac.jp/ptl/- 70/71 -2024-09-30

TSUBAME Portal User's Guide

Revision history
Date

Changes

2024/4/18

Initial version- 71/71 -2024-09-30