Published: January 2021

Getting Started

Prerequisites

Ensure that you fulfill the below requirements before proceeding.

• Gridpro EvOps  1.2008.2094 or later
• Pure Storage FlashBlade with Purity 3.0 or later
• API Token for target FlashBlade

Setting up Pure Storage Integration

The Azure Stack Hub Operators need to perform the following steps to enable the Pure Storage Integration in EvOps for Azure Stack Hub.

Enabling Feature and Adding Connector

1. Open Azure Stack Hub Administration Portal
2. Navigate to All Services and find EvOps
3. Open EvOps blade and click Features menu item.
4. In the Pure Storage section, flip the Status switch from Off -> On. Notice that the Pure Storage menu item gets activated
5. Select the Pure Storage menu item
6. Click the + Add connector button.
7. Provide a Name for the connector. Name listed in Connector drop-down when users create file systems and object store accounts.
8. Provide a Pure Storage API endpoint. URL Rest API endpoint of the Pure Storage FlashBlade.
9. Provide Max total file system provisioned size. Maximum allowed data size stored, regardless of how provisioned in Azure Stack Hub or Pure Storage interfaces. If the total amount of data stored reach this limit, no File system or Object store accounts can be created or modified using this connector. This setting ensures that the Azure Stack environment cannot over-provision beyond this size to each FlashBlade.
10. Click OK to add the connector.
11. If the Status column shows Connected, the connection works.

Importing Pure Storage Marketplace Items

Marketplace offerings for creating File systems and Object store accounts aren't by default published into the Marketplace. Follow the instructions below to publish the offerings. First, we need to locate the path to the azpkg files for the offerings stored in the EvOps deployment storage account. Make sure that you have access to the subscription that contains the EvOps RP infrastructure.

1. Log in to the Azure Stack Hub portal.
2. Click All services, then click Resource groups.
3. Open resource group named <Region>.evops, were <Region> represents the Azure Stack Hub region.
4. In the list of resources, click the storage account name that starts with evopsdeploy.
5. Click Containers in the left-side menu
6. Open the container with the current EvOps version in the name.
7. Click … on the file PSObjectStoreAccount.<Version>.azpkg and select Generate SAS
8. Click Generate SAS token and URL
9. Copy the Blob SAS URL path and save it for later use
10. Close the window
11. Click … on the file PSFileSystem.<Version>.azpkg and select Generate SAS
12. Click Generate SAS token and URL
13. ..Copy the Blob SAS URL path and save it for later use
14. Use a workstation with the AzS PowerShell tools installed and access to the privileged endpoint (PEP). Login as an Azure Stack Hub operator
15. Open a PowerShell ISE as administrator.
16. Paste below code:

    $armEndpoint = 'https://adminmanagement.%Region%.%Domain%'
    $adminArm = Add-AzureRMEnvironment -Name 'AzsAdmin' -ArmEndpoint $armEndpoint
    Login-AzureRmAccount -Environment $adminArm
    Add-AzsGalleryItem -GalleryItemUri '%OSADownloadURL%'
    Add-AzsGalleryItem -GalleryItemUri '%FSDownloadURL%'
    

17. Replace %Region% with Azure Stack stamp region-name
18. Replace %Domain% with Azure Stack domain name
19. Replace %OSADownloadURL% with the URL copied in step 9
20. Replace %FSDownloadURL% with the URL copied in step 13
21. Click F5 to run the script..
22. Log in with a user with equivalent to Cloud Admin..
23. Verify that the script executed without any errors

Creating a Plan with quota

1. Open Azure Stack Hub Administration Portal
2. Navigate to All services and click Plans in the ADMINISTRATIVE RESOURCES section
3. Click + Add
4. Provide a minimum Display name and select a Resource group, then click Next: Services
5. Check EvOps service in the list, then click Next: Quotas.
6. Click Create New
7. Provide a quota Name
8. Set Max accounts to 0 and leave Unlimited unchecked since this quota is for Pure Storage integration only
9. Set a quota on File systems by providing the total provisioned file system size for the Plan by setting Max total filesystem provisioned size to maximum quota size
10. Set a quota on Object store accounts by providing a total number of provisioned Object store accounts for the Plan by setting Max number of object store accounts
11. Click OK, then click Review + create
12. Click Create to create the Plan.

User guide

File systems

File storage is a data storage format in which data is stored and managed as files within folders within a hierarchical file system.  Evops provides the ability to create one or many root file systems from within Azure Stack against a Pure Storage FlashBlade storage system.  Below are the instructions on how to deploy a Pure Storage file system from Azure Stack Hub.

Create a File system

1. Open Azure Stack Hub Portal
2. Click + Create a resource.
3. Click Data + Storage section
4. Select the File system
   
   
5. Select target Subscription
6. Create or select an existing Resource group
7. Select a Location
8. Choose a FlashBlade from the Connector list.
9. Provide a File system name
10. Set an initial Provisioned size. Sets the size limit on the file system that can be modified later.
11. Select the Protocols to enable in the file system
12. Click Review and create
13. Use the Download template link to extract the ARM template for performing creating the File system.
14. Click Create

Edit File systems

1. Open Azure Stack Hub Portal
2. Click All services – All.
3. Select File systems
4. Click a File system in the list.
   
5. Click Configuration
   
   
6. From here, Provisioning size and Protocol settings are modifiable.
7. Click Snapshots
   
   
8. From here, Snapshots are created, deleted, and restored.
9. Properties and Locks are Azure Stack Hub defaults.

Create File systems using ARM template

1. You can create file systems using ARM templates directly using the below sample.

   {
   "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
           "fileSystemName": {
               "type": "string"
           },
           "connectorId": {
               "type": "string"
           },
           "nfsV3Enabled": {
               "type": "bool"
           },
           "smbEnabled": {
               "type": "bool"
           },
           "httpEnabled": {
               "type": "bool"
           },
           "nfsRules": {
               "type": "string"
           },
           "nfsV41Enabled": {
               "type": "bool"
           },
           "aclMode": {
               "type": "string"
           },
           "provisionedSize": {
               "type": "int"
           },
           "location": {
               "type": "string"
           },
           "tags": {
               "type": "object",
               "metadata": {
                   "description": "The map of key-value pairs used to tag the file system."
               }
           }
       },
       "resources": [
           {
               "apiVersion": "2015-05-01",
               "name": "[parameters('fileSystemName')]",
               "location": "[parameters('location')]",
               "type": "Gridpro.EvOps/fileSystems",
               "properties": {
                   "connectorId": "[parameters('connectorId')]",
                   "nfsV3Enabled": "[parameters('nfsV3Enabled')]",
                   "smbEnabled": "[parameters('smbEnabled')]",
                   "httpEnabled": "[parameters('httpEnabled')]",
                   "nfsRules": "[parameters('nfsRules')]",
                   "provisionedSize": "[parameters('provisionedSize')]",
                   "nfsV41Enabled": "[parameters('nfsV41Enabled')]",
                   "aclMode": "[parameters('aclMode')]"
               },
               "tags": "[parameters('tags')]",
               "kind": "FileSystem"
           }
       ]
   }
   

Object store accounts

Create an Object store account

1. Open Azure Stack Hub Portal
2. Click + Create a resource.
3. Click Data + Storage section
4. Select Object store account
   
   
5. Select target Subscription
6. Create or select an existing Resource group
7. Select a Location
8. Choose a FlashBlade from the Connector list.
9. Provide an Object store account name
10. Provide a Bucket name
11. Provide a Username
12. Click Review and create
13. Use the Download template link to extract the ARM template for performing creating the object store account.
14. Click Create

Edit Object store account

1. Open Azure Stack Hub Portal
2. Click All services – All.
3. Select Object store accounts
4. Click an Object store account in the list.
   
5. Click Buckets
   
   
6. From here, Buckets can be created, restored, and deleted, and versioning can enable versioning on buckets.
7. Click Users
   
   
8. From here, Users can be created with access keys and deleted.
9. Click Access keys
   
   
10. From here, you create Access keys. Access keys can also be enabled/disabled
11. Properties and Locks are Azure Stack Hub defaults

Create Object store account using ARM template

1. You can create Object store accounts using ARM templates directly using the below sample.

   {
       "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
           "accountName": {
               "type": "string"
           },
           "bucketName": {
               "type": "string"
           },
           "userName": {
               "type": "string"
           },
           "connectorId": {
               "type": "string"
           },
           "location": {
               "type": "string"
           },
           "tags": {
               "type": "object",
               "metadata": {
                   "description": "The map of key-value pairs used to tag the account."
               }
           }
       },
       "resources": [
           {
               "apiVersion": "2015-05-01",
               "name": "[parameters('accountName')]",
               "location": "[parameters('location')]",
               "type": "Gridpro.EvOps/objectStores",
               "properties": {
                   "connectorId": "[parameters('connectorId')]"
               },
               "tags": "[parameters('tags')]",
               "resources": [
                   {
                       "type": "users",
                       "apiVersion": "2015-05-01",
                       "name": "[parameters('userName')]",
                       "location": "[parameters('location')]",
                       "dependsOn": [
                           "[resourceId('Gridpro.EvOps/objectStores', parameters('accountName'))]"
                       ],
                       "properties": {}
                   },
                   {
                       "type": "buckets",
                       "apiVersion": "2015-05-01",
                       "name": "[parameters('bucketName')]",
                       "location": "[parameters('location')]",
                       "dependsOn": [
                           "[resourceId('Gridpro.EvOps/objectStores', parameters('accountName'))]"
                       ],
                       "properties": {}
                   }
               ]
           }
       ]
   }
   

Disable Pure Storage Integration

IMPORTANT: This section describes disabling Pure Storage integration. But because of Azure Resource Manager functionality, resources will still be visible in tenants where Pure Storage resources have been created and must be deleted manually not to show up for tenants.

Deleting Pure Storage Marketplace Items

1. Find a workstation with the AzS PowerShell tools installed and access to the privileged endpoint (PEP). Login as an Azure Stack Hub operator
2. Open a PowerShell ISE as administrator.
3. Paste below code:

   $armEndpoint = 'https://adminmanagement.%Region%.%Domain%'
   $adminArm = Add-AzureRMEnvironment -Name 'AzsAdmin' -ArmEndpoint $armEndpoint
   Login-AzureRmAccount -Environment $adminArm
   Remove-AzsGalleryItem -Name 'Gridpro.PSObjectStoreAccount.%Version%'
   Remove-AzsGalleryItem -Name 'Gridpro.PSFileSystem.%Version%'
   

4. Replace %Region% with Azure Stack stamp region-name
5. Replace %Domain% with Azure Stack domain name
6. Replace %Version% with the version of the imported Pure Storage marketplace items
7. Click F5 to run the script.
8. Log in with a user with equivalent to Cloud Admin.
9. Verify that the script executed without any errors
10. Refresh the browser and verify that Pure Storage Marketplace items aren't visible

Disable Pure Storage Integration Feature

1. Open Azure Stack Hub Administration Portal
2. Navigate to All Services and find EvOps
3. Open EvOps blade and click Features menu item.
4. In the Pure Storage section, flip the Status switch from On -> Off. Notice that the Pure Storage menu item gets disabled

Resources

Pure Storage FlashBlade S3 API Reference

Pure Storage Support