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

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

To add your own ISO image the following API is made available.
file
Example:

This API will return the created image it's diskId which is needed to boot from it.

Bare in mind this an asynchronous API it will return the diskId but the image might not be in CREATED status yet (check list images)

Booting your VM with a bootdisk

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

Listing CD-ROM Images

# request
curl -X POST "https://be-loc-dc01-001.gig.tech/restmachine/cloudapi/images/listCDROMImages" -H  "accept: application/json" -H  "Content-Type: application/json"
# 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:

# request
curl -X POST "https://be-loc-dc01-001.gig.tech/restmachine/cloudapi/machines/start" -H  "accept: application/json" -H  "Content-Type: application/json" -d '{"machineId":94,"diskId":178}'
# response
true

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

To access the console of the vm browse to https://<g8name>.gig.tech/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 10seconds, this could be used incase 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 withouth specifying a diskId.

Table of Contents