Managing Apache CloudStack Templates

Description

Templates are images of a base operating system that the user can choose from when creating a new instance. A template can be reused to create multiple instances.

Contents

Viewing a Template/ISO (by filter)

There are various filters using which you can sort and view templates. 

Perform the following steps to view a template/ISO:

1. On the left panel, click Templates.
   The Templates page displays.

2. Click the Select view the drop-down list and select an option to view the template. The following options are provided:

   Information

   Field Name	Description
   Templates	A domain admin can view all templates available in the domain. A normal user can view templates associated to or created by the user. You can register new templates from this page.
   ISO	A domain admin can view all ISOs available in the domain. A normal user can view ISOs associated to or created by the user. You can also register new ISOs from this page.

3. Based on your selection, the following information is displayed:

   Information

   For Templates:

   Field Name	Description
   Name	Displays the name of the template. Note: You can click on individual templates to view additional information and perform various tasks.
   Hypervisor	Displays the type of hypervisor on which the template is deployed.
   OS Type	Displays the type of operating system on which the template is deployed.
   Domain	Displays the name of the domain where the template is made available.  Leaseweb shared templates will have a default value as root.
   Account	Displays the name of the Account that made the template available. Leaseweb shared templates will have the default value as admin.
   Order	Use the following icons to arrange the display of templates: Click this to move the template to the top of the list. Click this to move the template to the bottom of the list. Click this to move the template a row above. Click this to move the template to a row below. Click this to drag and drop the template to any position on the list.
   Quickview	Displays an overview of the templates and the tasks that can be performed on them.

   For ISOs:

   Field Name	Description
   Name	Displays the name of the ISO. Note: You can click on individual ISOs to view additional information and perform various tasks.
   OS Type	Displays the type of operating system on which the template is deployed.
   Domain	Displays the name of the domain where the ISO is made available.  Leaseweb shared templates will have a default value as root.
   Account	Displays the name of the Account that made the ISO available. Leaseweb shared templates will have the default value as admin.
   Order	Use the following icons to arrange the display of ISOs: Click this to move the ISO to the top of the list. Click this to move the ISO to the bottom of the list. Click this to move the ISO a row above. Click this to move the ISO a row below. Click this to drag and drop the ISO to any position on the list.
   Overview	Displays an overview of the ISOs and the tasks that can be performed on them.

Registering a Template

Templates form the basic structure of your instance. You can upload a template either from a web server or upload from local file to your resource pool. 

Perform the following steps to register (upload) a template via any of the above methods:

1. On the left panel, click Images, Then click on Templates.
   The Templates page displays.
   
   
2. To upload a template from a local file, click the Upload from Local button.
   
3. The Upload Template from the Local dialog box displays. (Based on your role, options may vary)
   

4. Enter the following information and click OK.

   Field Name	Description
   Click or drag the local file	Option to browse and locate the local qcow2 file for upload
   Name	Enter a name using which you can identify the template.
   Description	Enter a description for the template. This description will help you to identify the template when you need to select one for creating an instance.
   Zone	Select the zone where this template should reside. Note: Currently, Leaseweb provides only 1 pre-configured zone.
   Hypervisor	Select the type of hypervisor for which you want to create the template. Note: For Leaseweb, KVM is selected by default.
   Root Disk Controller	Select the communication method between CPU and hard disk.
   Format	Select the format of the file that you want to upload. Note: Currently, Leaseweb support only QCOW2 format.
   OS Type	Select the operating system of the template that you want to create.
   Extractable	Select this check box to allow this template to be downloaded. Note: You can download a template by clicking . However, if this check box is not selected, you will not be able to download it to your local system.
   Password Enabled	Select this check box if you want your template to have the capability of resetting password. Note: If you select this check box, the Reset Password icon will appear for the instance. In order to have this capability, your template must have the “cloud-set-guest-password” script file. If you are configuring the template yourself, you can find information on downloading the “cloud-set-guest-password” script file from cloudstack-administration-guide.
   Public	Select this check box to make this template available to the community. Any user on the platform can access it. Once made public, you cannot revert the state
   HVM	Select this check box if Hardware Virtualization need to enabled for the template. Un-check if need to use Para Virtualization mode.

5. To upload from the URL, Click the Register template from the URL button.
   
   
6. The Register template from the URL dialog box displays. (Based on your role, options may vary)
   
   

7. Enter the following information and click OK.
   

   Information

   Field Name	Description
   URL	Enter the web server address and path where the file to be uploaded resides.
   Name	Enter a name using which you can identify the template.
   Description	Enter a description for the template. This description will help you to identify the template when you need to select one for creating an instance.
   Zone	Select the zone where this template should reside. Note: Currently, Leaseweb provides only 1 pre-configured zone.
   Hypervisor	Select the type of hypervisor for which you want to create the template. Note: For Leaseweb, KVM is selected by default.
   Root Disk Controller	Select the type of disk controller needed for the root disk of the template,  Currently, Leaseweb supports ide, default, virtio & virtio-scsi options.
   Format	Select the format of the file that you want to upload. Note: Currently, Leaseweb supports only the QCOW2 format.
   OS Type	Select the operating system of the template that you want to create. Note: It is important to select the correct operating system as it will impact performance. If you do not find your specific operating system from the drop-down list, select either Other PV (32-bit) or Other PV (64-bit) depending on the type of operating system.
   Extractable	Select this check box to allow this template to be downloaded. Note: You can download a template by clicking . However, if this check box is not selected, you will not be able to download it to your local system.
   Password Enabled	Select this check box if you want your template to have the capability of resetting your password. Note: If you select this check box, the Reset Password icon will appear for the instance. In order to have this capability, your template must have the “cloud-set-guest-password” script file. If you are configuring the template yourself, you can find information on downloading the “cloud-set-guest-password” script file from the cloudstack-administration-guide.
   Public	Select this check box to make this template available to all users. The iso will appear in the community list for any user to use.
   HVM	Select this check box if Hardware Virtualization needs to be enabled for the template. Un-check if need to use Para Virtualization mode.

Registering an ISO

You can upload an ISO from a web server to your resource pool. 

Perform the following steps to register (upload) an ISO:

1. On the left panel, Images, click ISO.
   The ISO page displays.
2. Click Register ISO.
   The Register ISO dialog box displays.
    

3. Enter the following information and click OK.

   Information

   Field Name	Description
   Name	Enter a name using which you can identify the ISO.
   Description	Enter a description for the ISO. This description will help you to identify the ISO when you need to select one for creating an instance.
   URL	Enter the web server address where the file to be uploaded resides.
   Direct Download	Select this check box to bypass the storage VM and download ISO directly from the management server.
   Zone	Select the zone where this ISO should reside. Note: Currently, Leaseweb provides only 1 pre-configured zone.
   Bootable	Select this check box to allow to boot from this ISO upon creating an instance.
   OS Type	Select the operating system of the ISO that you want to create.
   Extractable	Select this check box to allow this template to be downloaded. Note: You can download a template by clicking . However, if this check box is not selected, you will not be able to download it to your local system.
   Domain Wide	Select this check box to make this template available to all users. The iso will appear in the community list for any user to use.

You can also, upload an ISO file from your computer. To do so, perform the following steps:

1. To upload an ISO from a local file, click the Upload from Local button.
   
   

2. The Upload ISO from the Local dialog box displays. (Based on your role, options may vary)
   
   

3. Enter the following information and click OK.

   Information

   Field Name	Description
   Local File	Option to browse and locate the local ISO file for upload
   Name	Enter a name using which you can identify the ISO.
   Description	Enter a description for the ISO. This description will help you to identify the ISO when you need to select one for creating an instance.
   Zone	Select the zone where this ISO should reside. Note: Currently, Leaseweb provides only 1 pre-configured zone.
   Bootable	Select this check box to allow to boot from this ISO upon creating an instance.
   OS Type	Select the operating system of the ISO that you want to create.
   Extractable	Select this check box to allow this template to be downloaded. Note: You can download a template by clicking . However, if this check box is not selected, you will not be able to download it to your local system.
   Public	Select this check box to make this template available to all users. The iso will appear in the community list for any user to use.

Editing a Template/ISO

Perform the following steps to edit a template/ISO: 

1. On the left panel, click Images, and click Templates.
   The Templates page displays.
2. Click the Select view the drop-down list and select Templates (or ISO—depending on what you want to edit).
   The Templates (or ISO) page displays. 
3. Click the template (or ISO) that you want to edit.
   The Details tab displays.
4. Click the Edit icon.
   The editable fields allow you to enter/select new values.
   

5. Update the values and click Apply.
   The updated values display.
   

   Information

   Editable fields for a template—Name, Description, Password Enabled, Extractable, Featured,Public, and OS Type.

   Editable fields for an ISO—Name, Description, Public, Featured, and OS Type

Downloading a Template/ISO

You can download the existing template (or ISO) displayed on the Templates (or ISO) page to your local system.

Warning

Perform the following steps to download a template/ISO: 

1. On the left panel, click Images, and click Templates.
   The Templates page displays.
2. Click the Select view the drop-down list and select Templates (or ISO – depending on what you want to edit).
   The Templates (or ISO) page displays. 
3. Click the template (or ISO) that you want to download.
   The Details tab displays. 
4. Click the Download Template icon.
   
5. A Confirmation dialog box displays.
   
6. Click OK to download the template (or ISO).
   The Status dialog box displays the link using which you can download the template (or ISO).
   The URL will be available for 4 hours from creation.
   
   

Deleting a Template/ISO

Information

1. On the left panel, click Images, and click Templates (ISO).
   The Templates page displays.
2. Click the template (or ISO) that you want to delete.
   The Details tab displays.
3. Click the Zones. Select the zones where you would like to delete this ISO/Template. Click on the delete icon. 
   A Confirmation dialog box displays.
4. Click Yes to delete the template (or ISO).
   The template gets deleted from the list of templates (or ISOs) that display under the Templates (or ISO) list.