English

Install and execute AFF and FAS firmware Ansible automation package (Experienced Users)

Contributors netapp-manishc Download PDF of this page

Experienced users can follow the steps below to install and execute the AFF and FAS firmware ansible automation package quickly.

Users who require detailed steps to install and execute the AFF and FAS firmware ansible automation package, click here.

Firmware update with Ansible using NetApp Docker Image

Steps
  1. Pull the Ansible Docker image to the Linux host:

    $ docker pull schmots1/netapp-ansible
    Using default tag: latest
    latest: Pulling from schmots1/netapp-ansible
    docker.io/schmots1/netapp-ansible:latest
  2. Run the docker image as container on the Linux host:

    $ docker run -v <downloaded_playbook_path>:/<container_path> -it schmots1/netapp-ansible:latest /bin/bash
    The Ansible Playbook and the inventory file should be in the same path.
  3. Execute the Ansible Playbook on the Linux host. Firmware updates run in the background for a few hours.

    $ cd <container_path>
    $ ansible-playbook na_ontap_pb_upgrade_firmware.yml
    
    Enter your ONTAP admin username: ****
    Enter the password for your ONTAP admin user: ****
    Enter the base URL to the firmware package (using HTTP is recommended): http://<web-server>/path/
    PLAY [ONTAP Firmware Upgrade] ****************************************************************
    If the URLs for disk firmware and shelf firmware are http://<web-server>/path/all_shelf_fw.zip and http://<web-server>/path/all.zip, provide http://<web-server>/path/ as the input for the base URL to the firmware package.
  4. Log in to the cluster as the cluster administrator and verify that the new drive firmware has been installed:

    ::> storage disk show -fields firmware-revision,model
     disk     firmware-revision model
    --------------- ----------------- ----------------
    1.11.0   NA01              X423_HCOBE900A10
    1.11.1   NA01              X423_HCOBE900A10
    1.11.2   NA01              X423_HCOBE900A10
    1.11.3   NA01              X423_HCOBE900A10
    1.11.4   NA01              X423_HCOBE900A10

Firmware update if Ansible is already used

Steps
  1. Install Python and Ansible and then download the Python packages using PIP:

    $ pip install netapp-lib requests
    
    Installing collected packages: netapp-lib, requests
    Successfully installed netapp-lib-2020.3.12 requests-2.23.0
  2. Install the NetApp Ansible Collection:

    To install the collection only for the current user:
    $ ansible-galaxy collection install netapp.ontap
    
    For universal installation:
    $ ansible-galaxy collection install netapp.ontap -p /usr/share/ansible/collections
    $ chmod -R +rw /usr/share/ansible/collections
  3. Ensure that the Ansible Playbook and the inventory file are in the same path and then execute the Ansible Playbook. Firmware updates run in the background for a few hours.

    $ cd <playbook_path>
    $ ansible-playbook na_ontap_pb_upgrade_firmware_disk.yml
    
    Enter your ONTAP admin username: ****
    Enter the password for your ONTAP admin user: ****
    Enter the base URL to the firmware package (using HTTP is recommended): http://<web-server>/path/
    PLAY [ONTAP Firmware Upgrade] ****************************************************************
    If the URLs for disk firmware and shelf firmware are http://<web-server>/path/all_shelf_fw.zip and http://<web-server>/path/all.zip, provide http://<web-server>/path/ as the input for the base URL to the firmware package.
  4. Log in to the cluster as the cluster administrator and verify that the new drive firmware has been installed:

    ::> storage disk show -fields firmware-revision,model
     disk     firmware-revision model
    --------------- ----------------- ----------------
    1.11.0   NA01              X423_HCOBE900A10
    1.11.1   NA01              X423_HCOBE900A10
    1.11.2   NA01              X423_HCOBE900A10
    1.11.3   NA01              X423_HCOBE900A10
    1.11.4   NA01              X423_HCOBE900A10