Skip to content

Commit 350e047

Browse files
authored
Optional deploy-as-is (#209)
* Optional deploy-as-is * Fix typo
1 parent 68210ce commit 350e047

File tree

3 files changed

+28
-26
lines changed

3 files changed

+28
-26
lines changed

source/adminguide/templates.rst

Lines changed: 10 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -177,11 +177,6 @@ as the prototype for other VMs.
177177
5.4 to support a CentOS 6.2 image will in general not work.
178178
In those cases you should choose Other.
179179

180-
.. note::
181-
Since version 4.15, VMware templates do not allow users or administrators
182-
selecting an OS Type when registering a template. The OS Type is
183-
obtained from the template after it is registered.
184-
185180

186181
- **Public**. Choose Yes to make this template accessible to all
187182
users of this CloudStack installation. The template will appear in
@@ -198,13 +193,6 @@ The new template will be visible in the Templates section when the
198193
template creation process has been completed. The template is then
199194
available when creating a new VM.
200195

201-
.. note::
202-
Since version 4.15, CloudStack obtains information from the VMware templates
203-
automatically at registration time. If a template contains different deployment
204-
options (or configurations) as in the case of virtual appliances, then CloudStack
205-
display the information required by the template, allowing users or administrators
206-
to configure their instances.
207-
208196
Creating a Template from a Snapshot
209197
-----------------------------------
210198

@@ -249,7 +237,12 @@ To upload a template:
249237
available, or All Zones to make it available throughout
250238
CloudStack.
251239

252-
- **OS Type**: (Except for VMware). This helps CloudStack and the hypervisor perform
240+
- **Read VM settings from OVA**. (VMware only) If selected, the registered template will allow users to deploy VMs as clones of the template, including all their properties, configurations, end-user license agreements, disks, os type, etc. This option allows users to register virtual appliances. See `Support for Virtual Appliances <virtual_machines.html#about-virtual-appliances>`_.
241+
242+
.. note::
243+
When this option is selected the following fields are hidden: Root disk controller, Keyboard type and OS Type.
244+
245+
- **OS Type**: This helps CloudStack and the hypervisor perform
253246
certain operations and make assumptions that improve the
254247
performance of the guest. Select one of the following:
255248

@@ -264,8 +257,8 @@ To upload a template:
264257
those cases you should choose Other.
265258

266259
.. note::
267-
Since version 4.15, VMware templates do not allow users or administrators
268-
selecting an OS Type when registering a template. The OS Type is
260+
Since version 4.15.1, VMware templates do not allow users or administrators
261+
selecting an OS Type when registering a template if the option 'Read VM settings from OVA' is selected. In this case, the OS Type is
269262
obtained from the template after it is registered.
270263

271264
- **Hypervisor**: The supported hypervisors are listed. Select the
@@ -295,10 +288,9 @@ To upload a template:
295288
Note that uploading multi-disk templates is also supported.
296289

297290
.. note::
298-
VMware only: If the selected template contains OVF properties, different deployment options or configurations,
299-
multiple NICs or end-user license agreements, then the wizard will display these properties.
291+
VMware only: If the template is registered with the option 'Read VM settings from OVA' then the VM deployment wizard will display all the available OVF properties, different deployment options or configurations, multiple NICs or end-user license agreements.
300292

301-
See `Support for Virtual Appliances <virtual_machines.html#support-for-virtual-appliances>`_.
293+
See `Support for Virtual Appliances <virtual_machines.html#about-virtual-appliances>`_.
302294

303295

304296

@@ -314,11 +306,6 @@ The steps are similar as when Uploading a template/ISO from a remote HTTP server
314306
For this feature to work, your SSVMs must be supporting HTTPS (for more info please visit `“Using a SSL Certificate for the Console Proxy”
315307
<systemvm.html#using-a-ssl-certificate-for-the-console-proxy>`_).
316308

317-
.. note::
318-
Since version 4.15, VMware templates do not allow users or administrators
319-
selecting an OS Type when uploading a template. The OS Type is
320-
obtained from the template after it is uploaded.
321-
322309
Example GUI dialog of uploading Template/ISO from local (browser) is given below:
323310

324311
|template-upload-from-local.PNG|

source/adminguide/virtual_machines.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -912,11 +912,13 @@ snapshot:
912912
VM snapshots are deleted automatically when a VM is destroyed. You don't
913913
have to manually delete the snapshots in this case.
914914

915+
915916
Support for Virtual Appliances
916917
==============================
917918

918919
.. include:: virtual_machines/virtual_appliances.rst
919920

921+
920922
Unmanaging Virtual Machines
921923
===========================
922924

source/adminguide/virtual_machines/virtual_appliances.rst

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,18 @@
1+
.. Licensed to the Apache Software Foundation (ASF) under one
2+
or more contributor license agreements. See the NOTICE file
3+
distributed with this work for additional information#
4+
regarding copyright ownership. The ASF licenses this file
5+
to you under the Apache License, Version 2.0 (the
6+
"License"); you may not use this file except in compliance
7+
with the License. You may obtain a copy of the License at
8+
http://www.apache.org/licenses/LICENSE-2.0
9+
Unless required by applicable law or agreed to in writing,
10+
software distributed under the License is distributed on an
11+
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
12+
KIND, either express or implied. See the License for the
13+
specific language governing permissions and limitations
14+
under the License.
15+
116
About Virtual Appliances
217
------------------------
318

@@ -8,9 +23,7 @@ An OVA file contain disc images, as well as the configuration data of the virtua
823
Virtual Appliances are supported only on VMware.
924

1025
.. note::
11-
Since version 4.15, all the new templates registered are treated as virtual appliance templates.
12-
13-
To keep the existing functionality, all the templates registered before version 4.15 are not affected by this changes.
26+
Since version 4.15.1, administrators and users can register virtual appliance templates by selecting the option 'Read VM Settings from OVA' on the template registration.
1427

1528
Deployment options (configurations)
1629
-----------------------------------

0 commit comments

Comments
 (0)