Machine Images

Machine Images are a fundemental part of Compute services. They enable the end users to spin up compute instance (VM) with the Operating System of their choice immediately.

A machine image is a single file which contains a virtual disk that has a bootable operating system installed on it.

This guide describes how to create and manage machine images that are compatible with Zadara’s Cloud Services.

Creating Images

Machine Images can be created from the following source formats:

  • VMware OVA image.

  • KVM compatible image in RAW or QCOW2 formats.

    Note

    Openstack KVM images can be used using the KVM compatible image option.

Supported images must meet the following requirements:

  • The image must be a single bootable system disk.

  • The image must be configured to receive its network address via DHCP.

  • User access to the VM is required.

For a Windows image – Use cloudbase-init to prepare your image, and then use VNC to access the VM, or, enable the Remote Access service.

For a Linux image – SSH server service must be enabled.

Note the credentials to be used, when setting up a VM with the image.

Images that were already uploaded to the system are displayed in the images view.

Creating New Images from Files

To upload source files to create new images:

  1. In Main menu > Machine Images, click Images. The Image list is displayed.

    image-list

  2. In the Images toolbar, click the Create button, found at the top left-hand corner of the screen. The Create Image dialog box is displayed.

    image1

In the Create ISO Image wizard complete the following properties:

  • Name – Type in the Name of the image to create.

    Note

    When creating an ISO image in Zadara Cloud Services, the name of the image must end with the ‘.iso’ extension.

  • Description - (Optional) Enter the description of the image to upload.

  • Project - Select the project which owns this image.

  • Firmware Type- Select either BIOS (Default) or UEFI.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Scope - Determine the availability of this image for creating instances.

    • Project - Only for those with access to the project which owns this image.

    • Account - Only for the members of the account of the project which owns this image.

    • Public - Available for all users.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified.

  1. Click Next. The Setup tab is displayed.

    image2

  2. In the Setup tab > Create Image From, select the image source File radio button.

  3. In the Storage Pool dropdown, select the specific storage pool to upload the image to.

  4. In File, drag-and-drop or browse to select the file.

Creating New Images from URLs

Load the source from a URL to create an image.

To upload sources from URLs:

  1. In Main menu > Machine Images, click Images. The Image list is displayed.

  2. In the Images toolbar, click the + Create button, found on the top left-hand corner of the screen. The Create Image dialog box is displayed.

image3

In the Create ISO Image wizard complete the following properties:

  • Name – Type in the Name of the image to create.

    Note

    When creating an ISO image in Zadara Cloud Services, the name of the image must end with the ‘.iso’ extension.

  • Description - (Optional) Enter the description of the image when uploading.

  • Project - Select the project which owns this image.

  • Firmware Type- Select either BIOS (Default) or UEFI.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Scope - Determine the availability of this image for creating instances.

    • Project - Only for those with access to the project which owns this image.

    • Account - Only for the members of the account of the project which owns this image.

    • Public - Available for all users.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified.

  1. Click Next. The Setup tab is displayed.

    image4

    Note

    When the image is to be created from an additional URL source, click Add, found on the Creating Launch Configurations, and then define the parameters.

  2. In the Setup tab > Create Image From, select the image source URL radio button, and complete the following properties:

  • URL - Enter the URL of the image.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Use Legacy IDE - Determine whether to use the legacy IDE or the native IDE (Default).

  • Override Size - Select in order to keep the image the same size (Default) or to override it. To override the size, enter the new size.

  • Disk Type - Select if the image will be attached as a Disk (Default) or CDROM.

Creating New Images from existing Snapshots/Volumes

Load the source from a Snapshot/Volume to create an image.

To upload sources from snapshot or volume:

  1. In Main menu > Machine Images, click Images. The Image list is displayed.

  2. In the Images toolbar, click the + Create button, found on the top left-hand corner of the screen. The Create Image dialog box is displayed.

image5

In the Create ISO Image wizard complete the following properties:

  • Name – Type in the Name of the image to create.

    Note

    When creating an ISO image in Zadara Cloud Services, the name of the image must end with the ‘.iso’ extension.

  • Description - (Optional) Enter the description of the image to upload.

  • Project - Select the project which owns this image.

  • Firmware Type- Select either BIOS (Default) or UEFI.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Scope - Determine the availability of this image for creating instances.

    • Project - Only for those with access to the project which owns this image.

    • Account - Only for the members of the account of the project which owns this image.

    • Public - Available for all users.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified.

  1. Click Next. The Setup tab is displayed.

    image6

    Note

    When the image is to be created from an additional Snapshot/Volume, click Add, found on the Block Device Mapping header, and define the parameters.

  2. In the Setup tab > Create Image From, select the image source Snapshot/Volume radio button, and complete the following properties:

  • Snapshot-Volume – Select the Snapshot/Volume from the dropdown.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Use Legacy IDE - Determine whether to use the legacy IDE or the native IDE (Default).

  • Override Size - Select in order to keep the image the same size (Default) or to override it. To override the size, enter the new size.

  • Disk Type - Select if the image will be attached as a Disk (Default) or CDROM.

  1. Click the OK button. The image begins to be created. Its

    progress is displayed in Image list. When the uploading progress is completed, the Action Succeeded message is displayed.

    image7

New Image Creation from an Existing Volume can be done from the Storage view as well. Create an image from a volume, either directly from the volume or by using a snapshot of the volume. If the volume to use to create an image is currently not attached to a running VM, create an image directly from it, as described below. If the volume is attached to a running VM, and will not be stopped, detach the volume from it to create a snapshot of the volume, and then create an image from the snapshot.

To create an image from a volume

  1. In the Storage > Block Storage list, double-click the volume to create an image with. The Volume is displayed.

    image8

  2. In the Toolbar, click Create Image image9 button. The Create Image (from Volume) dialogue box is displayed.

    image10

  3. In the Create Image dialogue box , type in the following details:

  • Name – The name of the new image.

  • Description – The description of the new image.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified

  1. Select a tag from the dropdown, and then click OK. The new image is displayed in the Storage > Block Volume list.

Creating Images from Snapshots

The system permits creation of images from a volume snapshot. Using a volume snapshot as the image source allows the user to create the image without stopping the VM or detaching the volume from it.

To create an image from a snapshot:

  1. In the Storage > Snapshots list, double-click the snapshot to create an image with. The Snapshot is displayed.

image11

  1. In the Toolbar, click Create Image image12 button. The Create Image (from Snapshot) dialogue box is displayed.

image13

  1. In the Create Image dialogue box, type in the Name of the new image, and click OK. The new image is displayed in the Storage > Snapshot list.

Selecting and Deleting Images

When deleting an image, first select it from the Image list.

To select images:

  1. In the Machine Image > Image list, check the checkbox next to the Image you want to select. The Image is selected.

    image14

  2. Right-click to open the drop-down menu.

    image15

  3. Select Delete. The following message is displayed: “Are you sure you want to delete <name> volume?”

    image16

  4. Click Delete. The Image is deleted, and the following message is displayed: “Action Succeeded”.

    image17

Creating ISO Images

To create a VM from an ISO image, first create the ISO image. Once the ISO image is created, create a VM from it similar to the way a VM is created from any AMI. This section also deals with the updating of ISO images from previous versions of Zadara Cloud Services.

Creating ISO Images from File

This section of the document describes how to create an image from an ISO file.

To create an ISO image from File:

  1. In Main menu > Machine Images, click Images.

  2. In the Images toolbar, click on Create ISO. The Create ISO Image wizard is displayed.

    image18

In the Create ISO Image wizard complete the following properties:

  • Name – Type in the Name of the image to create.

    Note

    When creating an ISO image in Zadara Cloud Services, the name of the image must end with the ‘.iso’ extension.

  • Description - (Optional) Enter the description of the image to

    upload.

  • Project - Select the project which owns this image.

  • Firmware Type- Select either BIOS (Default) or UEFI.

  • Storage Pool - Select the specific storage pool to upload this

    image to.

  • Scope - Determine the availability of this image for creating instances.

    • Project - Only for those with access to the project which owns this image.

    • Account - Only for the members of the account of the project which owns this image.

    • Public - Available for all users.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified.

  1. Click Next. The OS Installation Disk window is displayed.

    image19

  2. In the Setup tab > OS Installation Disk, select the File radio button as the source of the OS Installation image.

  3. Drag-and-drop the file or browse it.

  4. For ISO image creation it is possible to add a Drivers disk that can be used during and after the operating system installation. In order to add a Drivers disk, click the Add Drivers button. The Additional Drivers Disk can be created from a file or existing snapshot/volume.

  5. Click Finish. The ISO Image is displayed in the Images list.

Creating ISO Images from URLs

This section of the document describes how to create an image from a URL.

To create an ISO image from a URL:

  1. In Main menu > Machine Images, click Images.

  2. In the Images toolbar, click on Create ISO. The Create ISO Image wizard is displayed.

    image20

In the Create ISO Image wizard complete the following properties:

  • Name – Type in the Name of the image beinge created.

    Note

    When creating an ISO image in Zadara Cloud Services, the name of the image must end with the ‘.iso’ extension.

  • Description - (Optional) Enter the description of the image to upload.

  • Project - Select the project which owns this image.

  • Firmware Type- Select either BIOS (Default) or UEFI.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Scope - Determine the availability of this image for creating instances.

    • Project - Only for those with access to the project which owns this image.

    • Account - Only for the members of the account of the project which owns this image.

    • Public - Available for all users.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified.

  1. Click Next. The OS Installation Disk window is displayed.

    image21

  2. In the Setup tab > OS Installation Disk > Source, select the URL radio button as the source of the OS Installation image.

  3. Copy and paste the URL into the URL field.

  • Skip SSL verification – Check in order to skip SSL verification

  1. For ISO image creation it is possible to add a Drivers disk that can be used during and after the operating system installation. In order to add a Drivers disk, click the Add Drivers button. The Additional Drivers Disk can be created from a file or existing snapshot/volume.

Creating ISO Images from existing Snapshots/Volumes

This section of the document describes how to create an image from Snapshots or Volumes.

To create an ISO image:

  1. In Main menu > Machine Images, click Images.

  2. In the Images toolbar, click on Create ISO. The Create ISO Image wizard is displayed.

    image22

In the Create ISO Image wizard complete the following properties:

  • Name – Type in the Name of the image to create.

    Note

    When creating an ISO image in Zadara Cloud Services, the name of the image must end with the ‘.iso’ extension.

  • Description - (Optional) Enter the description of the image to upload.

  • Project - Select the project which owns this image.

  • Firmware Type- Select either BIOS (Default) or UEFI.

  • Storage Pool - Select the specific storage pool to upload this image to.

  • Scope - Determine the availability of this image for creating instances.

    • Project - Only for those with access to the project which owns this image.

    • Account - Only for the members of the account of the project which owns this image.

    • Public - Available for all users.

  • Tags - (Optional) Attach one or more tags to this image by which it can be identified.

  1. Click Next. The Setup tab is displayed.

    image23

  2. In the Setup tab > OS Installation Disk, select the Snapshot/Volume radio button as the source of the OS Installation image.

  3. In Snapshot/Volume, select one of the ISO images as the OS Installation Source.

    Note

    The ISO images are distinguished from other Snapshots or Volumes by their “.iso” suffix.

  4. For ISO image creation it is possible to add a Drivers disk that can be used during and after the operating system installation. In order to add a Drivers disk, click the Add Drivers button. The Additional Drivers Disk can be created from a file or existing snapshot/volume.

  5. Click Finish. The ISO Image is displayed in the Images list.

The Marketplace

The marketplace provides tested image templates ready for implementation in to projects.

The following Installations are available in the Zadara Marketplace:

  • NeoKarm ver. 5.5

  • CentOS ver. 6, ver. 7

  • CirrOS ver. 0.5.1

  • Debian ver. 9, ver. 10

  • Fedora ver. 32

  • OpenSUSE ver. 15.2

  • Ubuntu Bionic ver. 18.04-LTS,

  • Ubuntu Xenial

To download a system installation from the Zadara Marketplace:

  1. In Machine Images > Marketplace, click Marketplace. The Marketplace Main window is displayed.

    image34

  2. Click Neokarm Toolbox 5.5.0. The Neokarm Toolbox download page is displayed.

    image35

  3. Click Download. A new image is registered in the system.

Import Tasks

The import tasks section acts as a status page for ongoing Import VM tasks.

This section of the document describes how to import tasks to implement for your needs.

In Hot Actions box, click Import. The Import VM dialogue box is displayed.

image36

  1. In the Import VM dialogue box > VM Parameters window, enter in the following properties:

  • VM Name – The name of the VM to create.

  • Firmware – Enter the firmware of the VM.

  • Storage Pool – Select the storage pool from the dropdown.

Fill in the field in Image Parameters:

  • Image Name –Enter the image name.

Fill in the fields in Import Method:

  • URL – Enter the URL or copy and paste it.

    • Skip SSL verification – Check to skip SSL verification

  • File – Select the radio button to import the file. Select either URL or File.

  1. Click OK. The imported VM progress is displayed in the Import Tasks menu.

AWS Image Import API

The following table describe the support AWS APIs for Image operations:

AWS API Name

Ignored Params

Optional Params

Required Params

Unsupported Params

DescribeImportImageTasks

ImportTaskId MaxResults NextToken

ImportImage

[]

Architecture ClientData ClientToken Description DiskContainer Hypervisor LicenseType Platform RoleName

[]

[]