From d3e79a9804e3b93c9105cf220e6ce9a43aa6f0c1 Mon Sep 17 00:00:00 2001 From: "zhiguo.li" Date: Tue, 8 Aug 2017 18:06:22 +0800 Subject: [PATCH] Change the way to create image service The way of creating service image in Shared File Systems installation guide is outdated. The parameter 'copy_from' is no longer supported by Glance V2.This patch mainly for changing the way of uploading an image to glance. At the same time, this patch modified the structer of this file to make it more clearly. Some content is splited and three subtitles are added, they are: 'Create a share type', 'Create a manila server image', and 'Create a share network'. Change-Id: Ie21f6c63e41d4de4ef94c21e3a2979943d25489a Closes-Bug: 1709266 --- ...ss-true-mode-using-shared-file-systems.rst | 93 +++++++++++++------ 1 file changed, 64 insertions(+), 29 deletions(-) diff --git a/install-guide/source/common/dhss-true-mode-using-shared-file-systems.rst b/install-guide/source/common/dhss-true-mode-using-shared-file-systems.rst index 1d629366d5..9d96ac369d 100644 --- a/install-guide/source/common/dhss-true-mode-using-shared-file-systems.rst +++ b/install-guide/source/common/dhss-true-mode-using-shared-file-systems.rst @@ -13,6 +13,8 @@ server is an instance where NFS shares are served. The cinder volumes are attached to share servers according to the definition of a share network. +Create a share type +------------------- #. Source the admin credentials to gain access to admin-only CLI commands: @@ -50,36 +52,30 @@ server is an instance where NFS shares are served. the Share types usage documentation `here _`. -#. Create a manila share server image in the Image service. You may skip this - step and use any existing image. However, for mounting a share, the service - image must contain the NFS packages as appropriate for the operating system. - Whatever image you choose to be the service image, be sure to set the - configuration values ``service_image_name``, ``service_instance_flavor_id``, - ``service_instance_user`` and ``service_instance_password`` in - ``manila.conf``. +Create a manila server image +------------------------ - .. note:: + For evaluation of the Shared File Systems service, the image used by manila server must support + network file system protocols such as NFS/CIFS. This guide creates a regular instance using the + manila-share-service image because it supports NFS and using the + manila-service-flavor that limits resource consumption by the instance to 256 MB memory on the + compute node. You may skip this step if you already have a such kind of image in glance. - Any changes made to ``manila.conf`` while the ``manila-share`` service - is running will require a restart of the service to be effective. - - .. note:: - - As an alternative to specifying a plain-text - ``service_instance_password`` in your configuration, a key-pair may be - specified with options ``path_to_public_key`` and - ``path_to_private_key`` to configure and allow password-less SSH access - between the `share node` and the share server/s created. +#. Download the source image of the share server: .. code-block:: console - $ glance image-create \ - --copy-from http://tarballs.openstack.org/manila-image-elements/images/manila-service-image-master.qcow2 \ - --name "manila-service-image" \ + $ wget http://tarballs.openstack.org/manila-image-elements/images/manila-service-image-master.qcow2 + +#. Add the image to the Image service: + + .. code-block:: console + + $ openstack image create "manila-service-image" \ + --file manila-service-image-master.qcow2 \ --disk-format qcow2 \ --container-format bare \ - --visibility public --progress - [=============================>] 100% + --public +------------------+--------------------------------------+ | Property | Value | +------------------+--------------------------------------+ @@ -101,6 +97,50 @@ server is an instance where NFS shares are served. | visibility | public | +------------------+--------------------------------------+ +#. Create a new flavor to support the service image: + + .. code-block:: console + + openstack flavor create manila-service-flavor --id 100 --ram 256 --disk 0 --vcpus 1 + +----------------------------+-----------------------+ + | Field | Value | + +----------------------------+-----------------------+ + | OS-FLV-DISABLED:disabled | False | + | OS-FLV-EXT-DATA:ephemeral | 0 | + | disk | 0 | + | id | 100 | + | name | manila-service-flavor | + | os-flavor-access:is_public | True | + | ram | 256 | + | rxtx_factor | 1.0 | + | swap | | + | vcpus | 1 | + +----------------------------+-----------------------+ + +.. note:: + + Be sure to set the configuration values ``service_image_name``, + ``service_instance_flavor_id``, ``service_anstance_user`` and ``service_instance_password`` + in``manila.conf`` according to the image you chose, and restart the manila-share process. + +.. note:: + + As an alternative to specifying a plain-text + ``service_instance_password`` in your configuration, a key-pair may be + specified with options ``path_to_public_key`` and + ``path_to_private_key`` to configure and allow password-less SSH access + between the `share node` and the share server/s created. + +Create a share network +---------------------- + +#. Source the ``demo`` credentials to perform + the following steps as a non-administrative project: + + .. code-block:: console + + $ . demo-openrc.sh + #. List available networks in order to get id and subnets of the private network: @@ -114,12 +154,7 @@ server is an instance where NFS shares are served. | 7c6f9b37-76b4-463e-98d8-27e5686ed083 | private | 3482f524-8bff-4871-80d4-5774c2730728 172.16.1.0/24 | +--------------------------------------+---------+----------------------------------------------------+ -#. Source the ``demo`` credentials to perform - the following steps as a non-administrative project: - - .. code-block:: console - - $ . demo-openrc.sh +#. Create the share network using the private network and subnet IDs: .. code-block:: console