Skip to content

feat(ins): update migration documentation #5305

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open

feat(ins): update migration documentation #5305

wants to merge 8 commits into from

Conversation

bene2k1
Copy link
Member

@bene2k1 bene2k1 commented Jul 21, 2025

Your checklist for this pull request

Description

Please describe what you added or changed.

@bene2k1 bene2k1 self-assigned this Jul 21, 2025
@bene2k1 bene2k1 added do not merge PR that shouldn't be merged before a specific date (eg release) status: tech review Waiting for technical review labels Jul 21, 2025
### Identify VMs to migrate

1. Review the VMs in the VMware environment to determine which ones to migrate.
2. Ensure the VM boots with UEFI (not Legacy BIOS), as Scaleway Instances require UEFI.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Ensure the VM boots with UEFI (not Legacy BIOS), as Scaleway Instances require UEFI.
2. Ensure the VMs boot with UEFI (not Legacy BIOS), as Scaleway Instances require UEFI.


1. Review the VMs in the VMware environment to determine which ones to migrate.
2. Ensure the VM boots with UEFI (not Legacy BIOS), as Scaleway Instances require UEFI.
3. Match the VM’s resource requirements (CPU, RAM, storage) to an appropriate Scaleway Instance type:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Match the VM’s resource requirements (CPU, RAM, storage) to an appropriate Scaleway Instance type:
3. Match each VM’s resource requirements (CPU, RAM, storage) to an appropriate Scaleway Instance type:

- Image: Ubuntu 24.04 Noble Bat.
- Block Storage: At least twice the storage size of the VM to be migrated.
- SSH Key: Configure an SSH key for access.
2. Connect to the Instance via SSH.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Connect to the Instance via SSH.
2. [Connect to the Instance via SSH](/instances/how-to/connect-to-instance/).

2. Connect to the Instance via SSH.
3. Install the required migration tools:

```shell
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesn't this need to be indented to avoid breaking the steps?

sudo ./aws/install
```
- `govmomi` — for interacting with vCenter
1. Optional: Configure serial Console output (for viewing boot sequences in Scaleway’s console):
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Optional: Configure serial Console output (for viewing boot sequences in Scaleway’s console):
1. Optional: Configure serial console output (for viewing boot sequences in Scaleway’s console):

git clone https://github.com/fg-scw/migration-scw-rhel
```

6. Create an Object Storage Bucket.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
6. Create an Object Storage Bucket.
6. Create an Object Storage bucket.


#### Converting the VM on the Converter Instance

1. Upload or Export the VM image:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Upload or Export the VM image:
1. Upload or export the VM image:


1. Upload or Export the VM image:
- Use `govc` (as shown in the Windows section) or upload the `.ova`/`.vmdk` file manually.
2. Extract the `.ova` File (if applicable):
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Extract the `.ova` File (if applicable):
2. Extract the `.ova` file (if applicable):


#### Creating snapshot, Block Volume, and Instance

1. Upload the Image:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Upload the Image:
1. Upload the image:

aws s3 cp povrhel9_scaleway.qcow2 s3://<bucket_name>/povrhel9_scaleway.qcow2
```

2. Import as a Snapshot:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Import as a Snapshot:
2. Import as a snapshot:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
do not merge PR that shouldn't be merged before a specific date (eg release) status: tech review Waiting for technical review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants