diff --git a/doc/user-guide/ch_cli.xml b/doc/user-guide/ch_cli.xml index 7d4ca9f315..69bd27ccc2 100644 --- a/doc/user-guide/ch_cli.xml +++ b/doc/user-guide/ch_cli.xml @@ -29,6 +29,8 @@ --> + + +
+ + Use snapshots to migrate instance + + Some cloud providers allow only administrators to + perform these steps. + + To use snapshots to migrate instances from OpenStack + projects to clouds, complete these steps: + + + Create a snapshot of the instance. + + + Download the snapshot as an image. + + + Import the snapshot to the new environment. + + + Boot a new instance from the snapshot. + + + + Perform the and procedures in the source + project. + Perform the and in the destination + project. + +
+ Create a snapshot of the instance + + + Always shut down the source VM before you take the + snapshot to make sure that all data is flushed to + disk. + $ nova list + +--------------------------------------+------------+--------+------------------------------+ + | ID | Name | Status | Networks | + +--------------------------------------+------------+--------+------------------------------+ + | c41f3074-c82a-4837-8673-fa7e9fea7e11 | example | ACTIVE | private=10.0.0.3 | + +--------------------------------------+------------+--------+------------------------------+ + $ nova stop example + + + Confirm that the instance shows a SHUTOFF + status. + $ nova list + +--------------------------------------+------------+---------+------------------------------+ + | ID | Name | Status | Networks | + +--------------------------------------+------------+---------+------------------------------+ + | c41f3074-c82a-4837-8673-fa7e9fea7e11 | example | SHUTOFF | private=10.0.0.3 | + +--------------------------------------+------------+---------+------------------------------+ + + + + Use the nova + image-create command to take a snapshot. Use the nova + image-list command to check the status until the status + is ACTIVE: + $ nova list + +--------------------------------------+------------+---------+------------------------------+ + | ID | Name | Status | Networks | + +--------------------------------------+------------+---------+------------------------------+ + | c41f3074-c82a-4837-8673-fa7e9fea7e11 | example | SHUTOFF | private=10.0.0.3 | + +--------------------------------------+------------+---------+------------------------------+ + $ nova image-create --poll example examplesnapshot + Instance snapshotting... 50% complete + $ nova image-list + +--------------------------------------+---------------------------------+--------+--------+ + | ID | Name | Status | Server | + +--------------------------------------+---------------------------------+--------+--------+ + | 657ebb01-6fae-47dc-986a-e49c4dd8c433 | cirros-0.3.1-x86_64-uec | ACTIVE | | + | 72074c6d-bf52-4a56-a61c-02a17bf3819b | cirros-0.3.1-x86_64-uec-kernel | ACTIVE | | + | 3c5e5f06-637b-413e-90f6-ca7ed015ec9e | cirros-0.3.1-x86_64-uec-ramdisk | ACTIVE | | + | f30b204e-1ce6-40e7-b8d9-b353d4d84e7d | examplesnapshot | ACTIVE | | + +--------------------------------------+---------------------------------+--------+--------+ + + +
+
+ Download the snapshot as an image + + + Get the image ID: + $ nova image-list ++--------------------------------------+------------------+--------+--------------------------------------+ +| ID | Name | Status | Server | ++--------------------------------------+------------------+--------+--------------------------------------+ +| f30b204e-1ce6-40e7-b8d9-b353d4d84e7d | examplesnapshot | ACTIVE | c41f3074-c82a-4837-8673-fa7e9fea7e11 | ++--------------------------------------+------------------+--------+--------------------------------------+ + + + Download the snapshot by using the image ID that + was returned in the previous step: + $ glance image-download --file snapshot.raw f30b204e-1ce6-40e7-b8d9-b353d4d84e7d + + The glance image-download + command requires the image ID and cannot use + the image name. + Ensure there is sufficient space on the + destination file system for the image + file. + + + + Make the image available to the new environment, + either through http or with direct upload to a + machine (scp). + + +
+
+ Import the snapshot to new environment + + + In the new project or cloud environment, import + the snapshot: + $ glance image-create --copy-from IMAGE_URL + + +
+
+ Boot a new instance from the snapshot + + + In the new project or cloud environment, use the + snapshot to create the new instance: + $ nova boot --flavor m1.tiny --image EXAMPLE_SNAPSHOT NEW_INSTANCE + + +
+