FAQ: Ansible Modules for PowerStore

To which Ansible modules for Dell EMC PowerStore version does this FAQ apply?

This FAQ applies to version 1.0, and 1.1 of the modules.

Where can I get the Ansible modules for Dell EMC PowerStore?

We have a repository in GitHub: https://github.com/dell/ansible-powerstore

Is there anything additional I need to install?

Yes, PowerStore modules require the PyPowerStore python library, available here. https://github.com/dell/python-powerstore, you can automate this installation using Ansible as a task in your playbooks.  Below is a sample task to install as part of a playbook.

- name: Install PyPowerStore using Git

  pip:

    name: git+git+https://github.com/dell/python-powerstore

    #virtualenv: /dellemc/venv

    #virtualenv_site_packages: yes

What version of the PowerStore family are supported?

All models.

What are the supported features for this Ansible module for Dell EMC PowerStore?

The release of Ansible Modules for Dell EMC PowerStore v1.1 includes the following modules:

• Gather Facts Module
• Get the nas_servers list

Get the smb_shares list

Get the nfs_exports list

Get the tree_quotas list

Get the user_quotas list

Get the list of entities with filters

Get the file system list

• File System Module

Create new File System

Get File System details

Modify File System attributes

Delete File System

• NFS Export Module

Create NFS Export for filesystem/filesystem snapshot

Get NFS export details

Modify the attributes of NFS export

Add/remove host access

Delete NFS export

• SMB Share Module

Create a SMB Share

Update attributes of SMB Share

Get details of SMB Share

Delete SMB Share

• Quota Module

Create a User/Tree Quota

Update User/Tree Quota

Get User/Tree Quota

Delete Tree Quota

• NAS Server Module

Get NAS Server details

Rename NAS Server

Modify NAS Server attributes

• Snapshot Module

Create a new Volume Group Snapshot

Delete an existing Volume Group Snapshot

Get details of Volume Group Snapshot

Modify Volume Group Snapshot

Create a new Volume Snapshot

Get details of Volume Snapshot

Modify Volume Snapshot

Delete an existing Volume Snapshot

• File System Snapshot Module

Create filesystem snapshot

Get filesystem snapshot details

Modify attributes of filesystem snapshot

Delete filesystem snapshot

Do these modules support any array initialization or day-0 configuration?

No, the focus of these modules is repetitive storage provisioning operations and not tasks like setting network parameters, adding array management users/group, adding licenses, or software upgrades.

 

Where can I find playbook examples?
Examples are available in the embedded documentation along with each module's python code. They can be viewed using the ansible-doc command.  Sample playbooks are also on GitHub 

 

What are the known limitations?
Please refer to the limitations and considerations section in the release notes.

 

How to uninstall the modules?
Uninstallation simply involves deleting the module python files in the the directories in which they were originally copied.

 

I have a question or a problem, where do I submit an issue against the driver?
The Ansible modules for Dell EMC PowerStore are officially by Dell EMC. Therefore you can open a discussion in the Automation community forum, or open a ticket directly on the support website.

Will my playbooks from v1.0 of the modules continue to work if I upgrade?

Yes.  

Can I run this module in a production environment?
Yes, the module is production-grade. Please make sure your environment follows the pre-requisites and Ansible best practices.