[最終更新日時] 2020年9月7日

English versionもあります。

目次

• 接続
  • RCCSコンピュータへのログイン
  • ssh公開鍵とウェブページ用パスワードの登録
  • ログインシェル
• RCCSシステムの全体像
• リソース関係
  • CPU点数とキュー係数
  • リソース集計
  • ユーザ別 リソース制限設定／表示
• キューイングシステム関連
  • キューイングシステムの全体像
  • キュー構成
  • ジョブの状態表示
  • ジョブの投入
  • ジョブの取り消し
  • ジョブのホールドとリリース
  • 実行済みジョブの情報取得
• ビルドと実行
  • ビルドのコマンド
  • 並列プログラムの実行方法
  • 開発支援ツール
  • Environment Modules
• パッケージプログラム
• その他のRCCS固有コマンド
  • バッチジョブ関連
  • 資源使用状況表示
  • バッチスクリプト用ユーティリティコマンド
  • 演算ノード上のファイル操作
• 問い合わせ

接続

RCCSのコンピューターへのログイン

• フロントエンド(ccfep.ims.ac.jp)へはsshの公開鍵認証を使って接続します。
• GPU搭載フロントエンド('ccgpup', 'ccgpuv')へは'ccfep'からのみ接続できます。
• メンテナンス中はログイン出来ません。→定期メンテナンス情報（メンテナンス日は原則毎月第一月曜日）
• フロントエンドへのログインは、日本に割り当てられたIPv4アドレスを持つホストまたは許可されたホストからでなければなりません。→日本国外からの接続について

ssh公開鍵とウェブページ用パスワードの登録

sshの公開鍵と秘密鍵のペアを最初に作成しておきます。作成方法が不明な方はインターネットなどで調べてください。
クイックスタートガイドのページにも情報があります。

初めて登録する場合もしくはウェブページ用パスワードを忘れた場合

1. 専用ウェブページの「登録案内メールの発行」をウェブブラウザーで開きます。
2. 利用申請書で申請したメールアドレスを入力後、「登録案内メール送信」ボタンを押します。
3. 自動送信されたメールの中に記載されているURLをウェブブラウザーで開きます。
4. ユーザー限定ページにアクセスするために、新たに設定したいパスワードを2ヶ所に入力します。
5. あらかじめ用意したsshの公開鍵をペーストなどして入力します。
6. 「保存」ボタンを押します。

ウェブページ用パスワードを使う場合

1. 専用ウェブページ(https://ccportal.ims.ac.jp/account/)をウェブブラウザーで開き、ユーザー名とパスワードを入力し、「ログイン」ボタンを押します。
2. 画面右上の「アカウント情報」を開きます。
3. 「編集」タブを押します。
4. パスワードを変更するは、現在のパスワードと新たに設定したいパスワードを入力します。
5. あらかじめ用意したsshの公開鍵をペーストなどして入力します。
6. 「保存」ボタンを押します。

ログインシェル

• /bin/csh(tcsh)、/bin/bash、/bin/zshを利用できます。
• 変更はssh公開鍵と同じウェブページで行ないます。変更が反映されるまで時間がかかる場合があります。
• .loginや.cshrcはカスタマイズしても構いませんが、十分な注意が必要です。

RCCSシステムの全体像

• いわゆる会話処理ができるのは、ccfep (8ノード) と ccgpup, ccgpuv です。ビルドやデバッグにご利用下さい。
• 'ccgpup', 'ccgpuv' 以外の会話処理ノードはインターネットから直接ログインできます。
• 保存期間が異なるディスクが、/work、/ramd、/home、/saveの4種類あります。
• アクセス速度は、下図の太い線の方が高速です。
• /workは計算途中の一時ファイルを置くのに使います。ジョブ終了後に削除されます。
• /ramdは容量が176GBもしくは752GB程度のラムディスクです。プログラムで使うメモリー量とラムディスクで使う容量の総計はキューイングシステムによって管理されています。
• /homeと/saveは現在全く同様に扱われています。容量制限についても合算値で判断されます。(歴史的な経緯で名前だけが異なっています。)
• /tmp、/var/tmp、/dev/shmの一時ディレクトリーの使用を禁止します。一時ディレクトリーを使用しているジョブは見つけ次第削除しますので予めご了承ください。

リソース関係

CPU点数とキュー係数

CPU点数は、CPUやGPUを使うことによって減ります。
減る点数はシステム毎に設定されているCPUキュー係数とGPUキュー係数により求められます。

• 会話処理ノードの内、ccfep, ccgpuv はCPU時間でCPU点数が消費されます。
• 会話処理ノードの ccgpup ではCPU点数が消費されません。
• 他のシステムは、経過時間でCPU点数が消費されます。
• 実際の費用は無料です。

　現在の使用CPU点数、残りのCPU点数を知るためには、showlim -cコマンドを使います。

リソース集計

• キューイングシステムで実行されたジョブの集計とディスク使用量の集計は10分毎に行います。
• 会話処理の集計は、毎日5:15に行ないます。
• CPU点数を使いきると、グループ内利用者全員の全ての実行中ジョブは削除され、新たなジョブ投入が抑止されます。
• ディスク使用量が制限値を越えると、新たなジョブ投入が抑止されます。

ユーザ別 リソース制限の設定／表示

• 代表利用者のみがリグループ内のメンバー個々に対してグループに割り当てられたリソース量を限度に制限値を設定できます。
• 一般利用者はリソース制限の値を確認することができます。
• リソース制限の種類は、CPU数、点数、ディスク容量です。

キューイングシステム関連

キューイングシステムの全体像

キュー構成

全利用者が利用可能なキュー

• jobtype=coreで19コア以上のジョブの最大時間は一週間です。
• jobtype=gpuvのジョブについても最大時間は一週間です。
• 上記以外のジョブの最大時間は、定期メンテナンスまでです。ただし、1週間を越えるジョブが実行できる演算ノードは全体の半数です。
• 526ノード並列までのジョブは、同一OmniPathグループ内に接続された演算ノードで実行されます。
• 演算ノードccnnのうち272ノードは1-4ノードのジョブ専用です。
• ジョブの最大時間が1日以下のジョブタイプsmallのジョブは、演算ノードccnfで実行される場合があります。
• ジョブの最大時間が1日以下で要求コア数が4-18のジョブタイプcoreのジョブは、演算ノードcccaで実行される場合があります。
• ジョブタイプcore, gpu, gpup, gpuvのジョブは他のジョブとノードを共有します。
• 演算ノードcccaには2-8 GPUが搭載されており、ノード内GPU間高速通信(Peer-to-peer通信)が可能です。
  • jobtype=gpup を指定した場合には NVIDIA Tesla P100 搭載ノードで実行されます。
  • jobtype=gpuv を指定した場合には NVIDIA Tesla V100 搭載ノードで実行されます。
  • jobtype=gpu を指定した場合には P100, V100 のどちらかが使われます。
• グループ制限を判断する点数には追加点数を含みません。

別途申請が必要なキュー

キューの設定は下記の通りです。

ジョブの状態表示

ccfep% jobinfo -h cclx [-c] [-s] [-l|-m|-w [-g|-a]] [-n]

もしくは

ccfep% jobinfo -q (PN|PNR[0-9]) [-c] [-s] [-l|-m|-w [-g|-a]] [-n]

• -c　最新データを使って表示
• -s　サマリー表示
• -m　メモリ情報を表示
• -w　ジョブをサブミットしたディレクトリーを表示
• -l　リスト表示
• -g　グループ内の全ユーザの情報を表示
• -a　全てのユーザの情報を表示
• -n　ノード別空きコア数を表示
• -h　対象システムを指定
• -q　対象キューを指定

例: サマリー表示

利用中/キュー待ち中/ホールド中ジョブの数やCPU数、GPU数を表示します。

ccfep% jobinfo -h cclx

専有利用キュー等の特殊キューの利用がなければ、以下のコマンドでも同じ情報が得られます。

ccfep% jobinfo -q PN

上記コマンドに -c オプションをつけると最新の情報が得られます。ただし、表示に少し時間がかかります。

例: 個々のジョブの状態を見る

ccfep% jobinfo -h cclx -l

専有利用等がなければ、

ccfep% jobinfo -q PN -l

で情報が得られます。投入直後のジョブがすぐに実行されたか知りたい場合には以下のように -c オプションを追加して下さい。

ccfep% jobinfo -q PN -c -l

例: 自身の所属するグループユーザのジョブを表示する。

以下のように -l に加えて -g オプションを追加した場合にはご自身のジョブに加えて、同一グループのジョブも表示されます。

ccfep% jobinfo -q PN -g -l -c

-a オプションを追加した場合には全ユーザーのジョブが表示されます。ただし、自分以外の情報は隠蔽されます。
 

例: ジョブの作業ディレクトリを表示する

どこでジョブを実行したのかがわからなくなった場合には -w オプションを追加することで、
ジョブの作業ディレクトリ(PBS_O_WORKDIR)を表示するを表示することもできます。

ccfep% jobinfo -q PN -w

(-c を追加することも可能です。)
 

ジョブの投入

下記の２つの方法があります

• jsubコマンドにバッチファイルを指定してジョブを投入する
• g09sub / g16subコマンドにgaussianのインプットファイルを指定してジョブを簡単に投入する（gaussian専用）

以下はjsubを使ってジョブを投入する方法です

ヘッダー部の書き方

ジョブの投入には、バッチスクリプトが必要です。その際、バッチコマンドをスクリプトの最初に記述しなければなりません。

• csh, bash (/bin/sh), zsh でのジョブ投入が可能です。
• どのシェルでも #PBS で始まる行は共通に使えます。
• バッチスクリプトのサンプルは、ccfep:/local/apl/lx/アプリケーション名/samples/にあります。

#PBS -r n

• Nnode: 実ノード数
• Ncore: ノードあたりの確保するコア数
• Nproc: ノードあたりのプロセス数
• Nthread: プロセスあたりのスレッド数
• Jobtype: large, small, core, gpu, gpup, gpuvのいずれか
  • large: 18.8GB / core
  • small: 4.4GB / core
  • core: 18コア以下のジョブ
  • gpu, gpup, gpuv: GPUを使う計算
• Ngpu: 使用するGPUの数

2ノード80プロセス並列(MPI並列)する場合の「使用CPU数」行の書き方

GPGPUを使用する場合の「使用CPU数」行の書き方

こちらのページにもいくつかサンプルがあります。

ジョブの投入コマンド

バッチスクリプトが準備できたら、下記のようにジョブを投入します。

ccfep% jsub -q (PN|PNR[0-9]) [-g XXX] [-W depend=(afterok|afterany):JOBID1[:JOBID2...]] script.csh

計算物質科学スパコン共用事業利用枠としてジョブ投入する場合は、-gオプションをつけます。（XXXは計算物質科学スパコン共用事業利用枠のグループ名）
ジョブの依存関係を-Wオプションで設定できます。正常終了後に実行させる場合はafterok、異常終了後でも実行させる場合はafteranyを指定します。依存関係のあるジョブIDをコロンで区切って指定します。
バッチスクリプトのサンプルは、ccfep:/local/apl/lx/アプリケーション名/samples/にあります。
 

一連のジョブ実行(ステップジョブ)

--step もしくは --stepany オプションをつけることで、比較的簡単にジョブを順番に実行することができます。
 

ステップジョブ1: 複数のジョブを順番に実行する。前のジョブが異常終了した場合には以後のジョブは破棄。

ccfep% jsub -q (PN|PNR[0-9]) [-g XXX] --step [-W depend=(afterok|afterany):JOBID1[:JOBID2...]] script.csh script2.csh ...

ステップジョブ2: 複数のジョブを順番に実行する。前のジョブが終了したら次のジョブを実行。

ccfep% jsub -q (PN|PNR[0-9]) [-g XXX] --stepany [-W depend=(afterok|afterany):JOBID1[:JOBID2...]] script.csh script2.csh ...

実行例:

ccfep% jsub -q PN --stepany job1.csh job2.csh job3.csh

ジョブの取消

あらかじめjobinfoコマンドで、取り消したいジョブのRequest IDを調べておきます。その後、

ccfep% jdel [-h cclx] RequestID

とします。
 

ジョブのホールドとリリース

キュー待ち状態のジョブを実行されないように留めておく(ホールドする)ことができます。
あらかじめjobinfoコマンド等でジョブIDを調べておいた上で以下のコマンドを実行することでジョブをホールドできます。

ccfep% jhold [-h cclx] RequestID

ホールドしたジョブを解放するには、

ccfep% jrls [-h cclx] RequestID

とします。

実行済みジョブの情報取得

ジョブの終了日時、経過時間、並列化効率の情報をjobeffコマンドで得ることができます。

ccfep% jobeff -h (cclx|cck|ccpg|ccuv) [-d "last_n_day"] [-a] [-o item1[,item2[,...]]]

表示される項目を-oオプションを使ってカスタマイズすることができます。itemには次のキーワードを指定することができます。

• queue: キュー名
• jobid: ジョブID
• user: ユーザー名
• group: グループ名
• node: 計算に使われた最初のノード名
• Node: 計算に使われた全ノード名
• start: ジョブの開始時刻（YYYY/MM/DD HH:MM）
• type: ジョブタイプ
• Start: ジョブの開始時刻（YYYY/MM/DD HH:MM:SS）
• finish: ジョブの終了時刻（YYYY/MM/DD HH:MM）
• Finish: ジョブの終了時刻（YYYY/MM/DD HH:MM:SS）
• elaps: 経過時間
• cputime: 全CPU時間
• used_memory: 使用したメモリー量
• ncpu: 予約したCPU数
• ngpu: 予約したGPU数
• nproc: MPIのプロセス数
• nsmp: プロセスあたりのスレッド数
• peff: 並列化効率
• attention: 非効率なジョブかどうか
• command: ジョブ名
• exit_status: ジョブの終了コード
• point: ジョブが使用したCPU点数
• all: 主要なもの全て

例1: 最近 10 日以内に終わったジョブの ID, 開始日時、終了日時、点数を表示

ccfep% jobeff -h cclx -d 10 -o jobid,user,start,finish,point

例2: 2020年度に実行したジョブの ID, 終了日時、点数、実行ディレクトリを表示

ccfep% jobeff -h cclx -y 2020 -o jobid,finish,point,Workdir

例3: 最近 2 日以内に終了したジョブの主要な情報を表示

(all は点数(point)を表示しません。点数を表示したい場合は他の例を参照下さい)

ccfep% jobeff -h cclx -d 2 -o all

ビルドと実行

ビルドのコマンド

各種ライブラリ、MPI環境等の導入状況についてはパッケージプログラム一覧のページをご覧下さい。
 

並列プログラムの実行方法

cclx

ジョブスクリプト中、select 行で MPI プロセスの数を mpiprocs に、OpenMP のスレッド数を ompthreads に正しく設定して下さい。
例: 合計 12 CPU で 4 MPI プロセス、3 OpenMP スレッドの場合は ncpus=12:mpiprocs=4:ompthreads=3 となります。

センター側で導入したアプリケーションのサンプル( /local/apl/(システム名)/(アプリ名)/samples 以下に有り)も参考にして下さい。
 

ジョブスクリプトでの OpenMP スレッド指定

jsub で実行する場合、ompthreads で指定した値が自動的に指定されます。
スクリプト内で OMP_NUM_THREADS 環境変数で手動指定しても問題ありません。
当然ですが、jsub で実行しない場合(フロントエンドノードでのテスト場合等)は OMP_NUM_THREADS 環境変数を設定する必要があります。
 

MPIでのホスト指定

jsub で実行する場合、MPI が使うホストリストのファイル名が PBS_NODEFILE 環境変数に入ります。
センター側で導入している MPI 環境(Intel MPI, OpenMPI)ではこの環境変数を自動的に読み込むため、
いわゆる machine file 指定を省略して実行できます。

例: 4 MPI * 3 OpenMP ハイブリッド並列の例

#!/bin/sh
#PBS -l select=1:ncpus=12:mpiprocs=4:ompthreads=3:jobtype=core
#PBS -l walltime=24:00:00
cd $PBS_O_WORKDIR
mpirun -np 4 /some/where/my/program options

• OpenMP のスレッド数は ompthreads で指定された値が使われます(OMP_NUM_THREADS=3 を指定したと同義)
• センター側で導入した MPI 環境の場合 machine file は通常省略できます。
• PBS_NODEFILE 環境変数を machine file に指定しても動作は同じです。

開発支援ツール

一部コマンドライン版も使えますが、一般的にはX Window版の方が使いやすいです。

Intel Inspector

• メモリ／スレッドエラー検証ツール
• (GUI command) inspxe-gui
• (CUI command) inspxe-cl

Intel Vtune Amplifier XE

• 性能解析ツール
• (GUI command) amplxe-gui
• (CUI command) amplxe-cl

Allinea Forge

• デバッガー
• (GUI command) ddt

Environment Modules

2018年7月よりEnvironment Modules(moduleコマンド)の利用も可能です。詳細については、こちらのページをご覧ください。

パッケージプログラム

• 各システムにインストールされている最新の一覧は、パッケージプログラム状態一覧で参照できます。
• バッチスクリプトのサンプルは、ccfep:/local/apl/システム名/アプリケーション名/samples/ディレクトリーを御覧下さい。
• アプリケーションの実体は、各システムの/local/apl/システム名/アプリケーション名/にあります。
• センターでビルドしたアプリケーションの構築法はアプリケーションライブラリーの構築方法を御覧下さい。

ソフトウェア導入の要望

下記の項目を全てご記入の上、rccs-admin[at]ims.ac.jp宛(迷惑メール対策のため、＠を[at]に置換しています)に送信してください。
有料ソフトウェアの場合、導入できないことがあります。

• 導入を希望するソフトウェアの名前、バージョン
• ソフトウェアの概要と特長
• 共同利用システムに導入を希望する必要性
• 開発元のURL

その他のRCCS固有コマンド

バッチジョブ関連

jobinfo, jsub, jdel, jhold, jrls, jobeff については上に説明があります。

Gaussian専用ジョブ投入ツール

g16の場合

ccfep% g16sub [-q "QUE_NAME"] [-j "jobtype"] [-g "XXX"] [-walltime "hh:mm:ss"] [-noedit] \
              [-rev "g16xxx"] [-np "ncpus"] [-ngpus "n"] [-mem "size"] [-save] [-mail] input_files

• g09を使うg09subコマンドも有ります。
• デフォルトのwalltimeは72時間に設定しています。ジョブの実行時間より多少多めに時間を設定してください。
• "g16sub"と入力すると各オプションの意味や使用例が表示されます。
• 元となるインプット中の %nproc や %cpu、%mem の情報は g16sub や g09sub に上書きされます。それらについては -np や -mem 等のオプションで指定して下さい
  • -noedit を使えば %mem の上書きを抑制することはできますが、非推奨です。
  • メモリ量については自動的に上限に近い値が指定されます。値を減らしたい時のような特殊ケースを除けば、ユーザ側で指定する必要はありません。

例: g16c01 で制限時間 24 時間、12 コア利用ジョブ(my_gaussian_input.gjf は Gaussian のインプットファイル)

ccfep% g16sub -rev g16c01 -walltime 24:00:00 -np 12 my_gaussian_input.gjf

ジョブの実行開始時間予測(waitest)

ccfep にある waitest コマンドで実行開始時間が予測できます。詳細についてはこちらのページ(要ログイン)をご覧下さい。
 

資源使用状況表示

ccfep% showlim (-cpu|-c|-disk|-d) [-m]

• -cpu|-c: 使用した使用点数と割当点数の表示
• -disk|-d: 使用しているディスク容量と上限容量の表示
• -m: 所属全メンバー毎の使用状況と上限値の表示

例1: 自身及びグループの利用/割り当て CPU 点数の表示

ccfep% showlim -c

例2: グループ全体及びグループの各メンバの利用/割り当て CPU 点数の表示

ccfep% showlim -c -m

例3: グループ全体及びグループの各メンバの利用/割り当てディスク容量表示

ccfep% showlim -d -m

バッチスクリプト用ユーティリティーコマンド

コマンドの実行時間の制限

/local/apl/lx/ps_walltime -d duration -- command [arguments...]

• -d duration: コマンドを実行させたい時間を"-d 72:00:00"のような形式で記述します。
• 指定時間を過ぎるとcommandをkillします。

ジョブの統計情報の表示

/local/apl/lx/jobstatistic

• PBSのヘッダー行でジョブ終了時にメール送信を指示したときに含まれるジョブ統計情報相当を出力します。
• コマンド実行時までのジョブ統計情報です。

出力項目

• resources_used.cpupercent: CPU利用効率。最大の値はスレッド数x100。複数ノード使用時には異常値を示す場合があります。
• resources_used.cput: 各CPUで実際に演算した時間の総和。
• resources_used.mem: 実際に使用したメモリー量。
• resources_used.ncpus: 使用したCPU数。
• resources_used.walltime: ジョブの実行時間。

演算ノード上のファイル操作

remshコマンドを使うと、演算ノードのramdiskのようにフロントエンド(ccfep)から直接アクセスできないファイルへアクセスできます。

remsh hostname command options

• hostname cccc???, cccca???, ccnn???, ccnf??? のようなホスト名です。
• command 実行するコマンド。ls, cat, cp, find のいずれかを指定できます。
• options コマンドのオプションです。

例: ユーザzzzによる演算ノードccnnXXXでのramdisk操作

remsh ccnnXXX ls /ramd/users/zzz

remsh ccnnXXX cat /ramd/users/zzz/99999/fort.10 | tail

ジョブを実行しているノード名はjobinfoコマンドより確認できます。

問い合わせ

https://ccportal.ims.ac.jp/contact
をご参照下さい。