RemoteClusterAccess

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

Конструктор

r = parallel.cluster.RemoteClusterAccess(username)

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

Описание

r = parallel.cluster.RemoteClusterAccess(username) создает RemoteClusterAccess объект с Username установите на username.

По умолчанию вам предлагают пароль, когда вы соединяетесь с кластером.

Совет

Если вы установили кластерный профиль для удаленного кластера, использовать parcluster. Для получения дополнительной информации смотрите, Обнаруживают Кластеры и Профили Кластера Использования.

Только необходимо использовать RemoteClusterAccess если необходимо изменить сменные скрипты для сторонних планировщиков, с которыми вы соединяетесь в неразделяемом или удаленном режиме представления. Вы используете сменные скрипты, когда вы соединяетесь с кластером с помощью Типового интерфейса планировщика.

Если клиент не может подчиниться непосредственно стороннему планировщику, или клиент не совместно использует файловую систему с кластером, рассматривает следующее:

Если сторонний планировщик имеет MathWorks^® дополнение, установите его. Когда вы используете дополнение, можно настроить кластерный профиль с помощью мастера установки или Кластерного менеджера по Профилю, чтобы установить много настроек. Для получения дополнительной информации см. Сменные Скрипты для Типовых Планировщиков.
Если необходимо использовать сторонний планировщик, который не имеет дополнения, или если необходимо настроить дополнение, смотрите, Конфигурируют Используя Типовой Интерфейс Планировщика (MATLAB Parallel Server).
Используйте RemoteClusterAccess когда необходимо изменить настройки для удаленной кластерной связи, представления или передачи данных.

r = parallel.cluster.RemoteClusterAccess(___,Name,Value) создает RemoteClusterAccess объект с помощью одних или нескольких аргументов name-value. Например, задайте 'Port',31415 соединяться с кластером с помощью номера порта 31415. Задайте аргументы name-value после всех других входных параметров.

Принятые аргументы name-value:

'AuthenticationMode' — Режим аутентификации, который вы используете, когда вы соединяетесь с кластером в виде строкового скаляра или вектора символов.
Если вы задаете аргумент 'IdentityFilename', значением по умолчанию является 'IdentityFile'. В противном случае значением по умолчанию является 'Password'. Допустимые значения для 'AuthenticationMode' :
- 'Password' – клиент предлагает вам ваш пароль SSH. Ваше имя пользователя задано Username свойство.
- 'IdentityFile' – клиент использует единичный файл, чтобы аутентифицировать, когда вы соединяетесь с кластером. Если вы задаете файл с помощью IdentityFilename опция, вы используете тот файл. В противном случае, MATLAB^® подсказки вы, чтобы задать полный путь к единичному файлу, когда вы соединяетесь.
- 'Agent' – клиент взаимодействует через интерфейс с агентом SSH, работающим на клиентской машине. Только Театрализованное представление агент SSH поддерживается на клиентских машинах Windows.
'IdentityFileHasPassphrase' — Отметьте указание, если единичный файл требует пароля в виде true или false. Если true, вам предлагают пароль, когда вы соединяетесь. Если единичный файл не предоставляется, этот аргумент значения имени не используется.
'IdentityFilename' — Полный путь к единичному файлу, чтобы использовать, когда RemoteClusterAccess подключения к удаленному хосту в виде 'IdentityFilename' и строковый скаляр или вектор символов.
'Port' — Номер порта в кластере вы соединяетесь с в виде целочисленного скаляра между 1 и 65535.
Значением по умолчанию является 22.

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

Методы

MethodName	Описание
`connect`	`connect(r,clusterHost)` устанавливает связь с заданным хостом с помощью пользовательских учетных опций, предоставленных в конструкторе. Зеркальное отражение файла не поддерживается. `clusterHost` должен запустить Linux. `connect(r,clusterHost,remoteDataLocation)` устанавливает связь с заданным хостом с помощью пользовательских учетных опций, предоставленных в конструкторе. `remoteDataLocation` идентифицирует папку на `clusterHost` это используется для зеркального отражения файла. Удостоверения пользователя, предоставленные в конструкторе, должны иметь доступ для записи к этой папке.
`disconnect`	`disconnect(r)` отключает существующую удаленную связь. `connect` метод, должно быть, был уже назван.
`doLastMirrorForJob`	`doLastMirrorForJob(r,job)` выполняет итоговую копию измененных файлов от удаленного `remoteDataLocation` к локальному `JobStorageLocation` для предоставленного задания. Любые рабочие зеркала для задания также останавливаются, и файлы задания удалены из удаленного `remoteDataLocation`. `startMirrorForJob` или `resumeMirrorForJob` метод, должно быть, был уже назван.
`getRemoteJobLocation`	`getRemoteJobLocation(r,jobID,remoteOS)` возвращает полный путь в удаленное местоположение задания для предоставленного `jobID`. Допустимые значения для `remoteOS` `'pc'` и `'unix'`.
`isJobUsingConnection`	`isJobUsingConnection(r,jobID)` возвращает `true` если задание в настоящее время зеркально отражается.
`resumeMirrorForJob`	`resumeMirrorForJob(r,job)` возобновляет зеркальное отражение файлов от удаленного `remoteDataLocation` к локальному `JobStoragelocation` для предоставленного задания. Это похоже на `startMirrorForJob` метод, но сначала не копирует файлы с локального `JobStorageLocation` к удаленному `remoteDataLocation`. `connect` метод, должно быть, был уже назван. Это полезно, если исходный клиентский сеанс работы с MATLAB закончился, и вы получаете доступ к тем же файлам от нового клиентского сеанса.
`runCommand`	`[status,result] = runCommand(r,command)` запускает предоставленную команду на удаленном хосте и возвращает получившееся состояние и стандартный вывод. `connect` метод, должно быть, был уже назван.
`startMirrorForJob`	`startMirrorForJob(r,job)` копии все файлы задания от локального `JobStorageLocation` к удаленному `remoteDataLocation`, и начинает зеркально отражать файлы так, чтобы любые изменения в файлах в удаленном `remoteDataLocation` копируются назад в локальный `JobStorageLocation`. `connect` метод, должно быть, был уже назван.
`stopMirrorForJob`	`stopMirrorForJob(r,job)` сразу останавливает зеркальное отражение файлов от удаленного `remoteDataLocation` к локальному `JobStorageLocation` для заданного задания. `startMirrorForJob` или `resumeMirrorForJob` метод, должно быть, был уже назван. Это отменяет рабочее зеркало и удаляет файлы для задания от удаленного местоположения. Это похоже на `doLastMirrorForJob`, за исключением того, что `stopMirrorForJob` не предпринимает попытки гарантировать, что локальные файлы задания актуальны. Для нормальной зеркальной остановки используйте `doLastMirrorForJob`.
`getConnectedAccess`	`getConnectedAccess(host,username)` возвращает `RemoteClusterAccess` объект, который соединяется с предоставленным хостом. Эта функция может возвратить ранее созданный `RemoteClusterAccess` возразите, существуете ли вы. `host` должен запустить Linux. `getConnectedAccess(...,P1,V1,...Pn,Vn)` передает дополнительные параметры `RemoteClusterAccess` конструктор.
`getConnectedAccessWithMirror`	`getConnectedAccessWithMirror(host,remoteDataLocation,username)` возвращает `RemoteClusterAccess` объект, который соединяется с предоставленным хостом, с помощью `remoteDataLocation` как зеркальное местоположение. Эта функция может возвратить ранее созданный `RemoteClusterAccess` возразите, существуете ли вы. `host` должен запустить Linux. `getConnectedAccessWithMirror(...,P1,V1,...Pn,Vn)` передает дополнительные параметры `RemoteClusterAccess` конструктор.

Свойства

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

PropertyName	Описание
`AuthenticationMode`	Опция, указывающая, как вы аутентифицируетесь, когда вы соединяетесь с кластером, возвратилась как одно из следующего: `'Password'` – клиент предлагает вам ваш пароль SSH. Ваше имя пользователя задано `Username` свойство. `'IdentityFile'` – клиент использует единичный файл, чтобы аутентифицировать, когда вы соединяетесь с кластером. Если `IdentityFilename` свойство не является пустой строкой или пустым символьным вектором, вы используете тот файл. В противном случае, подсказки MATLAB вы, чтобы задать полный путь к единичному файлу, когда вы соединяетесь. `'Agent'` – клиент взаимодействует через интерфейс с агентом SSH, работающим на клиентской машине. Только Театрализованное представление агент SSH поддерживается на клиентских машинах Windows. Если `IdentityFilename` свойство не является скаляром пустой строки или пустым символьным вектором, это свойство установлено в `'IdentityFile'` по умолчанию. В противном случае это установлено в `'Password'` по умолчанию. Чтобы установить это свойство, задайте `'AuthenticationMode'` аргумент значения имени, когда вы создаете `RemoteClusterAccess` объект.
`Hostname`	Имя удаленного хоста доступа, возвращенного как вектор символов. Значением по умолчанию является пустой символьный вектор.
`IdentityFileHasPassphrase`	Отметьте указание, если единичный файл требует пароля в виде разделенной запятой пары, состоящей из `'IdentityFileHasPassphrase'` и `true` или `false`. Значением по умолчанию является `false`. Если это свойство установлено в `true`, вам предлагают пароль, когда вы соединяетесь. Если единичный файл не предоставляется, это свойство не используется. Чтобы установить это свойство, задайте `'IdentityFileHasPassphrase'` аргумент значения имени, когда вы создаете `RemoteClusterAccess` объект.
`IdentityFilename`	Полный путь к единичному файлу, чтобы использовать, когда `RemoteClusterAccess` возразите подключениям к удаленному хосту, возвращенному как вектор символов. Значением по умолчанию является пустой символьный вектор. Если это свойство пусто, вам предлагают пароль, когда вы соединяетесь. Чтобы установить это свойство, задайте `'IdentityFilename'` аргумент значения имени, когда вы создаете `RemoteClusterAccess` объект.
`IsConnected`	Отметьте указание если `RemoteClusterAccess` объект соединяется с кластером, возвращенным как `true` или `false`. Значением по умолчанию является `false`.
`IsFileMirrorSupported`	Отметьте указание, если зеркальное отражение файла поддерживается для `RemoteClusterAccess` объект в виде `true` или `false`. Значением по умолчанию является `false`. `IsFileMirrorSupported` свойство установлено в `true` если `JobStorageLocation` свойство не пусто.
`JobStorageLocation`	Местоположение на удаленном хосте к файлам, которые зеркально отражаются, возвратилось как вектор символов. Значением по умолчанию является пустой символьный вектор. Чтобы установить это свойство, используйте любой из следующих синтаксисов, чтобы соединиться с кластером: `connect(r,clusterHost,remoteDataLocation)` `r = getConnectedAccessWithMirror(host,remoteDataLocation,username)` `r = getConnectedAccessWithMirror(___,P1,V1,...Pn,Vn)`
`Port`	Номер порта вы используете, чтобы соединиться с кластером, возвращенным как целочисленный скаляр между `1` и `65535`. Значением по умолчанию является `22`. Чтобы установить это свойство, задайте `'Port'` аргумент значения имени, когда вы создаете `RemoteClusterAccess` объект.
`UseIdentityFile`	Отметьте указание если `RemoteClusterAccess`возразите использует единичный файл, чтобы соединиться с кластером, возвращенным как `true` или `false`. Значением по умолчанию является `false`. Если `AuthenticationMode` свойством является `'IdentityFile'`, `UseIdentityFile` свойством является `true`.
`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)

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

Документация

RemoteClusterAccess

Конструктор

Описание

Методы

Свойства

Примеры

Смотрите также

Темы

Документация Parallel Computing Toolbox

Поддержка