https://github.com/netapp/host
Ansible collection that facilitates host related tasks for NetApp E-Series storage.
https://github.com/netapp/host
netapp-public
Last synced: 10 months ago
JSON representation
Ansible collection that facilitates host related tasks for NetApp E-Series storage.
- Host: GitHub
- URL: https://github.com/netapp/host
- Owner: NetApp
- Created: 2020-10-15T17:52:57.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-08T16:43:04.000Z (almost 2 years ago)
- Last Synced: 2025-03-24T01:23:24.431Z (11 months ago)
- Topics: netapp-public
- Language: Python
- Homepage:
- Size: 695 KB
- Stars: 2
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# NetApp E-Series Host Collection
NetApp E-Series Host collection consists of host utility roles relating to E-Series platforms.
The roles in this collection can be used to configure your host-storage connection for the different supported
protocols (e.g. iSCSI, iSER, NVMe over InfiniBand), discover the mapped E-Series volumes, format them to your
specifications, and assign persistent mount points to them.
- [NetApp E-Series Host Collection](#netapp-e-series-host-collection)
- [Table of Contents](#table-of-contents)
- [Requirements](#requirements)
- [Requirements for E-Series Storage Systems](#requirements-for-eseries-storage-systems)
- [Requirements for E-Series Hosts](#requirements-for-e-series-hosts)
- [Tested Ansible Versions](#tested-ansible-versions)
- [Tested Platforms](#tested-platforms)
- [Feature Roles](#feature-roles)
- [Storage Setup](#storage-setup)
- [Mount](#mount)
- [Unmount](#unmount)
- [Snapshot](#snapshot)
- [Support Roles](#support-roles)
- [Protocol](#protocol)
- [Multipath](#multipath)
- [SELinux](#selinux)
- [IB OpenSM](#ib-opensm)
- [IP over IB](#ip-over-ib)
- [IB iSER](#ib-iser)
- [IB srp](#ib-srp)
- [NVMe over IB](#nvme-over-ib)
- [NVMe over FC](#nvme-over-fc)
- [NVMe over RoCE](#nvme-over-roce)
- [RoCE](#roce)
- [iSCSI](#iscsi)
- [FC](#fc)
- [SAS](#sas)
- [License](#license)
- [Maintainer Information](#maintainer-information)
### Requirements for E-Series Storage Systems
NetApp E-Series E2800 platform or newer (For older platforms, use NetApp E-Series SANtricity Web Services Proxy.)
### Requirements for E-Series Hosts.
- Python3.6 or later
Ansible 5.x (ansible-core 2.12)
- RHEL 8.4
Feature roles perform high level functions and will include the supporting roles as needed. Inventory variables will
need to be defined for any included feature roles as well as any needed [supporting roles](#support-roles). For
example, when the [Storage Setup](roles/storage_setup/README.md) role is included in your playbook and the targeted
E-Series storage system utilizes the NVMe over InfiniBand communication protocol then the
[NVMe over IB](roles/nvme_ib/README.md) role's inventory variables for will also need to be defined.
The storage_setup role installs and configures multipath and any supported protocols required for host-storage
communications based on E-Series mapped volumes. The support roles include multipath and protocol roles.
See [netapp_eseries.host.storage_setup documentation](roles/storage_setup/README.md) for more details.
The mount role will format and/or mount E-Series volumes on hosts. See
[netapp_eseries.host.mount documentation](roles/mount/README.md) for more details.
The unmount role will unmount E-Series volumes from hosts. See
[netapp_eseries.host.unmount documentation](roles/unmount/README.md) for more details.
The snapshot role attempts to create filesystem safe point-in-time snapshot images. See
[netapp_eseries.host.snapshot documentation](roles/snapshot/README.md) for more details.
Support Role are intended to aid the feature roles but may be called directly in unique situations.
The protocol role installs and configures any supported protocols required for host-storage communications based
on E-Series mapped volumes. See [netapp_eseries.host.protocol documentation](roles/protocol/README.md) for more
details.
The multipath role configures multipathing for SCSI and NVMe devices. See
[netapp_eseries.host.multipath documentation](roles/multipath/README.md) for more details.
The selinux role configures SELinux. See [netapp_eseries.host.selinux documentation](roles/selinux/README.md) for more
details.
The ib_opensm role configuration OpenSM subnet managers. See
[netapp_eseries.host.ib_opensm documentation](roles/ib_opensm/README.md) for more details.
The ipoib role configures InfiniBand network interfaces. See
[netapp_eseries.host.ipoib documentation](roles/ipoib/README.md) for more details.
The ib_iser role installs and configures the required kernel modules and packages for InfiniBand iSER protocol. See
[netapp_eseries.host.ib_iser documentation](roles/ib_iser/README.md) for more details.
The ib_srp role installs and configures the required kernel modules and packages for InfiniBand SRP protocol. See
[netapp_eseries.host.ib_srp documentation](roles/ib_srp/README.md) for more details.
The nvme_ib role installs and configures the required kernel modules and packages for NVMe over InfiniBand protocol.
See [netapp_eseries.host.nvme_ib documentation](roles/nvme_ib/README.md) for more details.
The nvme_fc role installs and configures the required kernel modules and packages for NVMe over Fibre Channel
protocol. See [netapp_eseries.host.nvme_fc documentation](roles/nvme_fc/README.md) for more details.
The nvme_roce role installs and configures the required kernel modules and packages for NVMe over RoCE protocol.
See [netapp_eseries.host.nvme_roce documentation](roles/nvme_roce/README.md) for more details.
The RoCE role configures ethernet interfaces for the RoCE protocol (IB over Ethernet). See
[netapp_eseries.host.roce documentation](roles/roce/README.md) for more details.
The iscsi role installs and configures the required packages for the iSCSI protocol. See
[netapp_eseries.host.iscsi documentation](roles/iscsi/README.md) for more details.
The fc role is simply a place holder for the fibre channel protocol. See
[netapp_eseries.host.fc documentation](roles/fc/README.md) for more details.
The sas role is simply a place holder for the SAS protocol. See
[netapp_eseries.host.sas documentation](roles/sas/README.md) for more details.
BSD-3-Clause
- Vu Tran (@VuTran007)
- Christian Whiteside (@mcwhiteside)