コマンドラインスクリプトによる MATLAB ジョブスケジューラの構成

MATLAB^® ジョブスケジューラは、グラフィカルインターフェイスまたはコマンドラインを使用して起動できます。グラフィカルインターフェイスの使用方法については、MATLAB ジョブスケジューラの構成を参照してください。グラフィカルインターフェイスである管理センターを使用するには、クラスターのすべてのノードに直接ネットワーク接続するコンピューター上で管理センターを実行しなければなりません。そのようなコンピューターで管理センターを実行できない場合は、コマンドラインインターフェイスを使用しなければなりません。コマンドラインインターフェイスの使用方法については、次の手順に従ってください。

メモ

MATLAB ジョブスケジューラクラスターを初めてセットアップする場合、テストおよび評価に適した基本構成については、MATLAB ジョブスケジューラおよびネットワークライセンスマネージャー向けのインストールを参照してください。

以下の手順において、matlabroot はインストールされている MATLAB Parallel Server™ ソフトウェアの場所を示します。以下の説明でこの文字列が使用されていたら、パスをご使用の場所に置き換えてください。

古いインストールの `mjs` サービスの停止

クラスターノード上で古いバージョンの MATLAB Parallel Server が実行されている場合、新しいインストールのサービスを開始する前に、その mjs サービスを停止する必要があります。

Windows 上の `mjs` の停止

管理者権限で Windows^® コマンドウィンドウを開きます。
コマンドウィンドウで、制御スクリプトが含まれている古いインストール環境のフォルダーに移動します。
```
cd oldmatlabroot\toolbox\parallel\bin
```
次のコマンドを入力して、古いサービスを停止しアンインストールして、このサービスに関連付けられているファイルを削除します。
```
mjs uninstall -clean
```
R2019a より前のリリースでは、このサービスは mdce と呼ばれています。代わりに、次のコマンドを入力します。
```
cd oldmatlabroot\toolbox\distcomp\bin
mdce uninstall -clean
```
メモ
-clean フラグを使用すると、すべての既存のジョブデータが永久的に削除されます。このデータを削除する前に、今後そのデータを使用することがないことを確認してください。
すべてのワーカーノードでこの手順を繰り返します。

UNIX 上の `mjs` の停止

root としてログインします。root としてログインできない場合は、oldmatlabroot/toolbox/parallel/bin/mjs_def.sh ファイルの CHECKPOINTBASE、LOGBASE、PIDBASE、および該当する場合は LOCKBASE パラメーターを変更し、書き込み権限のあるフォルダーを指す必要があります。R2019a より前のリリースで、このファイルは oldmatlabroot/toolbox/distcomp/bin/mdce_def.sh です。
それぞれのクラスターノードで、次のコマンドを入力して mjs サービスを停止し、このサービスに関連付けられているファイルを削除します。
```
cd oldmatlabroot/toolbox/parallel/bin
./mjs stop -clean
```
R2019a より前のリリースでは、このサービスは mdce と呼ばれています。代わりに、次のコマンドを入力します。
```
cd oldmatlabroot/toolbox/distcomp/bin
./mdce stop -clean
```
メモ
-clean フラグを使用すると、すべての既存のジョブデータが永久的に削除されます。このデータを削除する前に、今後そのデータを使用することがないことを確認してください。

MATLAB ジョブスケジューラのカスタマイズ

クラスターノード上で mjs サービスを開始する前に、MATLAB ジョブスケジューラの追加機能を組織の要件に合わせてカスタマイズできます。カスタマイズ可能な機能の詳細については、MATLAB ジョブスケジューラのカスタマイズおよびクラスターのセキュリティと認証を参照してください。

`mjs` サービス、MATLAB ジョブスケジューラおよびワーカーの起動 (Windows)

mjs サービスの開始
すべてのノード (ヘッドノードおよびワーカーノード) 上に mjs サービスをインストールしなければなりません。ヘッドノードから始めます。
1. 管理者権限で Windows コマンドウィンドウを開きます。
2. Windows コマンドウィンドウで、制御スクリプトがあるフォルダーに移動します。
```
cd matlabroot\toolbox\parallel\bin
```
3. 次のコマンドを入力して mjs サービスをインストールします。
```
mjs install
```
4. 次のコマンドを入力して mjs サービスを開始します。
```
mjs start
```
5. すべてのワーカーノードでこの手順を繰り返します。
項目 a ～ d の代わりに、1 台のマシンから次のように入力し、リモートで mjs サービスをノードにインストールして開始することもできます。
```
cd matlabroot\toolbox\parallel\bin
ssh hostA mjs install
ssh hostA mjs start
```
hostA は、リモートホストを表します。ssh ユーティリティの詳細については、次のように入力して使用上の注意事項を参照してください。
```
ssh
```
インストールの完了後、mjs サービスはマシンが再起動するたびに実行を開始します。MATLAB ジョブスケジューラやワーカーセッションが実行されているかどうかに関係なく、mjs サービスは明示的な停止またはアンインストールが行われるまで稼働し続けます。
MATLAB ジョブスケジューラの起動
MATLAB ジョブスケジューラを起動するには、Windows コマンドプロンプトで次のコマンドを入力します。MATLAB Parallel Server のインストール環境にアクセスできる場合、MATLAB ジョブスケジューラを実行するマシンで作業する必要はありません。
1. Windows コマンドプロンプトで、スタートアップスクリプトがあるフォルダーに移動します。
```
cd matlabroot\toolbox\parallel\bin
```
2. 名前 <MyMJS> に一意のテキストを指定して MATLAB ジョブスケジューラを起動します。
```
startjobmanager -name <MyMJS> -remotehost <MATLAB Job Scheduler host name> -v
```
3. 目的のホスト上で MATLAB ジョブスケジューラが実行されていることを確認します。
```
nodestatus -remotehost <MATLAB Job Scheduler host name>
```
  メモ
  MATLAB ジョブスケジューラが実行されているホスト上で startjobmanager を実行している場合は、-remotehost フラグを指定する必要はありません。
  クラスター上に複数の MATLAB ジョブスケジューラがある場合、それぞれの名前は一意でなければなりません。
ワーカーの起動
メモ
マシン上でワーカーを起動するには、そのマシン上で既に mjs サービスが実行されていなければなりません。ネットワークライセンスマネージャーを使用している場合は、ネットワーク上で実行されていなければなりません。
ワーカーとして使用するそれぞれのノードに対して、Windows コマンドプロンプトで次のコマンドを入力します。MATLAB Parallel Server のインストール環境にアクセスできる場合、MATLAB ワーカーを実行するマシンで作業する必要はありません。
1. スタートアップスクリプトがあるフォルダーに移動します。
```
cd matlabroot\toolbox\parallel\bin
```
2. このワーカーを登録する MATLAB ジョブスケジューラの名前を表す <MyMJS> について、次のテキストを使用して各ノードでワーカーを起動します。このテキストは 1 行で入力します。
```
startworker -jobmanagerhost <MATLAB Job Scheduler host name>
    -jobmanager <MyMJS> -remotehost <worker host name> -v
```
  同じマシンで複数のワーカーセッションを実行するには、-num オプションを使用して、起動するワーカーの数を指定します。ワーカー名には '_1'、'_2' のように数字が付加されます。
```
startworker ... -num <numWorkers>
```
3. ワーカーが実行されていることを確認します。
```
nodestatus -remotehost <worker host name>
```
4. すべてのワーカーノードについて項目 b ～ c を繰り返します。
MATLAB Parallel Server は、最大 10,000 個のワーカーをもつ MATLAB ジョブスケジューラクラスターをサポートします。 (R2023b 以降)
mjs、MATLAB ジョブスケジューラおよびワーカープロセスの詳細 (シャットダウンおよびカスタマイズの方法) については、MATLAB ジョブスケジューラの構成と管理を参照してください。

`mjs` サービス、MATLAB ジョブスケジューラおよびワーカーの起動 (UNIX)

mjs サービスの開始
各クラスターノードで、次のコマンドを入力して mjs サービスを開始します。
```
cd matlabroot/toolbox/parallel/bin
./mjs start
```
また、1 台のマシンから次のように入力して、ノードで mjs サービスをリモートで起動することもできます。
```
cd matlabroot/toolbox/parallel/bin
ssh hostA matlabroot/toolbox/parallel/bin/mjs start
ssh hostB matlabroot/toolbox/parallel/bin/mjs start
ssh hostC matlabroot/toolbox/parallel/bin/mjs start
```
hostA、hostB、および hostC は、リモートホスト名を表します。ホスト名のリストが長い場合は、1 台のマシンから次のように入力して、複数のノードで mjs サービスをリモートで起動することもできます。
```
for host in hostA hostB hostC;
 do ssh $host matlabroot/toolbox/parallel/bin/mjs start;
done 
```
ssh ユーティリティの詳細については、次のように入力して使用上の注意事項を参照してください。
```
ssh
```
また、次のように入力してシステムリファレンスマニュアルにアクセスすることもできます。
```
man ssh
```
MATLAB ジョブスケジューラの起動
MATLAB ジョブスケジューラを起動するには、次のコマンドを入力します。MATLAB Parallel Server のインストール環境にアクセスできる場合、MATLAB ジョブスケジューラを実行するマシンで作業する必要はありません。
1. スタートアップスクリプトがあるフォルダーに移動します。
```
cd matlabroot/toolbox/parallel/bin
```
2. 名前 <MyMJS> に一意のテキストを指定して MATLAB ジョブスケジューラを起動します。このテキストは 1 行で入力します。
```
./startjobmanager -name <MyMJS> -remotehost <MATLAB Job Scheduler host name> -v
```
3. MATLAB ジョブスケジューラが目的のホスト上で実行されていることを確認します。
```
./nodestatus -remotehost <MATLAB Job Scheduler host name>
```
  メモ
  クラスター上に複数の MATLAB ジョブスケジューラがある場合、それぞれの名前は一意でなければなりません。
ワーカーの起動
メモ
マシン上でワーカーを起動するには、そのマシン上で既に mjs サービスが実行されていなければなりません。ネットワークライセンスマネージャーを使用している場合は、ネットワーク上で実行されていなければなりません。
MATLAB ワーカーをホスティングするコンピューターごとに、次のコマンドを入力します。MATLAB Parallel Server のインストール環境にアクセスできる場合、MATLAB ワーカーを実行するマシンで作業する必要はありません。
1. スタートアップスクリプトがあるフォルダーに移動します。
```
cd matlabroot/toolbox/parallel/bin
```
2. このワーカーを登録する MATLAB ジョブスケジューラの名前を表す <MyMJS> について、次のテキストを使用して各ノードでワーカーを起動します。このテキストは 1 行で入力します。
```
./startworker -jobmanagerhost <MATLAB Job Scheduler host name>
   -jobmanager <MyMJS> -remotehost <worker host name> -v
```
  同じマシンで複数のワーカーセッションを実行するには、-num オプションを使用して、起動するワーカーの数を指定します。ワーカー名には '_1'、'_2' のように数字が付加されます。
```
./startworker ... -num <numWorkers>
```
3. ワーカーが実行されていることを確認します。ワーカーノードごとに次のコマンドを実行します。
```
./nodestatus -remotehost <worker host name>
```
MATLAB Parallel Server は、最大 10,000 個のワーカーをもつ MATLAB ジョブスケジューラクラスターをサポートします。 (R2023b 以降)
mjs、MATLAB ジョブスケジューラおよびワーカープロセスの詳細 (シャットダウンおよびカスタマイズの方法) については、MATLAB ジョブスケジューラの構成と管理を参照してください。

MATLAB ジョブスケジューラを含むインストール環境の検証

MATLAB Parallel Server 製品のインストールおよび構成が正しく行われたことを確認するには、クラスタープロファイルを作成して検証します。詳細については、MATLAB Parallel Server クラスターへの MATLAB クライアントの接続を参照してください。プロファイルの検証時にクラスター全体を占有しないように、使用するワーカー数を指定できます。検証をパスしなかった場合は、MathWorks インストールサポートチームに問い合わせるか、一般的な問題のトラブルシューティングを参照してください。

クラスタープロファイルの作成後に、アプリケーションに適した任意の変更を加えることができます (NumWorkersRange、AttachedFiles、AdditionalPaths など)。他のユーザー用にプロファイルを保存するには、クラスタープロファイルマネージャーでプロファイルを選択し、[エクスポート] をクリックしてから、便利な場所のファイルにプロファイルを保存します。後で、クラスタープロファイルマネージャーの実行中に、他のユーザーは [インポート] をクリックしてこのプロファイルをインポートできます。クラスタープロファイルの詳細については、クラスターの検出とクラスタープロファイルの使用 (Parallel Computing Toolbox)を参照してください。

コマンドラインスクリプトによる MATLAB ジョブスケジューラの構成

古いインストールの `mjs` サービスの停止

Windows 上の `mjs` の停止

UNIX 上の `mjs` の停止

MATLAB ジョブスケジューラのカスタマイズ

`mjs` サービス、MATLAB ジョブスケジューラおよびワーカーの起動 (Windows)

`mjs` サービス、MATLAB ジョブスケジューラおよびワーカーの起動 (UNIX)

MATLAB ジョブスケジューラを含むインストール環境の検証

参考

トピック

コマンド ライン スクリプトによる MATLAB ジョブ スケジューラの構成

古いインストールの mjs サービスの停止

Windows 上の mjs の停止

UNIX 上の mjs の停止

MATLAB ジョブ スケジューラのカスタマイズ

mjs サービス、MATLAB ジョブ スケジューラおよびワーカーの起動 (Windows)

mjs サービス、MATLAB ジョブ スケジューラおよびワーカーの起動 (UNIX)

MATLAB ジョブ スケジューラを含むインストール環境の検証

参考

トピック

コマンドラインスクリプトによる MATLAB ジョブスケジューラの構成

古いインストールの `mjs` サービスの停止

Windows 上の `mjs` の停止

UNIX 上の `mjs` の停止

MATLAB ジョブスケジューラのカスタマイズ

`mjs` サービス、MATLAB ジョブスケジューラおよびワーカーの起動 (Windows)

`mjs` サービス、MATLAB ジョブスケジューラおよびワーカーの起動 (UNIX)

MATLAB ジョブスケジューラを含むインストール環境の検証