parallel.Cluster

Доступ к кластерным свойствам и поведению

Конструкторы

parcluster

getCurrentCluster (в рабочей области работника MATLAB)

Контейнерная иерархия

Родительский элемент

'none'

Дочерние элементы

parallel.Job, parallel.Pool

Описание

parallel.Cluster object обеспечивает доступ к кластеру, который управляет очередью заданий и распределяет задачи рабочим для выполнения.

Типы

Двумя категориями кластеров является MATLAB® Планировщик задания и общий планировщик задания (CJS). Планировщик Задания MATLAB доступен в MATLAB Parallel Server™. Кластеры CJS охватывают все другие типы, включая локальные, типовые, и сторонние планировщики.

Используйте MJSComputeCloud объекты взаимодействовать с MATLAB Parallel Server для Amazon EC2® кластеры.

Следующая таблица описывает доступные типы кластерных объектов.

Кластерный типОписание
parallel.cluster.MJSВзаимодействуйте с кластером Планировщика Задания MATLAB на месте
parallel.cluster.MJSComputeCloudВзаимодействуйте с MATLAB Parallel Server для кластера Amazon EC2
parallel.cluster.LocalВзаимодействуйте с кластером CJS, запускающимся локально на клиентской машине
parallel.cluster.HPCServerВзаимодействуйте с кластером CJS, запускающим Windows Microsoft HPC Server
parallel.cluster.LSFВзаимодействуйте с кластером CJS, запускающим LSF
parallel.cluster.PBSProВзаимодействуйте с кластером CJS рабочий Альтаир PBS Pro или OpenPBS
parallel.cluster.TorqueВзаимодействуйте с кластером CJS, запускающим КРУТЯЩИЙ МОМЕНТ
parallel.cluster.SlurmВзаимодействуйте с кластером CJS рабочий Slurm
parallel.cluster.GenericВзаимодействуйте с кластером CJS использование типового интерфейса

Методы

Характерный для всех кластерных типов

batchЗапустите скрипт MATLAB или функционируйте на рабочем
createCommunicatingJobСоздайте связывающееся задание в кластере
createJobСоздайте независимое задание в кластере
findJobНайдите объекты задания сохраненными в кластере
isequalВерный, если кластеры имеют те же значения свойств
parpoolСоздайте параллельный пул в кластере
saveAsProfileСохраните кластерные свойства в заданный профиль
saveProfileСохраните измененные кластерные свойства в его текущий профиль

Планировщик задания MATLAB

changePasswordПредложите пользователю изменять пароль Планировщика Задания MATLAB
demoteПонизьте в должности задание в кластерной очереди
logoutВыйдите из кластера Планировщика Задания MATLAB
promoteПродвиньте задание в очереди кластера Планировщика Задания MATLAB
resumeПродолжите обрабатывать очередь в Планировщике Задания MATLAB

MJSComputeCloud

shutdown Закройте кластер облака
startЗапустите кластер облака
wait (cluster)Ожидайте кластера облака, чтобы изменить состояние

Сервер HPC, PBS Pro, LSF, КРУТЯЩИЙ МОМЕНТ, Slurm и локальные кластеры

getDebugLogСчитайте выходные сигналы из задания, запущенного в кластере CJS

Типовой

getDebugLogСчитайте выходные сигналы из задания, запущенного в кластере CJS
getJobClusterDataПолучите определенные пользовательские данные для задания в типовом кластере
getJobFolderПапка на клиенте, где задания хранятся
getJobFolderOnClusterПапка в кластере, где задания хранятся
getLogLocationРегистрируйте местоположение для задания или задачи
setJobClusterDataУстановите определенные пользовательские данные для задания в типовом кластере

Свойства

Характерный для всех кластерных типов

Следующие свойства характерны для всех кластерных типов объектов.

СвойствоОписание
ClusterMatlabRootЗадает путь к MATLAB для рабочих, чтобы использовать
HostИмя хоста кластерного главного узла
JobStorageLocationМестоположение, где кластер хранит информация о задаче и задание
JobsСписок заданий содержится в этом кластере
LicenseNumberНомер лицензии, чтобы использовать, когда рабочие задания с этим кластером
ModifiedВерный, если какие-либо свойства в этом кластере были изменены
NumThreadsКоличество вычислительных потоков для рабочих
NumWorkersКоличество рабочих, доступных для этого кластера
OperatingSystemОперационная система узлов используется кластером
ProfileПрофиль раньше создавал этот кластер
RequiresOnlineLicensingВерный, если кластер использует онлайн лицензирование
TypeТип этого кластера
UserDataИнформация сопоставлена с кластерным объектом в клиентском сеансе

Задайте JobStorageLocation свойство как одно из следующих.

  • Если вы используете типовой интерфейс планировщика в удаленном режиме, чтобы взаимодействовать со сторонним планировщиком, и клиент и рабочие используют различные операционные системы, задают структуру. Структура должна иметь поля 'windows' и 'unix'. Поля являются Windows и путем к Unix, соответствующим папке, где кластер хранит информация о задаче и задание. Следующая структура задает ту же папку с помощью Windows UNC path ('\\organization\some\path') и путь к Unix ('/organization/some/path'):

    struct('windows', '\\organization\some\path', 'unix', '/organization/some/path')

  • В противном случае используйте вектор символов или строку, чтобы задать папку, где кластер хранит информация о задаче и задание.

Планировщик задания MATLAB

MJS кластерные объекты имеют следующие свойства в дополнение к общей собственности:

СвойствоОписание
AllHostAddressesIP-адреса кластерного хоста
BusyWorkersВ настоящее время выполняющиеся задачи рабочих
IdleWorkersРабочие, в настоящее время доступные для выполняющихся задач
HasSecureCommunicationВерный, если кластер использует безопасную коммуникацию
NameИмя этого кластера
NumBusyWorkersКоличество в настоящее время выполняющихся задач рабочих
NumIdleWorkersКоличество рабочих, доступных для выполняющихся задач
PromptForPasswordВерный, если система должна запросить пароль при аутентификации пользователя
SecurityLevelСтепень безопасности, к которой применяются кластер и его задания. Для описаний уровней безопасности смотрите Набор безопасность Кластера Планировщика Задания MATLAB (MATLAB Parallel Server).
StateТекущее состояние кластера
UsernameПользователь, получающий доступ к кластеру

MJSComputeCloud

MJSComputeCloud кластерные объекты имеют следующие свойства в дополнение к общей собственности:

СвойствоОписание
BusyWorkersВ настоящее время выполняющиеся задачи рабочих
CertificateКластерный сертификат SSL
HasSecureCommunicationВерный, если кластер использует безопасную коммуникацию
IdentifierУникальный кластерный идентификатор
IdleWorkersРабочие, в настоящее время доступные для выполняющихся задач
MatlabVersionВерсия MATLAB, работающего на рабочих
MaxNumWorkers

Максимальное количество рабочих этот кластер может использовать.

  • Когда вы используете кластер с автоматическим изменением размеров, рабочие добавляются автоматически до этого максимального значения по мере необходимости. Для получения дополнительной информации об автоматическом изменении размеров смотрите, Изменяют размер Кластеров Автоматически.

  • Когда вы используете кластер без автоматического изменения размеров, это значение является количеством рабочих, когда вы запустили кластер.

NameИмя этого кластера
NumBusyWorkersКоличество в настоящее время выполняющихся задач рабочих
NumIdleWorkersКоличество рабочих, доступных для выполняющихся задач
NumWorkersRequestedКоличество рабочих требуют для этого кластера. Кластер добавляет или удаляет рабочих как можно скорее, чтобы достигнуть этого номера.
SharedState

Общее состояние кластера, который может быть:

  • Персональный – Только можно использовать этот кластер, пока вы создали его.

  • Общий – Любой может использовать этот кластер.

ShutdownAtЗавершите работу времени или события
StateТекущее состояние кластера
UsernameПользователь, получающий доступ к кластеру

Локальный

Local кластерные объекты не имеют никаких доступных для редактирования свойств вне свойств, характерных для всех кластеров.

Сервер HPC

HPCServer кластерные объекты поддерживаются на клиентах, запускающих Windows.

HPCServer кластерные объекты имеют следующие свойства в дополнение к общей собственности:

СвойствоОписание
ClusterVersionВерсия Сервера HPC Microsoft Windows, работающего на кластере
HasSharedFilesystemЗадайте, совместно используют ли клиент и кластерные узлы JobStorageLocation
JobDescriptionFileИмя файла должностной инструкции XML, чтобы использовать при создании заданий
JobTemplateИмя задания обрабатывает по шаблону, чтобы использовать для заданий, представленных Серверу HPC
NameИмя этого кластера
UseSOAJobSubmissionПозвольте представление архитектуры для обслуживания широкого круга запросов (SOA) на Сервере HPC

PBS Pro и КРУТЯЩИЙ МОМЕНТ

PBSPro кластерные объекты поддерживаются на клиентах, запускающих Windows или Linux. Torque кластерные объекты поддерживаются на клиентах, запускающих Linux.

PBSPro и Torque кластерные объекты имеют следующие свойства в дополнение к общей собственности:

СвойствоОписание
CommunicatingJobWrapperСкрипт, который кластер запускает, чтобы запустить рабочих
RcpCommandКоманда, чтобы скопировать файлы в и от клиента
ResourceTemplateЗадайте qsub опции, чтобы запросить ресурсы во время представления задания
RshCommandУдаленная команда выполнения используется на узлах рабочего во время связывающегося задания
HasSharedFilesystemЗадайте, совместно используют ли клиент и кластерные узлы JobStorageLocation
ProcsPerNode

Количество процессоров на узел в виде конечного положительного целочисленного скаляра.

Когда вы представите задание кластеру, количество ядер на узел, который запрашивает MATLAB, как гарантируют, будет меньше чем или равно ProcsPerNode. Установите ProcsPerNode равняйтесь максимальному количеству процессоров, которые вы хотите, чтобы MATLAB запросил от каждого кластерного узла.

MATLAB запрашивает самое маленькое количество ядер на узел, требуемый запускать задание.

  • Если NumThreads свойство кластера меньше чем или равно ProcsPerNode, MATLAB запрашивает NumThreads процессоры на рабочего, затем максимизирует количество рабочих на узел. Например, если NumThreads 16 и NumThreads 5, MATLAB запрашивает 15 ядра, самое маленькое кратное 5 это меньше NumThreads.

  • Если NumThreads из кластера больше ProcsPerNode, MATLAB запрашивает ProcsPerNode процессоры на узел.

    Когда NumThreads больше ProcsPerNode, вы можете столкнуться с проблемами эффективности. Как лучшая практика, набор NumThreads меньше чем или равный ProcsPerNode. Для получения дополнительной информации смотрите Количество Редактирования Рабочих и Кластерных Настроек.

SubmitArgumentsЗадайте дополнительные аргументы, чтобы использовать при представлении заданий

LSF

LSF кластерные объекты поддерживаются на клиентах, запускающих Windows, macOS, или Linux.

LSF кластерные объекты имеют следующие свойства в дополнение к общей собственности:

СвойствоОписание
ClusterNameИмя кластера LSF
CommunicatingJobWrapperСкрипт, который кластер запускает, чтобы запустить рабочих
HasSharedFilesystemЗадайте, совместно используют ли клиент и кластерные узлы JobStorageLocation
ResourceTemplateЗадайте bsub опции, чтобы запросить ресурсы во время представления задания
SubmitArgumentsЗадайте дополнительные аргументы, чтобы использовать при представлении заданий

Slurm

Slurm кластерные объекты поддерживаются на клиентах, запускающих Linux.

Slurm кластерные объекты имеют следующие свойства в дополнение к общей собственности:

СвойствоОписание
ClusterNameИмя кластера Slurm
CommunicatingJobWrapperСкрипт, который кластер запускает, чтобы запустить рабочих
ResourceTemplateЗадайте sbatch опции, чтобы запросить ресурсы во время представления задания
SubmitArgumentsЗадайте дополнительные аргументы, чтобы использовать при представлении заданий

Типовой

Generic кластерные объекты поддерживаются на клиентах, запускающих Windows, macOS, или Linux.

Если вы создаете типовой кластерный объект из R2017a или более позднего профиля, у вас есть следующие свойства в дополнение к общей собственности:

СвойствоОписание
AdditionalPropertiesДополнительные свойства для сменных скриптов
HasSharedFilesystemЗадайте, совместно используют ли клиент и кластерные узлы JobStorageLocation
PluginScriptsLocationПапка, содержащая скрипты плагина планировщика

Если вы создаете типовой кластерный объект из R2016b или более раннего профиля, у вас есть следующие свойства в дополнение к общей собственности:

СвойствоОписание
CancelJobFcnФункция, чтобы запуститься при отмене задания
CancelTaskFcnФункция, чтобы запуститься при отмене задачи
CommunicatingSubmitFcnФункция, чтобы запуститься при представлении связывающегося задания
DeleteJobFcn Функция, чтобы запуститься при удалении задания
DeleteTaskFcnФункция, чтобы запуститься при удалении задачи
GetJobStateFcnФункция, чтобы запуститься при запросе состояния задания
HasSharedFilesystemЗадайте, совместно используют ли клиент и кластерные узлы JobStorageLocation
IndependentSubmitFcnФункция, чтобы запуститься при представлении независимого задания

Справка

Для дальнейшей справки на кластерных объектах, включая ссылки, чтобы помочь для определенных кластерных типов и свойств объектов, введите:

help parallel.Cluster
Представленный в R2012a