Модуль dellemc.unity.nasserver – Управление серверами NAS на системе хранения Unity

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.0.0).

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

Для установки используйте: ansible-galaxy collection install dellemc.unity. Для использования этого модуля требуются дополнительные требования, см. Требования для получения подробностей.

Для использования в плейбуке укажите: dellemc.unity.nasserver.

Новинка в dellemc.unity 1.1.0

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление серверами NAS на системе хранения Unity включает получение и изменение параметров серверов NAS.

Требования

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

Устройство хранения Dell Unity версии 5.1 или выше.
Ansible-core версии 2.14 или выше.
Python 3.9, 3.10 или 3.11.
Storops Python SDK версии 1.2.11.

Параметры

Параметр	Комментарии
allow_unmapped_user boolean	Этот флаг используется для принудительного отключения доступа в случае неудачи сопоставления пользователя. Если `true`, то разрешить доступ в случае неудачи сопоставления пользователя. Если `false`, то запретить доступ в случае неудачи сопоставления пользователя. Может быть указан при изменении сервера NAS. Варианты: `false` `true`
current_unix_directory_service string	Это служба каталогов, используемая для запроса информации об идентификации UNIX (таких как UIDs, GIDs, группы net). Может быть указан при изменении сервера NAS. Варианты: `"NONE"` `"NIS"` `"LOCAL"` `"LDAP"` `"LOCAL_THEN_NIS"` `"LOCAL_THEN_LDAP"`
default_unix_user string	Имя пользователя по умолчанию Unix, используемое для предоставления доступа в случае неудачи сопоставления пользователя Windows с Unix. Может быть указан при изменении сервера NAS.
default_windows_user string	Имя пользователя Windows по умолчанию, используемое для предоставления доступа в случае неудачи сопоставления пользователя Unix с Windows. Может быть указан при изменении сервера NAS.
enable_windows_to_unix_username_mapping boolean	Этот параметр указывает, включено ли сопоставление имени пользователя Unix с/из Windows. Может быть указан при изменении сервера NAS. Варианты: `false` `true`
is_backup_only boolean	Указывает, используется ли сервер NAS только для резервного копирования. Может быть указан при изменении сервера NAS. Варианты: `false` `true`
is_multiprotocol_enabled boolean	Этот параметр указывает, включен ли многопротокольный режим совместного доступа. Может быть указан при изменении сервера NAS. Варианты: `false` `true`
is_packet_reflect_enabled boolean	Если пакет должен быть отражён, то этот параметр должен быть установлен в `true`. Может быть указан при изменении сервера NAS. Варианты: `false` `true`
is_replication_destination boolean	Указывает, является ли сервер NAS целевым для репликации. Может быть указан при изменении сервера NAS. Варианты: `false` `true`
nas_server_id string	Идентификатор сервера NAS. Для выполнения задачи требуется либо nas_server_name, либо nas_server_id. Параметры nas_server_name и nas_server_id взаимоисключающие.
nas_server_name string	Имя сервера NAS. Для выполнения задачи требуется либо nas_server_name, либо nas_server_id. Параметры nas_server_name и nas_server_id взаимоисключающие.
nas_server_new_name string	Новое имя сервера NAS. Может быть указан при изменении сервера NAS.
password string / обязательно	Пароль сервера управления Unity.
port integer	Номер порта, через который происходит общение с сервером управления Unity. По умолчанию: `443`
replication_params dictionary	Параметры, необходимые для включения репликации.
destination_nas_server_name string	Имя целевого сервера NAS. Значение по умолчанию — имя исходного сервера NAS с префиксом «DR_».
destination_pool_id string	Идентификатор пула для выделения целевых LUN. Взаимоисключающий с destination_pool_name.
destination_pool_name string	Имя пула для выделения целевых LUN. Взаимоисключающий с destination_pool_id.
destination_sp string	Процесс хранения целевого сервера NAS Варианты: `"SPA"` `"SPB"`

END_OF_DOCUMENT_MARKER

is_backup boolean	Указывает, является ли целевой сервер NAS резервной копией. Варианты: `false` `true`
new_replication_name string	Имя репликации для переименования сессии.
remote_system dictionary	Подробности удалённой системы, к которой настраивается репликация. Параметр remote_system должен быть указан, если replication_type равен `remote`.
remote_system_host string / обязательно	IP-адрес или FQDN удалённого узла Unisphere Unity.
remote_system_password string / обязательно	Пароль удалённого узла Unisphere Unity.
remote_system_port integer	Порт, на котором размещён удалённый узел Unisphere Unity. По умолчанию: `443`
remote_system_username string / обязательно	Имя пользователя удалённого узла Unisphere Unity.
remote_system_verifycert boolean	Логическая переменная для указания, следует ли проверять сертификат SSL удалённого узла Unisphere Unity. `true` - Указывает, что сертификат SSL должен быть проверен. `false` - Указывает, что сертификат SSL проверять не нужно. Варианты: `false` `true` ← (по умолчанию)
replication_mode string	Режим репликации. Это обязательно для включения репликации. Варианты: `"asynchronous"` `"manual"`
replication_name string	Определённое пользователем имя сессии репликации.
replication_type string	Тип репликации. Варианты: `"local"` `"remote"`
rpo integer	Максимальное время ожидания, прежде чем система синхронизирует LUN источника и назначения. Параметр rpo должен быть указан, если replication_mode равен `asynchronous`. Значение должно находиться в диапазоне от `5` до `1440`.
replication_reuse_resource boolean	Этот параметр указывает, используется ли существующий сервер NAS для репликации. Варианты: `false` `true`
replication_state string	Состояние репликации. Варианты: `"enable"` `"disable"`
state string / обязательно	Определяет состояние сервера NAS на массиве. Присутствующее значение указывает, что сервер NAS должен существовать в системе после выполнения задачи. В этой версии удаление сервера NAS не поддерживается. Поэтому, если для любого существующего сервера NAS состояние задано как `absent`, будет выброшено сообщение об ошибке. Для любого несуществующего сервера NAS, если состояние задано как `absent`, будет возвращено значение None. Варианты: `"present"` `"absent"`
unispherehost string / обязательно	IP-адрес или FQDN сервера управления Unity.
username string / обязательно	Имя пользователя сервера управления Unity.
validate_certs aliases: verifycert boolean	Логическая переменная для указания, следует ли проверять сертификат SSL. `true` - Указывает, что сертификат SSL должен быть проверен. `false` - Указывает, что сертификат SSL проверять не нужно. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

check_mode не поддерживается.
Модули в этой коллекции с именем «dellemc.unity» созданы для поддержки платформы хранения Dell Unity.

Примеры

- name: Get Details of NAS Server
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "{{nas_server_name}}"
    state: "present"

- name: Modify Details of NAS Server
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "{{nas_server_name}}"
    nas_server_new_name: "updated_sample_nas_server"
    is_replication_destination: false
    is_backup_only: false
    is_multiprotocol_enabled: true
    allow_unmapped_user: true
    default_unix_user: "default_unix_sample_user"
    default_windows_user: "default_windows_sample_user"
    enable_windows_to_unix_username_mapping: true
    current_unix_directory_service: "LDAP"
    is_packet_reflect_enabled: true
    state: "present"

- name: Enable replication for NAS Server on Local System
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_id: "nas_10"
    replication_reuse_resource: false
    replication_params:
      replication_name: "test_replication"
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "local"
      destination_pool_name: "Pool_Ansible_Neo_DND"
      destination_sp: "SPA"
      is_backup: true
    replication_state: "enable"
    state: "present"

- name: Enable replication for NAS Server on Remote System
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_reuse_resource: false
    replication_params:
      replication_name: "test_replication"
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "remote"
      remote_system:
        remote_system_host: '10.10.10.10'
        remote_system_verifycert: false
        remote_system_username: 'test1'
        remote_system_password: 'test1!'
      destination_pool_name: "fastVP_pool"
      destination_sp: "SPA"
      is_backup: true
    replication_state: "enable"
    state: "present"

- name: Enable replication for NAS Server on Remote System in existing NAS Server
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_reuse_resource: true
    replication_params:
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "remote"
      replication_name: "test_replication"
      remote_system:
        remote_system_host: '10.10.10.10'
        remote_system_verifycert: false
        remote_system_username: 'test1'
        remote_system_password: 'test1!'
      destination_pool_name: "fastVP_pool"
    replication_state: "enable"
    state: "present"

- name: Modify replication on the nasserver
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_params:
      replication_name: "test_repl"
      new_replication_name: "test_repl_updated"
      replication_mode: "asynchronous"
      rpo: 50
    replication_state: "enable"
    state: "present"

- name: Disable replication on the nasserver
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_state: "disable"
    state: "present"

- name: Disable replication by specifying replication_name on the nasserver
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_params:
      replication_name: "test_replication"
    replication_state: "disable"
    state: "present"

Значения возврата

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `true`
nas_server_details словарь	Детали сервера NAS. Возвращается: когда сервер NAS существует. Пример: {"allow_unmapped_user": null, "cifs_server": {"UnityCifsServerList": [{"UnityCifsServer": {"hash": 8761756885270, "id": "cifs_34"}}]}, "current_sp": {"UnityStorageProcessor": {"hash": 8761756885273, "id": "spb"}}, "current_unix_directory_service": "NasServerUnixDirectoryServiceEnum.NIS", "default_unix_user": null, "default_windows_user": null, "existed": true, "file_dns_server": {"UnityFileDnsServer": {"hash": 8761756885441, "id": "dns_12"}}, "file_interface": {"UnityFileInterfaceList": [{"UnityFileInterface": {"hash": 8761756889908, "id": "if_37"}}]}, "filesystems": null, "hash": 8761757005084, "health": {"UnityHealth": {"hash": 8761756867588}}, "home_sp": {"UnityStorageProcessor": {"hash": 8761756867618, "id": "spb"}}, "id": "nas_10", "is_backup_only": false, "is_multi_protocol_enabled": false, "is_packet_reflect_enabled": false, "is_replication_destination": false, "is_replication_enabled": true, "is_windows_to_unix_username_mapping_enabled": null, "name": "dummy_nas", "pool": {"UnityPool": {"hash": 8761756885360, "id": "pool_7"}}, "preferred_interface_settings": {"UnityPreferredInterfaceSettings": {"hash": 8761756885438, "id": "preferred_if_10"}}, "replication_type": "ReplicationTypeEnum.REMOTE", "size_allocated": 3489660928, "tenant": null, "virus_checker": {"UnityVirusChecker": {"hash": 8761756885426, "id": "cava_10"}}}
allow_unmapped_user boolean	Включить/отключить состояние доступа в случае сбоя сопоставления пользователей. Возвращается: успех
current_unix_directory_service строка	Служба каталогов, используемая для запроса информации об идентичности для UNIX (таких как UID, GID, группы net). Возвращается: успех
default_unix_user строка	Имя пользователя по умолчанию Unix, используемое для предоставления доступа в случае сбоя сопоставления пользователей Windows с Unix. Возвращается: успех
default_windows_user строка	Имя пользователя по умолчанию Windows, используемое для предоставления доступа в случае сбоя сопоставления пользователей Unix с Windows. Возвращается: успех
id строка	Идентификатор сервера NAS. Возвращается: успех
is_backup_only boolean	Используется ли сервер NAS только для резервного копирования. Возвращается: успех
is_multi_protocol_enabled boolean	Указано, включен ли режим совместного использования с несколькими протоколами. Возвращается: успех
is_packet_reflect_enabled boolean	Необходимо ли включить отражение пакетов. Возвращается: успех
is_replication_destination boolean	Если сервер NAS является пунктом назначения репликации, то true. Возвращается: успех
is_windows_to_unix_username_mapping_enabled boolean	Указано, включено ли сопоставление имен пользователей Unix/Windows. Возвращается: успех
name строка	Имя сервера NAS. Возвращается: успех

Авторы

P Srinivas Rao (@srinivas-rao5)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/unity/nasserver_module.html