Panzura VM Disk Expansion Instructions for Adding Disk
Panzura VM Disk Expansion Instructions for Adding Disk Capacity
695 Campbell Technology Parkway Suite 225 Campbell, CA 95008 [email protected] 1-855-PANZURA (1-855-726-9872) +1 (408) 578-8888 © 2017 Panzura, Inc. All rights reserved. The information in this manual is subject to change without notice. Originated in the USA. Any other trademarks appearing in this guide are the property of their respective companies. October 2017
Fall
08
Panzura VM – Disk Expansion
Contents Introduction .............................................................................................................................................. 3 Prerequisites............................................................................................................................................. 3 Adding virtual disks to the Panzura VM in vCenter or vSphere ........................................... 3 Requesting a license token from the license portal for disk expansion ................. Error! Bookmark not defined. Login into the License server and complete the request form ...... Error! Bookmark not defined. Expanding Panzura Filer’s capacity in the management WebUI .......................................... 8 Checking the existing capacity before expansion .................................................................. 8 Adding expansion licenses and configuring expanded virtual disks. ......................... 11 Installing Disk Expansion Licenses ..................................................................................... 11 Disk Expansion Configuration and Provisioning ........................................................... 12 Confirming capacity expansion when done .......................................................................... 15 The process for expanding a Panzura VM is now complete ...................................... 15
Page 2 of 15
Panzura VM – Disk Expansion
Introduction The audience for this document is for internal use (technical staff including SEs and Support Engineers) and covers a step-by-step procedure for expanding disk capacity for a Panzura VM including: - Adding disks to the Panzura VM using vCenter (note that this procedure does not require vCenter and the same steps can be done using the vSphere WebUI following the same basic steps outlined using the vSphere client) - Installing a license and expanding capacity using the Panzura WebUI
Prerequisites -
Access to the license server or a valid license token or license file Valid vCenter or vSphere credentials Available capacity in a datastore that is accessible by the ESX host the Panzura VM is installed. Panzura WebUI login credentials
Adding virtual disks to the Panzura VM in vCenter or vSphere The first step will be to create virtual disks from an available data store that is accessible by the ESX host that your Panzura VM is running on as a guest. A. Login to either VCenter or VSphere client Note: You will need privileges to add disks to the Panzura VM
B. Find and select the Panzura VM you wish to expand disk capacity for Select the Panzura VM that you plan to expand by navigating to it in the left and Navigator pane under hosts or use the search function to find your specific VM by name. In this example we are going to add additional capacity to the Panzura Filer VM named; PM-11614-CC2 as shown below.
Page 3 of 15
Panzura VM – Disk Expansion
C. Right-click on the Panzura VM you want to add additional capacity to and select “Edit Settings” as shown below.
D. Add additional virtual disks to the Panzura VM to extend its total capacity To expand an existing Panzura VM’s overall capacity you must add additional virtual disks. The type of virtual disk and its associated license will determine what type of capacity you are adding. For example, if your Panzura VM consist entirely of SSD virtual disks then all the configured virtual disks will be shared for both metadata and cache space. Adding additional SSD virtual disks will increase this overall space. If your Panzura VM consists of both SSD virtual disks and HDD virtual disks then the VM has allocated all the SSDs for metadata and all the HDDs for cache space. Adding additional virtual SSDs will increase the metadata space and adding additional virtual HDDs will increase the cache space. A VM made up entirely of virtual HDDs is not supported. Important note: If you add virtual HDDs to an all virtual SSDs configuration the existing SSDs will be reconfigured for
Page 4 of 15
Panzura VM – Disk Expansion
metadata while the new virtual HDDs will be configured for cache space. Existing cache on the SSDs will be evicted out over time. Note: In this procedure, 2 disks virtual disks will be added to the VM simply as an example. The size of these disks are arbitrarily small and not representative of a practical expansion size in a production environment. Available space is pulled from either directly attached disks or configured and attached datastores to the ESX host(s). The maximum size that can be set per virtual disk depends on several factors including available capacity on either direct attached disks or configured datastores, ESX version and type of connected datastore (NFS and its underlying filesystem). Up to 62TB is supported and some cases each individual virtual disk is limited to 2TB. The size you choose will depend on the amount of capacity you wish to add to your Panzura VM. Generally spreading the overall capacity over more virtual disks has some performance advantages vs a few very large virtual disks. Keep a long view in mind of where you may grow over time. Most deployments utilize multiple virtual disks of 2TB or less in size. 1. From the “New Device” drop-down menu select “New Hard Disk” from the menu as shown below.
2. Configure the virtual disk capacity
Page 5 of 15
Panzura VM – Disk Expansion
Expand the “New Hard Disk” menu to see all the configurable options. In this example, we will set the capacity of the new virtual disk to 20GB for the size (this would be much larger in a production environment).
3. Add the 2nd disk by selecting the “Add” button again.
4. For the 2nd disk selection, this example added 50GB (shown below) of storage capacity for a total of 70GB of additional capacity for this VM. Note: The expansion license must match the number of drives being added. Repeat step 4 if adding additional drives. In this example 2 drives have been added to the existing Panzura VM which will require the installation of a 2-disk expansion license. Note: The Filer always uses the disk with the lowest available SCSI device node as the OS boot disk. For release 6.3 the lowest possible device node is 0:1. For release 7.0 the lowest possible device node is 0:0. A problem can occur if you manually add
Page 6 of 15
Panzura VM – Disk Expansion
a data disk with a lower device node than the OS boot disk, because when you reboot, the system will try to boot from the disk with the lowest device node. To avoid any problems, select a SCSI device node that is higher than that of the OS boot disk, as shown in the figure.
Select “OK” when adding disks is complete. E. Verify that the disks were added successfully. (this is shown at the bottom of the screen in the vSphere client under Recent Tasks).
Page 7 of 15
Panzura VM – Disk Expansion
Expanding Panzura Filer’s capacity in the management WebUI The next section will describe how to add the newly created virtual disks to the Panzura VM to expand the overall capacity, for either metadata, cache or both. Before and after views of available capacity, licenses and disk expansion status for the Panzura VM will be shown to confirm a successful operation.
Checking the existing capacity before expansion A. Login to the Filer you are expanding by going the URL for that filer (https://hostname)
B. Select Dashboard from the home page of the Panzura UI.
Page 8 of 15
Panzura VM – Disk Expansion
1. Scroll down until the section labeled Local Status; notice a total of 131GB is currently available for this VM
2. Scroll down to the section labeled Disk & RAID section to see the currently allocated disks. Note: The 20GB and the 50GB capacity are recognized by the filer but are not yet configured. Listed below as Unconfigured with a status of Need License.
3. To view current license prior to expansion, Select Home - > Configuration –> License Manager - > Installed License Modules Notice there is no disk expansion license.
Page 9 of 15
Panzura VM – Disk Expansion
4. To view currently allocated disks prior to expansion Select Home - > Configuration –> Disk Expansion - > Disk Expansion Configuration Note: The 20GB and 50GB disks are not recognized by the disk expansion tool.
Page 10 of 15
Panzura VM – Disk Expansion
Adding expansion licenses and configuring expanded virtual disks. This section describes how to add the disk expansion license token as well as adding and configuring the newly allocated disks to the filer. For this procedure, you must have a token provided by Panzura. Installing Disk Expansion Licenses A. Install disk expansion license on Panzura filer. Goto Home -> Configuration -> License Manager and click on the Activate License Token icon 1. Paste the license token received from Panzura 2. Select ‘Activate” 3. Once the license is activated the following message appears
3 1
2 B. Activating installed disk expansion license 1. Goto Home -> Configuration -> License Manager and click on the Installed License Modules icon 2. Select the “SSD Expansion Pack 2ea” license
Page 11 of 15
Panzura VM – Disk Expansion
3. Select “Activate”; this will change the status flag from “New” to “Active” as shown below.
Disk Expansion Configuration and Provisioning A. Configure New Disks 1. Select Home - > Configuration –> Disk Expansion and click on the Disk Expansion Configuration icon. Notice that now the disks are recognized but in an unconfigured state requiring configuration and provisioning. This is a 2-step process, the disks have to be configure as HDD or SSD and then provisioned. 2. The header sections are clickable operations. Select and click the header labeled “CONFIGURE NEW” as shown below.
Page 12 of 15
Panzura VM – Disk Expansion
This will bring up the following pop-up dialog box 3. Select “SSD” for the disk type if you are adding virtual SSDs. Note the comments in earlier section regarding SSD vs HDD virtual disks, constraints and resulting behavior. 4. Select the default from the Group Type pull down as shown below 5. Select “SUBMIT
Page 13 of 15
Panzura VM – Disk Expansion
Once submitted the following pop-up dialog box will appear.
B. Now provision the disk by selecting header button labeled; “PROVISION” Notice that the disk type changed from “unknown” to “SSD”
The following dialog box appears to confirm provisioning the disk.
Once the disk is provisioned you will get a confirmation popup like the one below;
Page 14 of 15
Panzura VM – Disk Expansion
C. Add the 2nd disk by repeating the previous steps under A & B above. All disk in “unconfigured” state must be configured and provisioned by following the steps outlined under A & B above. Repeat these steps for all additional disks to be configured and provisioned.
Confirming capacity expansion when done A. Confirmation of expanded capacity Notice both the 20GB and 50GB are now available for use below.
B. Dashboard view of expanded capacity Notice that VM capacity has increased from 131GB to a total of 205GB after expansion.
The process for expanding a Panzura VM is now complete
Page 15 of 15
695 Campbell Technology Parkway Suite 225 Campbell, CA 95008 [email protected] 1-855-PANZURA (1-855-726-9872) +1 (408) 578-8888 © 2017 Panzura, Inc. All rights reserved. The information in this manual is subject to change without notice. Originated in the USA. Any other trademarks appearing in this guide are the property of their respective companies. October 2017
Fall
08
Panzura VM – Disk Expansion
Contents Introduction .............................................................................................................................................. 3 Prerequisites............................................................................................................................................. 3 Adding virtual disks to the Panzura VM in vCenter or vSphere ........................................... 3 Requesting a license token from the license portal for disk expansion ................. Error! Bookmark not defined. Login into the License server and complete the request form ...... Error! Bookmark not defined. Expanding Panzura Filer’s capacity in the management WebUI .......................................... 8 Checking the existing capacity before expansion .................................................................. 8 Adding expansion licenses and configuring expanded virtual disks. ......................... 11 Installing Disk Expansion Licenses ..................................................................................... 11 Disk Expansion Configuration and Provisioning ........................................................... 12 Confirming capacity expansion when done .......................................................................... 15 The process for expanding a Panzura VM is now complete ...................................... 15
Page 2 of 15
Panzura VM – Disk Expansion
Introduction The audience for this document is for internal use (technical staff including SEs and Support Engineers) and covers a step-by-step procedure for expanding disk capacity for a Panzura VM including: - Adding disks to the Panzura VM using vCenter (note that this procedure does not require vCenter and the same steps can be done using the vSphere WebUI following the same basic steps outlined using the vSphere client) - Installing a license and expanding capacity using the Panzura WebUI
Prerequisites -
Access to the license server or a valid license token or license file Valid vCenter or vSphere credentials Available capacity in a datastore that is accessible by the ESX host the Panzura VM is installed. Panzura WebUI login credentials
Adding virtual disks to the Panzura VM in vCenter or vSphere The first step will be to create virtual disks from an available data store that is accessible by the ESX host that your Panzura VM is running on as a guest. A. Login to either VCenter or VSphere client Note: You will need privileges to add disks to the Panzura VM
B. Find and select the Panzura VM you wish to expand disk capacity for Select the Panzura VM that you plan to expand by navigating to it in the left and Navigator pane under hosts or use the search function to find your specific VM by name. In this example we are going to add additional capacity to the Panzura Filer VM named; PM-11614-CC2 as shown below.
Page 3 of 15
Panzura VM – Disk Expansion
C. Right-click on the Panzura VM you want to add additional capacity to and select “Edit Settings” as shown below.
D. Add additional virtual disks to the Panzura VM to extend its total capacity To expand an existing Panzura VM’s overall capacity you must add additional virtual disks. The type of virtual disk and its associated license will determine what type of capacity you are adding. For example, if your Panzura VM consist entirely of SSD virtual disks then all the configured virtual disks will be shared for both metadata and cache space. Adding additional SSD virtual disks will increase this overall space. If your Panzura VM consists of both SSD virtual disks and HDD virtual disks then the VM has allocated all the SSDs for metadata and all the HDDs for cache space. Adding additional virtual SSDs will increase the metadata space and adding additional virtual HDDs will increase the cache space. A VM made up entirely of virtual HDDs is not supported. Important note: If you add virtual HDDs to an all virtual SSDs configuration the existing SSDs will be reconfigured for
Page 4 of 15
Panzura VM – Disk Expansion
metadata while the new virtual HDDs will be configured for cache space. Existing cache on the SSDs will be evicted out over time. Note: In this procedure, 2 disks virtual disks will be added to the VM simply as an example. The size of these disks are arbitrarily small and not representative of a practical expansion size in a production environment. Available space is pulled from either directly attached disks or configured and attached datastores to the ESX host(s). The maximum size that can be set per virtual disk depends on several factors including available capacity on either direct attached disks or configured datastores, ESX version and type of connected datastore (NFS and its underlying filesystem). Up to 62TB is supported and some cases each individual virtual disk is limited to 2TB. The size you choose will depend on the amount of capacity you wish to add to your Panzura VM. Generally spreading the overall capacity over more virtual disks has some performance advantages vs a few very large virtual disks. Keep a long view in mind of where you may grow over time. Most deployments utilize multiple virtual disks of 2TB or less in size. 1. From the “New Device” drop-down menu select “New Hard Disk” from the menu as shown below.
2. Configure the virtual disk capacity
Page 5 of 15
Panzura VM – Disk Expansion
Expand the “New Hard Disk” menu to see all the configurable options. In this example, we will set the capacity of the new virtual disk to 20GB for the size (this would be much larger in a production environment).
3. Add the 2nd disk by selecting the “Add” button again.
4. For the 2nd disk selection, this example added 50GB (shown below) of storage capacity for a total of 70GB of additional capacity for this VM. Note: The expansion license must match the number of drives being added. Repeat step 4 if adding additional drives. In this example 2 drives have been added to the existing Panzura VM which will require the installation of a 2-disk expansion license. Note: The Filer always uses the disk with the lowest available SCSI device node as the OS boot disk. For release 6.3 the lowest possible device node is 0:1. For release 7.0 the lowest possible device node is 0:0. A problem can occur if you manually add
Page 6 of 15
Panzura VM – Disk Expansion
a data disk with a lower device node than the OS boot disk, because when you reboot, the system will try to boot from the disk with the lowest device node. To avoid any problems, select a SCSI device node that is higher than that of the OS boot disk, as shown in the figure.
Select “OK” when adding disks is complete. E. Verify that the disks were added successfully. (this is shown at the bottom of the screen in the vSphere client under Recent Tasks).
Page 7 of 15
Panzura VM – Disk Expansion
Expanding Panzura Filer’s capacity in the management WebUI The next section will describe how to add the newly created virtual disks to the Panzura VM to expand the overall capacity, for either metadata, cache or both. Before and after views of available capacity, licenses and disk expansion status for the Panzura VM will be shown to confirm a successful operation.
Checking the existing capacity before expansion A. Login to the Filer you are expanding by going the URL for that filer (https://hostname)
B. Select Dashboard from the home page of the Panzura UI.
Page 8 of 15
Panzura VM – Disk Expansion
1. Scroll down until the section labeled Local Status; notice a total of 131GB is currently available for this VM
2. Scroll down to the section labeled Disk & RAID section to see the currently allocated disks. Note: The 20GB and the 50GB capacity are recognized by the filer but are not yet configured. Listed below as Unconfigured with a status of Need License.
3. To view current license prior to expansion, Select Home - > Configuration –> License Manager - > Installed License Modules Notice there is no disk expansion license.
Page 9 of 15
Panzura VM – Disk Expansion
4. To view currently allocated disks prior to expansion Select Home - > Configuration –> Disk Expansion - > Disk Expansion Configuration Note: The 20GB and 50GB disks are not recognized by the disk expansion tool.
Page 10 of 15
Panzura VM – Disk Expansion
Adding expansion licenses and configuring expanded virtual disks. This section describes how to add the disk expansion license token as well as adding and configuring the newly allocated disks to the filer. For this procedure, you must have a token provided by Panzura. Installing Disk Expansion Licenses A. Install disk expansion license on Panzura filer. Goto Home -> Configuration -> License Manager and click on the Activate License Token icon 1. Paste the license token received from Panzura 2. Select ‘Activate” 3. Once the license is activated the following message appears
3 1
2 B. Activating installed disk expansion license 1. Goto Home -> Configuration -> License Manager and click on the Installed License Modules icon 2. Select the “SSD Expansion Pack 2ea” license
Page 11 of 15
Panzura VM – Disk Expansion
3. Select “Activate”; this will change the status flag from “New” to “Active” as shown below.
Disk Expansion Configuration and Provisioning A. Configure New Disks 1. Select Home - > Configuration –> Disk Expansion and click on the Disk Expansion Configuration icon. Notice that now the disks are recognized but in an unconfigured state requiring configuration and provisioning. This is a 2-step process, the disks have to be configure as HDD or SSD and then provisioned. 2. The header sections are clickable operations. Select and click the header labeled “CONFIGURE NEW” as shown below.
Page 12 of 15
Panzura VM – Disk Expansion
This will bring up the following pop-up dialog box 3. Select “SSD” for the disk type if you are adding virtual SSDs. Note the comments in earlier section regarding SSD vs HDD virtual disks, constraints and resulting behavior. 4. Select the default from the Group Type pull down as shown below 5. Select “SUBMIT
Page 13 of 15
Panzura VM – Disk Expansion
Once submitted the following pop-up dialog box will appear.
B. Now provision the disk by selecting header button labeled; “PROVISION” Notice that the disk type changed from “unknown” to “SSD”
The following dialog box appears to confirm provisioning the disk.
Once the disk is provisioned you will get a confirmation popup like the one below;
Page 14 of 15
Panzura VM – Disk Expansion
C. Add the 2nd disk by repeating the previous steps under A & B above. All disk in “unconfigured” state must be configured and provisioned by following the steps outlined under A & B above. Repeat these steps for all additional disks to be configured and provisioned.
Confirming capacity expansion when done A. Confirmation of expanded capacity Notice both the 20GB and 50GB are now available for use below.
B. Dashboard view of expanded capacity Notice that VM capacity has increased from 131GB to a total of 205GB after expansion.
The process for expanding a Panzura VM is now complete
Page 15 of 15
