Adding a VM image

A VM Image is a template of a virtual machine. VM Images can be imported for use in Templates, and become live virtual machines when launched as an Environment. 

There are 3 ways VM Images can be added into Heropa. 

1. Ask the Heropa team and they will add it in for you! 
2. Import directly from Amazon Web Services (AWS)
3. Upload from an OVA file
4. Create a VM image from Azure VHD

View a list of all available / added images by selecting VM Images. 

Ask the Heropa team

We can easily source base versions of VM images and add these into Heropa for you. This includes macOS images. Speak to your account manager or contact support@heropa.com. 

Import a VM image from Amazon Web Services (AWS)

Heropa uses AWS as an infrastructure provider, which means you can import an existing AWS Amazon Machine Image (AMI) directly into Heropa. The AMI will need to be made accessible first. Here’s how:

In AWS

1. Locate the AMI in your AWS console, then choose Actions / Modify Image Permissions

2. In the Modify Image Permissions window enter 768621140189 in the AWS Account Number, then click Add Permission.

3. Verify that the AWS Account Number has been successfully added.

4. Copy the AMI ID to your clipboard

In Heropa

1. In the Heropa Portal, from the Left Navigation menu choose VM Images, select the VM images tab, then click Add. 
2. In the Create new VM image window, complete the following information:

• Company: Select the company that will own the VM Image.
  • Users with a global role type can create a VM Image for any company. Users with a company role type can create a VM Image for their own company only.
  • Select 'Share with all companies' if the VM Image is to be available to all companies. For more information, see: Sharing resources across Companies.
• Method: AWS AMI
• Name: Enter the display name of the VM Image
• Region: Select the region where your AMI is located
• OS type: Select the OS
• Connection type: Select the method of connecting to the VM Image  
• Image ID: Enter your AMI ID
• Instance type: Set the default size for your VM image. This can be modified later.

Once the above information has been completed, click Create.

On the VM image details page enter the Username and Password, then click Save.

Note: You can optionally add a Description and User notes.

The VM image will have a status of Missing or Pending for a few minutes until the addition has been successfully processed.

When the Status is Available, the VM image is ready to use in a template.

Upload from an OVA file

1. In the Heropa Portal, from the Left Navigation menu choose VM Images, select the Import tab, then select Upload. 
2. Complete the details in the Upload details window.

Create a VM image from Azure VHD

Heropa uses AWS as an infrastructure provider, which means you can import an existing AWS Amazon Machine Image (AMI) directly into Heropa. The AMI will need to be made accessible first. Here’s how:

In Azure

1. Identify the storage account and storage container defined in the region configuration of your BYO Azure cloud account.
2. Create or copy the VHD file you want to use into the storage container

In Heropa

1. In the Heropa Portal, from the Left Navigation menu choose VM Images, select the VM images tab, then click Add. 
2. In the Create new VM image window, complete the following information:

• Company: Select the company that will own the VM Image.
  • Users with a global role type can create a VM Image for any company. Users with a company role type can create a VM Image for their own company only.
  • Select 'Share with all companies' if the VM Image is to be available to all companies. For more information, see: Sharing resources across Companies.
• Method: Azure VHD
• Name: Enter the display name of the VM Image
• Region: Select the region of the storage container that contains the VHD
• OS type: Select the OS
• Connection type: Select the method of connecting to the VM Image 
• VM Generation:  This determines the boot method that the operating system requires. See Azure documentation for more information
• Instance type: Set the default size for your VM image. This can be modified later.
• Disk type: Select Standard SSD or Premium SSD
• VHD file name: Select from the dropdown of discovered VHD files in the storage container

Once the above information has been completed, click Create.

On the VM image details page enter the Username and Password, then click Save.

Note: You can optionally add a Description and User notes.

The VM image will have a status of Missing or Pending for a few minutes until the addition has been successfully processed.

When the Status is Available, the VM image is ready to use in a template.