stoarray 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 16f9b1bb71ba39793550906a15129a2c15a8112f
-  data.tar.gz: dce631b9a9b8804930136b39d7a370d9737a949e
+  metadata.gz: a53326d24d57ffb7ff0dfb2d411eba1a8ef69e4a
+  data.tar.gz: 403071201cf86e546061ca8803cd2c7be16fc357
 SHA512:
-  metadata.gz: 8c3ec8d8cd00f1fc0b42d2fb23be76e9a91885aa8c7f393f110e562a449ceb6f3f58cb8ac00b0e3b0372815bdea8baaf3cdffacdd30ee88b22832f385382cb78
-  data.tar.gz: 81a6925fa9fd306314f908f7594dcd5f9271e41cf5ab92d285457e625092d67e638d28cdddca421c651bfa409389e1bf01d9bf25f018b3429cafa602426b3da0
+  metadata.gz: a0b004540bc61a3bd412b1b480c056bcfadf70b84ead88fffe33c6d0e7b7eb3628ae9d0c8332c33a6045c8cbfc7b426685eb997ae22c9d583b846dc81893a0ca
+  data.tar.gz: f073c3e361096a7a1752ccf4b3c32b2428d8553339a6d3dfd8b03c892242a9fe84d860f3e1d3755d487d9f5d3fa0d01cf777ecccd24355c1fc64924a5cc35d72

data/README.md

@@ -19,7 +19,9 @@ And then execute:
 
 In your script:
 
-    require 'stoarray'
+```ruby
+require 'stoarray'
+```
 
 EMC's Xtremio and Pure's storage arrays are currently supported.
 
@@ -27,41 +29,46 @@ Both api's use json for parameters and the examples below follow suit.
 I prefer to set variables that will not change in a json configuration file.
 It is very easy to then build from there.
 
-Examples using Pure:
---------------------
+## Clone refresh using Pure
+---------------------------
 
 ###First the json configuration file:
+
     {
       "authorization":"123li123o90yourapitoken2h1hi3",
-      "base_url":"https://purearray01/api/1.4/",
+      "base_url":"https:///purearray01.something.net/api/1.4/",
       "headers": { "Content-Type": "application/json" },
-      "newhost": "testsrv01",
-      "new_luns_testsrv01": [
-        "testsrv01_u23_1_src",
-        "testsrv01_u23_2_src",
-        "testsrv01_u23_3_src",
-        "testsrv01_u23_4_src",
-        "testsrv01_u23_5_src"
-        ],
-      "params_host_testsrv01": {
-        "wwnlist":  [
-          "10:00:00:00:C1:A3:BG:16",
-          "10:00:00:00:C1:A3:BG:17"
-          ]
+      "params_snap_u23": {
+        "snap_pairs": {
+          "x0319t186_u23_1_src": "x0319t186_u23_1_des",
+          "x0319t186_u23_2_src": "x0319t186_u23_2_des",
+          "x0319t186_u23_3_src": "x0319t186_u23_3_des",
+          "x0319t186_u23_4_src": "x0319t186_u23_4_des",
+          "x0319t186_u23_5_src": "x0319t186_u23_5_des"
+        },
+        "source": [
+          "x0319t186u23"
+        ]
       }
     }
 
 The top three likely will not change between api calls.
 
 + authorization - This is your api token.
-+ base_url      - URL for your array and api
++ base_url      - URL for your array and api version
 + headers       - Pass the content type (JSON in this case)
 
+These are what you need to set for clone refreshes. In this example,
+they are nested under "params_snap_u23".
+
++ snap_pairs    - Map source volume(s) to target volume(s).
++ source        - This is the name of the source protection group.
+
 ###Back to your script, after the require 'stoarray'
 
 ```ruby
 # Location of json configuration file and api token
-conf    = JSON.parse(File.read('/Users/yourid/pure.json'))
+conf    = JSON.parse(File.read('/Some/path/pure.json'))
 token   = conf['authorization']
 ```
 
@@ -69,7 +76,7 @@ Pure uses cookies. You trade one for your api token and then you can use the coo
 while your session persists (30 minute inactivity timeout, unless you destroy it early).
 
 ```ruby
-# Get a cookie for our session
+# Get a cookie for our session - required by Pure.
 url     = conf['base_url'] + 'auth/session'
 headers = conf['headers']
 params  = { api_token: token }
@@ -82,27 +89,19 @@ headers['Cookie'] = cookies
 Now we will send application type json and the cookie with each call.
 
 ```ruby
-# Create host and set list of WWN's
-params   = conf['params_host_testsrv01']
-url_host = conf['base_url'] + 'host/' + conf['newhost']
-host     = Stoarray.new(headers: headers, meth: 'Post', params: params, url: url_host).host
-puts host['response']
-
-# Create volumes and map them to new host
-conf['new_luns_testsrv01'].each do |vol|
-  url_vol = conf['base_url'] + 'volume/' + vol
-  voly = Stoarray.new(headers: headers, meth: 'Post', params: { :size => "10G" }, url: url_vol).volume
-  puts JSON.parse(voly.body) if verbose == true
-  url_map = url_host + '/volume/' + vol
-  mappy = Stoarray.new(headers: headers, meth: 'Post', params: {}, url: url_map).host
-  puts mappy['response'] if verbose == true
-end
-
+# Now refresh the clones
+params = conf['params_snap_u23']
+refresh = Stoarray.new(headers: headers, meth: 'Post', params: params, url: conf['base_url']).refresh
+puts "Status:   " + refresh['status'].to_s
+puts "Response: " + refresh['response'].to_s
 ```
 
-In the above example, you end up with a new host on the array, named testsrv01, including WWN's, and five, new 10GB volumes mapped to the host.
+In the above example, the source protection group is first snapped.
+Next, each target volume is overwritten with the source snapshot (snap_pairs).
+Any error along the way will cause the gem to return all status codes
+and all array responses. Success gives a 201, SUCCESS.
 
-###Now for Xtremio, json first:
+## Xtremio clone refresh, json first
     {
       "base_url":"https://xmsserver01/api/json/v2/types/",
       "headers": {
@@ -140,6 +139,11 @@ puts "Status:   " + refresh['status'].to_s
 puts "Response: " + refresh['response'].to_s
 ```
 
+## Troubleshooting
+
+error 307 - Enter fully qualified domain name (FQDN) for the array to fix.
+    purearray01.something.net instead of just purearray01
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/arraycalls.rb

@@ -79,18 +79,88 @@ class Stoarray
     end
   end
 
+  def pgroup
+    if @url.to_s =~ /pgroup/
+      response = @request.start { |http| http.request(@call) }
+      responder(response)
+    else
+      error_text("pgroup", @url.to_s, "pgroup")
+    end
+  end
+
   def refresh
     case @url.to_s
     when /snapshot/ # Xtremio
       @call.body = flippy(JSON.parse(@call.body)).to_json
       refreshy = @request.start { |http| http.request(@call) }
       responder(refreshy)
-    when /volume/ # Pure, handle the interim snap automagically
-      # obviously not implemented yet :)
-      refreshy = @request.start { |http| http.request(@call) }
-      responder(refreshy)
+    when /1.4/ # Pure, handle the interim snap automagically
+      error_state = false
+      url     = 'https://' + @url.host + '/api/1.4/pgroup'
+      source  = (JSON.parse(@call.body))['source']
+      suffix  = Time.new.strftime("%A") # Day of the week.
+      pam     = { :snap => true, :source => source, :suffix => suffix }
+      snap    = Stoarray.new(headers: @headers, meth: 'Post', params: pam, url: url).pgroup
+      respond = {
+        "response" => {
+          "snap" => {
+            "response" => snap['response']
+          }
+        },
+        "status" => {
+          "snap" => {
+            "status" => snap['status']
+          }
+        }
+      }
+      if snap['status'] >= 200 && snap['status'] <= 299
+        pairs   = (JSON.parse(@call.body))['snap_pairs']
+        pairs.each do |key, val|
+          tgt = 'clone_' + val
+          src = source[0] + '.' + suffix + '.' + key
+          pam = { :overwrite => true, :source => src }
+          url = 'https://' + @url.host + '/api/1.4/volume/' + val
+          clone = Stoarray.new(headers: @headers, meth: 'Post', params: pam, url: url).volume
+          respond['response'][tgt] = {
+            "response" => clone['response']
+          }
+          respond['status'][tgt] = {
+            "status" => clone['status']
+          }
+        end
+        url   = 'https://' + @url.host + '/api/1.4/pgroup/' + source[0] + '.' + suffix
+        zappy = Stoarray.new(headers: @headers, meth: 'Delete', params: {}, url: url).pgroup
+        respond['response']['destroy'] = {
+          "response" => zappy['response']
+        }
+        respond['status']['destroy'] = {
+          "status" => zappy['status']
+        }
+        pam   = { :eradicate => true }
+        disintegrate = Stoarray.new(headers: @headers, meth: 'Delete', params: pam, url: url).pgroup
+        respond['response']['eradicate'] = {
+          "response" => disintegrate['response']
+        }
+        respond['status']['eradicate'] = {
+          "status" => disintegrate['status']
+        }
+      else
+        respond
+      end
+      respond['status'].each do |key, val|
+        error_state = true if val.any? { |status, code| code.to_i < 200 || code.to_i > 299 }
+      end
+      if error_state == true
+        respond
+      else
+        response = {
+          "response" =>
+            "SUCCESS: Refresh completed for #{source[0]} protection group.\n",
+          "status" => 201
+        }
+      end
     else
-      error_text("refresh", @url.to_s, "snapshot or volume")
+      error_text("refresh", @url.to_s, "snapshot or 1.4")
     end
   end
 

data/lib/stoarray/version.rb

@@ -1,3 +1,3 @@
 class Stoarray
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/stoarray.gemspec

@@ -7,7 +7,7 @@ dev_deps = %w{bundler coveralls guard guard-rspec pry pry-nav pry-remote rake rs
 Gem::Specification.new do |spec|
   spec.name          = "stoarray"
   spec.version       = Stoarray::VERSION
-  spec.date          = "2015-12-28"
+  spec.date          = "2016-02-02"
   spec.authors       = ["Kody Wilson"]
   spec.email         = ["kodywilson@gmail.com"]
   spec.summary       = %q{Storage array Ruby sdk}
@@ -15,6 +15,9 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/kodywilson/stoarray"
   spec.license       = "MIT"
 
+  # This gem will work with 2.0.0 or greater...
+  spec.required_ruby_version = '>= 2.0.0'
+
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stoarray
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Kody Wilson
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-28 00:00:00.000000000 Z
+date: 2016-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -171,7 +171,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="