From ff924964deaabfb5a34a8823d0fea1f1d0c308d7 Mon Sep 17 00:00:00 2001 From: Suresh Kumar Anaparti Date: Thu, 5 Nov 2020 17:39:47 +0530 Subject: [PATCH] Updated docs with the new storage plugin for Dell EMC PowerFlex/ScaleIO (formerly VxFlexOS) --- source/adminguide/storage.rst | 1 + source/conceptsandterminology/concepts.rst | 5 ++ source/installguide/configuration.rst | 72 +++++++++++++++++-- .../installguide/management-server/_nfs.rst | 2 +- 4 files changed, 74 insertions(+), 6 deletions(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 9993c29db5..4820bf9e6c 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -105,6 +105,7 @@ Storage media \\ hypervisor VMware vSphere Citrix XenServer **Storage over-provisioning** NFS and iSCSI NFS NFS No **SMB/CIFS** No No No Yes **Ceph/RBD** No No Yes No +**PowerFlex/ScaleIO** No No Yes No ============================================== ================ ==================== =========================== ============================ XenServer uses a clustered LVM system to store VM images on iSCSI and diff --git a/source/conceptsandterminology/concepts.rst b/source/conceptsandterminology/concepts.rst index 6649d58a8d..d938b918ae 100644 --- a/source/conceptsandterminology/concepts.rst +++ b/source/conceptsandterminology/concepts.rst @@ -440,6 +440,9 @@ Storage is not supported in Hyper-V. Ceph/RBD storage is only supported by the KVM hypervisor. It can be used as Zone-wide Primary Storage. +PowerFlex/ScaleIO (v3.5) is only supported by the KVM hypervisor. It can be used +as Cluster-wide or Zone-wide Primary Storage. + CloudStack is designed to work with all standards-compliant iSCSI and NFS servers that are supported by the underlying hypervisor, including, for example: @@ -452,6 +455,8 @@ for example: - Scale Computing for NFS +- Dell EMC PowerFlex™ (v3.5) + If you intend to use only local disk for your installation, you can skip adding separate primary storage. diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index 89123c31a1..2052a5232a 100644 --- a/source/installguide/configuration.rst +++ b/source/installguide/configuration.rst @@ -498,7 +498,7 @@ Basic Zone Configuration - **Name.** The name of the storage device. - **Protocol.** For XenServer, choose either NFS, iSCSI, or - PreSetup. For KVM, choose NFS, SharedMountPoint,CLVM, or RBD. For + PreSetup. For KVM, choose NFS, SharedMountPoint,CLVM, RBD or custom (for PowerFlex). For vSphere choose either VMFS (iSCSI or FiberChannel) or NFS. The remaining fields in the screen vary depending on what you choose here. @@ -677,7 +677,7 @@ Advanced Zone Configuration - **Name.** The name of the storage device. - **Protocol.** For XenServer, choose either NFS, iSCSI, or - PreSetup. For KVM, choose NFS, SharedMountPoint, CLVM, and RBD. + PreSetup. For KVM, choose NFS, SharedMountPoint, CLVM, RBD or custom (for PowerFlex). For vSphere choose either VMFS (iSCSI or FiberChannel) or NFS. The remaining fields in the screen vary depending on what you choose here. @@ -1181,9 +1181,8 @@ cluster. - **Name.** The name of the storage device. - **Protocol.** For XenServer, choose either NFS, iSCSI, or - PreSetup. For KVM, choose NFS or SharedMountPoint. For vSphere - choose either NFS, PreSetup (VMFS, vSAN, vVols) or datastorecluster. For Hyper-V, - choose SMB. + PreSetup. For KVM, choose NFS, SharedMountPoint or custom (for PowerFlex). For vSphere + choose either NFS, PreSetup (VMFS, vSAN, vVols) or datastorecluster. For Hyper-V, choose SMB. - **Server (for NFS, iSCSI, or PreSetup).** The IP address or DNS name of the storage device. @@ -1258,6 +1257,10 @@ Configuring a Storage Plug-in primary storage (although most of its features are available through the CloudStack UI). + +SolidFire Plug-in +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + .. note:: The SolidFire storage plug-in for CloudStack is part of the standard CloudStack install. There is no additional work required to add this @@ -1322,6 +1325,65 @@ example, '=' is represented as '%3D')] by (Min IOPS \* clusterDefaultBurstIopsPercentOfMaxIops parameter) (can be a decimal value)] +PowerFlex Plug-in +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This plugin enables Dell EMC PowerFlex™ (v3.5) storage pools as a managed +primary storage in CloudStack for KVM hypervisor. + +The PowerFlex/ScaleIO storage installation/setup and creation of the PowerFlex storage pool is +out of scope of this document. For PowerFlex storage installation instructions, Refer +to PowerFlex product documentation: +https://www.dell.com/support/home/en-in/product-support/product/scaleio/docs. + +To know more details about PowerFlex, refer to +https://cpsdocs.dellemc.com/bundle/PF_KNOW/page/GUID-D6DFA46A-6085-47CE-88A9-B503EFC6CFD2.html. + +When this storage pool is used with Compute or Disk Offerings, an administrator is +able to build an environment in which a root or data disk that a user creates leads +to the dynamic creation of a PowerFlex volume. This volume has guaranteed performance +with the ScaleIO Data Client (SDC) limits specified in the offering using the details +parameter keys: bandwidthLimitInMbps &iopsLimit (both defaulted to 0 - unlimited). +Such a PowerFlex volume is associated with one (and only ever one) CloudStack volume, +so performance of the CloudStack volume does not vary depending on how heavily other +tenants are using the system. This volume migration is supported across PowerFlex storage +pools only, which are on same or distinct storage instance. + +The createStoragePool API has been augmented to support plugable storage +providers. The following is a list of parameters to use when adding +storage to CloudStack that is based on the PowerFlex plug-in: + +- command=createStoragePool + +- scope=[zone | cluster] + +- zoneid=[your zone id] + +- podid=[your pod id, for cluster-wide primary storage] + +- clusterid=[your cluster id, for cluster-wide primary storage] + +- name=[name for primary storage] + +- hypervisor=KVM + +- provider=PowerFlex + +- url=[storage pool url] + +The url parameter contains the PowerFlex storage pool details, specifed +in the following format: + +powerflex://:@/ + +- =[user name for API access to PowerFlex gateway] + +- =[password for API access to PowerFlex gateway (password is URL encoded for example, '=' is represented as '%3D')] + +- =[PowerFlex gateway host] + +- =[PowerFlex storage pool name (case sensitive)] + .. _add-secondary-storage: diff --git a/source/installguide/management-server/_nfs.rst b/source/installguide/management-server/_nfs.rst index 98df3cb5f6..13b48f3d21 100644 --- a/source/installguide/management-server/_nfs.rst +++ b/source/installguide/management-server/_nfs.rst @@ -25,7 +25,7 @@ CloudStack. .. note:: NFS is not the only option for primary or secondary storage. For example, - you may use Ceph RBD, GlusterFS, iSCSI, and others. The choice of storage + you may use Ceph RBD, PowerFlex, GlusterFS, iSCSI, and others. The choice of storage system will depend on the choice of hypervisor and whether you are dealing with primary or secondary storage.