Spec-Zone.ru › Ansible

Модуль ibm.storage_virtualize.ibm_svc_host — управление хостами в системах семейства IBM Storage Virtualize

Примечание

Этот модуль входит в коллекцию ibm.storage_virtualize (версия 3.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install ibm.storage_virtualize.

Чтобы использовать её в плейбуке, укажите: ibm.storage_virtualize.ibm_svc_host.

Добавлено в ibm.storage_virtualize 1.0.0

  • Обзор
  • Параметры
  • Примечания
  • Примеры

Обзор

  • Интерфейс Ansible для управления командами хостов ‘mkhost’, ‘chhost’ и ‘rmhost’.

Параметры

Параметр

Описание

clustername

строка / обязательный

Имя хоста, IP-адрес управления или IP-адрес раздела системы Storage Virtualize.

domain

строка

Домен системы Storage Virtualize.

Допустимо, если для параметра clustername указано имя хоста.

draftpartition

строка

добавлено в ibm.storage_virtualize 2.5.0

Указывает имя чернового раздела, который будет назначен хосту.

Допустимо при state=present для изменения хоста.

Поддерживается в системах семейства Storage Virtualize версии 8.6.3.0 и выше.

fcwwpn

строка

Список WWPN инициаторов, которые необходимо добавить на хост. Необходимо указать полный список WWPN.

Параметры fcwwpn и iscsiname взаимоисключающие.

Обязателен при state=present для создания или изменения хоста Fibre Channel (FC).

fdminame

строка

добавлено в ibm.storage_virtualize 2.7.0

Объект хоста, создаваемый на основе fdminame. Для создания хоста необходимо указать допустимое значение fdminame.

Параметры fcwwpn и fdminame взаимоисключающие.

Параметр взаимоисключающий с другими параметрами: saswwpn, fcwwpn, iscsiname и nqn.

Допустимо при state=present для создания хоста.

hostcluster

строка

добавлено в ibm.storage_virtualize 1.5.0

Указывает имя кластера хостов, в который необходимо добавить объект хоста. Кластер хостов должен существовать до добавления в него объекта хоста.

Параметры hostcluster и nohostcluster взаимоисключающие.

Допустимо при state=present для создания или изменения хоста.

iogrp

строка

Указывает одну или несколько групп ввода-вывода (I/O), из которых хост может получать доступ к томам. После указания этого параметра изменить его нельзя.

Допустимо при state=present для создания хоста.

iscsiname

строка

Список IQN инициаторов, которые необходимо добавить на хост. IQN разделяются запятыми. Необходимо указать полный список IQN.

Параметры fcwwpn и iscsiname взаимоисключающие.

Допустимо при state=present для создания хоста.

location

строка

добавлено в ibm.storage_virtualize 2.7.0

Указывает идентификатор или имя системы, размещённой совместно с этим хостом.

Если указать пустую строку (“”), хост обычно будет отправлять операции ввода-вывода в предпочтительную систему раздела хранилища.

Допустимо при state=present для изменения существующего хоста.

Поддерживается в системах семейства Storage Virtualize версии 8.7.0.0 и выше.

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

log_path

строка

Путь к файлу журнала отладки.

name

строка / обязательный

Указывает имя или метку нового объекта хоста.

nodraftpartition

логический

добавлено в ibm.storage_virtualize 2.5.0

Если указано значение True, объект хоста удаляется из чернового раздела.

Параметры draftpartition и nodraftpartition взаимоисключающие.

Допустимо при state=present для изменения существующего хоста.

Поддерживается в системах семейства Storage Virtualize версии 8.6.3.0 и выше.

Допустимые значения:

  • false
  • true

nohostcluster

логический

добавлено в ibm.storage_virtualize 1.5.0

Если указано значение True, объект хоста удаляется из кластера хостов.

Параметры hostcluster и nohostcluster взаимоисключающие.

Допустимо при state=present для изменения существующего хоста.

Допустимые значения:

  • false
  • true

nopartition

логический

добавлено в ibm.storage_virtualize 2.1.0

Если указано значение True, объект хоста удаляется из раздела хранилища.

Параметры partition и nopartition взаимоисключающие.

Допустимо при state=present для изменения существующего хоста.

Поддерживается в системах семейства Storage Virtualize версии 8.6.1.0 и выше.

Допустимые значения:

  • false
  • true

nqn

строка

добавлено в ibm.storage_virtualize 1.12.0

Список NQN инициаторов, которые необходимо добавить на хост. NQN разделяются запятыми. Необходимо указать полный список NQN.

Обязателен при protocol=rdmanvme or tcpnvme для создания.

Допустимо при state=present для создания или изменения хоста.

old_name

строка

добавлено в ibm.storage_virtualize 1.9.0

Указывает старое имя хоста при переименовании.

Допустимо при state=present для переименования существующего хоста.

partition

строка

добавлено в ibm.storage_virtualize 2.1.0

Указывает раздел хранилища, с которым необходимо связать хост.

Допустимо при state=present для создания или изменения хоста.

Поддерживается в системах семейства Storage Virtualize версии 8.6.1.0 и выше.

password

строка

Пароль REST API для системы Storage Virtualize.

Параметры username и password обязательны, если для аутентификации пользователя не используется token.

portset

строка

добавлено в ibm.storage_virtualize 1.12.0

Указывает набор портов, который необходимо связать с хостом.

Допустимо при state=present для создания или изменения хоста.

protocol

строка

Указывает протокол, используемый хостом для взаимодействия с системой хранения. Поддерживается только протокол ‘scsi’.

Допустимо при state=present для создания хоста.

Допустимые значения:

  • "scsi"
  • "rdmanvme"
  • "tcpnvme"
  • "fcnvme"
  • "iscsi"
  • "fcscsi"

site

строка

Указывает имя сайта хоста.

Допустимо при state=present для создания или изменения хоста.

Если для site указана пустая строка (“”), она рассматривается как nosite, что означает удаление существующего сайта.

state

строка / обязательный

Создаёт или обновляет хост (present) либо удаляет его (absent).

Допустимые значения:

  • "absent"
  • "present"

suppressofflinealert

строка

добавлено в ibm.storage_virtualize 2.7.0

Если указано значение yes, событие не будет создаваться, когда хост находится в автономном режиме.

Допустимо при state=present для изменения существующего хоста.

Поддерживается в системах семейства Storage Virtualize версии 8.7.2.0 и выше.

Допустимые значения:

  • "yes"
  • "no"

token

строка

добавлено в ibm.storage_virtualize 1.5.0

Токен аутентификации для проверки пользователя в системе Storage Virtualize.

Чтобы создать токен, используйте модуль ibm.storage_virtualize.ibm_svc_auth.

type

строка

Указывает тип хоста.

Допустимо при state=present для создания или изменения хоста.

username

строка

Имя пользователя REST API для системы Storage Virtualize.

Параметры username и password обязательны, если для аутентификации пользователя не используется token.

validate_certs

логический

Проверяет сертификат.

Допустимые значения:

  • false ← (по умолчанию)
  • true

Примечания

Примечание

  • Этот модуль поддерживает check_mode.
  • Параметр scsi объявлен устаревшим начиная с версии 8.5.0.0. Вместо scsi используйте iscsi или fcscsi, в зависимости от ситуации.
  • Этот модуль поддерживает вход в систему через IP-адрес раздела.
  • При входе через IP-адрес раздела не поддерживаются параметры ‘site’, ‘iogrp’, ‘partition’, ‘nopartition’, ‘draftpartition’, ‘site’, ‘nosite’.

Примеры

- name: Define a new iSCSI host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: iscsi_host0
    state: present
    iscsiname: iqn.1994-05.com.redhat:2e358e438b8a
    iogrp: 0:1:2:3
    protocol: scsi
    type: generic
    site: site-name
    portset: portset0
- name: Add a host to an existing host cluster
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: host0
    state: present
    hostcluster: hostcluster0
- name: Define a new FC host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: fc_host0
    state: present
    fcwwpn: 100000109B570216:1000001AA0570266
    iogrp: 0:1:2:3
    protocol: scsi
    type: generic
    site: site-name
- name: Rename an existing host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    old_name: "old_host_name"
    name: "new_host_name"
    state: "present"
- name: Create an iSCSI host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: iscsi_host0
    iscsiname: iqn.1994-05.com.redhat:2e358e438b8a,iqn.localhost.hostid.7f000001
    state: present
- name: Create a tcpnvme host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: tcpnvme_host0
    protocol: tcpnvme
    nqn: nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06397
    state: present
- name: Delete a host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: host0
    state: absent
- name: Add existing host to draft partition
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: host0
    state: prersent
    draftpartition: partition_name
- name: Remove a host from a draft partition
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: host0
    state: present
    nodraftpartition: 'True'
- name: Create a fcnvme host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: fcnvme_host0
    protocol: fcnvme
    nqn: nqn.2014-08.org.nvmexpress:b2071fa4-4356-410f-a4ae-7ebfab5b0e90
    portset: portset_name
    state: present
- name: Create an fdmi host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: fdmi_host0
    fdminame: Ansible-Host-1
    state: present
- name: Create a host with preferred location.
  ibm.storage_virtualize.ibm_svc_host:
    clustername: '{{ clustername }}'
    username: '{{ username }}'
    password: '{{ password }}'
    state: present
    name: host0
    location: fs9500cl-2
    partition: ha-partition-0
- name: Remove the currently set location from host.
  ibm.storage_virtualize.ibm_svc_host:
    clustername: '{{ clustername }}'
    username: '{{ username }}'
    password: '{{ password }}'
    state: present
    name: host0
    location: ""
- name: Remove the currently set site from host.
  ibm.storage_virtualize.ibm_svc_host:
    clustername: '{{ clustername }}'
    username: '{{ username }}'
    password: '{{ password }}'
    state: present
    name: host0
    site: ""
- name: Create a fcnvme host inside a partition
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: fcnvme_host0
    protocol: fcnvme
    nqn: nqn.2014-08.org.nvmexpress:b2071fa4-4356-410f-a4ae-7ebfab5b0e90
    portset: postset0
    state: present
- name: Create a tcpnvme host inside a partition
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: tcpnvme_host0
    protocol: tcpnvme
    nqn: nqn.2014-08.org.nvmexpress:b2071fa4-4356-410f-a4ae-7ebfab5b0e90
    portset: postset0
    state: present

Авторы

  • Sreshtant Bohidar (@Sreshtant-Bohidar)
  • Rohit Kumar (@rohitk-github)
  • Sandip G. Rajbanshi (@Sandip-Rajbanshi)
  • Lavanya C R(@Lavanya-C-R1)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Сообщить о проблеме

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ibm/storage_virtualize/ibm_svc_host_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API