RemoteClusterAccess
クライアント ユーティリティがローカルで使用できないときにスケジューラに接続する
コンストラクター
r = parallel.cluster.RemoteClusterAccess(username)
r = parallel.cluster.RemoteClusterAccess(username,P1,V1,...,Pn,Vn)
説明
r = parallel.cluster.RemoteClusterAccess(
は、username
)Username
が username
に設定された RemoteClusterAccess
オブジェクトを作成します。
既定では、クラスターに接続する際にパスワードを要求されます。
ヒント
リモート クラスターのクラスター プロファイルを設定した場合は、parcluster
を使用します。詳細については、クラスターの検出とクラスター プロファイルの使用を参照してください。
非共有モードまたはリモート送信モードで接続するサードパーティ製スケジューラのプラグイン スクリプトを変更する必要がある場合、使用する必要があるのは RemoteClusterAccess
のみです。プラグイン スクリプトは、汎用スケジューラ インターフェイスを使用してクラスターに接続する場合に使用します。
クライアントがサードパーティ製スケジューラに直接投入できない場合、またはクライアントがファイル システムをクラスターと共有していない場合は、以下を検討してください。
サードパーティ製スケジューラに MathWorks® アドオンがある場合は、それをインストールします。アドオンを使用する場合、セットアップ ウィザードまたはクラスター プロファイル マネージャーを使用してクラスター プロファイルを設定し、多数の設定を指定できます。詳細については、汎用スケジューラのプラグイン スクリプトを参照してください。
アドオンがないサードパーティ製スケジューラを使用する必要がある場合、またはアドオンのカスタマイズが必要な場合は、汎用スケジューラ インターフェイスを使用した構成 (MATLAB Parallel Server)を参照してください。
リモート クラスター接続、投入、またはデータ転送の設定を変更する必要がある場合は、
RemoteClusterAccess
を使用します。
r = parallel.cluster.RemoteClusterAccess(___,
は、1 つ以上の名前と値の引数を使用して、Name,Value
)RemoteClusterAccess
オブジェクトを作成します。たとえば、'Port',31415
を指定すると、ポート番号 31415
を使用してクラスターに接続します。名前と値の引数は、他のすべての入力引数の後で指定します。
受け入れられる名前と値の引数は以下のとおりです。
'AuthenticationMode'
— クラスターへの接続時に使用する認証モード。string スカラーまたは文字ベクトルとして指定します。引数
'IdentityFilename'
を指定する場合、既定値は'IdentityFile'
です。それ以外の場合、既定値は'Password'
です。'AuthenticationMode'
の有効な値は次のとおりです。'Agent'
– クライアントはクライアント マシン上で実行される SSH エージェントと連動します。'IdentityFile'
– クライアントはクラスターへの接続時に ID ファイルを使用して認証を行います。IdentityFilename
オプションを使用してファイルを指定する場合は、そのファイルを使用します。それ以外の場合、MATLAB® は接続時に ID ファイルへの絶対パスを指定するよう要求します。'Multifactor'
– クライアントにより 1 回以上の入力が要求されます。たとえば、クライアント上で 2 要素認証 (2FA) が有効になっている場合、クライアントによりパスワードと 2 番目の認証要素に対する応答を要求されます。'Password'
– クライアントにより SSH パスワードが要求されます。ユーザー名はUsername
プロパティで指定されます。
'IdentityFileHasPassphrase'
— ID ファイルでパスフレーズを要求するかどうかを指定するフラグ。true
またはfalse
として指定します。true
の場合は、接続時にパスワードを要求されます。ID ファイルが提供されていない場合、この名前と値の引数は使用されません。'IdentityFilename'
—RemoteClusterAccess
がリモート ホストに接続する際に使用する ID ファイルの絶対パス。'IdentityFilename'
、および string スカラーまたは文字ベクトルとして指定します。'Port'
— 接続先のクラスターのポート番号。1
~65535
の整数スカラーとして指定します。既定値は
22
です。
詳細と詳しい例については、リモート ホストからの送信および共有ファイル システムなしでの送信を参照してください。
メソッド
メソッド名 | 説明 |
---|---|
connect |
|
disconnect | disconnect(r) は既存のリモート接続を切断します。connect メソッドを事前に呼び出しておかなければなりません。 |
doLastMirrorForJob |
|
getRemoteJobLocation |
|
isJobUsingConnection | ジョブが現在ミラーされていない場合、 |
resumeMirrorForJob |
|
runCommand |
|
startMirrorForJob |
|
stopMirrorForJob |
|
getConnectedAccess |
|
getConnectedAccessWithMirror |
|
プロパティ
RemoteClusterAccess
オブジェクトには、以下の読み取り専用のプロパティがあります。これらの値は、このオブジェクトを作成するときか、その connect
メソッドを呼び出すときに設定します。
プロパティ名 | 説明 |
---|---|
AuthenticationMode | クラスターに接続する際の認証方法を示すオプション。次のいずれかとして返されます。
このプロパティを設定するには、 |
Hostname | アクセスするリモート ホストの名前。文字ベクトルとして返されます。 既定値は空の文字ベクトルです。 |
IdentityFileHasPassphrase | ID ファイルでパスフレーズを要求するかどうかを指定するフラグ。 既定値は このプロパティが このプロパティを設定するには、 |
IdentityFilename |
既定値は空の文字ベクトルです。このプロパティが空の場合は、接続時にパスワードを要求されます。 このプロパティを設定するには、 |
IsConnected |
既定値は |
IsFileMirrorSupported |
既定値は
|
JobStorageLocation | ミラーされているファイルのリモート ホストでの場所。文字ベクトルとして返されます。 既定値は空の文字ベクトルです。 このプロパティを設定するには、次のいずれかの構文を使用してクラスターに接続します。
|
Port | クラスターへの接続に使用するポート番号。 既定値は このプロパティを設定するには、 |
UseIdentityFile |
既定値は |
Username | クラスターへの接続に使用するユーザー名。文字ベクトルとして返されます。 |
例
リモート データの場所からファイルをミラーします。job
オブジェクトはお使いの汎用スケジューラのジョブを表しているものとします。
remoteConnection = parallel.cluster.RemoteClusterAccess('testname'); connect(remoteConnection,'headnode1','/tmp/filemirror'); startMirrorForJob(remoteConnection,job); submit(job) % Wait for the job to finish wait(job); % Ensure that all the local files are up to date, and remove the % remote files doLastMirrorForJob(remoteConnection,job); % Get the output arguments for the job results = fetchOutputs(job)
詳細と例については、リモート ホストからの送信および共有ファイル システムなしでの送信を参照してください。