emc_vnx
Contributions Requested
11,131 downloads
6,346 latest version
4.0 quality score
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.
Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.
Support the Puppet Community by contributing to this module
You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:
- Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
- Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.
For questions about updating the module, contact the module’s author.
Version information
- 0.1.5 (latest)
- 0.1.3
- 0.1.2
- 0.1.1
- 0.1.0
Start using this module
- r10k or Code Manager
- Bolt
- Manual installation
- Direct download
Add this module to your Puppetfile:
mod 'swindlife-emc_vnx', '0.1.5'
Learn more about managing modules with a PuppetfileAdd this module to your Bolt project:
bolt module add swindlife-emc_vnx
Learn more about using this module with an existing projectManually install this module globally with Puppet module tool:
puppet module install swindlife-emc_vnx --version 0.1.5
Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.
DownloadDocumentation
#Puppet VNX Module Puppet VNX module wraps Naviseccli into Puppet module to simplify the configuration of VNX Initiator, DNS, Storage Pool, Hot Spare, Storage Group, LUN, Fast Cache, NTP, Domain, SP and Array.
CI Status
Prerequisite
Ruby >= 1.9.3 RubyGem >= 3.6.0
Prepare
Download and install Navisphere CLI
For VNX1 Series: https://support.emc.com/downloads/12781_VNX1-Series
For VNX2 Series: https://support.emc.com/downloads/36656_VNX2-Series
Example
transport {'vnx5400':
username => 'nasadmin',
password => 'nasadmin',
server => '10.10.166.9'
}
vnx_storagepool {"elc-cloud":
disks => ['0_0_4', '0_0_5', '0_0_6', '0_0_7', '0_0_8'],
raid_type => 'r_5',
transport => Transport['vnx5400'],
ensure => present
}
Notice: Type parameters refer to Navisphere CLI parameters
TO DO
- Add more configurable resources
License
Licensed under the Apache License, Version 2.0 (the “License”). See LICENSE for details.
Contact
jie.bao@emc.com layne.peng@emc.com
Support
Please file bugs and issues on the Github issues page for this project. This is to help keep track and document everything related to this repo. For general discussions and further support you can join the EMC {code} Community slack channel. Lastly, for questions asked on Stackoverflow.com please tag them with EMC. The code and documentation are released with no warranties or SLAs and are intended to be supported through a community driven process.
Please log tickets and issues at our Projects site
Types in this module release
Manage EMC VNX NTP settings.
Parameters | |
---|---|
ensure | |
keyvalue | The NTP keyvalue for authentication. |
ntp_servers | The NTP server address. |
provider | |
server_key | The NTP server key value. |
Properties | |
---|---|
ensure_running | Control whether NTP is started or not |
interval | The synchronization interval in minutes from 30 to 43200. |
Providers | |
---|---|
vnx_ntp | Configure NTP settings for VNX. |
Manage EMC VNX LUNs.
Parameters | |
---|---|
ensure | |
lun_name | The LUN name |
name | The LUN name |
primary_lun_name | The primary LUN number |
primary_lun_number | The primary LUN number |
provider | |
type | LUN type, THIN or Thick. Unchangeable once created. |
Properties | |
---|---|
allocation_owner | Allocation Service Port the LUN belong to |
allocation_policy | The allocation policy on the pool LUN. |
allow_inband_snap_attach | Allow Inband Snap Attach |
allow_snap_auto_delete | Allow deleting snap automatically when lun is deleted |
auto_assign | Specifies whether to use auto assign for the LUN. Unchangeable once created. |
capacity | The LUN capacity |
consumed_capacity | Consumed Capacity |
consumed_capacity_blocks | Consumed Capacity (Blocks) |
current_owner | Current Service Port the LUN belong to |
default_owner | Default Service Port the LUN belong to |
ignore_thresholds | Forces the non-snap LUN to be created, ignoring possible threshold related error |
initial_tier | The initial tier preference |
is_pool_lun | |
is_thin_lun | |
lun_number | The LUN Id. |
new_name | The LUN new name |
offset | The LUN offset. Unchangeable once created. |
pool_id | Storage pool the LUN will belong to. Unchangeable once created. |
pool_name | Storage pool the LUN will belong to. Unchangeable once created. |
raid_type | Raid Type of the LUN |
size_qual | Size qualifier for the LUN capacity |
tiering_policy | The LUN auto-tiering policy |
uid | UID |
user_capacity_blocks | User Capacity (Blocks) |
Providers | |
---|---|
vnx_lun | Manage LUNs for VNX. |
Manage EMC VNX DNS settings.
Parameters | |
---|---|
domain | The DNS Domain name |
ensure | |
provider |
Properties | |
---|---|
name_servers | The DNS name server IPv4 addresses. |
search_list | The DNS search list. |
Providers | |
---|---|
vnx_dns | Configure DNS settings for VNX. |
Manage EMC VNX FAST cache settings.
Parameters | |
---|---|
cache_mode | Cache mode, can be rw or ro |
ensure | |
name | Fast Cache Name |
provider | |
raid_type | The FAST Cache raid type |
Properties | |
---|---|
disks | The VNX disks to be used for FAST Cache. Disks must be specified in an array. |
Providers | |
---|---|
vnx_fastcache | Manages VNX FAST Cache settings. |
Manage EMC autotiering and autotiering schedule.
Parameters | |
---|---|
duration | The duration for a manual relocation. |
ensure_enabled | Controls the enabling and disabling of autotiering |
poolname | The pool name for relocation. Specify pool name or 'all' to apply to all pools |
relocation_rate | The rate for manual relocation; high, medium or low. |
schedule | The days of the week for the scheduled VNX autotiering. |
time | The time of day for VNX autotiering. Valid values are colon separated digits representing hour and time in the formate hh:mm or h:mm. |
Manage VNX systems to monitor.
Parameters | |
---|---|
ensure_exported | Exports the template file |
ensure_imported | Imports the template file |
ensure_monitored | Manages adding and removing systems to monitor |
ensure_swapped | Swaps the specified template with the current template name |
file_path | The File path for exported templates |
resolve_conflict | Resolves Template conflicts |
server | The host agent where the system is added |
system | The VNX system |
template_name | The Template filename to be imported to the template database |
Manage VNX Event Monitor Templates.
Parameters | |
---|---|
ensure_exported | Exports the template file |
ensure_imported | Imports the template file |
ensure_swapped | Swaps the specified template with the current template name |
file_path | The File path for exported templates |
resolve_conflict | Resolves Template conflicts |
template_filename | The Template filename to be imported to the template database |
template_name | The Template Name |
Manage EMC VNX storage groups.
Parameters | |
---|---|
ensure | |
name | Storage group name. |
provider | |
sg_name | Storage group name. |
Properties | |
---|---|
addonly | addonly only used when you don't want to move anything from storagegroup |
array_commpath | Owner SP. |
failover_mode | Owner SP. |
HBAs | HBA/SP Pairs |
hbauid | The HBA UID for an Initiator |
host_name | Host name. |
hostname | Owner SP. |
initiator_type | Owner SP. |
ip_address | The IP address of virtual machine |
luns | HLU/ALU Pairs |
new_name | The storage group new name. |
setpathonly | addonly only used when you don't want to move anything from storagegroup |
shareable | The storage group shareable property. |
sp | Owner SP. |
sp_port | Owner SP. |
uid | Storage group uid. |
unit_serialnumber | Owner SP. |
Providers | |
---|---|
vnx_storagegroup | Manages VNX Storage Groups. |
Manage EMC VNX Qos Settings.
Parameters | |
---|---|
ensure | |
lun_name | The LUN name |
name | The IOclass name |
provider |
Properties | |
---|---|
anyio | The anyio. |
control_method | The control_method. |
current_state | The current_state. |
fail_action | The fail_action. |
goal_value | The goal_value. |
io_size_range | The io_size_range. |
io_type | The io_type. |
ioclass | The IOclass. |
lun_number | The LUN Id. |
lun_wwn | The LUN WWN. |
metric_type | The metric_type. |
number_of_luns | The number_of_luns. |
policy_name | The policy name. |
raid_type | The raid_type. |
status | The status. |
Providers | |
---|---|
vnx_nqm | Set QoS for LUNs for VNX. |
Manage VNX Analyzer settings.
Parameters | |
---|---|
default_logging | Sets logging to defaults |
ensure_started | Controls starting and stopping the analyzer |
log_period | Sets performance logging to run for 1-7 days |
name | VNX Analyzer name, defaults to analyzer |
nar_interval | Polling interval for performance logging |
non_stop | Sets performance logging to non_stop |
periodic_logging | Creates archive files at periods of 156 samples |
rt_interval | Polling interval for real-time chart windows |
Manage EMC VNX Array name.
Parameters | |
---|---|
ensure | |
name | The name for the VNX Array |
provider |
Providers | |
---|---|
vnx_array | Manage VNX Array name. |
Manage EMC VNX storage pools.
Parameters | |
---|---|
auto_tiering | Sets the auto tiering schedule |
ensure | |
ensure_fastcache | Enables or disables FAST Cache for the pool |
initialverify | Specify whether initial verify is run on pool creation or expansion |
name | The storage pool name. |
provider | |
rdrive_count | The RAID drive count used to create internal RAID groups |
skip_rules | Allows skipping rule checking when creating pools |
snappool_fullthreshold | Enables or disables checking HWM for auto delete |
snappool_hwm | The pool full HWM that triggers auto delete |
snappool_lwm | The pool full LWM that stops auto delete |
snapspace_hwm | Snapshot space used HWM that triggers auto delete |
snapspace_lwm | Snapshot space LWM which stops auto delete |
snapspace_threshold | Check snapshot space for HWM for auto delete |
Properties | |
---|---|
available_capacity_blocks | Available Capacity (Blocks) |
available_capacity_gbs | Available Capacity (GBs) |
cancel_expand | cancel expand |
consumed_capacity_blocks | Consumed Capacity (Blocks) |
consumed_capacity_gbs | Consumed Capacity (GBs) |
current_operation | Current Operation |
current_operation_percent_completed | Current Operation Status Completed |
current_operation_state | Current Operation State |
current_operation_status | Current Operation Status |
description | The storage pool description |
disk_type | Disk Type |
disks | The disks to add to the storage pool. |
luns | LUNs |
new_name | The new storage pool name. |
oversubscribed_by_blocks | Oversubscribed by (Blocks) |
oversubscribed_by_gbs | Oversubscribed by (GBs) |
percent_full | Percent Full |
percent_full_threshold | The percent full before alerts are generated |
percent_subscribed | Percent Subscribed |
pool_id | |
raid_type | The RAID type for the pool. |
raw_capacity_blocks | Raw Capacity (Blocks) |
raw_capacity_gbs | Raw Capacity (GBs) |
state | State |
status | Status |
total_subscribed_capacity_blocks | Total Subscribed Capacity (Blocks) |
total_subscribed_capacity_gbs | Total Subscribed Capacity (GBs) |
user_capacity_blocks | User Capacity (Blocks) |
user_capacity_gbs | User Capacity (GBs) |
Providers | |
---|---|
vnx_storagepool | Manages VNX Storage Pools. |
Manage EMC VNX Domain settings.
Parameters | |
---|---|
domain | The VNX Domain name |
domain_member | The IP address of the system to add to the VNX domain |
ensure | |
ensure_master | Sets the specified system as the domain master |
old_password | Password for user |
old_scope | The user scope, global, local, or LDAP |
old_user | Specify user to add system |
provider |
Properties | |
---|---|
ensure_member | Ensure a system is part of a VNX domain. |
Providers | |
---|---|
vnx_domain | Configure NTP settings for VNX. |
Manage EMC VNX LDAP settings.
Parameters | |
---|---|
bind_password | The LDAP password |
binddn | The login for LDAP/AD |
cert | The pathname of the trusted cert file to be uplodaded to the cert store |
ensure | |
group_member_attribute | A search filter for the different attribute types to identify the different groups of members |
group_name_attribute | The attribute to which the user group's common name will be appended in the servers |
group_object_class | A search filter in a situation where a group has multiple entries in a server |
group_search_path | The LDAP group search path |
portnumber | The LDAP Port number, 389 for LDAN, 636 for LDAPS |
protocol | The LDAP Protocol |
server | The VNX LD Server IP Address |
servertype | The LDAP Server type |
user_id_attribute | The attribute to which the user ID will be appended in the LDAP/AD servers |
user_name_attribute | The attribute to which the user's common name (cn) will be appended in the servers |
user_object_class | A search filter in a situation where a user has multiple entries in a server |
user_search_path | The LDAP user search path |
Manage EMC VNX FAST cache settings.
Parameters | |
---|---|
disks | The VNX disks to be used for FAST Cache. Disks must be specified in a comma separated list. |
ensure | |
mode | The VNX FAST Cache mode, can only be ro or rw. |
provider | |
rtype | The VNX FAST Cache raid type, can only be disk or r_1. |
Providers | |
---|---|
vnx_fastcache | Manages VNX FAST Cache settings. |
VNX Initiator/Hosts.
Parameters | |
---|---|
ensure | |
hba_uid | The HBA UID for an Initiator not name |
hbauid | The HBA UID for an Initiator |
provider |
Properties | |
---|---|
arraycommpath | Array Comm Path |
failovermode | failover mode |
hostname | The host name of virtual machine |
ip_address | The IP address of virtual machine |
ports | Information about each port of this HBA |
Providers | |
---|---|
vnx_initiator | Manage Hosts/Initiators for VNX. |
Manage EMC VNX ISCSI Port settings.
Parameters | |
---|---|
address | THe IP Address of the SP Port |
alias | The iSCSI port Alias |
enable_vlantag | Allows enabling or disabling of VLAN tagging |
ensure | |
gateway | The gateway address for the SP Port |
initiator_authenticate | True sets this value to 0 or not required, False sets to 1 and required |
mtu | The MTU for the port |
name | The VNX SP Port to configure |
port_speeed | The Port speed |
subnetmask | The Subnet Mask for the SP Port |
vlanid | The Port VLAN ID |
vportid | The virtual Port ID. |
Manage transport connectivity info such as username, password, server, scope.
Parameters | |
---|---|
cli_path | |
name | The name of the network transport. |
password | |
provider | |
scope | |
server | |
username |
Providers | |
---|---|
default | Basic provider for transport that just returns the value passed into the resource |
Manage EMC VNX SP name and IP settings.
Parameters | |
---|---|
ensure | |
gateway | The IP gateway address |
ipaddress | The IPv4 address for the VNX SP |
provider | |
service_processor | The Service Processor |
subnetmask | The IP Subnet mask |
Properties | |
---|---|
sp_name | The Service Processor network name |
Providers | |
---|---|
vnx_sp | Manage VNX Service Processor settings. |