From ab29f8f583ca7941703420c7ef9cfd1d288e0bf6 Mon Sep 17 00:00:00 2001 From: Deepti Navale Date: Tue, 22 Apr 2014 16:11:26 +1000 Subject: [PATCH] Updates to the 'Launch and manage instances' section Included the following updates: * Option 'Delete on Terminate' to delete a volume when an instance is terminated. * Note regarding the Flavor field being selected based on the minimum image requirements. * New 'Advanced Options' tab option in the 'Launch Instance' window for selecting the type of disk partition. * Minor updates to 'Create Snapshots' section. Partial-Bug: #1307860 Change-Id: Ic23fcb4612e0d16505d509c80c20b18a89e0bb1c --- .../section_dashboard_launch_instances.xml | 36 +- ..._dashboard_launch_instances_from_image.xml | 361 +++++++++--------- 2 files changed, 196 insertions(+), 201 deletions(-) diff --git a/doc/user-guide/section_dashboard_launch_instances.xml b/doc/user-guide/section_dashboard_launch_instances.xml index 9d6845f7f7..1b9c36472d 100644 --- a/doc/user-guide/section_dashboard_launch_instances.xml +++ b/doc/user-guide/section_dashboard_launch_instances.xml @@ -82,25 +82,19 @@ Select the instance from which to create a snapshot. - From the Actions list, - select Create - Snapshot. + In the Actions column, click + Create Snapshot. - In the Create Snapshot dialog box, enter a name - for the snapshot, and then click Create - Snapshot. - The Images & Snapshots - category shows the instance snapshot. + In the Create Snapshot dialog box, enter a name for the + snapshot, and click Create Snapshot. + The Images category shows the instance + snapshot. - - To launch an instance from the snapshot, select - the snapshot and click - Launch. Proceed with - . + To launch an instance from the snapshot, select the snapshot and + click Launch. Proceed with + .
@@ -115,13 +109,11 @@ In the More list in the - Actions column, select - the state. - You can resize or rebuild an instance. You can - also choose to view the instance console log. - Depending on the current state of the instance, - you can pause, resume, suspend, soft or hard - reboot, or terminate it. + Actions column, select the state. + You can resize or rebuild an instance. You can also choose + to view the instance console log, edit instance or the security + groups. Depending on the current state of the instance, you can + pause, resume, suspend, soft or hard reboot, or terminate it.
diff --git a/doc/user-guide/section_dashboard_launch_instances_from_image.xml b/doc/user-guide/section_dashboard_launch_instances_from_image.xml index 28f2e24f17..0dade15723 100644 --- a/doc/user-guide/section_dashboard_launch_instances_from_image.xml +++ b/doc/user-guide/section_dashboard_launch_instances_from_image.xml @@ -34,195 +34,198 @@ Log in to the dashboard, choose a project, and click - Images & Snapshot. + Images. The dashboard shows the images that have been uploaded to - OpenStack Image Service and are available for this - project. + OpenStack Image Service and are available for this + project. For details on creating images, see Creating images manually in the OpenStack - Virtual Machine Image Guide. + xlink:href="http://docs.openstack.org/image-guide/content/ch_creating_images_manually.html" + >Creating images manually in the OpenStack + Virtual Machine Image Guide. - Select an image and click - Launch. + Select an image and click Launch. In the Launch Instance dialog box, specify the following - values: + values: - - - - - Details tab - - - - - Availability - Zone - - By default, this value is set to the - availability zone given by the cloud provider - (for example, us-west or - apac-south). For most - cases, it could be - nova. + + + + + Details tab + + + + + Availability Zone + + By default, this value is set to the availability zone + given by the cloud provider (for example, us-west + or apac-south). For some cases, it could be + nova. + + + + Instance Name + Assign a name to the virtual machine. + The name you assign here becomes the initial host + name of the server. After the server is built, if you change + the server name in the API or change the host name directly, + the names are not updated in the dashboard. + Server names are not guaranteed to be unique when + created so you could have two instances with the same host + name. + + + + + Flavor + Specify the size of the instance to launch. + The flavor is selected based on the size of the + image selected for launching an instance. For example, while + creating an image, if you have entered the value in the + Minimun RAM (MB) field as 2048, then on + selecting the image, the default flavor is + m1.small. + + + + + Instance Count + To launch multiple instances, enter a value greater + than 1. The default is 1. + + + Instance Boot Source + Your options are: + + + Boot from image + If you choose this option, a new field + for Image Name displays. You can + select the image from the list. + + + Boot from snapshot + If you choose this option, a new field for + Instance Snapshot displays. You + can select the snapshot from the list. + + + Boot from volume + If you choose this option, a new field for + Volume displays. You can select + the volume from the list. + + + Boot from image (creates a new volume) + With this option, you can boot from an + image and create a volume by entering the + Device Size and Device Name + for your volume. Click the Delete on Terminate + option to delete the volume on terminating the instance. + + + + Boot from volume snapshot (creates a new + volume) + Using this option, you can boot from a + volume snapshot and create a new volume by choosing + Volume Snapshot from a list and + adding a Device Name for your volume. + Click the Delete on Terminate option + to delete the volume on terminating the instance. + + + + Since you are launching an instance from an + image, Boot from image is + chosen by default. + + + + Image Name + This field changes based on your previous selection. + Since you have chosen to launch an instance using an image, + the Image Name field displays. Select + the image name from the dropdown list. + + + + Access & Security + tab + + + Keypair + Specify a key pair. + If the image uses a static root password or a + static key set (neither is recommended), you do + not need to provide a key pair to launch the instance. + + + Security Groups + Activate the security groups that you want to + assign to the instance. + Security groups are a kind of cloud firewall that + define which incoming network traffic is forwarded to + instances. For details, see . + + If you have not created any security groups, you can + assign only the default security group to the instance. + + + + Networking tab + + + Selected Networks + To add a network to the instance, click the + + in the Available Networks + field. + + + + Post-Creation tab + + + Customization Script + Specify a customization script that runs after your + instance launches. + + + Advanced Options tab + + + Disk Partition + Select the type of disk partition from the dropdown + list. + + + Automatic + + Entire disk is single partition and + automatically resizes. + + + Manual + + Faster build times but requires + manual partitioning. + + + - - Instance Name - Assign a name to the virtual machine. - - The name you assign here becomes the - initial host name of the server. After the - server is built, if you change the server - name in the API or change the host name - directly, the names are not updated in the - dashboard. - Server names are not guaranteed to be - unique when created so you could have two - instances with the same host name. - - - - - - Flavor - Specify the size of the instance to - launch. - - - Instance - Count - To launch multiple instances, enter a value - greater than 1. The default is 1. - - - - - Instance Boot Source - - - Your options are: - - - - Boot from - image—If you choose - this option, a new field for - Image Name - displays. You can select the image from - the list. - - - - Boot from - snapshot—If you choose - this option, a new field for - Instance Snapshot - displays. You can select the snapshot - from the list. - - - - Boot from - volume—If you choose - this option, a new field for - Volume displays. - You can select the volume from the - list. - - - - Boot from image (creates a new - volume) —With this - option, you can boot from an image and - create a volume by entering the - Device Size and - Device Name for - your volume. - - - - Boot from volume snapshot - (creates a new volume)— - Using this option, you can boot from a - volume snapshot and create a new volume - by choosing Volume - Snapshot from a list and - adding a Device - Name for your volume. - - - Since you are launching an instance from an - image, Boot from image is - chosen by default. - - - - - - Image Name - - - - This field changes based on your previous - selection. Since you have chosen to launch an - instance using an image, the Image - Name field displays. Select the - image name from the dropdown list. - - - - Access & - Security tab - - - Keypair - Specify a key pair. - If the image uses a static root password or a - static key set (neither is recommended), you do - not need to provide a key pair to launch the - instance. - - - Security - Groups - Activate the security groups that you want to - assign to the instance. - Security groups are a kind of cloud firewall - that define which incoming network traffic is - forwarded to instances. For details, see . - If you have not created any security groups, - you can assign only the default security group - to the instance. - - - Networking tab - - - Selected - Networks - To add a network to the instance, click the - + in the - Available Networks - field. - - - Post-Creation tab - - - Customization - Script - Specify a customization script that runs after - your instance launches. -