dellemc.vxrail.dellemc_vxrail_lcm_v1 (1.3.0) — module

Perform a full upgrade or a partial upgrade with v4/upgrade api

| "added in version" 1.3.0 of dellemc.vxrail"

Authors: VxRail Development Team(@VxRailDevTeam) <ansible.team@dell.com>

Install collection

Install with ansible-galaxy collection install dellemc.vxrail:==1.3.0


Add to requirements.yml

  collections:
    - name: dellemc.vxrail
      version: 1.3.0

Description

This module will perform a partial upgrade of all VxRail software and hardware. It includes the optional variable "target_hosts_name", which indicates the nodes to be upgraded.If "target_hosts" is not provided, this module upgrades all nodes in cluster.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: LCM with v1 api
  dellemc_vxrail_lcm_v1:
    vxmip: "{{ vxmip }}"
    vcadmin: "{{ vcadmin }}"
    vcpasswd: "{{ vcpasswd }}"
    bundle_file_locator: "{{ bundle_file_locator }}"
    vc_root_account: "{{ vc_root_account }}"
    vc_root_passwd: "{{ vc_root_passwd }}"
    vxm_root_account: "{{ vxm_root_account }}"
    vxm_root_passwd: "{{ vxm_root_passwd }}"
    psc_root_account: "{{ psc_root_account }}"
    psc_root_passwd: "{{ psc_root_passwd }}"
    source_vcsa_host_name: "{{ source_vcsa_host_name }}"
    source_vcsa_host_user_name: "{{ source_vcsa_host_user_name }}"
    source_vcsa_host_user_passwd: "{{ source_vcsa_host_user_passwd }}"
    source_psc_host_name: "{{ source_psc_host_name }}"
    source_psc_host_user_name: "{{ source_psc_host_user_name }}"
    source_psc_host_user_passwd: "{{ source_psc_host_user_passwd }}"
    target_vcsa_host_name: "{{ target_vcsa_host_name }}"
    target_vcsa_host_user_name: "{{ target_vcsa_host_user_name }}"
    target_vcsa_host_user_passwd: "{{ target_vcsa_host_user_passwd }}"
    temporary_ip: "{{ temporary_ip }}"
    temporary_gateway: "{{ temporary_gateway }}"
    temporary_netmask: "{{ temporary_netmask }}"

Inputs

    
vxmip:
    description: The IP address of the VxRail Manager System
    required: true
    type: str

timeout:
    default: 21600
    description: Time out value for LCM Upgrade, the default value is 21600 seconds
    required: false
    type: int

vcadmin:
    description: Administrative account of the vCenter Server the VxRail Manager is registered
      to
    required: true
    type: str

vcpasswd:
    description: The password for the administrator account provided in vcadmin
    required: true
    type: str

temporary_ip:
    default: 0.0.0.0
    description: Temporary IP to be used during the vCenter upgrade
    required: false
    type: str

vc_root_passwd:
    description: The password for the root account provided in vcroot
    required: true
    type: str

psc_root_passwd:
    default: all
    description: The password for the root account provided in PSC
    required: false
    type: str

vc_root_account:
    description: root account of the vCenter Server the VxRail Manager is registered to
    required: true
    type: str

vxm_root_passwd:
    description: The password for the root account provided in vxm
    required: true
    type: str

psc_root_account:
    default: root
    description: root account of the PSC the VxRail Manager is registered to
    required: false
    type: str

vxm_root_account:
    description: root account of VxRail Manager
    required: true
    type: str

temporary_gateway:
    default: 0.0.0.0
    description: Gateway to be used during the vCenter upgrade
    required: false
    type: str

temporary_netmask:
    default: 0.0.0.0
    description: Netmask to be used during the vCenter upgrade
    required: false
    type: str

bundle_file_locator:
    description: the path of lcm bundle on vxm, which is recommended under /data/store2
    required: true
    type: str

source_psc_host_name:
    default: all
    description: Hostname of the ESXi host
    required: false
    type: str

source_vcsa_host_name:
    default: all
    description: Hostname of the ESXi host
    required: false
    type: str

target_vcsa_host_name:
    default: all
    description: Hostname of the ESXi host
    required: false
    type: str

source_psc_host_user_name:
    default: root
    description: The username of account provided in the ESXi host
    required: false
    type: str

source_vcsa_host_user_name:
    default: root
    description: The username of account provided in the ESXi host
    required: false
    type: str

target_vcsa_host_user_name:
    default: root
    description: The username of account provided in the ESXi host
    required: false
    type: str

source_psc_host_user_passwd:
    default: all
    description: The password of account provided in the ESXi host
    required: false
    type: str

source_vcsa_host_user_passwd:
    default: all
    description: The password of account provided in the ESXi host
    required: false
    type: str

target_vcsa_host_user_passwd:
    default: all
    description: The password of account provided in the ESXi host
    required: false
    type: str

Outputs

LCM_status:
  description: LCM status summary
  returned: always
  sample: "{\n \"LCM_V1API_Uprade\": {\n     \"request_id\": \"2ce09bde-d987-4fff-8f90-6fc430e2bfc3\"\
    ,\n     \"status\": \"COMPLETED\"\n }\n \"msg\": \"LCM is successful. Please see\
    \ the /tmp/vxrail_ansible_lcm_v1.log for more details\"\n}"
  type: dict
changed:
  description: Whether or not the resource has changed.
  returned: always
  type: bool