From 128266810203356a9eae4e6e8d8ba1284ff509c1 Mon Sep 17 00:00:00 2001 From: Hemant Agrawal <34645097+hemantnetapp@users.noreply.github.com> Date: Fri, 13 Mar 2020 13:17:54 +0530 Subject: [PATCH] Update README.md --- README.md | 66 ++++++++++++++++++++++++------------------------------- 1 file changed, 29 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index d10d220..f4ae747 100644 --- a/README.md +++ b/README.md @@ -1,72 +1,64 @@ -# NetApp Service Level Manager Ansible Integration Solution +# Active IQ Unified Manager Ansible Integration Solution -This pack contains Ansible modules and sample playbooks for NetApp® Service Level Manager (SLM) that enable you to configure service-level-based NetApp storage management. The Ansible modules for SLM act as the orchestrator tool. - -# Disclaimer -This document contains best practices for Ansible modules and sample playbooks, it provides no warranties or SLAs, expressed or implied. +The Active IQ Unified Manager Ansible Integration Solution pack contains Ansible modules and sample playbooks for Active IQ Unified Manager (AIQUM). These modules enable you to configure Service Level Objective (SLO) based storage management. The Ansible modules for AIQUM act as an orchestrator tool. # Repository includes: -1. Ansible modules for SLM -2. Sample playbooks + +1. Ansible modules for AIQUM +2. Sample Playbooks 3. README file # Supported configurations: -1. NetApp Service Level Manager version 1.3 RC1 -2. Ansible version 2.7.0 -3. Python version 2.7.0, 3.5.0, 3.6.0 + +1. Active IQ Unified Manager version 9.7 +2. Ansible version 2.9.1 +3. Python versions 2.7.0, 3.5.0, and 3.6.0 + # Overview -You can use Ansible modules for SLM to configure service-level-based NetApp storage management. -You can download the modules on your Ansible server using the following configuration steps. After you configure the modules, you can use them to write custom playbooks according to specific use cases or requirements. The modules function as an interface between Ansible and NetApp Service Level Manager. Using the modules, the commands provided at the Ansible server are translated into RESTful API calls to SLM. Responses are sent from SLM to the Ansible server. +User can use Ansible modules for AIQUM to configure SLO-based storage management. +User can download the modules on their Ansible server by using the following configuration steps. After user has configured the modules, it can be used to write custom playbooks according to specific use cases or requirements. The modules function as an interface between Ansible and AIQUM. On using the modules, the commands provided at the Ansible server are translated into RESTful API calls to AIQUM. Responses are sent from AIQUM to the Ansible server. # Configuration ## Prerequisites -1. Ansible must be setup (RHEL-7) -2. NetApp Service Level Manager version 1.3 RC1 must be installed and working +1. Ansible must be set up on your Red Hat Enterprise Linux 7.x system +2. Active IQ Unified Manager version 9.7 must be installed and working ## Steps -1. Log in as root at both the Ansible Master machine and the Ansible Slave servers. -2. To modify the Ansible modules library folder, edit the ansible.cfg file using the command: +1. As a root user, log in to both the Ansible master machine and the Ansible managed servers. +2. Edit the *ansible.cfg* file to modify the Ansible modules library folder: ``` vi /etc/ansible/ansible.cfg ``` -3. Find the commented line for the library default value; remove the # sign from start of the line and change it to: +3. Search for the commented line with the default value for the library parameter and remove the # symbol at the beginning of the line: ``` library = /root/modules ``` -4. Log in as root at the Ansible server. -5. Create a directory using the command: +4. Log in as a root user to the Ansible server and create the modules directory at */root* level: ``` mkdir modules ``` -6. Run the command: -``` -cd modules -``` -7. Run the command: -``` -pwd -``` -8. Verify that the output is: -``` -/root/modules -``` -9. In "/root/modules”, download all modules from “NetApp/Ansible-with-NetApp-Service-Level-Manager”. +5. In */root/modules*, download all the modules from the *NetApp/Ansible-with-Active-IQ-Unified-Manager* directory. **Note:** You can download these modules to either of the Master Ansible servers. -10. Install the “requests” Python package PIP install requests. -11. Use the sample playbooks provided to get started. +6. Install the *requests* Python package using following command: +``` +PIP install requests +``` + +7. Refer to the available sample playbooks to get started. # Module Documentation -You can access documentation for each module using the Ansible standard doc command. +You can access the documentation for each module by using the standard Ansible doc command: ``` -ansible-doc nslm_luns.py +ansible-doc aiqum_luns.py ``` # Support -Report any problems to: https://github.com/NetApp/Ansible-with-NetApp-Service-Level-Manager/issues +Report any problems to: https://github.com/NetApp/Ansible-with-Active-IQ-Unified-Manager/issues +Or please report it to the following mail id: *ng-aiqum-solutions@netapp.com*