Language editting and added info links

- Language editting and formatting.
- Added links with additional information for StorPool and the StorPool
  plug-in

Author: slavkap

source/installguide/configuration.rst

@@ -1430,53 +1430,92 @@ StorPool Plug-in
 ~~~~~~~~~~~~~~~~
 
 .. note::
-   The StorPool storage plug-in for CloudStack is part of the standard
-   CloudStack install. There is no additional work required to add this
-   component.
+   The StorPool storage plug-in for CloudStack described here is part of
+   the standard installation for CloudStack versions 4.17.0.0 and newer.
+   There is no additional work required to add this component.
 
-The StorPool plug-in is deeply integrated with CloudStack and works on with KVM hypervisors.
+   In case you use a version before 4.17.0.0, you should install the
+   StorPool plug-in provided in the `StorPool CloudStack
+   <https://github.com/storpool/storpool-cloudstack-integration/>`_
+   repository.
+
+The StorPool plug-in is deeply integrated with CloudStack and works on with KVM
+hypervisors. For more information on how you can accelerate your CloudStack
+deployment using CloudStack and StorPool together, see `Primary CloudStack
+storage <https://storpool.com/cloudstack>`_.
 
 When used with service 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 StorPool volume, which has guaranteed
 performance. Such a StorPool volume is associated with one CloudStack volume,
 so performance of the CloudStack volume does not vary depending on how
 heavily other tenants are using the system. The volume migration is supported
-across non-managed storage pools (e.g. NFS/Local storage/Ceph) to StorPool, and
-across StorPool storage pools.
+accross non-managed storage pools (e.g. NFS/Local storage/Ceph) to StorPool, and
+accross StorPool storage pools. For more information about StorPool volumes, see
+`Volumes and snapshots
+<https://kb.storpool.com/user_guides/user_guide.html#volumes-and-snapshots>`_.
 
-More technical details could be found on `StorPool Knowledge Base <https://kb.storpool.com/>`_.
+The `createStoragePool <https://cloudstack.apache.org/api/apidocs-4.19/apis/
+createStoragePool.html>`_ API has been augmented to support plugable storage
+providers.
 
-The createStoragePool API has been augmented to support pluggable storage providers.
 The following is a list of parameters to use when adding storage to CloudStack that is based on the StorPool plug-in:
 
-command=createStoragePool
-scope=[zone]
-zoneid=[your zone id]
-hypervisor=KVM
-name=[name for primary storage]
-protocol=SharedMountPoint
-provider=StorPool
-capacityBytes=[used for accounting purposes only. May be more or less than the actual StorPool Template capacity]
-url=[storage pool url]
-The url parameter contains the StorPool storage pool details, specified in the following format:
-
-SP_API_HTTP=address:port;SP_AUTH_TOKEN=token;SP_TEMPLATE=template_name
-
--       <SP_API_HTTP>=[address of StorPool Api]
--       <SP_AUTH_TOKEN>=[StorPool's token]
--       <SP_TEMPLATE>=[name of StorPool's Template]
-
-================================= ====================================================================================================================================================================
-StorPool Configurations                     Description
-================================= ====================================================================================================================================================================
-sp.bypass.secondary.storage       For StorPool Managed storage backup to secondary
-sp.cluster.id                     For StorPool multi cluster authorization (It will be set automatically for each cluster)
-sp.enable.alternative.endpoint    Used for StorPool primary storage, defines if there is a need to be used alternative endpoint
-sp.alternative.endpoint           Used for StorPool primary storage for an alternative endpoint. Structure of the endpoint is `SP_API_HTTP=address:port; SP_AUTH_TOKEN=token; SP_TEMPLATE=template_name`
-storpool.volume.tags.checkup      Minimal interval (in seconds) to check and report if a StorPool volume created by CloudStack exists in CloudStack's database
-storpool.snapshot.tags.checkup    Minimal interval (in seconds) to check and report if a StorPool Snapshot created by CloudStack exists in CloudStack's database
-================================= ====================================================================================================================================================================
+- command=createStoragePool
+- scope=[zone]
+- zoneid=[your zone id]
+- hypervisor=KVM
+- name=[name for primary storage]
+- protocol=SharedMountPoint
+- provider=StorPool
+- capacityBytes=[used for accounting purposes only. May be more or less than
+  the actual StorPool Template capacity]
+- url=[storage pool url]
+
+The ``url`` parameter contains the StorPool storage pool details, specified in
+the following format:
+
+.. code-block:: console
+
+   SP_API_HTTP=address:port;SP_AUTH_TOKEN=token;SP_TEMPLATE=template_name
+
+The details are as follows:
+
+- <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
+<https://kb.storpool.com/user_guides/user_guide.html#node-configuration-options>`_
+and `Templates <https://kb.storpool.com/user_guides/user_guide.html#templates>`_.
+
+After adding StorPool as primary storage you can set the following parameters in
+the Settings tab:
+
+sp.bypass.secondary.storage
+   For StorPool managed storage backup to secondary.
+
+sp.cluster.id
+   For StorPool multi cluster authorization (it will be set automatically for
+   each cluster).
+
+sp.enable.alternative.endpoint
+   Used for StorPool primary storage, defines if there is a need to be used
+   alternative endpoint.
+
+sp.alternative.endpoint
+   Used for StorPool primary storage for an alternative endpoint. Structure of
+   the endpoint is `SP_API_HTTP=address:port; SP_AUTH_TOKEN=token;
+   SP_TEMPLATE=template_name`.
+
+storpool.volume.tags.checkup
+   Minimal interval (in seconds) to check and report if a StorPool volume
+   created by CloudStack exists in CloudStack's database.
+
+storpool.snapshot.tags.checkup
+   Minimal interval (in seconds) to check and report if a StorPool Snapshot
+   created by CloudStack exists in CloudStack's database.
 
 HPE Primera/3PAR Plug-in
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~