Migrating your VM to Gigify Uganda Limited

In this tutorial, we will discuss all the supported formats for migrating VMs to Gigify Uganda Limited. As a customer, you will probably need to migrate a VM or more from a cloud service provider or vendor to Gigify Uganda Limited, instead of building everything from scratch.

Note: This tutorial is being updated periodically with the new supported versions of VMs.

Possible methods of migration

To migrate a VM to Gigify Uganda Limited portal, you can use any of the following options:

1. Gigify Uganda Limited CLI.
2. Import from an S3 server.
3. Use backup tools like Acronis.

Migrate VMs using CLI

Gigify Uganda Limited CLI provides multiple options for importing VMs to Gigify Uganda Limited. You can download the Gigify Uganda Limited CLI and learn more about how to use it through CLI Guide.

For importing VMs using CLI, you can use either OVA or OVF extensions. Check the following example in the export/import tutorial to learn how you can import your VM to Gigify Uganda Limited portal using CLI.

Use the following command on CLI, to learn more about the supported flags use --help at the end of the command.

./portal-afriqloud-com import vm <CUSTOMER_ID> <CLOUDSPACE_ID> [OVA | OVF] [flags]

For importing disks using CLI, you can use the VMDK extension.

Use the following command on CLI, to learn more about the supported flags use --help at the end of the command.

./portal-afriqloud-com import image <CUSTOMER_ID> <CLOUDSPACE_ID> <DISK_NAME> <IMAGE> <TYPE> <DESC>

Note: In case you want to import a disk or VM that's not exported from Gigify Uganda Limited portal, you'll need to install virt-io drivers before importing it to Gigify Uganda Limited portal.

Migrate VMs using S3

It's also possible to migrate your VM that is uploaded on S3 server to Gigify Uganda Limited portal. This can be done using the Gigify Uganda Limited portal by going to Cloudspace > CREATE VM > Import from S3.

Check virtual machine documentation to learn more about how to create VMs from S3.

Or you can use an API endpoint like the following:

POST /customers/<CUSTOMER_ID>/cloudspaces/<CLOUDSPACE_ID>/vms/import-s3?link=<S3_SERVER_LINK>&key=<S3_ACCESS_KEY>&secret=<S3_SERVER_SECRET>&region=<S3_SERVER_REGION>&bucket=<BUCKET_NAME>&object_name=<OBJECT_NAME>&name=<VM_NAME>&description=<DESCRIPTION>&vcpus=<NUMBER_OF_VCPUS>&memory=<MEMORY_SIZE>&boot_type=<BOOT_TYPE>&os_type=<OS_TYPE>&os_name=<OS_NAME>

Both OVA or OVF extensions are supported when you migrate your VM from S3 server.

Migrate VMs from backup tools

Gigify Uganda Limited portal supports VM migration from backup tools like Acronis. This can be done using the Gigify Uganda Limited portal by going to Cloudspace > CREATE VM > Create from acronis backup.

Check virtual machine documentation to learn more about how to create VMs from Acronis backup.

Or you can use an API endpoint like the following:

POST /customers/<CUSTOMER_ID>/cloudspaces/<CLOUDSPACE_ID>/vms?name=<VM_NAME>&description=<DESCRIPTION>&vcpus=<NUMBER_VCPUS>&memory=<MEMORY_SIZE>&private_ip=<PRIVATE_IP>&image_id=<IMAGE_ID>&disk_size=<DISK_SIZE>&os_type=<OS_TYPE>&os_name=<OS_NAME>&enable_vm_agent=<AGENT_STATUS_BOOLEAN>&all_vm_disks=<CLONE_SNAPSHOTS_STATUS_BOOLEAN>&acronis=<ACRONIS_BACKUP_STATUS_BOOLEAN>&boot_type=<BOOT_TYPE>

Migrate VMs from different Cloud service providers

You can migrate your VMs from multiple cloud service providers to Gigify Uganda Limited by simply exporting the VM from your service provider, then you can use the CLI to import it to Gigify Uganda Limited. Check this example on how you can migrate your VMware VM to Gigify Uganda Limited.