Differences

This shows you the differences between two versions of the page.

--- hpc_onboarding_guide [2026/05/13 12:04]
bdepaula created
+++ hpc_onboarding_guide [2026/05/13 12:29] (current)
bdepaula [Fugaku Account Application System (FAAS)]
@@ Line 1: / Line 1: @@
 ====== HPC Onboarding Guide ======
-This page describes instructions for obtaining credentials to different HPC clusters. It includes tips for the onboarding process, and other tricks to avoid you wasting too much time with the HPC support staff, or having to ask others at BSC.
+This page summarizes the onboarding process for several HPC systems, including common pitfalls and recommendations to avoid delays with support teams.
 ===== RIKEN Fugaku =====
-For both RIKEN's Fugaku and U-Tokyo's Miyabi supercomputers, there is the requirement to have created an account in the Japanese High Performance Computing Infrastructure, HPCI [[https://www.hpci-office.jp/]]. You can create the account today, without having a project. So we recommend that you start with that as soon as you know that you will have to access Fugaku.
+Access to both Fugaku and Miyabi requires an account in the Japanese High Performance Computing Infrastructure (HPCI):
-It is important to note that you will be asked for identification documents, and also for a company ID. The company ID is the BSC identification card (used at the doors and turnstiles in our buildings). **You must provide the photo of the front and back of your card**, even if the back is blank. Try to take a photo so they see it is the same card (maybe showing the lanyard).
+https://www.hpci-office.jp/
-Also important to note that your name must match your BSC ID. This means **using your name in capital letters**, and in the exact order as in the identification card (they will reject your application and you will probably waste days if you do not follow this, so it is pointless to argue on this).
+You can create an HPCI account before being assigned to a project, so it is recommended to start this process as early as possible.
-Their page may read as if you can use a Spanish driver's license or TIE, instead of the passport. **They will ask for your passport**. It might be simpler to just upload TIE and Passport (in one case where that was done, they did not ask for anything else; for others they required the passport after uploading only the TIE).
+During registration you will be asked for:
+  * Personal identification documents
+  * A company ID
-Upon completing the HPCI process, you will receive a **user ID** (hpc1234...), and a **Verification Code** (besides having to use your email, a password, etc.). Keep the Verification Code as you will need this later in the registration process with Fugaku (same with Miyabi).
+For BSC users, the company ID is the BSC access card used at the building entrances. Upload photos of both the front and back of the card, even if the back is blank.
-The PI of the project or someone from RIKEN will contact you asking for your HPCI ID and Verification code. Give that to them, and wait for their confirmation.
+Your name must exactly match the format used in your BSC card:
+  * Use uppercase letters
+  * Preserve the same order of names and surnames
-You will have to complete now the process at the FAAS (Fugaku Access Account System): https://apply.fugaku.r-ccs.riken.jp/login. Create an account, and again upload your documents, and complete each step in the process. There will be a page asking you to upload documents, and the text may read as if you need Japanese documents. Ignore that, just click to complete the Wizard/Quiz, and it will ask you to upload your personal identification, and again the BSC ID. Remember, use the correct names. They will reject your application and ask you to upload passport, match the ID name, include the back of your documents in the photos, etc. This may take weeks if you do not include it on your first try.
+Failure to do so will usually result in rejection and significant delays.
-The process includes several steps, and there are "dots" in the FAAS page that are grey, orange, or green. Follow the process, completing whatever is orange. Some of these dots will turn gray. It does not mean that the step is complete. There is a person who verifies the application. It may take one day, to a couple of weeks. Please, be patient.
+Although the HPCI documentation may suggest that a TIE or Spanish driver's license is sufficient, in practice they usually request the passport. Uploading both TIE and passport from the beginning is recommended.
+==== Fugaku Account Application System (FAAS) ====
+After completing the HPCI registration, you will receive:
+  * An HPCI User ID (e.g. ''hpci1234'')
+  * A Verification Code
-Once your account is approved, you will receive a certificate (e.g.,
+Keep the Verification Code, as it will be required later for both Fugaku and Miyabi onboarding.
+Your project PI or a RIKEN contact will ask for:
+  * Your HPCI User ID
+  * Your Verification Code
+Continue the process through FAAS:
+https://apply.fugaku.r-ccs.riken.jp/login
+Create an account and complete all onboarding steps. You will again be asked to upload:
+  * Personal identification
+  * BSC identification card
+Common reasons for rejection include:
+  * Passport missing
+  * Name mismatch
+  * Missing back side of ID cards
+  * Low-quality photos
+The FAAS interface displays onboarding steps as colored dots:
+  * Orange: action required
+  * Green: completed
+  * Grey: pending review or inactive
+{{:faas_fugaku.png?600 |}}
+Approval may take from one day to several weeks.
+==== Browser User Certificate ====
+After approval, you will receive a browser certificate (e.g. ''u1234.p12'').
+FAAS also provides a PDF containing the certificate passphrase. Store both securely.
+Import the certificate into your browser, for example in Firefox:
+  Preferences → Privacy & Security → Certificates → View Certificates → Import
+The certificate is required to access:
+  * User Portal:
+    https://www.fugaku.r-ccs.riken.jp/user_portal/
+  * Fugaku OnDemand:
+    https://ondemand.fugaku.r-ccs.riken.jp/pun/sys/dashboard
+  * Fugaku website:
+    https://www.fugaku.r-ccs.riken.jp/en/
+==== SSH Keys ====
+Fugaku explicitly forbids adding SSH keys directly on login nodes. Doing so may result in account suspension.
+Only use SSH keys uploaded through the Fugaku User Portal.
+If GitHub or GitLab access is required, use SSH forwarding instead of copying keys to the system.
+Example SSH configuration:
+<code>
+Host fugaku
+    HostName login.fugaku.r-ccs.riken.jp
+    User u1***
+    IdentityFile ~/.ssh/id_rsa
+</code>
+==== Batch Scheduler ====
+Fugaku uses Fujitsu's PJM implementation, part of the ''Fujitsu Technical Computing Suite (TCS)''.
+Autosubmit supports this PJM version. Fugaku also provides a smaller Slurm environment mainly associated with GPU resources.
+Example PJM batch job:
+<code bash>
+#!/bin/bash
+#PJM -N test_job
+#PJM -L elapse=00:02:00
+#PJM -L rscgrp=small
+#PJM -g ra1*****
+hostname
+</code>
+Submit the job with:
+<code bash>
+pjsub --no-check-directory job.sh
+</code>
+Check resources with:
+<code bash>
+pjshowrsc --rg
+</code>

User Tools

Site Tools

Differences

Page Tools