Getting Started with the Pure Storage Python Toolkit

Let’s get started with the Python toolkit. There are a few options to get going with Windows:

1. Use physical or virtual Windows 8.1 (this is what I will be using on a Surface Pro 3 no-less)
2. Use physical or virtual Windows Server

Quick Steps

1. Download and install Babun (pronounced Baboon) – This is one of the slicker and easier to setup Windows Shells.
2. After Babun installs it will automatically start, you should see the below screenshot.
3. Run the following command to download to use setuptools bootstrap installer:
   
   wget <a href=”https://bootstrap.pypa.io/ez_setup.py”>https://bootstrap.pypa.io/ez_setup.py</a> -O – | python <a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step3.png”><img title=”Step3″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step3_thumb.png” alt=”Step3″ width=”563″ height=”337″ border=”0″ /></a>

   1 2 3

   wget <a href=“https://bootstrap.pypa.io/ez_setup.py”>https://bootstrap.pypa.io/ez_setup.py</a> -O – | python <a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step3.png”><img title=“Step3” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step3_thumb.png” alt=“Step3” width=“563” height=“337” border=“0” /></a>

4. Run
   
   clear

   1

   clear

5. Run the following command to install:
   
   easy_install pip <a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step5.png”><img title=”Step5″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step5_thumb.png” alt=”Step5″ width=”566″ height=”339″ border=”0″ /></a>

   1 2 3

   easy_install pip   <a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step5.png”><img title=“Step5” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step5_thumb.png” alt=“Step5” width=“566” height=“339” border=“0” /></a>

6. Run the following command to download the Pure Storage Python Toolkit:
   
   wget <a href=”https://pypi.python.org/packages/source/p/purestorage/purestorage-1.4.0.tar.gz”>https://pypi.python.org/packages/source/p/purestorage/purestorage-1.4.0.tar.gz </a><a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step6.png”><img title=”Step6″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step6_thumb.png” alt=”Step6″ width=”571″ height=”342″ border=”0″ /></a>

   1 2

   wget <a href=“https://pypi.python.org/packages/source/p/purestorage/purestorage-1.4.0.tar.gz”>https://pypi.python.org/packages/source/p/purestorage/purestorage-1.4.0.tar.gz </a><a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step6.png”><img title=“Step6” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step6_thumb.png” alt=“Step6” width=“571” height=“342” border=“0” /></a>

7. Run the following command to install the Python Requests module which provides HTTP capabilities:
   
   pip install requests <a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step8.png”><img title=”Step8″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step8_thumb.png” alt=”Step8″ width=”579″ height=”347″ border=”0″ /></a>

   1 2 3

   pip install requests   <a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step8.png”><img title=“Step8” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step8_thumb.png” alt=“Step8” width=“579” height=“347” border=“0” /></a>

   
   Note: I had already installed this so you’ll see the requirement has already been satisfied.
8. Now let’s install the Pure Storage Python Toolkit 1.4.0:
   
   pip install purestorage-1.4.0.tar.gz <a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step7.png”><img title=”Step7″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step7_thumb.png” alt=”Step7″ width=”576″ height=”345″ border=”0″ /></a>

   1 2 3

   pip install purestorage–1.4.0.tar.gz   <a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step7.png”><img title=“Step7” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Step7_thumb.png” alt=“Step7” width=“576” height=“345” border=“0” /></a>

Now we are done installing and setting up the environment. On to creating the first simple script to create a connection and a volume. Most of of the steps below are about commands to use in VIM (Vi Improved).

1. vim New-PfaVolume.py

   1	vim New–PfaVolume.py

   
   Note: This is going to create a Python file named New-PfaVolume… dang that file name looks awfully similar.
2. i

   1

   i

   
   Note: Just type “I” (no quotes) to enter INSERT mode.
3. The next few lines are the core of the script for connecting to the FlashArray and creating a volume. The following lines will create a FlashArray using the purestorage library. Then we will assign the array object by using the FlashArray with the various properties, then finally create a TEST-VOLUME1 that is 500GB in size.from purestorage import FlashArray
   array = FlashArray(target=”<IP>”, username=”pureuser”, password””=”pureuser”)
   array.create_volume(“TEST-VOLUME1”, “500G”)
4. The next few lines with exit out of insert mode, write the file (:w) and quit VIM (:q)
   
   ESC :w :q <a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step4.png”><img title=”Part2_Step4″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step4_thumb.png” alt=”Part2_Step4″ width=”606″ height=”220″ /></a>

   1 2 3 4 5

   ESC :w :q   <a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step4.png”><img title=“Part2_Step4” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step4_thumb.png” alt=“Part2_Step4” width=“606” height=“220” /></a>

   
    
5. Now time to run the New-PfaVolume.py script:
   
   python New-PfaVolume.py <a href=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step5.png”><img title=”Part2_Step5″ src=”https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step5_thumb.png” alt=”Part2_Step5″ width=”617″ height=”90″ /></a>

   1 2 3

   python New–PfaVolume.py   <a href=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step5.png”><img title=“Part2_Step5” src=“https://www.purepowershellguy.com/wp-content/uploads/2015/07/Part2_Step5_thumb.png” alt=“Part2_Step5” width=“617” height=“90” /></a>

Super simple and demonstrates using our Python Toolkit from a Windows machine. Next part we’ll create a host, connect volumes, and take snapshots. But in the meantime if you are interested take a look at the Programming Interfaces on the Pure1 Community or visit the Online Quick Start Guide to do some more work on your own.

I’m just starting on some other examples using the Python Toolkit so there will be others coming in between my PowerShell SDK/Toolkit work. What’s next…C# is what I’m thinking about.

Thanks,
barkz