Installation and configuration

To use the StorPool plugin you should first install StorPool, and then set is as primary storage in CloudStack.

Installing StorPool

First, perform the StorPool installation (see Installation and setup). Note the following:

  • Create a StorPool template to be used by CloudStack (see Templates). Note that you must set placeHead, placeAll, placeTail, and replication.

  • There is no need to set default volume size because it is determined by the CloudStack disks and services offering.

Setting up a StorPool PRIMARY storage pool in CloudStack

Tip

For more information about this procedure, check Adding Primary Storage in the CloudStack documentation.

The next step after installing StorPool is configuring the plugin. Log in to the CloudStack UI, go to Infrastructure > Primary Storage > Add Primary Storage, and enter the following details:

  • Command: createStoragePool

  • Scope: select Zone-Wide

  • Hypervisor: select KVM

  • Zone: pick appropriate zone

  • Zone id: enter your zone id

  • Name: enter a name for the primary storage

  • Protocol: select custom

  • Path: enter /dev/storpool (required argument, actually not needed in practice).

  • Provider: select StorPool

  • Managed: leave unchecked (currently ignored)

  • Capacity Bytes: used for accounting purposes only. May be more or less than the actual StorPool template capacity.

  • Capacity IOPS: currently not used (may use for max IOPS limitations on volumes from this pool).

  • URL: enter SP_API_HTTP=address:port;SP_AUTH_TOKEN=token;SP_TEMPLATE=template_name. At present one template can be used for at most one Storage Pool.

    • SP_API_HTTP - address of StorPool API

    • SP_AUTH_TOKEN - StorPool’s token

    • SP_TEMPLATE - name of StorPool’s template

    • For more information about these values, see Node configuration options and Templates.

    • For versions 4.19.1.0 and newer, you can use an alternative format for the URL: storpool://{SP_AUTH_TOKEN}@{SP_API_HTTP}:{SP_API_HTTP_PORT}/{SP_TEMPLATE}

  • Storage Tags: If left blank, the StorPool storage plugin will use the pool name to create a corresponding storage tag. This storage tag may be used later, when defining service or disk offerings.

Configuring the plugin

After adding StorPool as primary storage you can set the plugin parameters. For details, see Plugin settings.

If you want to use StorPool’s Quality of Service feature with CloudStack, see Using QoS.

More information