RemoteClusterAccess

Свяжите с планировщиками, когда клиентские утилиты не будут доступны локально

Конструктор

parallel.cluster.RemoteClusterAccess

r = parallel.cluster.RemoteClusterAccess(username)

r = parallel.cluster.RemoteClusterAccess(username,P1,V1,...,Pn,Vn)

Описание

parallel.cluster.RemoteClusterAccess позволяет вам устанавливать связь и команды выполнения на удаленном хосте. Этот класс предназначается для использования с типовым интерфейсом планировщика при использовании удаленного представления заданий или в неразделяемых файловых системах.

r = parallel.cluster.RemoteClusterAccess(username) использует предоставленное имя пользователя при соединении с удаленным хостом и возвращает RemoteClusterAccess объект r. Вам предложат пароль при установлении связи.

r = parallel.cluster.RemoteClusterAccess(username,P1,V1,...,Pn,Vn) позволяет дополнительные пары значения параметров, которые изменяют поведение связи. Принятые параметры:

  • 'IdentityFilename' — Вектор символов, содержащий полный путь к единичному файлу, чтобы использовать при соединении с удаленным хостом. Если 'IdentityFilename' не задан, вам предлагают пароль при установлении связи.

  • 'IdentityFileHasPassphrase' — Логическое указание, требует ли единичный файл пароля. Если это правда, вам предлагают пароль при установлении связи. Если единичный файл не предоставляется, это свойство проигнорировано. Этим значением является false по умолчанию.

Для получения дополнительной информации и подробные примеры, смотрите Представление от Удаленного Хоста и Представление без Совместно используемой файловой системы.

Методы

MethodName Описание
connect

connect(r,clusterHost) устанавливает связь с заданным хостом с помощью пользовательских учетных опций, предоставленных в конструкторе. Зеркальное отражение файла не поддержано.

connect(r,clusterHost,remoteDataLocation) устанавливает связь с заданным хостом с помощью пользовательских учетных опций, предоставленных в конструкторе. remoteDataLocation идентифицирует папку на clusterHost это используется в зеркальном отражении файла. Удостоверения пользователя, предоставленные в конструкторе, должны иметь доступ для записи к этой папке.

disconnectdisconnect(r) отключает существующую удаленную связь. connect метод, должно быть, был уже назван.
doLastMirrorForJob

doLastMirrorForJob(r,job) выполняет итоговую копию измененных файлов от удаленного DataLocation к локальному DataLocation для предоставленного задания. Любые рабочие зеркала для задания также останавливаются, и файлы задания удалены из удаленного DataLocation. startMirrorForJob или resumeMirrorForJob метод, должно быть, был уже назван.

getRemoteJobLocation

getRemoteJobLocation(r,jobID,remoteOS) возвращает полный путь в удаленное местоположение задания для предоставленного jobID. Допустимые значения для remoteOS 'pc' и 'unix'.

isJobUsingConnection

isJobUsingConnection(r,jobID) возвращает true если задание в настоящее время зеркально отражается.

resumeMirrorForJob

resumeMirrorForJob(r,job) возобновляет зеркальное отражение файлов от удаленного DataLocation к локальному DataLocation для предоставленного задания. Это похоже на startMirrorForJob метод, но сначала не копирует файлы с локального DataLocation к удаленному DataLocation. connect метод, должно быть, был уже назван. Это полезно, если исходный клиентский сеанс работы с MATLAB закончился, и вы получаете доступ к тем же файлам от нового клиентского сеанса.

runCommand

[status,result] = runCommand(r,command) запускает предоставленную команду на удаленном хосте и возвращает получившееся состояние и стандартный вывод. connect метод, должно быть, был уже назван.

startMirrorForJob

startMirrorForJob(r,job) копии все файлы задания от локального DataLocation к удаленному DataLocation, и начинает зеркально отражать файлы так, чтобы любые изменения в файлах в удаленном DataLocation копируются назад в локальный DataLocation. connect метод, должно быть, был уже назван.

stopMirrorForJob

stopMirrorForJob(r,job) сразу останавливает зеркальное отражение файлов от удаленного DataLocation к локальному DataLocation для заданного задания. startMirrorForJob или resumeMirrorForJob метод, должно быть, был уже назван. Это отменяет рабочее зеркало и удаляет файлы для задания от удаленного местоположения. Это похоже на doLastMirrorForJob, за исключением того, что stopMirrorForJob не предпринимает попытки гарантировать, что локальные файлы задания актуальны. Для нормальной зеркальной остановки используйте doLastMirrorForJob.

getConnectedAccess

getConnectedAccess(host,username) возвращает RemoteClusterAccess объект, который соединяется с предоставленным хостом. Эта функция может возвратить ранее созданный RemoteClusterAccess возразите, существуете ли вы.

getConnectedAccess(...,P1,V1,...Pn,Vn) передает дополнительные параметры RemoteClusterAccess конструктор.

getConnectedAccessWithMirror

getConnectedAccessWithMirror(host,location,username) возвращает RemoteClusterAccess объект, который соединяется с предоставленным хостом, с помощью местоположения в качестве зеркального местоположения. Эта функция может возвратить ранее созданный RemoteClusterAccess возразите, существуете ли вы.

getConnectedAccessWithMirror(...,P1,V1,...Pn,Vn) передает дополнительные параметры RemoteClusterAccess конструктор.

Свойства

RemoteClusterAccess объект имеет следующие свойства только для чтения. Их значения установлены, когда вы создаете объект или вызываете его connect метод.

PropertyName Описание
HostnameИмя удаленного хоста доступа.
IdentityFileHasPassphrase Указывает, требует ли единичный файл пароля.
IdentityFilenameПолный путь к единичному файлу, используемому при соединении с удаленным хостом.
IsConnectedУказывает, существует ли активная связь с удаленным хостом.
IsFileMirrorSupportedУказывает, поддерживается ли зеркальное отражение файла для этой связи. Это - false если никакой удаленный DataLocation предоставляется connect() метод.
JobStorageLocationМестоположение на удаленном хосте к файлам, которые зеркально отражаются.
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)

Для получения дополнительной информации и примеры, смотрите Представление от Удаленного Хоста и Представление без Совместно используемой файловой системы.

Введенный в R2011a

Для просмотра документации необходимо авторизоваться на сайте