You can perform a set of actions with the templates:

  • view/edit/delete system templates
  • create/edit/delete/make public custom templates
  • manage template recipes and recipe variables
  • manage template system service add-ons

  • download new and update existing templates

View Template Details

The Control Panel's Templates List menu lists all of the templates available on your system, their version number, the number of recipes assigned to the template, the Operating System they install, whether swap disk is allowed, whether you can adjust their CPU cores/priority & RAM without rebooting a virtual server based on that template ("resize without reboot"), and whether hot migration is allowed.

The templates are organized into four tabs:

  • System templates - the OS images provided by OnApp.
  • My templates - the list of custom templates created by the user who is currently logged in. 

  • User templates - the list of templates converted by all users in the cloud from VS backups. To see user templates, make sure the See User Templates permission is enabled.

  • Inactive - the templates that are currently unavailable to build VS on.

To see which virtual servers are based on a specific template:

  1. Go to your Сontrol Panel > Cloud > Templates > Templates List menu to bring up the list of templates.
  2. Click the template's label (name) in the list.

If you are viewing the templates list on a narrow screen, you can customize the way the table is displayed by clicking the actions icon at the top of the table. In the drop-down list that appears, check the columns you want to be displayed and click Apply. The narrower your screen is, the more unchecked columns will be hidden from the table. If your screen is too narrow to fit all the columns you have checked, a scrollbar will appear at the bottom of the templates list. You can always alter your column selection later. Note that by default the Backup server column is not visible in the table on narrow screens.

Column selection is currently set for one browser. If you have checked some columns in one browser and open the list in some other browser, the column selection will be the default one for that other browser.

Edit Template Details

You can edit a range of template details through the Control Panel, including minimum disk size required, version number, filename and label. To do so:

  1. Go to your Control Panel > Cloud > Templates > Templates List menu. You'll see a list of templates on your system.
  2. Click the Actions icon next to the template you want to change, then choose Edit Template.
  3. On the screen that follows, enter template details as required:
    • Label – change the template name
    • Filename – edit the template filename
    • Version – the template version
    • Min disk size – the minimum VS disk size required to build a VS on this template (in GB)

    • Min memory size – the minimum VS RAM required to build a VS on this template (in MB)

      The maximum RAM that can be assigned to a VS is 168 GB regardless of the Max RAM value set in the bucket.

      The maximum RAM that can be assigned to a VS built on a XEN 32bit (x86) template is 16 GB.

    • Allowed hot migrate - move the slider to the right if you want to be able to hot-migrate VS created from this template.

  4. Click Save to finish.

Delete System Templates

To delete a template:

  1. Go to the Control Panel > Cloud > Templates > Templates List menu.
  2. Click the Actions icon next to the template you wish to delete, then choose Delete Template.

You cannot delete a template if there are virtual servers in your system built on that template. To delete the said template you will have to destroy such virtual server first.

Edit Custom Templates

You can edit your custom templates at any time. To do so:

  1. Go to your Control Panel > Cloud > Templates > Templates List menu and click the User Templates tab. Your custom templates will be listed there.
  2. Click the Actions icon next to the template you want to change.
  3. Choose Edit Template, make your changes on the screen that follows.
  4. Click Save.

Delete Custom Templates

You can delete your custom templates at any time. To do so:

  1. Go to your Control Panel > Cloud > Templates > Templates List menu and click the User Templates tab. Your custom templates will be listed there.
  2. Click the Actions icon next to the template you want to delete.
  3. Choose the  Delete Template button next to a template if you want to delete it.

You cannot delete a template if there are virtual servers in your system built on that template. To delete the said template you will have to destroy such virtual server first.

Make Templates Public

The template list is organized into three tabs. The User templates tab lists all the custom templates created form the backups. By default those templates are available only to those users who created them. When you make templates public, you make your templates available to all users:

  1. Go to your Control Panel > Cloud > Templates > Templates List menu.
  2. Click User templates tab.
  3. Click the Actions button next to the template you want to make public, then select Make public.
  4. Confirm the window that pops up.

When you make a custom template public, it is moved to a System templates tab.

Allow Users to Make Templates Public

All custom templates are private by default, which means they are only available to the users who created them. As the administrator, you can give users the right to create templates that are available to all users – i.e. to create public templates. This is handled through the Control Panel's Roles menu:

  1. Go to your Control Panel > Admin > Roles menu.
  2. Click the Edit icon next to the role you want to edit.
  3. On the screen that follows, check the box next to the Make own template public permission and click Save.

See also:

Leave feedback