GitHub - NetApp/santricity · GitHub
Skip to content You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert Branches Tags Open more actions menu Latest commit History 234 Commits 234 Commits Folders and files Name Name Last commit message Last commit date changelogs changelogs meta meta plugins plugins roles roles tests tests vars vars .gitignore .gitignore CHANGELOG.rst CHANGELOG.rst CONTRIBUTING.md CONTRIBUTING.md COPYING COPYING Jenkinsfile.blackduck Jenkinsfile.blackduck README.md README.md eseries-ansible-collections-diagram.png eseries-ansible-collections-diagram.png galaxy.yml galaxy.yml Repository files navigation NetApp E-Series SANtricity Collection The SANtricity collection consist of the latest available versions of the NetApp E-Series SANtricity modules and roles.
This collection provides NetApp E-Series customers with a wide range of configuration options through the collection's modules. However, the real benefit of using the SANtricity collection is found in the host and management roles. These roles provide ready-made, policy-based orchestration for E-Series platforms based on predefined role variables. Once the physical hardware has been installed, the SANtricity roles are capable of discovering the DHCP-assigned addresses, setting initial passwords and management interfaces so your automation can do full deployments for you without logging directly into the devices.
Yet that's just the beginning, the management role will also ensure alerts, ASUP, logging, LDAP, and firmware are configured as expected; and the host role will setup host interfaces, provision and map storage, and if your servers are defined in the inventory, correctly populate E-Series hosts and host groups automatically. Roles: - nar_santricity_common: Discover NetApp E-Series storage systems and configures SANtricity Web Services Proxy. - nar_santricity_host: Configure storage pools, volumes, hosts, host groups, port interfaces and snapshots. - nar_santricity_management: Manage storage system's name, management interfaces, alerts, syslog, auditlog, asup, ldap, certificates, drive firmware and controller firmware.
Modules: - na_santricity_alerts: Manage email alert notification settings - na_santricity_alerts_syslog: Manage syslog servers receiving storage system alerts - na_santricity_asup: Manage auto-support settings - na_santricity_auditlog: Manage audit-log configuration - na_santricity_auth: Set or update the password for a storage array - na_santricity_client_certificate: Manage remote server certificates - na_santricity_server_certificate: Manage storage system certificates - na_santricity_discover: Discover E-Series storage systems on a subnet - na_santricity_drive_firmware: Manage drive firmware - na_santricity_facts: Retrieve facts about NetApp E-Series storage arrays - na_santricity_firmware: Manage firmware - na_santricity_global: Manage global settings configuration - na_santricity_host: Manage eseries hosts - na_santricity_hostgroup: Manage array host groups - na_santricity_ib_iser_interface: Manage InfiniBand iSER interfaces. - na_santricity_iscsi_interface: Manage iSCSI interface configuration - na_santricity_iscsi_target: Manage iSCSI target configuration - na_santricity_ldap: Manage LDAP integration to use for authentication - na_santricity_lun_mapping: Manage lun mappings - na_santricity_mgmt_interface: Manage management interface configuration - na_santricity_nvme_interface: Manage NVMe interfaces - na_santricity_proxy_drive_firmware_upload: Manage proxy drive firmware cache. - na_santricity_proxy_firmware_upload: Manage proxy storage system firmware cache. - na_santricity_proxy_systems: Manage proxy storage systems. - na_santricity_snapshot: Manage Snapshot groups, volumes, and rollbacks. - na_santricity_storage_system: Manage SANtricity web services proxy storage arrays - na_santricity_storagepool: Manage volume groups and disk pools - na_santricity_syslog: Manage syslog settings - na_santricity_volume: Manage storage volumes *** Note that the following deprecated modules will be removed in a future release.
Deprecated Modules: - netapp_e_alerts: Manage email notification settings - netapp_e_amg: Create, remove, and update asynchronous mirror groups - netapp_e_amg_role: Update the role of a storage array within an Asynchronous Mirror Group (AMG) - netapp_e_amg_sync: Conduct synchronization actions on asynchronous mirror groups - netapp_e_asup: Manage auto-support settings - netapp_e_auditlog: Manage audit-log configuration - netapp_e_auth: Set or update the password for a storage array - netapp_e_drive_firmware: Manage drive firmware - netapp_e_facts: Retrieve facts about NetApp E-Series storage arrays - netapp_e_firmware: Manage firmware - netapp_e_flashcache: Manage SSD caches - netapp_e_global: Manage global settings configuration - netapp_e_hostgroup: Manage eseries hosts - netapp_e_host: Manage array host groups - netapp_e_iscsi_interface: Manage iSCSI interface configuration - netapp_e_iscsi_target: Manage iSCSI target configuration - netapp_e_ldap: Manage LDAP integration to use for authentication - netapp_e_lun_mapping: Create, delete, or modify lun mappings - netapp_e_mgmt_interface: Manage management interface configuration - netapp_e_snapshot_group: Manage snapshot groups - netapp_e_snapshot_images: Create and delete snapshot images - netapp_e_snapshot_volume: Manage snapshot volumes - netapp_e_storagepool: Manage volume groups and disk pools - netapp_e_storage_system: Manage Web Services Proxy manage storage arrays - netapp_e_syslog: Manage syslog settings - netapp_e_volume_copy: Create volume copy pairs - netapp_e_volume: Manage storage volumes (standard and thin) Requirements - NetApp E-Series E2800 platform or newer or NetApp E-Series SANtricity Web Services Proxy configured for older E-Series Storage arrays. - Python cryptography >= 2.5 package is required for na_santricity_server_certificate and nar_santricity_management role. - Python ipaddress and netaddr packages are required for na_santricity_discover, na_santricity_ and nar_santricity_common role.
Tested Ansible Versions - Ansible 12 (ansible-core 2.19) Example Playbook - hosts: eseries_storage_systems gather_facts: false collections: - netapp_eseries.santricity tasks: - name: Ensure all management related policies are enforced. import_role: name: nar_santricity_management - name: Ensure all host related policies are enforced. import_role: name: nar_santricity_host Example Storage System Inventory File (Simple example without storage system discovery) eseries_system_api_url: https://192.168.1.200:8443/devmgr/v2/ eseries_system_password: admin_password eseries_validate_certs: false eseries_system_name: my_eseries_array eseries_management_interfaces: config_method: static subnet_mask: 255.255.255.0 gateway: 192.168.1.1 dns_config_method: static dns_address: 192.168.1.253 ntp_config_method: static ntp_address: 192.168.1.200 controller_a: - address: 192.168.1.100 - address: 192.168.1.101 controller_b: - address: 192.168.1.102 - address: 192.168.1.103 eseries_initiator_protocol: fc # Storage pool and volume configuration eseries_storage_pool_configuration: - name: vg_01 raid_level: raid6 criteria_drive_count: 10 volumes: - name: metadata host: servers size: 4096 - name: vg_02 raid_level: raid5 criteria_drive_count: 10 volumes: - name: storage_[1-3] host: servers size: 2 size_unit: tb volume_metadata: # Used by netapp_eseries.host.mount role to format and mount volumes format_type: xfs mount_opt: "noatime,nodiratime,logbufs=8,logbsize=256k,largeio,inode64,swalloc,allocsize=131072k,nobarrier,_netdev" mount_dir: "/data/beegfs/" Example Storage System Inventory File (Discover storage system) Note that this discovery method works for SANtricity versions 11.62 or later, otherwise it will only discover the systems with unset passwords.
The rest of this page is on the live site.