Forge Home

hpe3par

HPE 3PAR Module for Puppet

5,706 downloads

5,678 latest version

4.6 quality score

We run a couple of automated
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.

Version information

  • 1.0.1 (latest)
  • 1.0.0 (deleted)
released May 8th 2018
This version is compatible with:
  • Puppet Enterprise 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x
  • Puppet >= 5.0.0
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'hewlettpackardenterprise-hpe3par', '1.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add hewlettpackardenterprise-hpe3par
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install hewlettpackardenterprise-hpe3par --version 1.0.1

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.

Download

Documentation

hewlettpackardenterprise/hpe3par — version 1.0.1 May 8th 2018

HPE 3PAR Module for Puppet

The hpe3par module is a starter kit which provides types and providers, using which you can write recipes to manage HPE 3PAR storage arrays. This module uses the hpe3par_sdk to communicate with the 3PAR storage arrays over http/https through the WSAPI REST service hosted on the array.

Use this by creating a new module and specifying a dependency on this module in your metadata. Then use any of the types provided by this module.

Note: The module name is 'hpe3par'. If you want to directly use from source, you need to rename the directory hpe3par_puppet_module to hpe3par in order to use the types.

Requirements

  • 3PAR OS
    • 3.2.2 MU4 + 106, MU6 + P107
    • 3.3.1 MU2
  • Puppet - 5.3
  • hpe3par_sdk ruby gem
  • WSAPI service should be enabled on the 3PAR storage array.

Pre-requisite installation

The hpe3par module uses the hpe3par_sdk ruby library to communicate with the HPE 3PAR array. To install the library dependency automatically include the following in your node definition:

class { 'hpe3par' : }

This will install the hpe3par_sdk onto the specified node.

Usage

The HPE 3PAR module can be used both in Puppet Device mode and Puppet Agent mode. Explanations as well as examples of what these modes mean are given below:

Puppet Agent

Puppet agent is the client/slave side of the puppet master/slave relationship. In the case of puppet agent the connection information needs to be included in the manifest supplied to the agent from the master or it could be included in a custom fact passed to the client. The connection string may be supplied as a URL or as 3 separate parameters (user, password and ssip). See the example manifests for details.

Example:

  hpe3par_volume { 'data_volume_1' :
    ensure                   => present,
    cpg                      => 'FC_r1',
    size                     => 1024,
    size_unit                => 'MiB',
    expiration_hours         => 5,
    ss_spc_alloc_warning_pct => '40',
    rm_ss_spc_alloc_warning  => true,
    url                      => 'https://3par_user:3par_user@array1.3par.com:8080'
  }

or

  hpe3par_volume { 'data_volume_1' :
    ensure                   => present,
    cpg                      => 'FC_r1',
    size                     => 1024,
    size_unit                => 'MiB',
    expiration_hours         => 5,
    ss_spc_alloc_warning_pct => '40',
    rm_ss_spc_alloc_warning  => true,
    user                     => '3par_user',
    password                 => '3par_user',
    ssip                     => 'array1.3par.com'
  }

In the case of Puppet Agent, connections to the HPE 3PAR array will be initiated from every machine which utilizes the HPE 3PAR puppet module this way.

Puppet Device

The Puppet Network Device (NetDev) system is a way to configure devices (switches, routers, storage) which do not have the ability to run Puppet agent natively. This application acts as a smart proxy between the Puppet Master and the managed device. To do this, Puppet NetDev connects to the Master on behalf of the managed device and asks for a catalog (a catalog containing device resources). It will then apply this catalog to the device by translating the resources to orders that the managed device understands. Puppet NetDev will then report back to the Master of any changes and failures in the same manner as a standard node.

The HPE 3PAR providers are designed to work with the Puppet Device concept and retrieves connection information from the url given in Puppet's device.conf file. Connection to the HPE 3PAR array is made from the machine running the puppet device command. An example is shown below:

  [array1.3par.com]
  type hpe3par
  url https://admin:password@array1.3par.com

In this mode, there is no need to specify array connection details while declaring a resource, since the connection details are picked up from the device config.

Example:

  # No need to specify the array connection details.
  # Connection details need to be specified in the device.conf.
  hpe3par_volume { 'data_volume_1' :
    ensure                   => present,
    cpg                      => 'FC_r1',
    size                     => 1024,
    size_unit                => 'MiB',
    expiration_hours         => 5,
    ss_spc_alloc_warning_pct => '40',
    rm_ss_spc_alloc_warning  => true
  }

Non Idempotent Actions

Actions are Idempotent when they can be run multiple times on the same system and the results will always be identical, without producing unintended side effects.

The following actions are non-idempotent:

  • Clone: resync, create_offline
  • Snapshot: restore online, restore offline
  • Virtual Volume: grow (grow_to_size is idempotent)
  • VLUN: All actions become non-idempotent when autolun is set to true

Reference

Type Reference

Development

Please read our Community Contributions Guidelines

License

This project is licensed under the Apache 2.0 license. Please see LICENSE for more info