dellemc.powerscale.settings (3.0.0) — module

Manages general settings for PowerScale storage system

| "added in version" 1.4.0 of dellemc.powerscale"

Authors: Meenakshi Dembi (@dembim) <ansible.team@dell.com>

Install collection

Install with ansible-galaxy collection install dellemc.powerscale:==3.0.0


Add to requirements.yml

  collections:
    - name: dellemc.powerscale
      version: 3.0.0

Description

Managing general settings on the PowerScale storage system which includes the following.

Get and update operations for email settings.

Add remove and get operations for NTP servers.

Get and update operation for cluster identity.

Get and update operation for cluster owner.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Get email settings
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update email settings
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    state: "{{state_present}}"
    mail_relay: "mailrelay.itp.dell.com"
    mail_sender: "lab-a2@dell.com"
    mail_subject: "lab-a2-alerts"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Add NTP server
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    ntp_servers:
      - "10.106.**.***"
      - "10.106.**.***"
    state: "{{state_present}}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Get NTP server
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    ntp_server_id: "10.106.**.***"
    state: "{{state_present}}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Remove NTP server
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    ntp_servers:
      - "10.106.**.***"
      - "10.106.**.***"
    state: "{{state_absent}}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update email settings and add NTP server
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    state: "{{state_present}}"
    mail_relay: "mailrelay.itp.dell.com"
    mail_sender: "lab-a2@dell.com"
    mail_subject: "lab-a2-alerts"
    ntp_servers:
      - "10.106.**.***"
      - "10.106.**.***"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update cluster owner details
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    state: "{{state_present}}"
    company: "Test company"
    location: "Test location"
    primary_contact:
      name: "primary_name11"
      phone1: "primary_phone11"
      phone2: "primary_phone21"
      email: "primary_email1@email.com"
    secondary_contact:
      name: "secondary_name11"
      phone1: "secondary_phone11"
      phone2: "secondary_phone21"
      email: "secondary_email1@email.com"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update cluster identity details
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    state: "{{state_present}}"
    name: "PIE-IsilonS-24241-Cluster"
    description: "This is new description for the cluster"
    logon_details:
      message_title: "This is the new title"
      description: "This is new description"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update all settings
  dellemc.powerscale.settings:
    onefs_host: "{{onefs_host}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    verify_ssl: "{{verify_ssl}}"
    state: "{{state_present}}"
    name: "PIE-IsilonS-24241-Cluster"
    description: "This is new description for the cluster"
    logon_details:
      message_title: "This is the new title"
      description: "This is new description"
    company: "Test company"
    location: "Test location"
    primary_contact:
      name: "primary_name11"
      phone1: "primary_phone11"
      phone2: "primary_phone21"
      email: "primary_email1@email.com"
    secondary_contact:
      name: "secondary_name11"
      phone1: "secondary_phone11"
      phone2: "secondary_phone21"
      email: "secondary_email1@email.com"
    mail_relay: "mailrelay.itp.dell.com"
    mail_sender: "lab-a2@dell.com"
    mail_subject: "lab-a2-alerts"
    ntp_servers:
      - "10.106.**.***"
      - "10.106.**.***"

Inputs

    
name:
    description:
    - Name of PowerScale Cluster.
    type: str

state:
    choices:
    - absent
    - present
    default: present
    description:
    - The state option is used to mention the existence of pool.
    type: str

company:
    description:
    - Name of the company.
    type: str

port_no:
    default: '8080'
    description:
    - Port number of the PowerScale cluster.It defaults to 8080 if not specified.
    required: false
    type: str

api_user:
    description:
    - username of the PowerScale cluster.
    required: true
    type: str

location:
    description:
    - Location of the company.
    type: str

mail_relay:
    description:
    - The address of the SMTP server to be used for relaying the notification messages.
    - An SMTP server is required in order to send notifications.
    - If this str is empty, no emails will be sent.
    type: str

onefs_host:
    description:
    - IP address or FQDN of the PowerScale cluster.
    required: true
    type: str

verify_ssl:
    choices:
    - true
    - false
    description:
    - boolean variable to specify whether to validate SSL certificate or not.
    - C(true) - indicates that the SSL certificate should be verified.
    - C(false) - indicates that the SSL certificate should not be verified.
    required: true
    type: bool

description:
    description:
    - Description of PowerScale Cluster.
    type: str

mail_sender:
    description:
    - The full email address that will appear as the sender of notification messages.
    type: str

ntp_servers:
    description:
    - List of NTP servers which need to be configured.
    elements: str
    type: list

api_password:
    description:
    - the password of the PowerScale cluster.
    required: true
    type: str

mail_subject:
    description:
    - The subject line for notification messages from this cluster.
    type: str

logon_details:
    description:
    - Details related to login to the Powerscale Cluster.
    suboptions:
      description:
        description:
        - Message description to be shown on the login screen.
        type: str
      message_title:
        description:
        - Message to be shown on the login screen.
        type: str
    type: dict

ntp_server_id:
    description:
    - ID of NTP server.
    type: str

email_settings:
    description:
    - (deprecated) This is an addition flag to view the email settings.
    - This option is deprecated and will be removed in the later version.
    type: bool

primary_contact:
    description:
    - Contact details of primary system admin.
    suboptions:
      email:
        description:
        - Email of primary system admin.
        type: str
      name:
        description:
        - Name of primary system admin.
        type: str
      phone1:
        description:
        - Phone1 of primary system admin.
        type: str
      phone2:
        description:
        - Phone2 of primary system admin.
        type: str
    type: dict

secondary_contact:
    description:
    - Contact details of secondary system admin.
    suboptions:
      email:
        description:
        - Email of secondary system admin.
        type: str
      name:
        description:
        - Name of secondary system admin.
        type: str
      phone1:
        description:
        - Phone1 of secondary system admin.
        type: str
      phone2:
        description:
        - Phone2 of secondary system admin.
        type: str
    type: dict

Outputs

changed:
  description: Whether or not the resource has changed.
  returned: Always
  sample: 'false'
  type: bool
cluster_identity:
  contains:
    description:
      description: Description of PowerScale cluster.
      type: str
    logon:
      contains:
        motd:
          description: Details of logon message.
          type: str
        motd_header:
          description: Details of logon message title.
          type: str
      description: Details of logon message shown on Powerscale login screen.
      type: dict
    mttdl_level_msg:
      description: mttdl_level_msg.
      type: str
    name:
      description: Name of PowerScale cluster.
      type: str
  description: Details related to cluster identity.
  returned: Always
  sample:
    cluster_identity:
      description: asdadasdasdasdadadadds
      logon:
        motd: This is new description
        motd_header: This is the new title
      mttdl_level_msg: none
      name: PIE-IsilonS-24241-Clusterwrerwerwrewr
  type: dict
cluster_owner:
  contains:
    company:
      description: Name of the company.
      type: str
    location:
      description: Location of the company.
      type: str
    primary_email:
      description: Email of primary system admin.
      type: str
    primary_name:
      description: Name of primary system admin.
      type: str
    primary_phone1:
      description: Phone1 of primary system admin.
      type: str
    primary_phone2:
      description: Phone2 of primary system admin.
      type: str
    secondary_email:
      description: Email of secondary system admin.
      type: str
    secondary_name:
      description: Name of secondary system admin.
      type: str
    secondary_phone1:
      description: Phone1 of secondary system admin.
      type: str
    secondary_phone2:
      description: Phone2 of secondary system admin.
      type: str
  description: Details related to cluster identity.
  returned: Always
  sample:
    cluster_owner:
      company: Test company
      location: Test location
      primary_email: primary_email@email.com
      primary_name: primary_name
      primary_phone1: primary_phone1
      primary_phone2: primary_phone2
      secondary_email: secondary_email@email.com
      secondary_name: secondary_name
      secondary_phone1: secondary_phone1
      secondary_phone2: secondary_phone2
  type: dict
email_settings:
  contains:
    settings:
      contains:
        batch_mode:
          description: This setting determines how notifications will be batched together
            to be sent by email.
          type: str
        mail_relay:
          description: The address of the SMTP server to be used for relaying the
            notification messages.
          type: str
        mail_sender:
          description: The full email address that will appear as the sender of notification
            messages.
          type: str
        mail_subject:
          description: The subject line for notification messages from this cluster.
          type: str
        smtp_auth_passwd_set:
          description: Indicates if an SMTP authentication password is set.
          type: bool
        smtp_auth_security:
          description: The type of secure communication protocol to use if SMTP is
            being used.
          type: str
        smtp_auth_username:
          description: Username to authenticate with if SMTP authentication is being
            used.
          type: str
        smtp_port:
          description: The port on the SMTP server to be used for relaying the notification
            messages.
          type: int
        use_smtp_auth:
          description: If true, this cluster will send SMTP authentication credentials
            to the SMTP relay server in order to send its notification emails.
          type: bool
        user_template:
          description: Location of a custom template file that can be used to specify
            the layout of the notification emails.
          type: str
      description: Details of the settings.
      returned: Always
      type: dict
  description: Details of the email settings.
  returned: Always
  sample:
    settings:
      batch_mode: none
      mail_relay: 10.**.**.**
      mail_sender: powerscale@dell.com
      mail_subject: Powerscale Cluster notifications
      smtp_auth_passwd_set: false
      smtp_auth_security: none
      smtp_auth_username: ''
      smtp_port: 25
      use_smtp_auth: false
      user_template: ''
  type: dict
ntp_servers:
  contains:
    servers:
      contains:
        id:
          description: Field id.
          type: str
        key:
          description: Key value from I(key_file) that maps to this server.
          type: str
        name:
          description: NTP server name.
          type: str
      description: List of servers.
      type: list
  description: List of NTP servers.
  returned: Always
  sample:
    servers:
    - id: 10.**.**.**
      key: null
      name: 10.**.**.**
  type: dict