Instance Tenant Transfer

Problem

There is a need to change the tenant in which an instance is hosted.

There is not supported method of changing an existing instance's tenancy.

Instance data must be transferred to the destination tenant.

Environment

• Platform9 Managed OpenStack - v4.0 and Higher

Procedure

If the source instance is booting from volume, the following steps may be executed in the UI to recreate the instance in the destination tenant.

1. Scope to the source tenant.

2. Power-off and snapshot the instance. virtual-machines-instance-snapshot

3. Create a volume from the newly created snapshot. create-volume-from-snapshot

4. Upload the volume as an Glance image. upload-volume-as-image

Info

Ensure the newly created Image is Public so it may be used by other tenants.

1. Scope to the destination tenant.

2. Create a new instance with the newly available Glance image.

Alternative Procedure

If exposing the image as Public is not a viable option, the instance volume may be transferred to the destination tenant by leveraging the OpenStack CLI.

1. Scope to the source tenant.

2. Power-off and snapshot the instance. virtual-machines-instance-snapshot

3. Create a volume from the newly created snapshot. create-volume-from-snapshot

4. Via CLI, transfer the newly created volume.

Bash

# source from_tenant.rc
# openstack volume transfer request create 1ffe881b-93fd-4030-9dc4-0acf1a0126fc
+------------+--------------------------------------+
| Field      | Value                                |
+------------+--------------------------------------+
| auth_key   | bee4e665a35a3a7a                     |
| created_at | 2022-09-28T00:50:17.835651           |
| id         | c459d215-3c46-4915-96f4-5c5c7077ed2a |
| name       | None                                 |
| volume_id  | 1ffe881b-93fd-4030-9dc4-0acf1a0126fc |
+------------+--------------------------------------+

# source to_tenant.rc
# openstack volume transfer request accept --auth-key bee4e665a35a3a7a c459d215-3c46-4915-96f4-5c5c7077ed2a
+-----------+--------------------------------------+
| Field     | Value                                |
+-----------+--------------------------------------+
| id        | c459d215-3c46-4915-96f4-5c5c7077ed2a |
| name      | None                                 |
| volume_id | 1ffe881b-93fd-4030-9dc4-0acf1a0126fc |
+-----------+--------------------------------------+

1. In the UI, scope to the destination tenant. Browse to Volumes and Snapshots and find the volume. Ensure Bootable is set to True.

2. Create a new instance with the newly available volume by selecting Boot Instance From Existing Volume during creation.

Additional Information