ibm.storage_virtualize.ibm_svc_mdisk (2.3.1) — module

This module manages MDisks on IBM Storage Virtualize family systems

| "added in version" 1.0.0 of ibm.storage_virtualize"

Authors: Peng Wang(@wangpww)

Install collection

Install with ansible-galaxy collection install ibm.storage_virtualize:==2.3.1


Add to requirements.yml

  collections:
    - name: ibm.storage_virtualize
      version: 2.3.1

Description

Ansible interface to manage 'mkarray' and 'rmmdisk' MDisk commands.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create MDisk and name as mdisk20
  ibm.storage_virtualize.ibm_svc_mdisk:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    name: mdisk20
    state: present
    level: raid0
    drive: '5:6'
    encrypt: no
    mdiskgrp: pool20
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete MDisk named mdisk20
  ibm.storage_virtualize.ibm_svc_mdisk:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    name: mdisk20
    state: absent
    mdiskgrp: pool20

Inputs

    
name:
    description:
    - The MDisk name.
    required: true
    type: str

drive:
    description:
    - Drive(s) to use as members of the RAID array.
    - Required when I(state=present), to create an MDisk array.
    type: str

level:
    choices:
    - raid0
    - raid1
    - raid5
    - raid6
    - raid10
    description:
    - Specifies the RAID level.
    - Required when I(state=present), to create an MDisk array.
    type: str

state:
    choices:
    - absent
    - present
    description:
    - Creates (C(present)) or removes (C(absent)) the MDisk.
    required: true
    type: str

token:
    description:
    - The authentication token to verify a user on the Storage Virtualize system.
    - To generate a token, use the ibm_svc_auth module.
    type: str
    version_added: 1.5.0
    version_added_collection: ibm.storage_virtualize

domain:
    description:
    - Domain for the Storage Virtualize system.
    - Valid when hostname is used for the parameter I(clustername).
    type: str

encrypt:
    choices:
    - 'yes'
    - 'no'
    default: 'no'
    description:
    - Defines use of encryption with the MDisk group.
    - Applies when I(state=present).
    type: str

log_path:
    description:
    - Path of debug log file.
    type: str

mdiskgrp:
    description:
    - The storage pool (mdiskgrp) to which you want to add the MDisk.
    required: true
    type: str

old_name:
    description:
    - Specifies the old name of an existing pool.
    - Applies when I(state=present), to rename the existing pool.
    type: str
    version_added: 2.0.0
    version_added_collection: ibm.storage_virtualize

password:
    description:
    - REST API password for the Storage Virtualize system.
    - The parameters I(username) and I(password) are required if not using I(token) to
      authenticate a user.
    type: str

username:
    description:
    - REST API username for the Storage Virtualize system.
    - The parameters I(username) and I(password) are required if not using I(token) to
      authenticate a user.
    type: str

driveclass:
    description:
    - Specifies the class that is being used to create the array.
    - Applies when I(state=present).
    type: str
    version_added: 2.0.0
    version_added_collection: ibm.storage_virtualize

drivecount:
    description:
    - Specifies the number of the drives.
    - The value must be a number in the range 2 - 128.
    - Applies when I(state=present).
    type: str
    version_added: 2.0.0
    version_added_collection: ibm.storage_virtualize

clustername:
    description:
    - The hostname or management IP of the Storage Virtualize system.
    required: true
    type: str

stripewidth:
    description:
    - Specifies the width of a single unit of redundancy within a distributed set of drives
    - The value must be a number in the range 2 - 16.
    - Applies when I(state=present).
    type: str
    version_added: 2.0.0
    version_added_collection: ibm.storage_virtualize

validate_certs:
    default: false
    description:
    - Validates certification.
    type: bool