ibm.ds8000.ds8000_lss (1.1.0) — module

Install collection

Install with ansible-galaxy collection install ibm.ds8000:==1.1.0

Add to requirements.yml

  collections:
    - name: ibm.ds8000
      version: 1.1.0

Description

Manage a DS8000 storage image logical subsystem (lss), also known as a logical control unit (lcu).

A lcu is configured to represent a grouping of logical CKD volumes.

The DS8000 has a 64 KB 256 volume address space that is partitioned into 255 lss units, where each lss contains 256 logical volume numbers. The 255 lss units are assigned to one of 16 address groups, where each address group contains 16 lsses, or 4 KB volume addresses.

lcus are typically created in groups of 16, beginning at lss address 00.

Requirements

• pyds8k >= 1.5.0
• python >= 3.6

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Ensure that a lss exists
  ibm.ds8000.ds8000_lss:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"
    lss_id: "80"
    state: present
    ssid: 2300

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Ensure that a lss does not exist
  ibm.ds8000.ds8000_lss:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"
    lss_id: "80"
    state: absent

Inputs

    
id:
    aliases:
    - lss
    description:
    - The lss ID to be created.
    - An lss ID is two hexadecimal characters 00 - FE.
    required: true
    type: str

port:
    default: 8452
    description:
    - The port number of the DS8000 storage system HMC.
    type: int

ssid:
    description:
    - The subsystem ID that you assign.
    - A subsystem ID is four hexadecimal characters 0000-FFFF.
    - Required when I(state=present)
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Specify the state the DS8000 lss should be in.
    type: str

ckd_type:
    choices:
    - 3990-3
    - 3990-tpf
    - 3990-6
    - bs2000
    default: 3990-6
    description:
    - The type of lss to create.
    type: str

hostname:
    description:
    - The hostname or IP address of the DS8000 storage system HMC.
    required: true
    type: str

password:
    description:
    - The password for the DS8000 storage system I(username).
    required: true
    type: str

username:
    description:
    - The username for the DS8000 storage system.
    required: true
    type: str

validate_certs:
    default: true
    description:
    - Controls validation of SSL chain of trust.
    - Set to C(no) to allow connection when SSL certificates are not trusted.
    type: bool

Outputs

lss:
  contains:
    id:
      description: The lss ID.
      sample: 1F
      type: str
  description: A list of dictionaries describing the lsses.
  elements: dict
  returned: I(state=present) changed
  sample: "[\n  {\n    \"id\": \"1F\"\n  }\n]\n"
  type: list