@@ -140,9 +140,10 @@ Template Replication on Secondary Storage
140140-----------------------------------------
141141
142142A 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
164165configuration settings that cap the number of secondary storage pools
165166a 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
206207Scope of application
0 commit comments