Skip to content

Commit 2c41042

Browse files
committed
Update template replication settings in documentation for clarity and consistency
1 parent 7f7ab96 commit 2c41042

1 file changed

Lines changed: 11 additions & 10 deletions

File tree

source/adminguide/templates.rst

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -140,9 +140,10 @@ Template Replication on Secondary Storage
140140
-----------------------------------------
141141

142142
A Zone may have more than one secondary storage (image store). When a
143-
Template is registered, CloudStack decides how many of those image
144-
stores should hold a copy of the Template. Historically, this decision
145-
was tied to the Template's ``public`` flag:
143+
Template is registered or a new Secondary Storage is added to the
144+
zone, CloudStack decides how many of those image stores should hold a
145+
copy of the Template. Historically, this decision was tied to the
146+
Template's ``public`` flag:
146147

147148
- **Public Templates** were copied to **every** image store in the
148149
Zone, so that the Template was readily available wherever a host
@@ -164,12 +165,12 @@ To give operators explicit control, CloudStack exposes two
164165
configuration settings that cap the number of secondary storage pools
165166
a Template is copied to:
166167

167-
- ``public.template.secstorage.copy`` — the maximum number of
168+
- ``secstorage.public.template.copy.max`` — the maximum number of
168169
secondary storage pools to which a public Template is copied. The
169170
default is ``0``, which means "copy to every image store in the
170171
Zone" and preserves the historical behavior.
171172

172-
- ``private.template.secstorage.copy`` — the maximum number of
173+
- ``secstorage.private.template.copy.max`` — the maximum number of
173174
secondary storage pools to which a private Template is copied. The
174175
default is ``1``, which preserves the historical behavior.
175176

@@ -186,21 +187,21 @@ Example scenarios
186187
~~~~~~~~~~~~~~~~~
187188

188189
- **Large Zone with 5 secondary storages.** Setting
189-
``public.template.secstorage.copy = 2`` copies public Templates to
190+
``secstorage.public.template.copy.max = 2`` copies public Templates to
190191
only 2 of the 5 image stores, freeing capacity on the others.
191192

192193
- **Ceph-backed secondary storage.** Setting
193-
``public.template.secstorage.copy = 1`` avoids redundant replication
194+
``secstorage.public.template.copy.max = 1`` avoids redundant replication
194195
because the storage layer already provides durability.
195196

196197
- **HA for private Templates.** Setting
197-
``private.template.secstorage.copy = 2`` keeps two copies of every
198+
``secstorage.private.template.copy.max = 2`` keeps two copies of every
198199
private Template so that the Template is still available if one
199200
image store is down.
200201

201202
- **Default (backward compatible).** With
202-
``public.template.secstorage.copy = 0`` and
203-
``private.template.secstorage.copy = 1``, CloudStack behaves exactly
203+
``secstorage.public.template.copy.max = 0`` and
204+
``secstorage.private.template.copy.max = 1``, CloudStack behaves exactly
204205
as in earlier releases.
205206

206207
Scope of application

0 commit comments

Comments
 (0)