Understanding NIM Demonstrations

Overview

NIM Demos are playbooks designed to demonstrate various Network Installation Management (NIM) operations on AIX systems. These playbooks cover a wide range of tasks such as updating LPARs, deallocating resources, applying customization scripts, and performing maintenance operations. The playbooks also include operations for creating, deleting, or showing NIM resource objects, checking the status of NIM operations, and performing FLRTVC (Fix Level Recommendation Tool for Virtual Clients) checks. Additionally, there are playbooks for backing up and restoring systems, migrating NIM masters, installing BOS (Base Operating System) using mksysb images, upgrading VIOS (Virtual I/O Server), and updating VIOS through the NIM master.

Usage of NIM Demos

NIM Demos are used by running the provided playbooks to perform tasks such as updating LPARs, deallocating resources, applying customization scripts, and performing maintenance operations. These playbooks are essential for managing and automating various NIM operations on AIX systems.

Examples of NIM Demos

NIM Demos are used in various playbooks such as playbooks/demo_nim.yml, playbooks/demo_nim_resource.yml, playbooks/demo_nim_check.yml, playbooks/demo_nim_flrtvc.yml, playbooks/demo_nim_suma.yml, playbooks/demo_nim_master_migration.yml, playbooks/demo_nim_install.yml, playbooks/demo_nim_backup.yml, playbooks/demo_nim_viosupgrade.yml, and playbooks/demo_nim_updateios.yml.

The playbook playbooks/demo_nim.yml demonstrates various NIM operations on AIX/VIOS. It includes tasks such as updating LPARs, deallocating resources, and applying customization scripts.

---
- name: NIM operation on AIX/VIOS
  hosts: nimserver2
  remote_user: root
  gather_facts: false
  vars:
    check_targets_v: standalone
    install_targets_v: quimby06
    update_lpp_v: latest_sp
    bos_inst_resgroup_v: basic_res_grp
    bos_inst_script_v: setup_root
    master_setup_device_v: /dev/cd0
    define_resource_v: setup_root
    define_location_v: /export/nim/script_res/yum_install.sh
    apply_script_v: setup_yum
    alloc_resource_v: 7200-03-04-1938-lpp_source
    rm_resource_v: quimby06_svg

  tasks:
    - name: Update a LPAR to the latest level available
      ibm.power_aix.nim:

NIM operations to create, delete or show NIM resource objects

This playbook demonstrates operations for creating, deleting, or showing NIM resource objects.

The playbook playbooks/demo_nim_resource.yml demonstrates operations for creating, deleting, or showing NIM resource objects.

---
- name: NIM operations to create, delete or show NIM resource objects
  hosts: nim1
  gather_facts: false
  vars:
    spot_name_v: spot_test4
    spot_final_location_v: /nim1/spot_test4_from_lpp_source
    lpp_source_v: lpp_source_test4
    software_lpp_source: /nim1/lpp_source
    lpp_source_location: /nim1/lpp_source_test4

  tasks:
    - name: Create/define an lpp_source NIM resource object from the software in the system.
      ibm.power_aix.nim_resource:
        action: create
        name: "{{ lpp_source_v }}"
        object_type: lpp_source
        attributes:
          source: "{{ software_lpp_source }}"
          location: "{{ lpp_source_location }}"
      register: result

NIM FLRTVC on AIX playbook

This playbook demonstrates how to perform FLRTVC (Fix Level Recommendation Tool for Virtual Clients) checks on AIX.

The playbook playbooks/demo_nim_flrtvc.yml demonstrates how to perform FLRTVC checks on AIX.

---
- name: NIM FLRTVC on AIX playbook
  hosts: nimserver
  gather_facts: false
  vars:
    apar: all
    vm_targets: quimby01
    path: /export/nim/ansible
    download: false

  tasks:

    - name: FLRTVC
      ibm.power_aix.nim_flrtvc:
        targets: "{{ vm_targets }}"
        path: "{{ path }}"
        verbose: true
        apar: "{{ apar }}"
        force: false
        clean: false
        download_only: "{{ download }}"

NIM check on AIX playbook

This playbook demonstrates how to check the status of NIM operations on AIX.

The playbook playbooks/demo_nim_check.yml demonstrates how to check the status of NIM operations on AIX.

---
- name: NIM check on AIX playbook
  hosts: nimserver
  gather_facts: false

  tasks:
    - name: AIX NIM
      nim:
        action: check
      register: result
    - ansible.builtin.debug:
        var: result
        cmd: ""

`Nim_master_migration` demo

This playbook demonstrates how to migrate NIM masters.

The playbook playbooks/demo_nim_master_migration.yml demonstrates how to migrate NIM masters.

---
# PREREQUISITES:

- name: "Nim_master_migration demo"
  hosts: "{{ hosts_val }}"
  gather_facts: false
  vars:
    hosts_val: all
    log_file: "/tmp/ansible_mpio_debug.log"
  remote_user: root
  tasks:
    - ansible.builtin.import_role:
        name: nim_master_migration
      vars:
        nim_master_migration_master_a: ansible-nim1
        nim_master_migration_master_b: "p9zpa-ansible-test2"
        nim_master_migration_alt_disk: "hdisk1"
        nim_master_migration_db_filename: "db_backupfile"
        nim_master_migration_lpp_source_v: "2317A_73D"
        nim_master_migration_spot_v: "2317A_73D_spot"
        nim_master_migration_nim_master_fileset_src: "~/bos.sysmgt"

Viosupgrade operation using NIM

This playbook demonstrates how to upgrade VIOS (Virtual I/O Server) using NIM.

The playbook playbooks/demo_nim_viosupgrade.yml demonstrates how to upgrade VIOS using NIM.

---
- name: Viosupgrade operation using NIM
  hosts: nimserver
  gather_facts: false
  vars:
    target_v: "quimby-vios2"
    target_file_v: "/tmp/mytargetfile"
    params_altdisk_v:
      all:
        resources: master_net_conf:logdir
        manage_cluster: true
        preview: true
      quimby-vios2:
        ios_mksysb: vios3-1-1-0_sysb
        rootvg_clone_disk: hdisk3
        backup_file_resource: quimby-vios2_iosb
    params_bosinst_v:
      all:
        ios_mksysb: vios3-1-1-0_sysb
        spotname: vios3-1-1-0_spot
        resources: master_net_conf:logdir

Backup operation using NIM for on `AIX/VIOS`

This playbook demonstrates how to perform backup operations on AIX/VIOS using NIM.

The playbook playbooks/demo_nim_backup.yml demonstrates how to perform backup operations on AIX/VIOS using NIM.

---
- name: Backup operation using NIM for on AIX/VIOS
  hosts: nimserver
  gather_facts: false
  vars:
    preview_v: true
    flags_v: ""
    other_attributes_v: ""
    # for savevg/restvg operation
    svg_type_v: savevg
    svg_location_v: /export/nim/savevg
    svg_name_v: ""
    svg_name_prefix_v: ""
    svg_name_postfix_v: ""
    svg_volume_group_v: datavg
    svg_other_attributes_v: -a disk=hdisk1 -a verbose=yes
    svg_shrink_fs_v: false
    # for Standalone LPAR
    # lpar_nim_node_v:        {}
    lpar_targets_v: quimby06
    sysb_location_v: /export/nim/mksysb

BOS install using mksysb image

This playbook demonstrates how to install the Base Operating System (BOS) using mksysb images.

The playbook playbooks/demo_nim_install.yml demonstrates how to install the Base Operating System (BOS) using mksysb images.

---
- name: BOS install using mksysb image
  hosts: nimserver
  gather_facts: false
  vars:
    vm_targets: quimby01
    res_group: basic_res_grp

  tasks:
    - name: Install using group resource
      ibm.power_aix.nim:
        action: bos_inst
        targets: "{{ vm_targets }}"
        group: "{{ res_group }}"
      register: result
    - ansible.builtin.debug:
        var: result

Update operation using NIM on VIOS

This playbook demonstrates how to update VIOS through the NIM master.

The playbook playbooks/demo_nim_updateios.yml demonstrates how to update VIOS through the NIM master.

---
- name: Update operation using NIM on VIOS
  hosts: nimserver
  gather_facts: false
  vars:
    preview_v: true
    targets_v: quimby-vios2
    lpp_source_v: ""
    rm_filesets_v: ""
    rm_installp_bundle_v: ""
    accept_licenses_v: true
    manage_cluster_v: false
    time_limit_v: "09/30/2020 14:30"

  tasks:
    - name: Update VIOS through the NIM Master
      ibm.power_aix.nim_updateios:
        action: install
        targets: "{{ targets_v }}"
        manage_cluster: "{{ manage_cluster_v }}"
        accept_licenses: "{{ accept_licenses_v }}"

This is an auto-generated document by Swimm 🌊 and has not yet been verified by a human

Overview​

Usage of NIM Demos​

Examples of NIM Demos​

NIM operations to create, delete or show NIM resource objects​

NIM FLRTVC on AIX playbook​

NIM check on AIX playbook​

Nim_master_migration demo​

Viosupgrade operation using NIM​

Backup operation using NIM for on AIX/VIOS​

BOS install using mksysb image​

Update operation using NIM on VIOS​