Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions source/adminguide/storage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@ Storage media \\ hypervisor VMware vSphere Citrix XenServer
**SMB/CIFS** No No No Yes
**Ceph/RBD** No No Yes No
**PowerFlex/ScaleIO** No No Yes No
**NetApp ONTAP** No No Yes No
============================================== ================ ==================== =========================== ============================

XenServer uses a clustered LVM system to store Instance images on iSCSI and
Expand Down
6 changes: 6 additions & 0 deletions source/conceptsandterminology/concepts.rst
Original file line number Diff line number Diff line change
Expand Up @@ -442,6 +442,10 @@ 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.

NetApp ONTAP is only supported by the KVM hypervisor. It can be used as
Cluster-wide or Zone-wide Primary Storage. It supports both NFS 3.0 and iSCSI
protocols.

CloudStack is designed to work with all standards-compliant iSCSI and
NFS servers that are supported by the underlying hypervisor, including,
for example:
Expand All @@ -460,6 +464,8 @@ for example:

- Pure FlashArray for FiberChannel

- NetApp ONTAP for NFS and iSCSI

If you intend to use only local disk for your installation, you can skip
adding separate primary storage.

Expand Down
71 changes: 71 additions & 0 deletions source/installguide/configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1594,6 +1594,77 @@ When a volume is created by the plugin, it will create bi-directional mappings i
- Each volume's description field in the Pure Flasharray storage system will have a formatted key/value pair with metadata mappings for the Cloudstack volume definition (user volume name, volume uuid, account/project information)
- Each virtual volume's WWID will be stored in the volume's path field in Cloudstack

NetApp ONTAP Plug-in
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This plugin enables NetApp ONTAP storage systems as a managed primary storage in
CloudStack for KVM hypervisors. It supports both NFS 3.0 and iSCSI protocols,
integrating with the traditional ONTAP unified storage architecture.

.. note::
The NetApp ONTAP storage plug-in for CloudStack is part of the standard
CloudStack install. There is no additional work required to add this
component.

This documentation assumes you have the following configured in your environment
before configuring a storage pool in CloudStack:

- NetApp ONTAP 9.15.1 or higher.
- A Storage Virtual Machine (SVM) configured with the appropriate protocol
(NFS or iSCSI) enabled.
- Management LIF accessible from the CloudStack management server on port 443
(HTTPS).
- Data LIF(s) of IPv4 type, accessible from all KVM hypervisor hosts where
volumes will be attached to Instances.
- Aggregates assigned to the SVM with sufficient capacity.
- For iSCSI: KVM hosts must have the iSCSI initiator configured with a valid
IQN. The host IQN must be set in the host's storage URL in CloudStack.
- For NFS: KVM hosts must have NFS client packages installed.

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 volume on the ONTAP storage system. Such a
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. Volume migration is supported between ONTAP storage
pools and between ONTAP storage pools and NFS storage pools.

.. note::
ONTAP requires a minimum volume size of 1.56 GB (1,677,721,600 bytes). The
plugin will automatically adjust requested sizes below this threshold.

The ``createStoragePool`` API can be used to configure an ONTAP primary storage
pool with the following parameters:

- 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=ONTAP
- url=[storage pool url]

The url parameter contains the ONTAP storage pool connection details, specified
as semicolon-separated key=value pairs in the following format::

username=<USERNAME>;password=<PASSWORD>;svmName=<SVM_NAME>;protocol=<PROTOCOL>;managementLIF=<MGMT_LIF_IP>

- USERNAME: ONTAP cluster admin username.
- PASSWORD: ONTAP cluster admin password (URL-encoded; for example, '=' is
represented as '%3D').
- SVM_NAME: name of the Storage Virtual Machine (SVM) configured on ONTAP.
- PROTOCOL: storage protocol to use. Must be one of ``NFS3`` or ``ISCSI``.
- MGMT_LIF_IP: IP address of the ONTAP cluster management LIF.

Limitations:

- Supports only KVM hypervisor.
- Supports only Unified ONTAP storage (disaggregated ONTAP is not supported).
- Supports only NFS 3.0 and iSCSI protocols.
- IPv6 and FQDN-type Data LIFs are not supported.

.. _add-secondary-storage:

Add Secondary Storage
Expand Down
2 changes: 1 addition & 1 deletion source/installguide/management-server/_nfs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ CloudStack.

.. note::
NFS is not the only option for primary or secondary storage. For example,
you may use Ceph RBD, PowerFlex, GlusterFS, iSCSI, Fiberchannel and others. The choice of storage
you may use Ceph RBD, PowerFlex, GlusterFS, iSCSI, Fiberchannel, NetApp ONTAP and others. The choice of storage
system will depend on the choice of hypervisor and whether you are dealing
with primary or secondary storage.

Expand Down