Categories

How to use your own ISO’s on the G8

You are here:
< All Topics

How to use your own ISO images on the G8

Our G8 platforms allow you to deploy your own ISO images that can be used for recovery or installing your Operating System from scratch.

Adding your ISO Image

Your ISO image should be in a format compatible with qemu-img and should be available publicly via http(s) or ftp.

Procedure

To follow along, go into the portal of your G8 and click the "Machine API" on the top of the screen:
file

To add your own ISO image the following API is made available under cloudapi__images.

file

You can invoke this call by first clicking [Try it out] and then entering the following parameters:

Once you have entered your parameters, press [Execute] to issue the call and get a result.

This API will return the created CDROMImage diskID which is needed to boot from.

Bare in mind if this is an asynchronous API it will return the diskID but the image might not be in CREATED status yet (check list images)
It's also important to note that CDROMImage(s) are actually disks not images

Booting your VM with a bootdisk

Normally a VM boots without a CD-ROM attached, to be able to use a CD-ROM you first need to halt your VM.

Listing CD-ROM Images

For this purpose, we expose another api call that you can use to list all CD-ROM Images by calling the api with no parameters or by specifying accountID to list CD-ROM Images belonging to it.

file

# resposne
[
  {
   ...
    "id": 178,
    "accountId": 1,
    "type": "C",
    "status": "CREATED",
    "name": "Rescue CD",
   ...
  }
]

This response tells us our image is created.

Start Machine with bootdisk

Now that we have validated that our image is in created status let's start our VM with it. For that we use another API call under cloudapi__machines:

file

You can invoke this call by first clicking [Try it out] and then entering the following parameters:

  • machineID: ID of a HALTED machine that you'd like to start with your CDROM attached.
  • diskID: ID of a disk to be attached to your machine. In this case this will be the CDROMImage ID that we obtained from the previous step which was 178.

Once you have entered your parameters, press [Execute] to issue the call and get a result.

Our VM will automatically start from CD-ROM with as fallback the bootdisk of the VM

To access the console of the vm browse to https://<g8url>/g8vdc/#/edit/<machineId> and click the console tab
file

As you can see on the screenshot above it is possible to access a boot menu during the start of your VM, this option appears for 10 seconds, this could be used in case you inserted a bootable CD-ROM but you would like to boot from the disk instead.

Remove the CD-ROM from your VM

To remove the CD-ROM you need to stop your VM and start it again without specifying a diskID.

Table of Contents