Merge branch 'IBM:dev-collection' into dev-collection

playbooks/demo_viosupgrade.yml

@@ -0,0 +1,27 @@
+---
+- name: "Demo VIOS upgrade"
+  hosts: "{{ hosts_val }}"
+  gather_facts: no
+  vars:
+    hosts_val: all
+    dir: "/home/padmin/update"
+    image_file: "/home/padmin/mymksysbA"
+    disks: ['hdisk1', 'hdisk2']
+    filename: "/home/padmin/file_list_name"
+  tasks:
+    - name: Perform the VIOS upgrade operation on new rootvg disks hdisk1 and hdisk2
+      viosupgrade:
+        image_file: "{{ image_file }}"
+        mksysb_install_disks: "{{ disks }}"
+
+    - name: Upgrade the VIOS that belongs to an SSP cluster
+      viosupgrade:
+        image_file: "{{ image_file }}"
+        mksysb_install_disks: "{{ disks }}"
+        cluster: yes
+
+    - name: Copy files from the current rootvg disk to a newly installed VIOS image
+      viosupgrade:
+        image_file: "{{ image_file }}"
+        mksysb_install_disks: "{{ disks }}"
+        filename: "{{ filename }}"

plugins/modules/viosupgrade.py

@@ -111,6 +111,8 @@
     default: yes
 notes:
   - The level of the target mksysb image must be at version 3.1.0.00, or later.
+  - If an iso image is used instead of mksysb image first convert the iso image into
+    mksysb image using viosupgrade -I <ISO_IMAGE> -W <PATH_TO_CREATE_MKSYSB_IMAGE>.
   - Installations through this module are of the type New and Complete installation.
     Any customized configurations that might exist on the currently running system
     before the installation starts (including the timezone), are not included in the