Spec-Zone.ru › Ansible

модуль dellemc.openmanage.idrac_storage_volume — настройка атрибутов конфигурации RAID

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.idrac_storage_volume.

Добавлено в dellemc.openmanage 9.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль предназначен для настройки атрибутов RAID.

Псевдонимы: dellemc_idrac_storage_volume

Требования

Для выполнения этого модуля на узле необходимы следующие компоненты.

  • python >= 3.9.6

Параметры

Параметр

Описание

ca_path

path

добавлено в dellemc.openmanage 5.0.0

Файл Privacy Enhanced Mail (PEM), содержащий сертификат центра сертификации (CA), который будет использоваться для проверки.

capacity

float

Размер виртуального диска в ГБ.

controller_id

string

Полный дескриптор устройства (FQDD) контроллера хранения, например ‘RAID.Integrated.1-1’. Для конфигурации RAID create требуется FQDD контроллера.

disk_cache_policy

string

Политика кэширования диска.

Варианты:

  • "Default" ← (по умолчанию)
  • "Enabled"
  • "Disabled"

idrac_ip

string / обязательный

IP-адрес iDRAC.

idrac_password

псевдонимы: idrac_pwd

string

Пароль пользователя iDRAC.

Если пароль не указан, используется переменная среды IDRAC_PASSWORD.

Пример: export IDRAC_PASSWORD=password

idrac_port

integer

Порт iDRAC.

По умолчанию: 443

idrac_user

string

Имя пользователя iDRAC.

Если имя пользователя не указано, используется переменная среды IDRAC_USERNAME.

Пример: export IDRAC_USERNAME=username

job_wait

boolean

Этот параметр позволяет ожидать завершения задания.

Применимо, если значение state — create или delete.

Варианты:

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

job_wait_timeout

integer

Максимальное время ожидания job_wait в секундах.

Этот параметр применяется, если job_wait имеет значение true.

По умолчанию: 900

media_type

string

Тип носителя.

Варианты:

  • "HDD"
  • "SSD"

number_dedicated_hot_spare

integer

Количество выделенных резервных дисков.

По умолчанию: 0

protocol

string

Протокол шины.

Варианты:

  • "SAS"
  • "SATA"
  • "PCIE"

raid_init_operation

string

Этот параметр задает операцию инициализации виртуального диска.

Варианты:

  • "None"
  • "Fast"

raid_reset_config

string

Этот параметр указывает, нужно ли выполнить операцию сброса конфигурации на контроллере RAID. Операция сброса конфигурации удаляет все виртуальные диски на контроллере RAID.

Варианты:

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

read_cache_policy

string

Политика кэширования чтения.

Варианты:

  • "NoReadAhead" ← (по умолчанию)
  • "ReadAhead"
  • "AdaptiveReadAhead"

span_depth

integer

Количество наборов дисков в конфигурации RAID.

span_depth требуется для create; его значение зависит от volume_type.

По умолчанию: 1

span_length

integer

Количество дисков в наборе.

span_length требуется для create; его значение зависит от volume_type.

По умолчанию: 1

state

string

create выполняет операцию создания тома.

delete выполняет операцию удаления тома.

view возвращает представление хранилища.

Варианты:

  • "create"
  • "delete"
  • "view" ← (по умолчанию)

stripe_size

integer

Размер полосы. Значение указывается кратным 64 * 1024.

По умолчанию: 65536

time_to_wait

integer

Максимальное время ожидания перед выключением в секундах для операции импорта профиля конфигурации сервера (SCP).

Этот параметр применяется, если значение state — create или delete.

По умолчанию: 300

timeout

integer

добавлено в dellemc.openmanage 5.0.0

Тайм-аут на уровне сокета в секундах.

По умолчанию: 30

validate_certs

boolean

добавлено в dellemc.openmanage 5.0.0

Если false, SSL-сертификаты не будут проверяться.

Настраивайте false только на сайтах под личным контролем, где используются самоподписанные сертификаты.

До версии коллекции 5.0.0 параметр validate_certs по умолчанию имеет значение false.

Варианты:

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

volume_id

string

Полный дескриптор устройства (FQDD) виртуального диска, например ‘Disk.virtual.0:RAID.Slot.1-1’. Этот параметр используется для получения сведений о виртуальном диске.

volume_type

string

Укажите требуемый уровень RAID.

Варианты:

  • "RAID 0" ← (по умолчанию)
  • "RAID 1"
  • "RAID 5"
  • "RAID 6"
  • "RAID 10"
  • "RAID 50"
  • "RAID 60"

volumes

list / elements=dictionary

Список атрибутов iDRAC, относящихся к виртуальным дискам. Применяется для операций create и delete.

Для операции create применяются параметры name и drives; можно также указать другие параметры тома.

Параметр drives обязателен для операции create и принимает либо location (список слотов дисков), либо id (список FQDD дисков).

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

Для операции delete применяется только параметр name.

Подробнее см. примеры.

write_cache_policy

string

Политика кэширования записи.

Варианты:

  • "WriteThrough" ← (по умолчанию)
  • "WriteBack"
  • "WriteBackForce"

x_auth_token

string

добавлено в dellemc.openmanage 9.3.0

Токен аутентификации.

Если x_auth_token не указан, используется переменная среды IDRAC_X_AUTH_TOKEN.

Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

  • Запускайте этот модуль в системе с прямым доступом к Integrated Dell Remote Access Controller.
  • Этот модуль поддерживает адреса IPv4 и IPv6 для idrac_ip.
  • Этот модуль поддерживает check_mode.
  • В iDRAC8 этот модуль не отображает сведения о батарее контроллера при операции view для хранилища.

Примеры

---
- name: Create single volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "create"
    controller_id: "RAID.Slot.1-1"
    volumes:
      - drives:
        location: [5]

- name: Create multiple volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    raid_reset_config: "True"
    state: "create"
    controller_id: "RAID.Slot.1-1"
    volume_type: "RAID 1"
    span_depth: 1
    span_length: 2
    number_dedicated_hot_spare: 1
    disk_cache_policy: "Enabled"
    write_cache_policy: "WriteBackForce"
    read_cache_policy: "ReadAhead"
    stripe_size: 65536
    capacity: 100
    raid_init_operation: "Fast"
    volumes:
      - name: "volume_1"
        drives:
          id: ["Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1", "Disk.Bay.2:Enclosure.Internal.0-1:RAID.Slot.1-1"]
      - name: "volume_2"
        volume_type: "RAID 5"
        span_length: 3
        span_depth: 1
        drives:
          location: [7, 3, 5]
        disk_cache_policy: "Disabled"
        write_cache_policy: "WriteBack"
        read_cache_policy: "NoReadAhead"
        stripe_size: 131072
        capacity: "200"
        raid_init_operation: "None"

- name: View all volume details
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "view"

- name: View specific volume details
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "view"
    controller_id: "RAID.Slot.1-1"
    volume_id: "Disk.Virtual.0:RAID.Slot.1-1"

- name: Delete single volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "delete"
    volumes:
      - name: "volume_1"

- name: Delete multiple volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "delete"
    volumes:
      - name: "volume_1"
      - name: "volume_2"

Возвращаемые значения

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

Ключ

Описание

error_info

dictionary

Сведения об ошибке HTTP.

Возвращается: при ошибке HTTP

Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}

msg

string

Общий статус операции настройки хранилища.

Возвращается: всегда

Пример: "Successfully completed the view storage volume operation"

storage_status

dictionary

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

Возвращается: при успешном выполнении

Пример: {"Id": "JID_XXXXXXXXX", "JobState": "Completed", "JobType": "ImportConfiguration", "Message": "Successfully imported and applied Server Configuration Profile.", "MessageId": "XXX123", "Name": "Import Configuration", "PercentComplete": 100, "StartTime": "TIME_NOW", "TargetSettingsURI": null}

Авторы

  • Felix Stephen (@felixs88)
  • Kritika Bhateja (@Kritika-Bhateja-03)
  • Abhishek Sinha(@ABHISHEK-SINHA10)
  • Akash Shendge(@shenda1)

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 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/dellemc/openmanage/idrac_storage_volume_module.html

Spec-Zone.ru

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