Skip to main content

Registering a VM Lab Image

Add an Amazon Machine Image (AMI) to Vocareum for use in Virtual Machine Labs

O
Written by Ophelia Yue
Updated over a week ago

For Admins

Introduction

With a Vocareum Virtual Machine Lab, you can provide learners with secure, streamlined access to stand-alone or networked cloud-hosted VMs.

Behind the scenes, each VM is an AWS EC2 Instance. An Amazon Machine Image (AMI) serves as a template for creating EC2 instances.

To create a VM Lab, you first need to add an AMI from your connected AWS account to Vocareum as a VM Image. This guide will walk through the process.

Prerequisites:

  • Admin access to a Vocareum Organization.

  • Virtual Machine Labs enabled and an AWS account connected to your Vocareum Organization. Contact support@vocareum.com for assistance with this setup.

  • An AMI in the AWS account connected to your Vocareum Organization. Refer to the guide for Adding a Custom AWS AMI for VM Labs for details.


Adding an Image Entry

  1. Go to the "Edit Org" page for your org.

  2. Navigate to the "Custom Infra." section and scroll to VM Labs

  3. Click "Register VM Images" which will take you to a page where you can define the images. This step tells Vocareum about how the image should be accessed.

  4. Click "Add image entry"

  5. You will be given the list of AMIs available in the account to choose from. If you shared an AMI, it should show up in the list.

  6. Specify the following sections for the image

  7. Access name: You can specify the name of the service by which the user will access this image. You can use more than one service. For example, if the AMI launches a web server on port 80 and a desktop server on port 3389, you should both of these services here.

  8. http/https: In the next element select one of the protocols for this service.

  9. port: Specify the port number which the service is listening on.

  10. Select "Save Configuration" to save the configuration. You edit the configuration later by selecting it from the list of images.


​

Did this answer your question?