)]}'
{"doc/source/adminref/installation.rst":[{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"d954a7dc13d53981caad6d29b0a32d35c14fb2ec","unresolved":false,"context_lines":[{"line_number":91,"context_line":"in our case it was MySQL. Then we need to create database for manila. It can"},{"line_number":92,"context_line":"be performed with following operation::"},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"    $ manila-manage db sync"},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"It will create database \u0027manila\u0027 and all required tables in it."},{"line_number":97,"context_line":"Here is list of tables for Kilo version of Manila::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_ca826d00","line":94,"updated":"2015-04-03 11:45:30.000000000","message":"Before this step, admin should: \n\n1. create a empty database in mysql\n\n2. configure mysql information in manila.conf\n\nRight ?","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"848f7476f74f7802de90ba44b6b53327bcfceba6","unresolved":false,"context_lines":[{"line_number":91,"context_line":"in our case it was MySQL. Then we need to create database for manila. It can"},{"line_number":92,"context_line":"be performed with following operation::"},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"    $ manila-manage db sync"},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"It will create database \u0027manila\u0027 and all required tables in it."},{"line_number":97,"context_line":"Here is list of tables for Kilo version of Manila::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_3e1eb763","line":94,"in_reply_to":"baa041b7_ca826d00","updated":"2015-04-03 12:55:21.000000000","message":"Right. Done","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"d954a7dc13d53981caad6d29b0a32d35c14fb2ec","unresolved":false,"context_lines":[{"line_number":93,"context_line":""},{"line_number":94,"context_line":"    $ manila-manage db sync"},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"It will create database \u0027manila\u0027 and all required tables in it."},{"line_number":97,"context_line":"Here is list of tables for Kilo version of Manila::"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"    +--------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_cab02de0","line":96,"updated":"2015-04-03 11:45:30.000000000","message":"I think  \"db sync\" would not create database.\n\nIt only create tables based on the database configuration in manila.conf","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"848f7476f74f7802de90ba44b6b53327bcfceba6","unresolved":false,"context_lines":[{"line_number":93,"context_line":""},{"line_number":94,"context_line":"    $ manila-manage db sync"},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"It will create database \u0027manila\u0027 and all required tables in it."},{"line_number":97,"context_line":"Here is list of tables for Kilo version of Manila::"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"    +--------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_1e19b379","line":96,"in_reply_to":"baa041b7_cab02de0","updated":"2015-04-03 12:55:21.000000000","message":"Done","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"d954a7dc13d53981caad6d29b0a32d35c14fb2ec","unresolved":false,"context_lines":[{"line_number":207,"context_line":""},{"line_number":208,"context_line":"    ‘%git_dir%/etc/manila/manila.conf.sample’"},{"line_number":209,"context_line":""},{"line_number":210,"context_line":"Copy it to the same dir as above files removing suffix ‘.sample’ from its name."},{"line_number":211,"context_line":""},{"line_number":212,"context_line":""},{"line_number":213,"context_line":"Basic configuration of Manila"}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_ed7c2bed","line":210,"updated":"2015-04-03 11:45:30.000000000","message":"This part should be done before create database.","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"848f7476f74f7802de90ba44b6b53327bcfceba6","unresolved":false,"context_lines":[{"line_number":207,"context_line":""},{"line_number":208,"context_line":"    ‘%git_dir%/etc/manila/manila.conf.sample’"},{"line_number":209,"context_line":""},{"line_number":210,"context_line":"Copy it to the same dir as above files removing suffix ‘.sample’ from its name."},{"line_number":211,"context_line":""},{"line_number":212,"context_line":""},{"line_number":213,"context_line":"Basic configuration of Manila"}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_50abaa1d","line":210,"in_reply_to":"baa041b7_ed7c2bed","updated":"2015-04-03 12:55:21.000000000","message":"Done","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"d954a7dc13d53981caad6d29b0a32d35c14fb2ec","unresolved":false,"context_lines":[{"line_number":227,"context_line":"    [DATABASE]"},{"line_number":228,"context_line":"    # Set up MySQL connection. In following  ‘foo’ is username,"},{"line_number":229,"context_line":"    # ‘bar’ is password and ‘quuz’ is host name or address:"},{"line_number":230,"context_line":"    connection \u003d mysql://foo:bar@quuz/manila?charset\u003dutf8"},{"line_number":231,"context_line":""},{"line_number":232,"context_line":"    [oslo_concurrency]"},{"line_number":233,"context_line":"    # Following opt defines directory to be used for lock files creation."}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_ed630b40","line":230,"updated":"2015-04-03 11:45:30.000000000","message":"database should be configured before tables creation for manila.","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"848f7476f74f7802de90ba44b6b53327bcfceba6","unresolved":false,"context_lines":[{"line_number":227,"context_line":"    [DATABASE]"},{"line_number":228,"context_line":"    # Set up MySQL connection. In following  ‘foo’ is username,"},{"line_number":229,"context_line":"    # ‘bar’ is password and ‘quuz’ is host name or address:"},{"line_number":230,"context_line":"    connection \u003d mysql://foo:bar@quuz/manila?charset\u003dutf8"},{"line_number":231,"context_line":""},{"line_number":232,"context_line":"    [oslo_concurrency]"},{"line_number":233,"context_line":"    # Following opt defines directory to be used for lock files creation."}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_f0663e28","line":230,"in_reply_to":"baa041b7_ed630b40","updated":"2015-04-03 12:55:21.000000000","message":"Done","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"d954a7dc13d53981caad6d29b0a32d35c14fb2ec","unresolved":false,"context_lines":[{"line_number":405,"context_line":""},{"line_number":406,"context_line":".. note::"},{"line_number":407,"context_line":"    Some configurations of Generic driver may require this network be attached"},{"line_number":408,"context_line":"    to public router."},{"line_number":409,"context_line":""},{"line_number":410,"context_line":"Then add them to share-network::"},{"line_number":411,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_cd35e746","line":408,"updated":"2015-04-03 11:45:30.000000000","message":"A public router is required for default.","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"848f7476f74f7802de90ba44b6b53327bcfceba6","unresolved":false,"context_lines":[{"line_number":405,"context_line":""},{"line_number":406,"context_line":".. note::"},{"line_number":407,"context_line":"    Some configurations of Generic driver may require this network be attached"},{"line_number":408,"context_line":"    to public router."},{"line_number":409,"context_line":""},{"line_number":410,"context_line":"Then add them to share-network::"},{"line_number":411,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"baa041b7_307dc6b1","line":408,"in_reply_to":"baa041b7_cd35e746","updated":"2015-04-03 12:55:21.000000000","message":"Done","commit_id":"cf1b447927679ba06dfb6677411f66a8dfe3496e"},{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"ee27811a6a909a943f721cd1d5ffd99e5eb15c6d","unresolved":false,"context_lines":[{"line_number":1,"context_line":".."},{"line_number":2,"context_line":"      Licensed under the Apache License, Version 2.0 (the \"License\"); you may"},{"line_number":3,"context_line":"      not use this file except in compliance with the License. You may obtain"},{"line_number":4,"context_line":"      a copy of the License at"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_605ec377","line":1,"updated":"2015-04-05 03:25:27.000000000","message":"..\n      Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n      not use this file except in compliance with the License. You may obtain\n      a copy of the License at\n\n          http://www.apache.org/licenses/LICENSE-2.0\n\n      Unless required by applicable law or agreed to in writing, software\n      distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\n      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the\n      License for the specific language governing permissions and limitations\n      under the License.\n\nManila installation\n\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\nThis document describes how to install Manila from the OpenStack \u0027Kilo\u0027\nrelease. Note that the process differs from previous releases and is likely to\nchange again in subsequent releases.\n\nManila consists of three main services, which are similar to those of the\nOpenStack Cinder project.\n\n- manila-api\n- manila-scheduler\n- manila-share\n\nInstallation of \u0027manila-api\u0027 and \u0027manila-scheduler\u0027 is common to nearly all\ndeployments. But configuration of \u0027manila-share\u0027 is backend-specific and can\ndiffer between deployments. This document covers a single use case, that of\nManila\u0027s \"Generic\" driver which uses Cinder as its backend.\n\nNote that the \u0027manila-share\u0027 service can run in two modes, with and without\nhandling of \u0027share servers\u0027.  In most cases share servers are virtual machines\nthat export file shares via various network file systems. The example in this\ndocument describes a backend that manages share servers using network resources\nprovided by Neutron.\n\n.. note::\n    Manila supports any network architecture. When a driver is managing its own\n    share servers, it can use any of several network plug-ins that provide\n    network resources. Manila includes plug-ins for Neutron and Nova-network,\n    as well as a \u0027StandaloneNetworkPlugin\u0027 for simple networks. When a driver\n    is not managing share servers, it has no need for network plug-ins.\n\nPrerequisites\n-------------\n- Ubuntu 14.04\n- MySQL database\n- RabbitMQ message bus\n- OpenStack Keystone\n- Git\n\nSteps to perform\n\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\n- Installation of Manila binaries\n- Installation of Manila client\n- Registration in Keystone\n- Preparation of external files (configs, etc...)\n- Basic configuration of Manila\n- Database setup\n- Running Manila services\n- Creation of pilot share\n\nInstallation of Manila binaries\n-------------------------------\nManila binaries may be installed using various distribution packages or from\nsource code. In our case we will use the latter, installation by cloning a git\nrepository.\n\nClone repo::\n\n    $ git clone https://github.com/openstack/manila\n    $ git checkout stable/kilo\n\nThen run the installation script::\n\n    $ sudo python setup.py install\n\nIt will install the manila binaries and their dependencies.\nThese are the expected binaries:\n\n- manila-all\n- manila-api\n- manila-manage\n- manila-scheduler\n- manila-share\n\nInstallation of Manila client\n-----------------------------\n\nTo send requests to manila we need to install the manila client.\n\nPull it from its git repo and install::\n\n    $ git clone https://github.com/openstack/python-manilaclient\n    $ cd python-manilaclient\n    $ sudo python setup.py install\n\nOR use PIP::\n\n    $ sudo pip install python-manilaclient\n\n.. note::\n    The starting version of the manila client for Kilo release is 1.0.3\n\nThe above will install the \u0027manila\u0027 binary that will be used for issuing\nmanila requests.\n\nRegistration in Keystone\n------------------------\n\nLike all other OpenStack projects, manila should be registered with Keystone.\nHere are the registration steps, similar to those of Cinder:\n\n1) Create Manila service user::\n\n    $ keystone user-create --name manila --pass %PASSWORD%\n\n2) Add the admin role to the manila user::\n\n    $ keystone user-role-add --user manila --tenant service --role admin\n\n.. note::\n    Tenant/project may differ, but it should be the same as for all other\n    service users such as ‘cinder’, ‘nova’, etc.\n\n3) Create the manila service entities::\n\n    $ keystone service-create \\\n        --name manila \\\n        --type share \\\n        --description \"OpenStack Shared Filesystems\"\n\n\nResult::\n\n    +-------------+----------------------------------+\n    |   Property  |              Value               |\n    +-------------+----------------------------------+\n    | description |   OpenStack Shared Filesystems   |\n    |   enabled   |               True               |\n    |      id     | 4c13e9ff7ec04f4e95a26f72ecdf9919 |\n    |     name    |              manila              |\n    |     type    |              share               |\n    +-------------+----------------------------------+\n\n\n4) Create the Share Filesystems service API endpoints::\n\n    $ keystone endpoint-create \\\n        --service-id $(keystone service-list | awk \u0027/ share / {print $2}\u0027) \\\n        --publicurl http://controller:8786/v1/%\\(tenant_id\\)s \\\n        --internalurl http://controller:8786/v1/%\\(tenant_id\\)s \\\n        --adminurl http://controller:8786/v1/%\\(tenant_id\\)s \\\n        --region regionOne\n\nResult::\n\n    +-------------+-----------------------------------------+\n    |   Property  |                  Value                  |\n    +-------------+-----------------------------------------+\n    |   adminurl  | http://controller:8786/v1/%(tenant_id)s |\n    |      id     |    c1984777db6941919657d15b25f05c94     |\n    | internalurl | http://controller:8786/v1/%(tenant_id)s |\n    |  publicurl  | http://controller:8786/v1/%(tenant_id)s |\n    |    region   |                regionOne                |\n    |  service_id |    4c13e9ff7ec04f4e95a26f72ecdf9919     |\n    +-------------+-----------------------------------------+\n\n.. note::\n    Port ‘8786’ is the default port for Manila. It may be changed to any\n    other port, and this change should also be made in the manila configuration\n    file using option ‘osapi_share_listen_port’ which defaults to ‘8786’.\n\nPreparation of external files\n-----------------------------\nCopy files from https://github.com/openstack/manila/tree/master/etc/manila\nto dir ‘/etc/manila’::\n\n    policy.json\n    api-paste.ini\n    rootwrap.conf\n    rootwrap.d/share.filters\n\n\nThen generate a config sample file using tox::\n\n    $ tox -e genconfig\n\nThis will create a file with the latest config options and their descriptions::\n\n    ‘%git_dir%/etc/manila/manila.conf.sample’\n\nCopy this file to the same directory as the above files, removing the suffix\n‘.sample’ from its name.\n\n\nBasic configuration of Manila\n-----------------------------\nIn our case we will set up one backend with the generic driver (using Cinder\nas its backend) configured to manage its own share servers::\n\n    [keystone_authtoken]\n    signing_dir \u003d /var/cache/manila\n    admin_password \u003d %password_we_used_with_user_creation_operation%\n    admin_user \u003d manila\n    admin_tenant_name \u003d %service_project_name_we_used_with_user_creation_operation%\n    auth_protocol \u003d http\n    auth_port \u003d 35357\n    auth_host \u003d %address_of_machine_with_keystone_endpoint%\n\n    [DATABASE]\n    # Set up MySQL connection. In following  ‘foo’ is username,\n    # ‘bar’ is password and ‘quuz’ is host name or address:\n    connection \u003d mysql://foo:bar@quuz/manila?charset\u003dutf8\n\n    [oslo_concurrency]\n    # Following opt defines directory to be used for lock files creation.\n    # Should be owned by user that runs manila-share processes.\n    # Defaults to env var ‘OSLO_LOCK_PATH’. It is used by manila-share services\n    # and is required to be set up. Make sure this dir is created and owned\n    # by user that run manila-share services.\n    lock_path \u003d /etc/manila/custom_manila_lock_path\n\n    [DEFAULT]\n    # Set pretty logging output\n    logging_exception_prefix \u003d %(color)s%(asctime)s.%(msecs)d TRACE %(name)s ^[[01;35m%(instance)s^[[00m\n    logging_debug_format_suffix \u003d ^[[00;33mfrom (pid\u003d%(process)d) %(funcName)s %(pathname)s:%(lineno)d^[[00m\n    logging_default_format_string \u003d %(asctime)s.%(msecs)d %(color)s%(levelname)s %(name)s [^[[00;36m-%(color)s] ^[[01;35m%(instance)s%(color)s%(message)s^[[00m\n    logging_context_format_string \u003d %(asctime)s.%(msecs)d %(color)s%(levelname)s %(name)s [^[[01;36m%(request_id)s ^[[00;36m%(user_id)s %(project_id)s%(color)s] ^[[01;35m%(instance)s%(color)s%(message)s^[[00m\n\n    # Set auth strategy for usage of Keystone\n    auth_strategy \u003d keystone\n\n    # Set message bus creds\n    rabbit_userid \u003d %rabbit_username%\n    rabbit_password \u003d %rabbit_user_password%\n    rabbit_hosts \u003d %address_of_machine_with_rabbit%\n    rpc_backend \u003d rabbit\n\n    # Following opt is used for definition of share backends that should be enabled.\n    # Values are conf groupnames that contain per manila-share service opts.\n    enabled_share_backends \u003d london\n\n    # Enable protocols ‘NFS’ and ‘CIFS’ as those are the only supported\n    # by Generic driver that we are configuring in this set up.\n    # All available values are (‘NFS’, ‘CIFS’, ‘GlusterFS’, ‘HDFS’)\n    enabled_share_protocols \u003d NFS,CIFS\n\n    # Following is password for user ‘neutron’ for interaction with Neutron.\n    # It is required only when Neutron is set up in lab, and handling of\n    # share servers is used within configured share drivers.\n    neutron_admin_password \u003d %password%\n\n    # Following is password for user ‘cinder’ for interaction with Cinder service.\n    # used only by Generic driver.\n    cinder_admin_password \u003d %password%\n\n    # Following is password for user ‘nova’ for interaction with Nova service.\n    # used only by Generic driver for the moment.\n    nova_admin_password \u003d %password%\n\n    # Manila requires ‘share-type’ for share creation.\n    # So, set here name of some share-type that will be used by default.\n    default_share_type \u003d default_share_type\n\n    state_path \u003d /opt/stack/data/manila\n    osapi_share_extension \u003d manila.api.contrib.standard_extensions\n    rootwrap_config \u003d /etc/manila/rootwrap.conf\n    api_paste_config \u003d /etc/manila/api-paste.ini\n    share_name_template \u003d share-%s\n\n    # Set scheduler driver with usage of filters. Recommended.\n    scheduler_driver \u003d manila.scheduler.filter_scheduler.FilterScheduler\n\n    # Set following two opts to ‘True’ to get maximum info in logging\n    verbose \u003d True\n    debug \u003d True\n\n    [london]\n    # This is custom opt group that is used for storing opts of share-service.\n    # This one is used only when enabled using opt \u0027enabled_share_backends\u0027\n    # from DEFAULT group.\n\n    # Set usage of Generic driver which uses Cinder as backend.\n    share_driver \u003d manila.share.drivers.generic.GenericShareDriver\n\n    # Generic driver supports both driver modes - with and without handling\n    # of share servers. So, we need to define explicitly which one we are\n    # enabling using this driver.\n    driver_handles_share_servers \u003d True\n\n    # Generic driver is the only driver that uses image from Glance for building\n    # service VMs in Nova. And following are data for some specific image.\n    # We used one defined in [1]\n    # [1] https://github.com/openstack/manila/blob/6785cad9/devstack/plugin.sh#L86\n    service_instance_password \u003d ubuntu\n    service_instance_user \u003d ubuntu\n    service_image_name \u003d ubuntu_1204_nfs_cifs\n\n    path_to_private_key \u003d /home/stack/.ssh/id_rsa\n    path_to_public_key \u003d /home/stack/.ssh/id_rsa.pub\n\n    # Custom name for share backend.\n    share_backend_name \u003d LONDON\n\n.. note::\n    The Generic driver does not use network plugins, so none is part of the\n    above configuration. Other drivers that manage their own share servers may\n    require one of Manila\u0027s network plug-ins.\n\nDatabase setup\n--------------\nManila supports different SQL dialects in theory, but it is only tested with\nMySQL, so this step assumes that MySQL has been installed.\n\nCreate the database for manila::\n\n    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"DROP DATABASE IF EXISTS manila;\"\n    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"CREATE DATABASE manila CHARACTER SET utf8;\"\n\nThen create manila\u0027s tables and apply all migrations::\n\n    $ manila-manage db sync\n\nHere is the list of tables for the Kilo release of Manila::\n\n    +--------------------------------------------+\n    | Tables_in_manila                           |\n    +--------------------------------------------+\n    | alembic_version                            |\n    | network_allocations                        |\n    | project_user_quotas                        |\n    | quota_classes                              |\n    | quota_usages                               |\n    | quotas                                     |\n    | reservations                               |\n    | security_services                          |\n    | services                                   |\n    | share_access_map                           |\n    | share_export_locations                     |\n    | share_metadata                             |\n    | share_network_security_service_association |\n    | share_networks                             |\n    | share_server_backend_details               |\n    | share_servers                              |\n    | share_snapshots                            |\n    | share_type_extra_specs                     |\n    | share_type_projects                        |\n    | share_types                                |\n    | shares                                     |\n    +--------------------------------------------+\n\nRunning Manila services\n-----------------------\n\nRun manila-api first::\n\n    $ /opt/stack/manila/bin/manila-api \\\n        --config-file /etc/manila/manila.conf \u0026 \\\n        echo $! \u003e/opt/stack/status/stack/m-api.pid; \\\n        fg || echo \"m-api failed to start\" | \\\n        tee \"/opt/stack/status/stack/m-api.failure\"\n\nCreate a default share type before running \u0027manila-share\u0027 service::\n\n    $ manila type-create default_share_type True\n\nResult::\n\n    +-----------+--------------------+------------+------------+-------------------------------------+\n    | ID        | Name               | Visibility | is_default | required_extra_specs                |\n    +-----------+--------------------+------------+------------+-------------------------------------+\n    | %some_id% | default_share_type | public     | -          | driver_handles_share_servers : True |\n    +-----------+--------------------+------------+------------+-------------------------------------+\n\nRestart manila-api service and get the list of share types::\n\n    $ manila type-list\n\nResult::\n\n    +-----------+----------------------------+------------+------------+--------------------------------------+\n    | ID        | Name                       | Visibility | is_default | required_extra_specs                 |\n    +-----------+----------------------------+------------+------------+--------------------------------------+\n    | %some_id% | default_share_type         | public     | YES        | driver_handles_share_servers : True  |\n    +-----------+----------------------------+------------+------------+--------------------------------------+\n\n\nAdd any additional extra specs to \u0027share-type\u0027 if needed using following command::\n\n    $ manila type-key default_share_type set key\u003dvalue\n\nThis may be viewed as follows::\n\n    $ manila extra-specs-list\n\nRun manila-scheduler::\n\n    $ /opt/stack/manila/bin/manila-scheduler \\\n        --config-file /etc/manila/manila.conf \u0026 \\\n        echo $! \u003e/opt/stack/status/stack/m-sch.pid; \\\n        fg || echo \"m-sch failed to start\" | \\\n        tee \"/opt/stack/status/stack/m-sch.failure\"\n\nRun manila-share::\n\n    $ /opt/stack/manila/bin/manila-share \\\n        --config-file /etc/manila/manila.conf \u0026 \\\n        echo $! \u003e/opt/stack/status/stack/m-shr.pid; \\\n        fg || echo \"m-shr failed to start\" | \\\n        tee \"/opt/stack/status/stack/m-shr.failure\"\n\nCreation of pilot share\n-----------------------\n\nIn this step we assume that the following services are running:\n\n- Keystone\n- Nova (used by Generic driver, not a strict dependency of Manila)\n- Neutron (default network backend for Generic driver, used when driver handles share servers)\n- Cinder (used by Generic driver)\n\nTo operate a driver that handles share servers, we must create a \u0027share\nnetwork\u0027, which is a set of network information that will be used during share\nserver creation. In our example, to use Neutron, we will do the following::\n\n    $ neutron net-list\n\nHere we note the ID of a Neutron network and one of its subnets.\n\n.. note::\n    Some configurations of the Generic driver may require this network be\n    attached to a public router. It is so by default. So, if you use the\n    default configuration of Generic driver, make sure the network is attached\n    to a public router.\n\nThen define a share network using the Neutron network and subnet IDs::\n\n    $ manila share-network-create \\\n        --name test_share_network \\\n        --neutron-network %id_of_neutron_network% \\\n        --neutron-subnet %id_of_network_subnet%\n\nNow we can create a share using the following command::\n\n    $ manila create NFS 1 --name testshare --share-network test_share_network\n\nThe above command will instruct Manila to schedule a share for creation. Once\ncreated, configure user access to the new share before attempting to mount it\nvia the network.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":1,"context_line":".."},{"line_number":2,"context_line":"      Licensed under the Apache License, Version 2.0 (the \"License\"); you may"},{"line_number":3,"context_line":"      not use this file except in compliance with the License. You may obtain"},{"line_number":4,"context_line":"      a copy of the License at"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_09516362","line":1,"in_reply_to":"baa041b7_605ec377","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":23,"context_line":"- manila-share"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"They are similar to services of Cinder project."},{"line_number":26,"context_line":"Installation of first two - \u0027manila-api\u0027 and \u0027manila-scheduler\u0027 is common"},{"line_number":27,"context_line":"almost for all deployments. But configuration of \u0027manila-share\u0027 is"},{"line_number":28,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":29,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_e9351fda","line":26,"updated":"2015-04-05 10:17:35.000000000","message":"I guess you wanted to use backticks for formatting the service names?","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":23,"context_line":"- manila-share"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"They are similar to services of Cinder project."},{"line_number":26,"context_line":"Installation of first two - \u0027manila-api\u0027 and \u0027manila-scheduler\u0027 is common"},{"line_number":27,"context_line":"almost for all deployments. But configuration of \u0027manila-share\u0027 is"},{"line_number":28,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":29,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_29dd47e0","line":26,"in_reply_to":"baa041b7_e9351fda","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":88,"context_line":"Installation of Manila client"},{"line_number":89,"context_line":"-----------------------------"},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"To be able to perform requests to manila we need to install client."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"Pull it from git repo and install::"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c9193b7b","line":91,"updated":"2015-04-05 10:17:35.000000000","message":"s/manila/Manila/","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":88,"context_line":"Installation of Manila client"},{"line_number":89,"context_line":"-----------------------------"},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"To be able to perform requests to manila we need to install client."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"Pull it from git repo and install::"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_09d843ee","line":91,"in_reply_to":"baa041b7_c9193b7b","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":96,"context_line":"    $ cd python-manilaclient"},{"line_number":97,"context_line":"    $ sudo python setup.py install"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"OR using PIP::"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"    $ sudo pip install python-manilaclient"},{"line_number":102,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_e94cff71","line":99,"updated":"2015-04-05 10:17:35.000000000","message":"s/OR/Or/","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":96,"context_line":"    $ cd python-manilaclient"},{"line_number":97,"context_line":"    $ sudo python setup.py install"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"OR using PIP::"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"    $ sudo pip install python-manilaclient"},{"line_number":102,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_e9e63fb3","line":99,"in_reply_to":"baa041b7_e94cff71","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":103,"context_line":".. note::"},{"line_number":104,"context_line":"    Start version of manila client for Kilo release is 1.0.3"},{"line_number":105,"context_line":""},{"line_number":106,"context_line":"It will install \u0027manila\u0027 binary that will be used for requests for manila."},{"line_number":107,"context_line":""},{"line_number":108,"context_line":"Registration in Keystone"},{"line_number":109,"context_line":"------------------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c947fb49","line":106,"updated":"2015-04-05 10:17:35.000000000","message":"s/for manila/for Manila/","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":103,"context_line":".. note::"},{"line_number":104,"context_line":"    Start version of manila client for Kilo release is 1.0.3"},{"line_number":105,"context_line":""},{"line_number":106,"context_line":"It will install \u0027manila\u0027 binary that will be used for requests for manila."},{"line_number":107,"context_line":""},{"line_number":108,"context_line":"Registration in Keystone"},{"line_number":109,"context_line":"------------------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c9e13b9c","line":106,"in_reply_to":"baa041b7_c947fb49","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":173,"context_line":""},{"line_number":174,"context_line":"Preparation of external files"},{"line_number":175,"context_line":"-----------------------------"},{"line_number":176,"context_line":"Copy files from https://github.com/openstack/manila/tree/master/etc/manila"},{"line_number":177,"context_line":"to dir ‘/etc/manila’::"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"    policy.json"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_a975d798","line":176,"updated":"2015-04-05 10:17:35.000000000","message":"Here we should use the files from the git clone. So %git_dir%","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":173,"context_line":""},{"line_number":174,"context_line":"Preparation of external files"},{"line_number":175,"context_line":"-----------------------------"},{"line_number":176,"context_line":"Copy files from https://github.com/openstack/manila/tree/master/etc/manila"},{"line_number":177,"context_line":"to dir ‘/etc/manila’::"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"    policy.json"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_a9ef1786","line":176,"in_reply_to":"baa041b7_a975d798","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":190,"context_line":""},{"line_number":191,"context_line":"    ‘%git_dir%/etc/manila/manila.conf.sample’"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"Copy it to the same dir as above files removing suffix ‘.sample’ from its name."},{"line_number":194,"context_line":""},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"Basic configuration of Manila"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_8978d390","line":193,"updated":"2015-04-05 10:17:35.000000000","message":"Just add the command:\ncp %git_dir%/etc/manila/manila.conf.sample /etc/manila/manila.conf","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":190,"context_line":""},{"line_number":191,"context_line":"    ‘%git_dir%/etc/manila/manila.conf.sample’"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"Copy it to the same dir as above files removing suffix ‘.sample’ from its name."},{"line_number":194,"context_line":""},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"Basic configuration of Manila"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_69e90f80","line":193,"in_reply_to":"baa041b7_8978d390","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":196,"context_line":"Basic configuration of Manila"},{"line_number":197,"context_line":"-----------------------------"},{"line_number":198,"context_line":"In our case we will set up one backend with generic driver (Cinder as backend)"},{"line_number":199,"context_line":"in mode with handling of share servers::"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"    [keystone_authtoken]"},{"line_number":202,"context_line":"    signing_dir \u003d /var/cache/manila"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_696fcfc5","line":199,"updated":"2015-04-05 10:17:35.000000000","message":"Mention that this should be done in `/etc/manila/manila.conf`","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":196,"context_line":"Basic configuration of Manila"},{"line_number":197,"context_line":"-----------------------------"},{"line_number":198,"context_line":"In our case we will set up one backend with generic driver (Cinder as backend)"},{"line_number":199,"context_line":"in mode with handling of share servers::"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"    [keystone_authtoken]"},{"line_number":202,"context_line":"    signing_dir \u003d /var/cache/manila"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_09ff2335","line":199,"in_reply_to":"baa041b7_696fcfc5","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":221,"context_line":"    lock_path \u003d /etc/manila/custom_manila_lock_path"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"    [DEFAULT]"},{"line_number":224,"context_line":"    # Set pretty logging output"},{"line_number":225,"context_line":"    logging_exception_prefix \u003d %(color)s%(asctime)s.%(msecs)d TRACE %(name)s ^[[01;35m%(instance)s^[[00m"},{"line_number":226,"context_line":"    logging_debug_format_suffix \u003d ^[[00;33mfrom (pid\u003d%(process)d) %(funcName)s %(pathname)s:%(lineno)d^[[00m"},{"line_number":227,"context_line":"    logging_default_format_string \u003d %(asctime)s.%(msecs)d %(color)s%(levelname)s %(name)s [^[[00;36m-%(color)s] ^[[01;35m%(instance)s%(color)s%(message)s^[[00m"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_69210f9f","line":224,"updated":"2015-04-05 10:17:35.000000000","message":"I think it\u0027s not needed to customize the logging output in this example","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":221,"context_line":"    lock_path \u003d /etc/manila/custom_manila_lock_path"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"    [DEFAULT]"},{"line_number":224,"context_line":"    # Set pretty logging output"},{"line_number":225,"context_line":"    logging_exception_prefix \u003d %(color)s%(asctime)s.%(msecs)d TRACE %(name)s ^[[01;35m%(instance)s^[[00m"},{"line_number":226,"context_line":"    logging_debug_format_suffix \u003d ^[[00;33mfrom (pid\u003d%(process)d) %(funcName)s %(pathname)s:%(lineno)d^[[00m"},{"line_number":227,"context_line":"    logging_default_format_string \u003d %(asctime)s.%(msecs)d %(color)s%(levelname)s %(name)s [^[[00;36m-%(color)s] ^[[01;35m%(instance)s%(color)s%(message)s^[[00m"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_a996f7ed","line":224,"in_reply_to":"baa041b7_69210f9f","updated":"2015-04-05 13:34:52.000000000","message":"Then where admin should take \u0027pretty\u0027 variant of logging output? I leave it here as harmless.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":271,"context_line":"    # Set scheduler driver with usage of filters. Recommended."},{"line_number":272,"context_line":"    scheduler_driver \u003d manila.scheduler.filter_scheduler.FilterScheduler"},{"line_number":273,"context_line":""},{"line_number":274,"context_line":"    # Set following two opts to ‘True’ to get maximum info in logging"},{"line_number":275,"context_line":"    verbose \u003d True"},{"line_number":276,"context_line":"    debug \u003d True"},{"line_number":277,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_49240bae","line":274,"updated":"2015-04-05 10:17:35.000000000","message":"Not needed in example","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":271,"context_line":"    # Set scheduler driver with usage of filters. Recommended."},{"line_number":272,"context_line":"    scheduler_driver \u003d manila.scheduler.filter_scheduler.FilterScheduler"},{"line_number":273,"context_line":""},{"line_number":274,"context_line":"    # Set following two opts to ‘True’ to get maximum info in logging"},{"line_number":275,"context_line":"    verbose \u003d True"},{"line_number":276,"context_line":"    debug \u003d True"},{"line_number":277,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_098603b9","line":274,"in_reply_to":"baa041b7_49240bae","updated":"2015-04-05 13:34:52.000000000","message":"These are not required, yes. But admin may start looking for such options intentionally before \u0027playing\u0027 with Manila. So, I leave it here.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":294,"context_line":"    # [1] https://github.com/openstack/manila/blob/6785cad9/devstack/plugin.sh#L86"},{"line_number":295,"context_line":"    service_instance_password \u003d ubuntu"},{"line_number":296,"context_line":"    service_instance_user \u003d ubuntu"},{"line_number":297,"context_line":"    service_image_name \u003d ubuntu_1204_nfs_cifs"},{"line_number":298,"context_line":""},{"line_number":299,"context_line":"    path_to_private_key \u003d /home/stack/.ssh/id_rsa"},{"line_number":300,"context_line":"    path_to_public_key \u003d /home/stack/.ssh/id_rsa.pub"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_296ae7b3","line":297,"updated":"2015-04-05 10:17:35.000000000","message":"Should be somewhere mentioned that a service image is needed for the generic driver.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":294,"context_line":"    # [1] https://github.com/openstack/manila/blob/6785cad9/devstack/plugin.sh#L86"},{"line_number":295,"context_line":"    service_instance_password \u003d ubuntu"},{"line_number":296,"context_line":"    service_instance_user \u003d ubuntu"},{"line_number":297,"context_line":"    service_image_name \u003d ubuntu_1204_nfs_cifs"},{"line_number":298,"context_line":""},{"line_number":299,"context_line":"    path_to_private_key \u003d /home/stack/.ssh/id_rsa"},{"line_number":300,"context_line":"    path_to_public_key \u003d /home/stack/.ssh/id_rsa.pub"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c98ffbca","line":297,"in_reply_to":"baa041b7_296ae7b3","updated":"2015-04-05 13:34:52.000000000","message":"Lines 291-294?","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":311,"context_line":"-----------"},{"line_number":312,"context_line":"Manila supports different SQL dialects in theory, but tested well only on MySQL"},{"line_number":313,"context_line":"backend. So, on this step it is assumed that SQL DB backend is installed,"},{"line_number":314,"context_line":"in our case it was MySQL."},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"Then we need to create database for manila::"},{"line_number":317,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_e963dfda","line":314,"updated":"2015-04-05 10:17:35.000000000","message":"s/was/is/","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":311,"context_line":"-----------"},{"line_number":312,"context_line":"Manila supports different SQL dialects in theory, but tested well only on MySQL"},{"line_number":313,"context_line":"backend. So, on this step it is assumed that SQL DB backend is installed,"},{"line_number":314,"context_line":"in our case it was MySQL."},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"Then we need to create database for manila::"},{"line_number":317,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_49bacb6f","line":314,"in_reply_to":"baa041b7_e963dfda","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":313,"context_line":"backend. So, on this step it is assumed that SQL DB backend is installed,"},{"line_number":314,"context_line":"in our case it was MySQL."},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"Then we need to create database for manila::"},{"line_number":317,"context_line":""},{"line_number":318,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"DROP DATABASE IF EXISTS manila;\""},{"line_number":319,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"CREATE DATABASE manila CHARACTER SET utf8;\""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_0965e3df","line":316,"updated":"2015-04-05 10:17:35.000000000","message":"s/manila/Manila/","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":313,"context_line":"backend. So, on this step it is assumed that SQL DB backend is installed,"},{"line_number":314,"context_line":"in our case it was MySQL."},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"Then we need to create database for manila::"},{"line_number":317,"context_line":""},{"line_number":318,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"DROP DATABASE IF EXISTS manila;\""},{"line_number":319,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"CREATE DATABASE manila CHARACTER SET utf8;\""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_69b7cf86","line":316,"in_reply_to":"baa041b7_0965e3df","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":318,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"DROP DATABASE IF EXISTS manila;\""},{"line_number":319,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"CREATE DATABASE manila CHARACTER SET utf8;\""},{"line_number":320,"context_line":""},{"line_number":321,"context_line":"Then create manila tables and apply all migrations::"},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"    $ manila-manage db sync"},{"line_number":324,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c95edb11","line":321,"updated":"2015-04-05 10:17:35.000000000","message":"s/manila/Manila/","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":318,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"DROP DATABASE IF EXISTS manila;\""},{"line_number":319,"context_line":"    $ mysql -u%DATABASE_USER% -p%DATABASE_PASSWORD% -h%MYSQL_HOST% -e \"CREATE DATABASE manila CHARACTER SET utf8;\""},{"line_number":320,"context_line":""},{"line_number":321,"context_line":"Then create manila tables and apply all migrations::"},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"    $ manila-manage db sync"},{"line_number":324,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_29b2e794","line":321,"in_reply_to":"baa041b7_c95edb11","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":355,"context_line":""},{"line_number":356,"context_line":"Run manila-api first::"},{"line_number":357,"context_line":""},{"line_number":358,"context_line":"    $ /opt/stack/manila/bin/manila-api \\"},{"line_number":359,"context_line":"        --config-file /etc/manila/manila.conf \u0026 \\"},{"line_number":360,"context_line":"        echo $! \u003e/opt/stack/status/stack/m-api.pid; \\"},{"line_number":361,"context_line":"        fg || echo \"m-api failed to start\" | \\"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_a99cb7c0","line":358,"updated":"2015-04-05 10:17:35.000000000","message":"Following this guide the binaries are not installed into `/opt/stack`. So I would just remove the whole `/opt/stack/manila/bin/`","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":355,"context_line":""},{"line_number":356,"context_line":"Run manila-api first::"},{"line_number":357,"context_line":""},{"line_number":358,"context_line":"    $ /opt/stack/manila/bin/manila-api \\"},{"line_number":359,"context_line":"        --config-file /etc/manila/manila.conf \u0026 \\"},{"line_number":360,"context_line":"        echo $! \u003e/opt/stack/status/stack/m-api.pid; \\"},{"line_number":361,"context_line":"        fg || echo \"m-api failed to start\" | \\"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_e9abdf1b","line":358,"in_reply_to":"baa041b7_a99cb7c0","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"3e4fd88203eb5743663dd4be8301254da9d5064d","unresolved":false,"context_lines":[{"line_number":363,"context_line":""},{"line_number":364,"context_line":"Create share type we set as default before running \u0027manila-share\u0027 service::"},{"line_number":365,"context_line":""},{"line_number":366,"context_line":"    $ manila type-create default_share_type True"},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Result::"},{"line_number":369,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c9b5bb31","line":366,"updated":"2015-04-05 10:26:12.000000000","message":"The \"True\" at the end of  command \"manila type-create\" is indicating  \"driver_handles_share_servers \u003d True\", right ?\n\nBut this paragraph makes the \"True\" looks like indicating the share-type we create is \"default\".\n\nAs admin may not have enough knowledge about the inside of Manila, I think here we should better create 2 share-types, while 1 is default and another is non-default. Or, just explain the command explicitly for this part.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":363,"context_line":""},{"line_number":364,"context_line":"Create share type we set as default before running \u0027manila-share\u0027 service::"},{"line_number":365,"context_line":""},{"line_number":366,"context_line":"    $ manila type-create default_share_type True"},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"Result::"},{"line_number":369,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_894e9394","line":366,"in_reply_to":"baa041b7_c9b5bb31","updated":"2015-04-05 13:34:52.000000000","message":"Added description for parameters.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"3e4fd88203eb5743663dd4be8301254da9d5064d","unresolved":false,"context_lines":[{"line_number":373,"context_line":"    | %some_id% | default_share_type | public     | -          | driver_handles_share_servers : True |"},{"line_number":374,"context_line":"    +-----------+--------------------+------------+------------+-------------------------------------+"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Restart manila-api service and get list of share types::"},{"line_number":377,"context_line":""},{"line_number":378,"context_line":"    $ manila type-list"},{"line_number":379,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_89869363","line":376,"updated":"2015-04-05 10:26:12.000000000","message":"why manila-api need to be restart ?","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":373,"context_line":"    | %some_id% | default_share_type | public     | -          | driver_handles_share_servers : True |"},{"line_number":374,"context_line":"    +-----------+--------------------+------------+------------+-------------------------------------+"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Restart manila-api service and get list of share types::"},{"line_number":377,"context_line":""},{"line_number":378,"context_line":"    $ manila type-list"},{"line_number":379,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_c97dbbb2","line":376,"in_reply_to":"baa041b7_89869363","updated":"2015-04-05 13:34:52.000000000","message":"Added more detailed description.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":396,"context_line":""},{"line_number":397,"context_line":"Run manila-scheduler::"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"    $ /opt/stack/manila/bin/manila-scheduler \\"},{"line_number":400,"context_line":"        --config-file /etc/manila/manila.conf \u0026 \\"},{"line_number":401,"context_line":"        echo $! \u003e/opt/stack/status/stack/m-sch.pid; \\"},{"line_number":402,"context_line":"        fg || echo \"m-sch failed to start\" | \\"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_899fb3b3","line":399,"updated":"2015-04-05 10:17:35.000000000","message":"same as for `manila-api` start.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":396,"context_line":""},{"line_number":397,"context_line":"Run manila-scheduler::"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"    $ /opt/stack/manila/bin/manila-scheduler \\"},{"line_number":400,"context_line":"        --config-file /etc/manila/manila.conf \u0026 \\"},{"line_number":401,"context_line":"        echo $! \u003e/opt/stack/status/stack/m-sch.pid; \\"},{"line_number":402,"context_line":"        fg || echo \"m-sch failed to start\" | \\"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_8967b324","line":399,"in_reply_to":"baa041b7_899fb3b3","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7102,"name":"Thomas Bechtold","email":"thomas.bechtold@chainguard.dev","username":"toabctl"},"change_message_id":"d457db69df94b6c4bcf577fe008976281a77eab6","unresolved":false,"context_lines":[{"line_number":404,"context_line":""},{"line_number":405,"context_line":"Run manila-share::"},{"line_number":406,"context_line":""},{"line_number":407,"context_line":"    $ /opt/stack/manila/bin/manila-share \\"},{"line_number":408,"context_line":"        --config-file /etc/manila/manila.conf \u0026 \\"},{"line_number":409,"context_line":"        echo $! \u003e/opt/stack/status/stack/m-shr.pid; \\"},{"line_number":410,"context_line":"        fg || echo \"m-shr failed to start\" | \\"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_69a6af11","line":407,"updated":"2015-04-05 10:17:35.000000000","message":"same as for `manila-api` start.","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c503f2cb79eee16bc12b287448154ed87aab5d6c","unresolved":false,"context_lines":[{"line_number":404,"context_line":""},{"line_number":405,"context_line":"Run manila-share::"},{"line_number":406,"context_line":""},{"line_number":407,"context_line":"    $ /opt/stack/manila/bin/manila-share \\"},{"line_number":408,"context_line":"        --config-file /etc/manila/manila.conf \u0026 \\"},{"line_number":409,"context_line":"        echo $! \u003e/opt/stack/status/stack/m-shr.pid; \\"},{"line_number":410,"context_line":"        fg || echo \"m-shr failed to start\" | \\"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_a964b721","line":407,"in_reply_to":"baa041b7_69a6af11","updated":"2015-04-05 13:34:52.000000000","message":"Done","commit_id":"257e47c0e9311797870907dbe1cc58731d4f0750"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_b4ba366d","line":30,"updated":"2015-04-06 15:27:28.000000000","message":"Suggestion:, Replace \"Hence, ...backend\" with something like this:\n\nThis document will cover how to setup Manila using the Generic driver, which is setup to use Cinder as its storage backend.  Please refer to \u003c.....\u003e for the installation and setup documentation of other Manila drivers.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_cd5e4876","line":30,"in_reply_to":"9aa53dc9_6b1a8c19","updated":"2015-04-06 18:23:25.000000000","message":"Correct.  What I am suggesting is to separate the configuration of the driver away from this document.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_6b1a8c19","line":30,"in_reply_to":"9aa53dc9_b4ba366d","updated":"2015-04-06 15:45:58.000000000","message":"This doc is NOT about how to setup Generic driver. This doc is about how to setup Manila. All three parts of it. And manila-share service installation described with simplest configuration of most available backend - Cinder.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"4a76701a79b2a3defb343e4022d9760d5026c15a","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"}],"source_content_type":"text/x-rst","patch_set":4,"id":"bab921fb_009e3156","line":30,"in_reply_to":"9aa53dc9_cd5e4876","updated":"2015-04-23 10:54:40.000000000","message":"As suggested below, renamed it to \"Quick start\" as more relevant naming of original intention.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"},{"line_number":34,"context_line":"handling of `share servers`.  In most cases share servers are virtual machines"},{"line_number":35,"context_line":"that export file shares via various network file systems. The example in this"},{"line_number":36,"context_line":"document describes a backend that manages share servers using network resources"},{"line_number":37,"context_line":"provided by Neutron."}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_f4355ef7","line":34,"updated":"2015-04-06 15:27:28.000000000","message":"In most cases?  What other cases can it do?","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"},{"line_number":34,"context_line":"handling of `share servers`.  In most cases share servers are virtual machines"},{"line_number":35,"context_line":"that export file shares via various network file systems. The example in this"},{"line_number":36,"context_line":"document describes a backend that manages share servers using network resources"},{"line_number":37,"context_line":"provided by Neutron."}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_2dc7f413","line":34,"in_reply_to":"9aa53dc9_0b878062","updated":"2015-04-06 18:23:25.000000000","message":"You may want to add that note to the document somehow.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"},{"line_number":34,"context_line":"handling of `share servers`.  In most cases share servers are virtual machines"},{"line_number":35,"context_line":"that export file shares via various network file systems. The example in this"},{"line_number":36,"context_line":"document describes a backend that manages share servers using network resources"},{"line_number":37,"context_line":"provided by Neutron."}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_0b878062","line":34,"in_reply_to":"9aa53dc9_f4355ef7","updated":"2015-04-06 15:45:58.000000000","message":"i.e bare-metal servers in Nova using Ironic.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":34,"context_line":"handling of `share servers`.  In most cases share servers are virtual machines"},{"line_number":35,"context_line":"that export file shares via various network file systems. The example in this"},{"line_number":36,"context_line":"document describes a backend that manages share servers using network resources"},{"line_number":37,"context_line":"provided by Neutron."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":".. note::"},{"line_number":40,"context_line":"    Manila supports any network architecture. When a driver is managing its own"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_a83adacb","line":37,"updated":"2015-04-06 15:27:28.000000000","message":"\"The .. Neutron\": Is this part of the Generic driver or something separate?  If it is part of the Generic driver, maybe there should be a document which describes its architecture, installation, setup, and usage instead of adding it here.\n\nSo instead, the document should just describe \u0027manila-api\u0027 and \u0027manila-scheduler\u0027, and leave \u0027manila-share\u0027 to be documented by the respective XXX-driver.rst document","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":34,"context_line":"handling of `share servers`.  In most cases share servers are virtual machines"},{"line_number":35,"context_line":"that export file shares via various network file systems. The example in this"},{"line_number":36,"context_line":"document describes a backend that manages share servers using network resources"},{"line_number":37,"context_line":"provided by Neutron."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":".. note::"},{"line_number":40,"context_line":"    Manila supports any network architecture. When a driver is managing its own"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_cb5cf8ef","line":37,"in_reply_to":"9aa53dc9_a83adacb","updated":"2015-04-06 15:45:58.000000000","message":"Existing docs for drivers show configurations for them. This doc shows configuration of backend combined with general configuration of whole service. It is done just using Generic driver as example.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":34,"context_line":"handling of `share servers`.  In most cases share servers are virtual machines"},{"line_number":35,"context_line":"that export file shares via various network file systems. The example in this"},{"line_number":36,"context_line":"document describes a backend that manages share servers using network resources"},{"line_number":37,"context_line":"provided by Neutron."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":".. note::"},{"line_number":40,"context_line":"    Manila supports any network architecture. When a driver is managing its own"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_4de238a1","line":37,"in_reply_to":"9aa53dc9_cb5cf8ef","updated":"2015-04-06 18:23:25.000000000","message":"This document should refer the reader to driver documentation.  This will help simplify this document.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Prerequisites"},{"line_number":47,"context_line":"-------------"},{"line_number":48,"context_line":"- Ubuntu 14.04"},{"line_number":49,"context_line":"- MySQL database"},{"line_number":50,"context_line":"- RabbitMQ message bus"},{"line_number":51,"context_line":"- OpenStack Keystone"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_28824a53","line":48,"updated":"2015-04-06 15:27:28.000000000","message":"Ubuntu 14.04 is not a pre-req.  What about CentOS?  AFAIK, only Linux is the prereq","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Prerequisites"},{"line_number":47,"context_line":"-------------"},{"line_number":48,"context_line":"- Ubuntu 14.04"},{"line_number":49,"context_line":"- MySQL database"},{"line_number":50,"context_line":"- RabbitMQ message bus"},{"line_number":51,"context_line":"- OpenStack Keystone"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_8bacb0ee","line":48,"in_reply_to":"9aa53dc9_28824a53","updated":"2015-04-06 15:45:58.000000000","message":"Here described prerequisites that were used and not that the only supported.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"abb42de4cfc03787ab8b8d4b2b2872a7dc3434e9","unresolved":false,"context_lines":[{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Prerequisites"},{"line_number":47,"context_line":"-------------"},{"line_number":48,"context_line":"- Ubuntu 14.04"},{"line_number":49,"context_line":"- MySQL database"},{"line_number":50,"context_line":"- RabbitMQ message bus"},{"line_number":51,"context_line":"- OpenStack Keystone"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_8233efaa","line":48,"in_reply_to":"9aa53dc9_6d773c03","updated":"2015-04-09 10:29:27.000000000","message":"Propositions?","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Prerequisites"},{"line_number":47,"context_line":"-------------"},{"line_number":48,"context_line":"- Ubuntu 14.04"},{"line_number":49,"context_line":"- MySQL database"},{"line_number":50,"context_line":"- RabbitMQ message bus"},{"line_number":51,"context_line":"- OpenStack Keystone"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_6d773c03","line":48,"in_reply_to":"9aa53dc9_8bacb0ee","updated":"2015-04-06 18:23:25.000000000","message":"Normally, that is not what \u0027prerequisites\u0027 mean.  You may want to reword it.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":75,"context_line":""},{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_083c2692","line":78,"updated":"2015-04-06 15:27:28.000000000","message":"Suggestion:\n  git clone -b stable/kilo https://github.com/openstack/manila","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":75,"context_line":""},{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_0ba0a0f3","line":78,"in_reply_to":"9aa53dc9_083c2692","updated":"2015-04-06 15:45:58.000000000","message":"Both are correct.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":6491,"name":"xing-yang","email":"xingyang105@gmail.com","username":"xing-yang"},"change_message_id":"692381d948fbb8d4795bd38d5e846ffe2eb50705","unresolved":false,"context_lines":[{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"baa041b7_ac32850e","line":79,"updated":"2015-04-05 16:28:47.000000000","message":"We don\u0027t have stable/kilo yet.  It is in master right now.  So if you want this to be merged before stable/kilo is cut, this should be changed.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"4a76701a79b2a3defb343e4022d9760d5026c15a","unresolved":false,"context_lines":[{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3ab451fb_ba043d7e","line":79,"in_reply_to":"9aa53dc9_2e26c068","updated":"2015-04-23 10:54:40.000000000","message":"Branch \"stable/kilo\" already exist. Leaving as is.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":6491,"name":"xing-yang","email":"xingyang105@gmail.com","username":"xing-yang"},"change_message_id":"175e68242d94dca6aaeaae442c9b20e992077ffa","unresolved":false,"context_lines":[{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_2e26c068","line":79,"in_reply_to":"9aa53dc9_30205f9b","updated":"2015-04-07 03:14:19.000000000","message":"I like this idea of showing both.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":2417,"name":"Ben Swartzlander","email":"ben@swartzlander.org","username":"bswartz"},"change_message_id":"6ec9c805667ab022f5f8e369f02f4e53902d1109","unresolved":false,"context_lines":[{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_30205f9b","line":79,"in_reply_to":"9aa53dc9_79c14780","updated":"2015-04-07 01:05:05.000000000","message":"Since this document will exist in both master and the stable branches, perhaps we should simply give examples of how to clone from both master and stable branches, and let the reader decide what they want to do.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"c2db7ab57925d85c2277e2c0e525784076946199","unresolved":false,"context_lines":[{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_79c14780","line":79,"in_reply_to":"baa041b7_4fe1abfd","updated":"2015-04-06 14:43:18.000000000","message":"Xing, it is done intentionally. If we set master, then it will be problematic to change it back when Kilo released.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"6655acc8d4c8687515a75ac17bc8ce000fc597d8","unresolved":false,"context_lines":[{"line_number":76,"context_line":"Clone repo::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    $ git clone https://github.com/openstack/manila"},{"line_number":79,"context_line":"    $ git checkout stable/kilo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"Then run the installation script::"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"baa041b7_4fe1abfd","line":79,"in_reply_to":"baa041b7_ac32850e","updated":"2015-04-05 17:32:43.000000000","message":"This doc is intended to serve indefinitely as the Kilo installation reference, so it seems better to hold it until stable/kilo exists rather than change the text.  I won\u0027t be long now, anyway.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":98,"context_line":""},{"line_number":99,"context_line":"Pull it from its git repo and install::"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"    $ git clone https://github.com/openstack/python-manilaclient"},{"line_number":102,"context_line":"    $ cd python-manilaclient"},{"line_number":103,"context_line":"    $ sudo python setup.py install"},{"line_number":104,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_c85cfeef","line":101,"updated":"2015-04-06 15:27:28.000000000","message":"Shouldn\u0027t this be also in the stable/kilo branch?","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":98,"context_line":""},{"line_number":99,"context_line":"Pull it from its git repo and install::"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"    $ git clone https://github.com/openstack/python-manilaclient"},{"line_number":102,"context_line":"    $ cd python-manilaclient"},{"line_number":103,"context_line":"    $ sudo python setup.py install"},{"line_number":104,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_ad89c4cc","line":101,"in_reply_to":"9aa53dc9_4b5fc80e","updated":"2015-04-06 18:23:25.000000000","message":"Why not?  Sounds like they should if this is the way for them to communicate and setup Manila.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":2417,"name":"Ben Swartzlander","email":"ben@swartzlander.org","username":"bswartz"},"change_message_id":"6ec9c805667ab022f5f8e369f02f4e53902d1109","unresolved":false,"context_lines":[{"line_number":98,"context_line":""},{"line_number":99,"context_line":"Pull it from its git repo and install::"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"    $ git clone https://github.com/openstack/python-manilaclient"},{"line_number":102,"context_line":"    $ cd python-manilaclient"},{"line_number":103,"context_line":"    $ sudo python setup.py install"},{"line_number":104,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_1d17b452","line":101,"in_reply_to":"9aa53dc9_ad89c4cc","updated":"2015-04-07 01:05:05.000000000","message":"Clients have tags, but not stable branches. We will do a 1.0.4 tag for the client around the time of the release, and that will be what users should use.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":98,"context_line":""},{"line_number":99,"context_line":"Pull it from its git repo and install::"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"    $ git clone https://github.com/openstack/python-manilaclient"},{"line_number":102,"context_line":"    $ cd python-manilaclient"},{"line_number":103,"context_line":"    $ sudo python setup.py install"},{"line_number":104,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_4b5fc80e","line":101,"in_reply_to":"9aa53dc9_c85cfeef","updated":"2015-04-06 15:45:58.000000000","message":"Clients do not have stable versions at all.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":205,"context_line":".. note::"},{"line_number":206,"context_line":"    Manila configuration file may be used from different places."},{"line_number":207,"context_line":"    `/etc/manila/manila.conf` is one of expected paths by default."},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Basic configuration of Manila"},{"line_number":210,"context_line":"-----------------------------"},{"line_number":211,"context_line":"In our case we will set up one backend with generic driver (using Cinder"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_c8b87ee8","line":208,"updated":"2015-04-06 15:27:28.000000000","message":"Suggestion: At this point, the document can have the reader choose which one of the drivers to setup.  Each of the drivers should have a document on how to install and setup.  The document can also suggest to the reader to use the Generic driver for simplicity.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":205,"context_line":".. note::"},{"line_number":206,"context_line":"    Manila configuration file may be used from different places."},{"line_number":207,"context_line":"    `/etc/manila/manila.conf` is one of expected paths by default."},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Basic configuration of Manila"},{"line_number":210,"context_line":"-----------------------------"},{"line_number":211,"context_line":"In our case we will set up one backend with generic driver (using Cinder"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_2d4a5484","line":208,"in_reply_to":"9aa53dc9_ab6894bb","updated":"2015-04-06 18:23:25.000000000","message":"An installation document should focus on guiding the reader through a step by step process.  One of the steps is to setup the driver.  It would be beneficial both to the reader and the document to simplify it and point the reader to the driver they are looking to install.  Once they configure the driver, the step after that would be to use the manila client as the document describes below","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":205,"context_line":".. note::"},{"line_number":206,"context_line":"    Manila configuration file may be used from different places."},{"line_number":207,"context_line":"    `/etc/manila/manila.conf` is one of expected paths by default."},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Basic configuration of Manila"},{"line_number":210,"context_line":"-----------------------------"},{"line_number":211,"context_line":"In our case we will set up one backend with generic driver (using Cinder"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_ab6894bb","line":208,"in_reply_to":"9aa53dc9_c8b87ee8","updated":"2015-04-06 15:45:58.000000000","message":"Choice of \"Generic driver\" is described in the beginning of this doc. It is part of this doc. And drivers already have their own doc pages.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":323,"context_line":"    require one of Manila\u0027s network plug-ins."},{"line_number":324,"context_line":""},{"line_number":325,"context_line":"Database setup"},{"line_number":326,"context_line":"--------------"},{"line_number":327,"context_line":"Manila supports different SQL dialects in theory, but it is only tested with"},{"line_number":328,"context_line":"MySQL, so this step assumes that MySQL has been installed."},{"line_number":329,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_288fea24","line":326,"updated":"2015-04-06 15:27:28.000000000","message":"Is this part generic to all drivers?  Can this be done before configuring the .conf file?","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":323,"context_line":"    require one of Manila\u0027s network plug-ins."},{"line_number":324,"context_line":""},{"line_number":325,"context_line":"Database setup"},{"line_number":326,"context_line":"--------------"},{"line_number":327,"context_line":"Manila supports different SQL dialects in theory, but it is only tested with"},{"line_number":328,"context_line":"MySQL, so this step assumes that MySQL has been installed."},{"line_number":329,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_6b1dec65","line":326,"in_reply_to":"9aa53dc9_288fea24","updated":"2015-04-06 15:45:58.000000000","message":"See lines 224-227","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":366,"context_line":""},{"line_number":367,"context_line":"Running Manila services"},{"line_number":368,"context_line":"-----------------------"},{"line_number":369,"context_line":""},{"line_number":370,"context_line":"Run manila-api first::"},{"line_number":371,"context_line":""},{"line_number":372,"context_line":"    $ manila-api \\"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_a8a3fa9d","line":369,"updated":"2015-04-06 15:27:28.000000000","message":"This is generic to Manila, so this can be shown after the driver of their choosing has been setup.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":366,"context_line":""},{"line_number":367,"context_line":"Running Manila services"},{"line_number":368,"context_line":"-----------------------"},{"line_number":369,"context_line":""},{"line_number":370,"context_line":"Run manila-api first::"},{"line_number":371,"context_line":""},{"line_number":372,"context_line":"    $ manila-api \\"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_c8163e55","line":369,"in_reply_to":"9aa53dc9_a8a3fa9d","updated":"2015-04-06 15:45:58.000000000","message":"I am not sure I get your point here. Services are running after configuration. And it is in expected order already.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"b59de2ed960f542e5e79fe07d55148c7cd5d6c9a","unresolved":false,"context_lines":[{"line_number":392,"context_line":"    +-----------+--------------------+------------+------------+-------------------------------------+"},{"line_number":393,"context_line":""},{"line_number":394,"context_line":"Service `manila-api` may be restarted to get updated information about"},{"line_number":395,"context_line":"`default share type`. So, get list of share types after restart of"},{"line_number":396,"context_line":"service `manila-api`::"},{"line_number":397,"context_line":""},{"line_number":398,"context_line":"    $ manila type-list"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_9d9ce46a","line":395,"updated":"2015-04-07 00:34:32.000000000","message":"Is this means when only one share-type exist, this share-type would be the \"default share type\". When more than one share-type exist, there would be no default share type ?","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"4a76701a79b2a3defb343e4022d9760d5026c15a","unresolved":false,"context_lines":[{"line_number":392,"context_line":"    +-----------+--------------------+------------+------------+-------------------------------------+"},{"line_number":393,"context_line":""},{"line_number":394,"context_line":"Service `manila-api` may be restarted to get updated information about"},{"line_number":395,"context_line":"`default share type`. So, get list of share types after restart of"},{"line_number":396,"context_line":"service `manila-api`::"},{"line_number":397,"context_line":""},{"line_number":398,"context_line":"    $ manila type-list"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3ab451fb_ba60bd36","line":395,"in_reply_to":"7aaa499b_bc7d411e","updated":"2015-04-23 10:54:40.000000000","message":"Config option can be set any time, even before start of manila-api service.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":6116,"name":"li,chen","email":"shchenli@cn.ibm.com","username":"chen-li"},"change_message_id":"bc3028bfe30e6dc44f8a50bddaf06ec65e6fe47b","unresolved":false,"context_lines":[{"line_number":392,"context_line":"    +-----------+--------------------+------------+------------+-------------------------------------+"},{"line_number":393,"context_line":""},{"line_number":394,"context_line":"Service `manila-api` may be restarted to get updated information about"},{"line_number":395,"context_line":"`default share type`. So, get list of share types after restart of"},{"line_number":396,"context_line":"service `manila-api`::"},{"line_number":397,"context_line":""},{"line_number":398,"context_line":"    $ manila type-list"}],"source_content_type":"text/x-rst","patch_set":4,"id":"7aaa499b_bc7d411e","line":395,"in_reply_to":"9aa53dc9_3b739bb3","updated":"2015-04-14 01:15:13.000000000","message":"So, the correct steps for admin should be:\n\n1. start manila-api\n\n2. create several share-types\n\n3. pick one share-type and add it into manila.conf\n\n4. restart manila-api\n\n\nThis looks a little strange to me.\nFrom an admin\u0027s view, it would be better for Manila to have a default share-type at beginning, and then give admin the right to change one of his/her own share-type to be default.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"abb42de4cfc03787ab8b8d4b2b2872a7dc3434e9","unresolved":false,"context_lines":[{"line_number":392,"context_line":"    +-----------+--------------------+------------+------------+-------------------------------------+"},{"line_number":393,"context_line":""},{"line_number":394,"context_line":"Service `manila-api` may be restarted to get updated information about"},{"line_number":395,"context_line":"`default share type`. So, get list of share types after restart of"},{"line_number":396,"context_line":"service `manila-api`::"},{"line_number":397,"context_line":""},{"line_number":398,"context_line":"    $ manila type-list"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_3b739bb3","line":395,"in_reply_to":"9aa53dc9_9d9ce46a","updated":"2015-04-09 10:29:27.000000000","message":"Only config option on line 277 defines default share type.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":431,"context_line":"        tee \"/opt/stack/status/stack/m-shr.failure\""},{"line_number":432,"context_line":""},{"line_number":433,"context_line":"Creation of pilot share"},{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_28b6cadc","line":434,"updated":"2015-04-06 15:27:28.000000000","message":"What is a pilot share?","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":431,"context_line":"        tee \"/opt/stack/status/stack/m-shr.failure\""},{"line_number":432,"context_line":""},{"line_number":433,"context_line":"Creation of pilot share"},{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_e843426b","line":434,"in_reply_to":"9aa53dc9_28b6cadc","updated":"2015-04-06 15:45:58.000000000","message":"The very first share.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":431,"context_line":"        tee \"/opt/stack/status/stack/m-shr.failure\""},{"line_number":432,"context_line":""},{"line_number":433,"context_line":"Creation of pilot share"},{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_4d2c78ab","line":434,"in_reply_to":"9aa53dc9_e843426b","updated":"2015-04-06 18:23:25.000000000","message":"Title needs to be reworded.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"2a630059d93b5c0341a40146b0e11d8e1c64fe39","unresolved":false,"context_lines":[{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"- Keystone"},{"line_number":439,"context_line":"- Nova (used by Generic driver, not strict dependency of Manila)"},{"line_number":440,"context_line":"- Neutron (default network backend for Generic driver, used when driver handles share servers)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_48c10e2e","line":437,"updated":"2015-04-06 15:27:28.000000000","message":"This section should probably go into the Generic driver documentation.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"4a76701a79b2a3defb343e4022d9760d5026c15a","unresolved":false,"context_lines":[{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"- Keystone"},{"line_number":439,"context_line":"- Nova (used by Generic driver, not strict dependency of Manila)"},{"line_number":440,"context_line":"- Neutron (default network backend for Generic driver, used when driver handles share servers)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"bab921fb_3403b475","line":437,"in_reply_to":"9aa53dc9_3152ae14","updated":"2015-04-23 10:54:40.000000000","message":"Done","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"9d353716baa75a5cdd0dd65acd7b4e2cc369adda","unresolved":false,"context_lines":[{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"- Keystone"},{"line_number":439,"context_line":"- Nova (used by Generic driver, not strict dependency of Manila)"},{"line_number":440,"context_line":"- Neutron (default network backend for Generic driver, used when driver handles share servers)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_882276b8","line":437,"in_reply_to":"9aa53dc9_48c10e2e","updated":"2015-04-06 15:45:58.000000000","message":"This doc shows specific case of Manila installation. And chosen \"generic\" driver is part of it. And here is shown very little part of its configuration.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"},{"author":{"_account_id":7652,"name":"Luis Pabón","email":"lpabon@gmail.com","username":"lpabon"},"change_message_id":"12ce4c7791ddb87b24eda97542d257b9176f6e02","unresolved":false,"context_lines":[{"line_number":434,"context_line":"-----------------------"},{"line_number":435,"context_line":""},{"line_number":436,"context_line":"In this step we assume that the following services are running:"},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"- Keystone"},{"line_number":439,"context_line":"- Nova (used by Generic driver, not strict dependency of Manila)"},{"line_number":440,"context_line":"- Neutron (default network backend for Generic driver, used when driver handles share servers)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9aa53dc9_3152ae14","line":437,"in_reply_to":"9aa53dc9_882276b8","updated":"2015-04-06 18:23:25.000000000","message":"Sounds like instead of a installation guide, this is looking more like a \u0027Quick-start\u0027 guide.\n\nIf it is a Quick-Start guide, then I agree with you, that showing the steps of how to setup the generic driver is correct.  If the guide is to be Manila Installation Guide, then the driver parts need to be moved into their own documents.","commit_id":"052d79074db62ee2c658cdb2f7da804ec676dce2"}],"doc/source/adminref/quick_start.rst":[{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"d97b28fefd0a3e287d240cdbb7e477929e486e49","unresolved":false,"context_lines":[{"line_number":25,"context_line":"- manila-share"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."}],"source_content_type":"text/x-rst","patch_set":8,"id":"bab921fb_90cc3dbc","line":28,"updated":"2015-04-25 19:32:27.000000000","message":"s/almost for/for almost/","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"a64da94c95126b447fa92ab2a8d8287ae727f98b","unresolved":false,"context_lines":[{"line_number":25,"context_line":"- manila-share"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9abe1de1_ac80b747","line":28,"in_reply_to":"bab921fb_90cc3dbc","updated":"2015-04-27 11:15:30.000000000","message":"Done","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"d97b28fefd0a3e287d240cdbb7e477929e486e49","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"}],"source_content_type":"text/x-rst","patch_set":8,"id":"bab921fb_b0798184","line":30,"updated":"2015-04-25 19:32:27.000000000","message":"This may sound better:\n\nHence, this document will cover a single use case, configuring the \"Generic\" driver that uses the Cinder project as its backend.","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"a64da94c95126b447fa92ab2a8d8287ae727f98b","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Installation of first two - `manila-api` and `manila-scheduler` is common"},{"line_number":28,"context_line":"almost for all deployments. But configuration of `manila-share` is"},{"line_number":29,"context_line":"backend-specific and can differ from deployment to deployment. Hence, this doc"},{"line_number":30,"context_line":"will cover just some specific case. And this case is \"Generic\" driver"},{"line_number":31,"context_line":"that uses Cinder project as backend."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Note that the `manila-share` service can run in two modes, with and without"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9abe1de1_4ce7db40","line":30,"in_reply_to":"bab921fb_b0798184","updated":"2015-04-27 11:15:30.000000000","message":"Done","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"d97b28fefd0a3e287d240cdbb7e477929e486e49","unresolved":false,"context_lines":[{"line_number":466,"context_line":""},{"line_number":467,"context_line":"    $ manila access-allow testshare ip 0.0.0.0/0 --access-level rw"},{"line_number":468,"context_line":""},{"line_number":469,"context_line":"We added read-write access to all IP addresses. Now, you can try mount this NFS share"},{"line_number":470,"context_line":"wherever you want."}],"source_content_type":"text/x-rst","patch_set":8,"id":"bab921fb_50aea5e6","line":469,"updated":"2015-04-25 19:32:27.000000000","message":"s/mount/mounting/","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"a64da94c95126b447fa92ab2a8d8287ae727f98b","unresolved":false,"context_lines":[{"line_number":466,"context_line":""},{"line_number":467,"context_line":"    $ manila access-allow testshare ip 0.0.0.0/0 --access-level rw"},{"line_number":468,"context_line":""},{"line_number":469,"context_line":"We added read-write access to all IP addresses. Now, you can try mount this NFS share"},{"line_number":470,"context_line":"wherever you want."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9abe1de1_6c485f2e","line":469,"in_reply_to":"bab921fb_50aea5e6","updated":"2015-04-27 11:15:30.000000000","message":"Done","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"d97b28fefd0a3e287d240cdbb7e477929e486e49","unresolved":false,"context_lines":[{"line_number":467,"context_line":"    $ manila access-allow testshare ip 0.0.0.0/0 --access-level rw"},{"line_number":468,"context_line":""},{"line_number":469,"context_line":"We added read-write access to all IP addresses. Now, you can try mount this NFS share"},{"line_number":470,"context_line":"wherever you want."}],"source_content_type":"text/x-rst","patch_set":8,"id":"bab921fb_704d293d","line":470,"updated":"2015-04-25 19:32:27.000000000","message":"s/wherever you want/onto any host/","commit_id":"680473770b9854013a760da32ef41cc73824a431"},{"author":{"_account_id":8851,"name":"Valeriy Ponomaryov","email":"kiparis.kh@gmail.com","username":"vponomaryov"},"change_message_id":"a64da94c95126b447fa92ab2a8d8287ae727f98b","unresolved":false,"context_lines":[{"line_number":467,"context_line":"    $ manila access-allow testshare ip 0.0.0.0/0 --access-level rw"},{"line_number":468,"context_line":""},{"line_number":469,"context_line":"We added read-write access to all IP addresses. Now, you can try mount this NFS share"},{"line_number":470,"context_line":"wherever you want."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9abe1de1_ec622fad","line":470,"in_reply_to":"bab921fb_704d293d","updated":"2015-04-27 11:15:30.000000000","message":"Done","commit_id":"680473770b9854013a760da32ef41cc73824a431"}]}