From f63b64891b5f8ccb56514c8e94f780b7028cf33b Mon Sep 17 00:00:00 2001 From: chenqiaomin Date: Sun, 12 Jul 2015 15:44:12 -0400 Subject: [PATCH] Add missing steps for opening category in User Guides Add missing steps for opening category in User Guides to make them consistent with the Admin Guide. Change-Id: I0c4b6d5b248fbf2a5814812d147141acadf25a1f Implements: blueprint user-guides-reorganised --- .../source/dashboard_manage_flavors.rst | 4 +- ...gure_access_and_security_for_instances.rst | 39 +++++++++++---- .../source/dashboard_create_networks.rst | 16 ++++++- doc/user-guide/source/dashboard_databases.rst | 46 ++++++++++++------ .../source/dashboard_launch_instances.rst | 24 ++++++++-- .../source/dashboard_manage_containers.rst | 48 ++++++++++++++++--- .../source/dashboard_manage_images.rst | 9 ++-- .../source/dashboard_manage_volumes.rst | 40 ++++++++++++++-- doc/user-guide/source/dashboard_stacks.rst | 24 ++++++---- 9 files changed, 196 insertions(+), 54 deletions(-) diff --git a/doc/user-guide-admin/source/dashboard_manage_flavors.rst b/doc/user-guide-admin/source/dashboard_manage_flavors.rst index 8a233f56e3..dfb93e4299 100644 --- a/doc/user-guide-admin/source/dashboard_manage_flavors.rst +++ b/doc/user-guide-admin/source/dashboard_manage_flavors.rst @@ -25,8 +25,8 @@ Create flavors Choose the :guilabel:`admin` project from the drop-down list at the top of the page. -#. In the :guilabel:`Admin` tab, open the :guilabel:`System - Panel` and click the :guilabel:`Flavors` category. +#. In the :guilabel:`Admin` tab, open the :guilabel:`System` + tab and click the :guilabel:`Flavors` category. #. Click :guilabel:`Create Flavor`. #. In the :guilabel:`Create Flavor` window, enter or select the parameters for the flavor. diff --git a/doc/user-guide/source/configure_access_and_security_for_instances.rst b/doc/user-guide/source/configure_access_and_security_for_instances.rst index 0f49be869c..83761f6fda 100644 --- a/doc/user-guide/source/configure_access_and_security_for_instances.rst +++ b/doc/user-guide/source/configure_access_and_security_for_instances.rst @@ -44,9 +44,15 @@ group rules to a project, if your cloud requires them. .. note:: When adding a rule, you must specify the protocol used with the destination port or source port. -#. Log in to the dashboard, choose a project, and click :guilabel:`Access & - Security`. The :guilabel:`Security Groups` tab shows the security groups - that are available for this project. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Access & Security` category. The :guilabel: + `Security Groups` tab shows the security groups that are available + for this project. #. Select the default security group and click :guilabel:`Manage Rules`. @@ -89,8 +95,13 @@ Add a key pair Create at least one key pair for each project. -#. Log in to the dashboard, choose a project, and click - :guilabel:`Access & Security`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Access & Security` category. #. Click the :guilabel:`Key Pairs` tab, which shows the key pairs that are available for this project. @@ -107,8 +118,13 @@ Create at least one key pair for each project. Import a key pair ~~~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click - :guilabel:`Access & Security`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Access & Security` category. #. Click the :guilabel:`Key Pairs` tab, which shows the key pairs that are available for this project. @@ -158,8 +174,13 @@ of the state of the instances involved. This procedure details the reservation of a floating IP address from an existing pool of addresses and the association of that address with a specific instance. -#. Log in to the dashboard, choose a project, and click - :guilabel:`Access & Security`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Access & Security` category. #. Click the :guilabel:`Floating IPs` tab, which shows the floating IP addresses allocated to instances. diff --git a/doc/user-guide/source/dashboard_create_networks.rst b/doc/user-guide/source/dashboard_create_networks.rst index ee9cb68ae9..ea22261e01 100644 --- a/doc/user-guide/source/dashboard_create_networks.rst +++ b/doc/user-guide/source/dashboard_create_networks.rst @@ -16,7 +16,13 @@ Guide `__. Create a network ~~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Networks`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Network` tab and + click :guilabel:`Networks` category. #. Click :guilabel:`Create Network`. @@ -62,7 +68,13 @@ Create a network Create a router ~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Routers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Network` tab and + click :guilabel:`Routers` category. #. Click :guilabel:`Create Router`. diff --git a/doc/user-guide/source/dashboard_databases.rst b/doc/user-guide/source/dashboard_databases.rst index 8c16c51368..e6f6af1fc8 100644 --- a/doc/user-guide/source/dashboard_databases.rst +++ b/doc/user-guide/source/dashboard_databases.rst @@ -57,10 +57,14 @@ flavor for the type of database instance you want. datastore and verified that you have an appropriate flavor, you can create a database instance. -#. Log in to the dashboard, choose a project, and click :guilabel:`Databases`. +#. Log in to the dashboard. -#. Click :guilabel:`Database Instances`. This lists the instances that already - exist in your environment. +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Database` tab and + click :guilabel:`Instances` category. This lists the instances that + already exist in your environment. #. Click :guilabel:`Launch Instance`. @@ -108,10 +112,13 @@ This example shows you how to back up and restore a MySQL database. To backup the database instance ------------------------------- -#. Log in to the dashboard, choose a project, and click - :guilabel:`Databases`. +#. Log in to the dashboard. -#. Click :guilabel:`Database Instances`. This displays the existing +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Database` tab and + click :guilabel:`Instances` category. This displays the existing instances in your system. #. Click :guilabel:`Create Backup`. @@ -136,10 +143,13 @@ Now assume that your original database instance is damaged and you need to restore it. You do the restore by using your backup to create a new database instance. -#. Log in to the dashboard, choose a project, and click - :guilabel:`Databases`. +#. Log in to the dashboard. -#. Click :guilabel:`Database Backups`. This lists the available backups. +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Database` tab and + click :guilabel:`Backups` category. This lists the available backups. #. Check the backup you want to use and click :guilabel:`Restore Backup`. @@ -162,10 +172,13 @@ such as its volume size and flavor. To change the volume size of an instance ---------------------------------------- -#. Log in to the dashboard, choose a project, and click - :guilabel:`Databases`. +#. Log in to the dashboard. -#. Click :guilabel:`Database Instances`. This displays the existing +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Database` tab and + click :guilabel:`Instances` category. This displays the existing instances in your system. #. Check the instance you want to work with. @@ -182,10 +195,13 @@ To change the volume size of an instance To change the flavor of an instance ----------------------------------- -#. Log in to the dashboard, choose a project, and - click :guilabel:`Databases`. +#. Log in to the dashboard. -#. Click :guilabel:`Database Instances`. This displays the existing +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Database` tab and + click :guilabel:`Instances` category. This displays the existing instances in your system. #. Check the instance you want to work with. In the diff --git a/doc/user-guide/source/dashboard_launch_instances.rst b/doc/user-guide/source/dashboard_launch_instances.rst index dd82d344c8..e8029dcfb1 100644 --- a/doc/user-guide/source/dashboard_launch_instances.rst +++ b/doc/user-guide/source/dashboard_launch_instances.rst @@ -30,7 +30,13 @@ When you launch an instance from a volume, note the following steps: When you launch an instance from an image, OpenStack creates a local copy of the image on the compute node where the instance starts. -#. Log in to the dashboard, choose a project, and click :guilabel:`Images`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Images` category. The dashboard shows the images that have been uploaded to OpenStack Image service and are available for this project. @@ -188,7 +194,13 @@ You can track usage for instances for each project. You can track costs per month by showing meters like number of vCPUs, disks, RAM, and uptime for all your instances. -#. Log in to the dashboard, choose a project, and click :guilabel:`Overview`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Overview` category. #. To query the instance usage for a month, select a month and click :guilabel:`Submit`. @@ -215,7 +227,13 @@ To launch an instance from the snapshot, select the snapshot and click Manage an instance ~~~~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Instances`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Instances` category. #. Select an instance. diff --git a/doc/user-guide/source/dashboard_manage_containers.rst b/doc/user-guide/source/dashboard_manage_containers.rst index 98f6072441..513299d82c 100644 --- a/doc/user-guide/source/dashboard_manage_containers.rst +++ b/doc/user-guide/source/dashboard_manage_containers.rst @@ -16,7 +16,13 @@ stored in the container and any accompanying metadata. Create a container ~~~~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Containers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Object Store` tab and + click :guilabel:`Containers` category. #. Click :guilabel:`Create Container`. @@ -31,7 +37,13 @@ You have successfully created a container. Upload an object ~~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Containers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Object Store` tab and + click :guilabel:`Containers` category. #. Select the container in which you want to store your object. @@ -58,7 +70,13 @@ Manage an object **To edit an object** -#. Log in to the dashboard, choose a project, and click :guilabel:`Containers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Object Store` tab and + click :guilabel:`Containers` category. #. Select the container in which you want to store your object. @@ -75,7 +93,13 @@ Manage an object **To copy an object from one container to another** -#. Log in to the dashboard, choose a project, and click :guilabel:`Containers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Object Store` tab and + click :guilabel:`Containers` category. #. Select the container in which you want to store your object. @@ -100,7 +124,13 @@ can upload the file later when it is ready. This temporary object acts a place-holder for a new object, and enables the user to share object metadata and URL info in advance. -#. Log in to the dashboard, choose a project, and click :guilabel:`Containers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Object Store` tab and + click :guilabel:`Containers` category. #. Select the container in which you want to store your object. @@ -122,7 +152,13 @@ Pseudo-folders are similar to folders in your desktop operating system. They are virtual collections defined by a common prefix on the object's name. -#. Log in to the dashboard, choose a project, and click :guilabel:`Containers`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Object Store` tab and + click :guilabel:`Containers` category. #. Select the container in which you want to store your object. diff --git a/doc/user-guide/source/dashboard_manage_images.rst b/doc/user-guide/source/dashboard_manage_images.rst index 5f31554bcb..58143433bf 100644 --- a/doc/user-guide/source/dashboard_manage_images.rst +++ b/doc/user-guide/source/dashboard_manage_images.rst @@ -29,7 +29,8 @@ Follow this procedure to upload an image to a project: #. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the appropriate project. -#. On the :guilabel:`Project` tab, click :guilabel:`Images`. +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Images` category. #. Click :guilabel:`Create Image`. @@ -95,7 +96,8 @@ Follow this procedure to update an existing image. #. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the appropriate project. -#. On the :guilabel:`Project` tab, click :guilabel:`Images`. +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Images` category. #. Select the image that you want to edit. @@ -124,7 +126,8 @@ with the appropriate permissions can delete images. #. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the appropriate project. -#. On the :guilabel:`Project` tab, click :guilabel:`Images`. +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Images` category. #. Select the images that you want to delete. diff --git a/doc/user-guide/source/dashboard_manage_volumes.rst b/doc/user-guide/source/dashboard_manage_volumes.rst index e70de13f26..f2c9178765 100644 --- a/doc/user-guide/source/dashboard_manage_volumes.rst +++ b/doc/user-guide/source/dashboard_manage_volumes.rst @@ -11,7 +11,13 @@ users can create volume types. Create a volume ~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Volumes`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Volumes` category. #. Click :guilabel:`Create Volume`. @@ -57,7 +63,13 @@ Attach a volume to an instance After you create one or more volumes, you can attach them to instances. You can attach a volume to one instance at a time. -#. Log in to the dashboard, choose a project, and click :guilabel:`Volumes`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Volumes` category. #. Select the volume to add to an instance and click :guilabel:`Edit Attachments`. @@ -94,7 +106,13 @@ A message indicates whether the action was successful. Create a snapshot from a volume ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Volumes`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Volumes` category. #. Select a volume from which to create a snapshot. @@ -110,7 +128,13 @@ Create a snapshot from a volume Edit a volume ~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click :guilabel:`Volumes`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Volumes` category. #. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the appropriate project. @@ -136,7 +160,13 @@ Delete a volume When you delete an instance, the data in its attached volumes is not destroyed. -#. Log in to the dashboard, choose a project, and click :guilabel:`Volumes`. +#. Log in to the dashboard. + +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. + +#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and + click :guilabel:`Volumes` category. #. Select the check boxes for the volumes that you want to delete. diff --git a/doc/user-guide/source/dashboard_stacks.rst b/doc/user-guide/source/dashboard_stacks.rst index 441914fcea..bd37392abc 100644 --- a/doc/user-guide/source/dashboard_stacks.rst +++ b/doc/user-guide/source/dashboard_stacks.rst @@ -25,9 +25,11 @@ openstack.org/developer/heat/>`_. Launch a stack ~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click - :guilabel:`Stacks` in the :guilabel:`Orchestration` category - on the :guilabel:`Project` tab. +#. Log in to the dashboard. +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. +#. On the :guilabel:`Project` tab, open the :guilabel:`Orchestration` tab and + click :guilabel:`Stacks` category. #. Click :guilabel:`Launch Stack`. #. In the :guilabel:`Select Template` dialog box, specify the following values: @@ -118,9 +120,11 @@ Events Manage a stack ~~~~~~~~~~~~~~ -#. Log in to the dashboard, choose a project, and click - :guilabel:`Stacks` in the :guilabel:`Orchestration` category - on the :guilabel:`Project` tab. +#. Log in to the dashboard. +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. +#. On the :guilabel:`Project` tab, open the :guilabel:`Orchestration` tab and + click :guilabel:`Stacks` category. #. Select the stack that you want to update. #. Click :guilabel:`Change Stack Template`. #. In the :guilabel:`Select Template` dialog box, select the @@ -136,9 +140,11 @@ Delete a stack When you delete a stack, you cannot undo this action. -#. Log in to the dashboard, choose a project, and click - :guilabel:`Stacks` in the :guilabel:`Orchestration` category - on the :guilabel:`Project` tab. +#. Log in to the dashboard. +#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the + appropriate project. +#. On the :guilabel:`Project` tab, open the :guilabel:`Orchestration` tab and + click :guilabel:`Stacks` category. #. Select the stack that you want to delete. #. Click :guilabel:`Delete Stack`. #. In the confirmation dialog box, click :guilabel:`Delete Stack`