Allow copy of templates from secondary storages of same or other zone when adding a new secondary storage

source/installguide/configuration.rst

@@ -1635,9 +1635,9 @@ System Requirements for Secondary Storage
 Adding Secondary Storage
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-When you create a new zone, the first secondary storage is added as part
-of that procedure. You can add secondary storage servers at any time to
-add more servers to an existing zone.
+When you create a new Zone, the first Secondary Storage is added as part
+of that procedure. You can add Secondary Storage servers at any time to
+add more servers to an existing Zone.
 
 .. warning::
    Ensure that nothing is stored on the server. Adding the server to
@@ -1664,29 +1664,29 @@ add more servers to an existing zone.
 
 #. Fill in the following fields:
 
-   -  Name. Give the storage a descriptive name.
+   -  **Name**: Give the storage a descriptive name.
 
-   -  Provider. Choose S3, Swift, NFS, or CIFS then fill in the related
+   -  **Provider**: Choose S3, Swift, NFS, or CIFS then fill in the related
       fields which appear. The fields will vary depending on the storage
       provider; for more information, consult the provider's
       documentation (such as the S3 or Swift website). NFS can be used
-      for zone-based storage, and the others for region-wide storage.
+      for Zone-based storage, and the others for region-wide storage.
       For Hyper-V, select SMB/CIFS.
 
       .. warning::
          Heterogeneous Secondary Storage is not supported in Regions. You can
          use only a single NFS, S3, or Swift account per region.
 
-   -  Create NFS Secondary Staging Store. This box must always be
+   -  **Create NFS Secondary Staging Store**: This box must always be
       checked.
 
       .. warning::
          Even if the UI allows you to uncheck this box, do not do so. This
          checkbox and the three fields below it must be filled in. Even when
-         Swift or S3 is used as the secondary storage provider, an NFS staging
+         Swift or S3 is used as the Secondary Storage provider, an NFS staging
          storage in each zone is still required.
 
-   -  Zone. The zone where the NFS Secondary Staging Store is to be
+   -  **Zone**: The Zone where the NFS Secondary Staging Store is to be
       located.
 
    -  **SMB Username**: Applicable only if you select SMB/CIFS provider.
@@ -1700,10 +1700,34 @@ add more servers to an existing zone.
    -  **SMB Domain**: Applicable only if you select SMB/CIFS provider.
       The Active Directory domain that the SMB share is a part of.
 
-   -  NFS server. The name of the zone's Secondary Staging Store.
+   -  **NFS server**: The name of the Zone's Secondary Staging Store.
 
-   -  Path. The path to the zone's Secondary Staging Store.
+   -  **Path**: The path to the Zone's Secondary Staging Store.
+
+   -  **Copy Templates from other storages**: This switch can be used to automatically
+      copy existing Templates from Secondary Storages in other Zones instead of
+      fetching from their URLs, more details are as below.
+
+
+When a new Secondary Storage is added, the Management Server attempts to make
+existing Templates available on the new Secondary Storage.
+
+CloudStack improves Template availability using the configuration:
+
++----------------------------------------------+-------------------------------------------------------------------------------------------------------------+-----------+
+| Name                                         | Description                                                                                                 | Default   |
++==============================================+=============================================================================================================+===========+
+| copy.templates.from.other.secondary.storages | Allow Templates to be copied from existing Secondary Storages (within the same Zone or across Zones)        | true      |
+|                                              | when adding a new Secondary Storage, instead of downloading them from the source URL.                       |           |
++----------------------------------------------+-------------------------------------------------------------------------------------------------------------+-----------+
+
+This setting is enabled by default and can be configured globally or at Zone level.
+
+CloudStack applies the following order of steps while trying to make a Template available in the new Secondary Storage:
 
+1. Attempt to copy the Template from another Secondary Storage in the same Zone.
+2. If not found, attempt to copy the Template from a Secondary Storage in a different Zone.
+3. If the copy operation fails, CloudStack falls back to downloading the Template using its URL as registered.
 
 Adding an NFS Secondary Staging Store for Each Zone
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~