)]}'
{"/COMMIT_MSG":[{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"b797f79e26f9786823be419a1815441193f50296","unresolved":false,"context_lines":[{"line_number":10,"context_line":"the main characteristics of the functionality that we usually include"},{"line_number":11,"context_line":"in the Admin Guide, such as volume creation, policies, microversions,"},{"line_number":12,"context_line":"and back end support."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Change-Id: I77bb849e039e1b44964ac0f30d48b5c16ca41b44"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":8,"id":"3fa0c359_a5d87d52","line":13,"updated":"2018-02-13 19:55:17.000000000","message":"Add yourself as co-author:\n\nCo-Authored-By: Ildiko Vancsa \u003cildiko.vancsa@gmail.com\u003e","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":10,"context_line":"the main characteristics of the functionality that we usually include"},{"line_number":11,"context_line":"in the Admin Guide, such as volume creation, policies, microversions,"},{"line_number":12,"context_line":"and back end support."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Change-Id: I77bb849e039e1b44964ac0f30d48b5c16ca41b44"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":8,"id":"3fa0c359_68d24cd3","line":13,"in_reply_to":"3fa0c359_a5d87d52","updated":"2018-02-14 11:38:17.000000000","message":"Good point, thanks for reminding.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"}],"doc/source/admin/blockstorage-volume-multiattach.rst":[{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"d6df2a95b30d273fe8a945996f75b12207bc247a","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":".. warning::"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"   Cinder (nor its backends) does not do anything in terms of file"},{"line_number":16,"context_line":"   systems or control of the volumes. In other words, it\u0027s up to the user to"},{"line_number":17,"context_line":"   ensure that a multiattach or clustered file system is used on the volumes."},{"line_number":18,"context_line":"   Otherwise there may be a high probability of data corruption."}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_ae78678f","line":15,"range":{"start_line":15,"start_character":34,"end_line":15,"end_character":40},"updated":"2018-02-13 15:12:21.000000000","message":"remove \u0027not do\u0027","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":".. warning::"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"   Cinder (nor its backends) does not do anything in terms of file"},{"line_number":16,"context_line":"   systems or control of the volumes. In other words, it\u0027s up to the user to"},{"line_number":17,"context_line":"   ensure that a multiattach or clustered file system is used on the volumes."},{"line_number":18,"context_line":"   Otherwise there may be a high probability of data corruption."}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_7df1af00","line":15,"range":{"start_line":15,"start_character":34,"end_line":15,"end_character":40},"in_reply_to":"3fa0c359_77078e19","updated":"2018-02-13 18:29:59.000000000","message":"I will remove the first sentence then.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"c2cf456b006fbff0035b5cc8c8b576ec2f24288c","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":".. warning::"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"   Cinder (nor its backends) does not do anything in terms of file"},{"line_number":16,"context_line":"   systems or control of the volumes. In other words, it\u0027s up to the user to"},{"line_number":17,"context_line":"   ensure that a multiattach or clustered file system is used on the volumes."},{"line_number":18,"context_line":"   Otherwise there may be a high probability of data corruption."}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_77078e19","line":15,"range":{"start_line":15,"start_character":34,"end_line":15,"end_character":40},"in_reply_to":"3fa0c359_ae78678f","updated":"2018-02-13 16:29:45.000000000","message":"Why? Then you\u0027d be saying cinder manages file systems, which it doesn\u0027t.\n\nI agree the negatives are a bit confusing though.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":17,"context_line":"   ensure that a multiattach or clustered file system is used on the volumes."},{"line_number":18,"context_line":"   Otherwise there may be a high probability of data corruption."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"As a prerequisite `new Attach/Detach API\u0027s were added to Cinder`_ in Ocata to"},{"line_number":21,"context_line":"overcome earlier limitations towards achieving volume multi-attach. The Nova"},{"line_number":22,"context_line":"API calls switched to using these new API\u0027s in the background in Queens, which"},{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_d89d950a","line":20,"range":{"start_line":20,"start_character":37,"end_line":20,"end_character":42},"updated":"2018-02-12 16:37:53.000000000","message":"APIs","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":17,"context_line":"   ensure that a multiattach or clustered file system is used on the volumes."},{"line_number":18,"context_line":"   Otherwise there may be a high probability of data corruption."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"As a prerequisite `new Attach/Detach API\u0027s were added to Cinder`_ in Ocata to"},{"line_number":21,"context_line":"overcome earlier limitations towards achieving volume multi-attach. The Nova"},{"line_number":22,"context_line":"API calls switched to using these new API\u0027s in the background in Queens, which"},{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_915d9148","line":20,"range":{"start_line":20,"start_character":37,"end_line":20,"end_character":42},"in_reply_to":"3fa0c359_d89d950a","updated":"2018-02-13 18:29:59.000000000","message":"Done","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":"As a prerequisite `new Attach/Detach API\u0027s were added to Cinder`_ in Ocata to"},{"line_number":21,"context_line":"overcome earlier limitations towards achieving volume multi-attach. The Nova"},{"line_number":22,"context_line":"API calls switched to using these new API\u0027s in the background in Queens, which"},{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"},{"line_number":24,"context_line":"transparent to the user."},{"line_number":25,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_389b5918","line":22,"range":{"start_line":22,"start_character":38,"end_line":22,"end_character":43},"updated":"2018-02-12 16:37:53.000000000","message":"APIs","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":"As a prerequisite `new Attach/Detach API\u0027s were added to Cinder`_ in Ocata to"},{"line_number":21,"context_line":"overcome earlier limitations towards achieving volume multi-attach. The Nova"},{"line_number":22,"context_line":"API calls switched to using these new API\u0027s in the background in Queens, which"},{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"},{"line_number":24,"context_line":"transparent to the user."},{"line_number":25,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_51538939","line":22,"range":{"start_line":22,"start_character":38,"end_line":22,"end_character":43},"in_reply_to":"3fa0c359_389b5918","updated":"2018-02-13 18:29:59.000000000","message":"Done","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":20,"context_line":"As a prerequisite `new Attach/Detach API\u0027s were added to Cinder`_ in Ocata to"},{"line_number":21,"context_line":"overcome earlier limitations towards achieving volume multi-attach. The Nova"},{"line_number":22,"context_line":"API calls switched to using these new API\u0027s in the background in Queens, which"},{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"},{"line_number":24,"context_line":"transparent to the user."},{"line_number":25,"context_line":""},{"line_number":26,"context_line":".. note::"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_78f7a15a","line":23,"range":{"start_line":23,"start_character":44,"end_line":23,"end_character":45},"updated":"2018-02-12 16:37:53.000000000","message":"This isn\u0027t closed.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":20,"context_line":"As a prerequisite `new Attach/Detach API\u0027s were added to Cinder`_ in Ocata to"},{"line_number":21,"context_line":"overcome earlier limitations towards achieving volume multi-attach. The Nova"},{"line_number":22,"context_line":"API calls switched to using these new API\u0027s in the background in Queens, which"},{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"},{"line_number":24,"context_line":"transparent to the user."},{"line_number":25,"context_line":""},{"line_number":26,"context_line":".. note::"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_11374101","line":23,"range":{"start_line":23,"start_character":44,"end_line":23,"end_character":45},"in_reply_to":"3fa0c359_78f7a15a","updated":"2018-02-13 18:29:59.000000000","message":"Done","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"},{"line_number":24,"context_line":"transparent to the user."},{"line_number":25,"context_line":""},{"line_number":26,"context_line":".. note::"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"    The volume multi-attach feature is only supported when using the new"},{"line_number":29,"context_line":"    attachment API calls such as attachment-create, attachment-update, and so"},{"line_number":30,"context_line":"    forth."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"How to create a \u0027multiattach\u0027 volume"},{"line_number":33,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_18c1bde5","line":30,"range":{"start_line":26,"start_character":0,"end_line":30,"end_character":10},"updated":"2018-02-12 16:37:53.000000000","message":"We don\u0027t really need to note this do we? You already said above that the feature relies on the 3.44 microversion, which implies the new APIs, so we don\u0027t need the extra note - it\u0027s just code details the user doesn\u0027t need to worry about.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":23,"context_line":"requires Cinder to provide API microversion \u00273.44 or higher. The switch is"},{"line_number":24,"context_line":"transparent to the user."},{"line_number":25,"context_line":""},{"line_number":26,"context_line":".. note::"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"    The volume multi-attach feature is only supported when using the new"},{"line_number":29,"context_line":"    attachment API calls such as attachment-create, attachment-update, and so"},{"line_number":30,"context_line":"    forth."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"How to create a \u0027multiattach\u0027 volume"},{"line_number":33,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_ec4f5e68","line":30,"range":{"start_line":26,"start_character":0,"end_line":30,"end_character":10},"in_reply_to":"3fa0c359_18c1bde5","updated":"2018-02-13 18:29:59.000000000","message":"Done","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":".. note::"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"   Creating a \u0027multiattach\u0027 volume is an admin-or-owner-only operation."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_1302fe0a","line":41,"range":{"start_line":41,"start_character":3,"end_line":41,"end_character":71},"updated":"2018-02-12 16:37:53.000000000","message":"By default. I\u0027d also mention the policy rules by name, you can find those here:\n\nhttps://review.openstack.org/#/c/537652/1/releasenotes/notes/add_multiattach_policies-8e0b22505ed6cbd8.yaml\n\nActually just do that in the policy rules section below, then we don\u0027t need this extra note.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":".. note::"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"   Creating a \u0027multiattach\u0027 volume is an admin-or-owner-only operation."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_ac20769c","line":41,"range":{"start_line":41,"start_character":3,"end_line":41,"end_character":71},"in_reply_to":"3fa0c359_1302fe0a","updated":"2018-02-13 18:29:59.000000000","message":"Ok, I will remove this and stop writing docs for people like me who just refuse to read the whole thing the first time... :)","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":42,"context_line":""},{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"   You\u0027ll need to ensure you have a backend device that reports"},{"line_number":46,"context_line":"   support of the multiattach capability, otherwise scheduling will fail on"},{"line_number":47,"context_line":"   create."},{"line_number":48,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_332e1a92","line":45,"range":{"start_line":45,"start_character":44,"end_line":45,"end_character":50},"updated":"2018-02-12 16:37:53.000000000","message":"Is this the volume type (volume driver)? It\u0027s the volume driver that reports the capability to the cinder scheduler, so I\u0027d say something along those lines rather than \u0027device\u0027.\n\nAlso, is there any way for an admin to know which volume drivers support multiattach per release without having to look at the code? Like a feature support matrix?","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"d6df2a95b30d273fe8a945996f75b12207bc247a","unresolved":false,"context_lines":[{"line_number":42,"context_line":""},{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"   You\u0027ll need to ensure you have a backend device that reports"},{"line_number":46,"context_line":"   support of the multiattach capability, otherwise scheduling will fail on"},{"line_number":47,"context_line":"   create."},{"line_number":48,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_ae3947a4","line":45,"range":{"start_line":45,"start_character":44,"end_line":45,"end_character":50},"in_reply_to":"3fa0c359_332e1a92","updated":"2018-02-13 15:12:21.000000000","message":"I would actually word this as \u0027You\u0027ll need to ensure that your storage backend supports the multiattach capabiility,\u0027  That is consistent with how we use the terminology elsewhere.\n\nAs far as a feature matrix.  We have one and we have been talking about automating the process for generating it.  I need to check where we are on that.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":42,"context_line":""},{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"   You\u0027ll need to ensure you have a backend device that reports"},{"line_number":46,"context_line":"   support of the multiattach capability, otherwise scheduling will fail on"},{"line_number":47,"context_line":"   create."},{"line_number":48,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_cc0aa21e","line":45,"range":{"start_line":45,"start_character":44,"end_line":45,"end_character":50},"in_reply_to":"3fa0c359_332e1a92","updated":"2018-02-13 18:29:59.000000000","message":"There are cases when the back end device does not support multi-attach however you\u0027re right in the sense that the volume driver will report the capability in either case.\n\nI will switch to driver and link to a wiki page that is supposed to list capabilities, however the code seems to be the correct source of this information in Cinder\u0027s case. :(","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"c2cf456b006fbff0035b5cc8c8b576ec2f24288c","unresolved":false,"context_lines":[{"line_number":42,"context_line":""},{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"   You\u0027ll need to ensure you have a backend device that reports"},{"line_number":46,"context_line":"   support of the multiattach capability, otherwise scheduling will fail on"},{"line_number":47,"context_line":"   create."},{"line_number":48,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_d72d4295","line":45,"range":{"start_line":45,"start_character":44,"end_line":45,"end_character":50},"in_reply_to":"3fa0c359_ae3947a4","updated":"2018-02-13 16:29:45.000000000","message":"\u003e As far as a feature matrix. We have one and we have been talking about automating the process for generating it. I need to check where we are on that.\n\nI\u0027m good with not automating it for now as long as we have a static place to say which backends support multiattach and in which release.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":61,"context_line":""},{"line_number":62,"context_line":".. note::"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"   Creating a new volume type is an admin-only operation."},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"To create the volume you need to use the volume type you created earlier, like"},{"line_number":67,"context_line":"this:"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_d35576fb","line":64,"range":{"start_line":64,"start_character":3,"end_line":64,"end_character":57},"updated":"2018-02-12 16:37:53.000000000","message":"By default policy, right? But this is configurable via policy.json.\n\nAlso, maybe just mention this in the policy rules section and remove the extra note here.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":61,"context_line":""},{"line_number":62,"context_line":".. note::"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"   Creating a new volume type is an admin-only operation."},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"To create the volume you need to use the volume type you created earlier, like"},{"line_number":67,"context_line":"this:"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_cccdc2b7","line":64,"range":{"start_line":64,"start_character":3,"end_line":64,"end_character":57},"in_reply_to":"3fa0c359_d35576fb","updated":"2018-02-13 18:29:59.000000000","message":"As this is a volume type create operation that has nothing to do with multi-attach itself I will eave this one here and adding that it is a default setting.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":68,"context_line":""},{"line_number":69,"context_line":".. code-block:: console"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --volume-type \u003cvolume_type_uuid\u003e"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":74,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_93436e42","line":71,"updated":"2018-02-12 16:37:53.000000000","message":"Use python-openstackclient commands for the example since I thought per-project CLIs were supposed to be deprecated?","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"d6df2a95b30d273fe8a945996f75b12207bc247a","unresolved":false,"context_lines":[{"line_number":68,"context_line":""},{"line_number":69,"context_line":".. code-block:: console"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --volume-type \u003cvolume_type_uuid\u003e"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":74,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_4ecd2383","line":71,"in_reply_to":"3fa0c359_93436e42","updated":"2018-02-13 15:12:21.000000000","message":"So, we need to decide here if we want a mix of openstackclient and cinderclient commands since not all of the commands for this can be done with openstackclient or if we want to standardize on cinderclient.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"d6df2a95b30d273fe8a945996f75b12207bc247a","unresolved":false,"context_lines":[{"line_number":71,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --volume-type \u003cvolume_type_uuid\u003e"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":74,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"},{"line_number":75,"context_line":"``avaialable``."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"The reasoning behind the limitation is that some consumers/hypervisors need to"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_cea613c2","line":74,"range":{"start_line":74,"start_character":9,"end_line":74,"end_character":29},"updated":"2018-02-13 15:12:21.000000000","message":"Currently, however, we","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":72,"context_line":""},{"line_number":73,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":74,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"},{"line_number":75,"context_line":"``avaialable``."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"The reasoning behind the limitation is that some consumers/hypervisors need to"},{"line_number":78,"context_line":"make special considerations at attach-time for multiattach volumes (like"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_5349665d","line":75,"range":{"start_line":75,"start_character":2,"end_line":75,"end_character":12},"updated":"2018-02-12 16:37:53.000000000","message":"available","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":72,"context_line":""},{"line_number":73,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":74,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"},{"line_number":75,"context_line":"``avaialable``."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"The reasoning behind the limitation is that some consumers/hypervisors need to"},{"line_number":78,"context_line":"make special considerations at attach-time for multiattach volumes (like"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_4c4e9238","line":75,"range":{"start_line":75,"start_character":2,"end_line":75,"end_character":12},"in_reply_to":"3fa0c359_5349665d","updated":"2018-02-13 18:29:59.000000000","message":"Done","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":87,"context_line":""},{"line_number":88,"context_line":".. code-block:: console"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --allow-multiattch"},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"RO / RW caveats (the secondary RW attachment issue)"},{"line_number":93,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_13799e92","line":90,"updated":"2018-02-12 16:37:53.000000000","message":"Again, use OSC CLIs.\n\nhttps://docs.openstack.org/python-openstackclient/pike/cli/command-objects/volume.html#volume-create","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":95,"context_line":"By default, secondary volume attachments are made in read/write mode"},{"line_number":96,"context_line":"which can be problematic, especially for operations like volume migration."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"There are plans to provide support to specify the attach-mode for the secondary"},{"line_number":99,"context_line":"attachments, for the latest information please take a look into `Cinder\u0027s specs"},{"line_number":100,"context_line":"list`_ for the current release."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Backend support"},{"line_number":103,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_b3da2a75","line":100,"range":{"start_line":98,"start_character":0,"end_line":100,"end_character":31},"updated":"2018-02-12 16:37:53.000000000","message":"Not sure about this. It\u0027s OK, but I think what we we\u0027ll be discussing at the PTG is the ability to pass the attach mode to the compute API when attaching a volume to a server and nova will pass that through to cinder, since you can technically already specify the attach mode in the host connector dict when calling attachment_update, it\u0027s just that the cinder code defaults to r/w if it\u0027s not specified:\n\nhttps://github.com/openstack/cinder/blob/c650324865bd2af5f8532a1e3fc2d262d445201c/cinder/volume/manager.py#L4391\n\nIf cinder changed that logic for the default attach mode based on the number of attachments, that\u0027s then a cinder thing, but it gets trickier (since you\u0027d have to consider what to do when you go back down from \u003e1 attachments to a single attachment and that attachment was previously attached as mode\u003dro, do you automatically flip it back to rw since it\u0027s the only one left?).","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab14e93e0ffdfd5fe178b075aa2167916305a86b","unresolved":false,"context_lines":[{"line_number":95,"context_line":"By default, secondary volume attachments are made in read/write mode"},{"line_number":96,"context_line":"which can be problematic, especially for operations like volume migration."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"There are plans to provide support to specify the attach-mode for the secondary"},{"line_number":99,"context_line":"attachments, for the latest information please take a look into `Cinder\u0027s specs"},{"line_number":100,"context_line":"list`_ for the current release."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Backend support"},{"line_number":103,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_d2054d15","line":100,"range":{"start_line":98,"start_character":0,"end_line":100,"end_character":31},"in_reply_to":"3fa0c359_4cfc52b4","updated":"2018-02-13 19:41:11.000000000","message":"I think it\u0027s OK to mention the caveat that all attachments will be made r/w by default, and that future changes may address that.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":95,"context_line":"By default, secondary volume attachments are made in read/write mode"},{"line_number":96,"context_line":"which can be problematic, especially for operations like volume migration."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"There are plans to provide support to specify the attach-mode for the secondary"},{"line_number":99,"context_line":"attachments, for the latest information please take a look into `Cinder\u0027s specs"},{"line_number":100,"context_line":"list`_ for the current release."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Backend support"},{"line_number":103,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_4cfc52b4","line":100,"range":{"start_line":98,"start_character":0,"end_line":100,"end_character":31},"in_reply_to":"3fa0c359_b3da2a75","updated":"2018-02-13 18:29:59.000000000","message":"I wasn\u0027t sure about this part, just felt like many people will have questions about this so thought to add a sentence. Can remove it if we\u0027re not comfortable with it.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"d6df2a95b30d273fe8a945996f75b12207bc247a","unresolved":false,"context_lines":[{"line_number":102,"context_line":"Backend support"},{"line_number":103,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Which volume and virt backends support multiattach?"},{"line_number":106,"context_line":"Is there a feature support matrix for volume backends that we can link to?"},{"line_number":107,"context_line":"How does one discover this (I guess the end user gets it from the volume type)?"},{"line_number":108,"context_line":"Does the storage backend capabilities API expose this to admins?"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Policy rules"},{"line_number":111,"context_line":"~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_2ea537a2","line":108,"range":{"start_line":105,"start_character":0,"end_line":108,"end_character":64},"updated":"2018-02-13 15:12:21.000000000","message":"All we have right now is this:  https://wiki.openstack.org/wiki/CinderSupportMatrix\n\nNeed to add a column for the multi-attach support.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"c2cf456b006fbff0035b5cc8c8b576ec2f24288c","unresolved":false,"context_lines":[{"line_number":102,"context_line":"Backend support"},{"line_number":103,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Which volume and virt backends support multiattach?"},{"line_number":106,"context_line":"Is there a feature support matrix for volume backends that we can link to?"},{"line_number":107,"context_line":"How does one discover this (I guess the end user gets it from the volume type)?"},{"line_number":108,"context_line":"Does the storage backend capabilities API expose this to admins?"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Policy rules"},{"line_number":111,"context_line":"~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_573e12b8","line":108,"range":{"start_line":105,"start_character":0,"end_line":108,"end_character":64},"in_reply_to":"3fa0c359_2ea537a2","updated":"2018-02-13 16:29:45.000000000","message":"Ah, well, that\u0027s better than nothing, and it says which release a feature was supported for a given driver.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":122,"context_line":""},{"line_number":123,"context_line":"Testing"},{"line_number":124,"context_line":"~~~~~~~"},{"line_number":125,"context_line":"\u003cildikov\u003e Is this an Admin Guide or rather Developer Guide content?"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"Some words about the nova-multiattach job, what it tests, and where it\u0027s"},{"line_number":128,"context_line":"defined (nova repo - link)."}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_93d28e27","line":125,"range":{"start_line":125,"start_character":43,"end_line":125,"end_character":58},"updated":"2018-02-12 16:37:53.000000000","message":"If you have a dev guide, you could throw it there.\n\nThe link to the job definition is here btw:\n\nhttp://git.openstack.org/cgit/openstack/nova/tree/playbooks/legacy/nova-multiattach/run.yaml\n\nAlternatively, we leave this for something in the nova docs and just omit it from the cinder docs.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"5c8bf161ca67b79a5874a2d0c57bab17030e7397","unresolved":false,"context_lines":[{"line_number":127,"context_line":"Some words about the nova-multiattach job, what it tests, and where it\u0027s"},{"line_number":128,"context_line":"defined (nova repo - link)."},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"Nova items"},{"line_number":131,"context_line":"~~~~~~~~~~"},{"line_number":132,"context_line":""},{"line_number":133,"context_line":"Compute API caveats"}],"source_content_type":"text/x-rst","patch_set":7,"id":"3fa0c359_f3b3d2e7","line":130,"updated":"2018-02-12 16:37:53.000000000","message":"We can start a new doc under the \u0027manage volumes\u0027 section in the nova admin guide:\n\nhttps://docs.openstack.org/nova/latest/admin/\n\nAnd then just link to that from here.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":21,"context_line":"As a prerequisite `new Attach/Detach APIs were added to Cinder`_ in Ocata to"},{"line_number":22,"context_line":"overcome earlier limitations towards achieving volume multi-attach."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"In case you use Cinder together with Nova API calls switched to using the new"},{"line_number":25,"context_line":"API calls in the background in Queens, in case the required microversion is"},{"line_number":26,"context_line":"available. The switch is transparent to the user."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"How to create a \u0027multiattach\u0027 volume"},{"line_number":29,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_854f8169","line":26,"range":{"start_line":24,"start_character":0,"end_line":26,"end_character":10},"updated":"2018-02-13 19:53:07.000000000","message":"This is hard to read. Maybe:\n\n\"In case you use Cinder together with Nova, compute API calls were switched to using the new block storage volume attachment APIs in Queens, if the required block storage API microversion is available.\"","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":21,"context_line":"As a prerequisite `new Attach/Detach APIs were added to Cinder`_ in Ocata to"},{"line_number":22,"context_line":"overcome earlier limitations towards achieving volume multi-attach."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"In case you use Cinder together with Nova API calls switched to using the new"},{"line_number":25,"context_line":"API calls in the background in Queens, in case the required microversion is"},{"line_number":26,"context_line":"available. The switch is transparent to the user."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"How to create a \u0027multiattach\u0027 volume"},{"line_number":29,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_a89a9410","line":26,"range":{"start_line":24,"start_character":0,"end_line":26,"end_character":10},"in_reply_to":"3fa0c359_854f8169","updated":"2018-02-14 11:38:17.000000000","message":"Done","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"32280bdeabfcd1e9efb1b74f7643b1516f92a977","unresolved":false,"context_lines":[{"line_number":32,"context_line":"have the \u0027multiattach\u0027 flag set to \u0027True\u0027 in the volume details. Please ensure"},{"line_number":33,"context_line":"you have the right role and policy settings before performing the operation."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Currently you can set it in two ways."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_ef6666bb","line":35,"range":{"start_line":35,"start_character":0,"end_line":35,"end_character":37},"updated":"2018-02-13 18:42:12.000000000","message":"Did you mean to leave this sentence here?  Seems to be just dangling with no further information.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":32,"context_line":"have the \u0027multiattach\u0027 flag set to \u0027True\u0027 in the volume details. Please ensure"},{"line_number":33,"context_line":"you have the right role and policy settings before performing the operation."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Currently you can set it in two ways."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_e55c451a","line":35,"range":{"start_line":35,"start_character":0,"end_line":35,"end_character":37},"in_reply_to":"3fa0c359_4fe51adb","updated":"2018-02-13 19:53:07.000000000","message":"Maybe just re-word this be, \"You can create a multiattach volume in two ways.\"\n\nBecause when I read the sentence above about policy settings, I thought this would now talk about policy.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":32,"context_line":"have the \u0027multiattach\u0027 flag set to \u0027True\u0027 in the volume details. Please ensure"},{"line_number":33,"context_line":"you have the right role and policy settings before performing the operation."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Currently you can set it in two ways."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_08b4e87e","line":35,"range":{"start_line":35,"start_character":0,"end_line":35,"end_character":37},"in_reply_to":"3fa0c359_e55c451a","updated":"2018-02-14 11:38:17.000000000","message":"Done","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"d562a31690491fa98221ea7884d3a10658973a51","unresolved":false,"context_lines":[{"line_number":32,"context_line":"have the \u0027multiattach\u0027 flag set to \u0027True\u0027 in the volume details. Please ensure"},{"line_number":33,"context_line":"you have the right role and policy settings before performing the operation."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Currently you can set it in two ways."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_4fe51adb","line":35,"range":{"start_line":35,"start_character":0,"end_line":35,"end_character":37},"in_reply_to":"3fa0c359_ef6666bb","updated":"2018-02-13 18:55:09.000000000","message":"The below two sections are sub-sections which I wanted to refer to here. Just Gerrit doesn\u0027t really show the difference between \u0027~\u0027 and \u0027-\u0027.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"32280bdeabfcd1e9efb1b74f7643b1516f92a977","unresolved":false,"context_lines":[{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"   For information on back ends that provide the functionality see"},{"line_number":40,"context_line":"   :ref:`back-end-support`."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Multiattach volume type"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_0f763271","line":39,"range":{"start_line":39,"start_character":22,"end_line":39,"end_character":31},"updated":"2018-02-13 18:42:12.000000000","message":"backends","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"d562a31690491fa98221ea7884d3a10658973a51","unresolved":false,"context_lines":[{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"   For information on back ends that provide the functionality see"},{"line_number":40,"context_line":"   :ref:`back-end-support`."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Multiattach volume type"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_af0b7e8b","line":39,"range":{"start_line":39,"start_character":22,"end_line":39,"end_character":31},"in_reply_to":"3fa0c359_0f763271","updated":"2018-02-13 18:55:09.000000000","message":"As a docs veteran, I need to defend this one it is actually correct here. :)\n\nSee this for reference: https://docs.openstack.org/doc-contrib-guide/writing-style/word-choice.html","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"9e449cdf03e8e4a924a64c658828407b88da6246","unresolved":false,"context_lines":[{"line_number":36,"context_line":""},{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"   For information on back ends that provide the functionality see"},{"line_number":40,"context_line":"   :ref:`back-end-support`."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Multiattach volume type"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_ab791cc5","line":39,"range":{"start_line":39,"start_character":22,"end_line":39,"end_character":31},"in_reply_to":"3fa0c359_af0b7e8b","updated":"2018-02-14 15:11:24.000000000","message":"Fair enough.  Using \u0027backends\u0027 is kind-of convention in Cinder though you are right, it is not correct from a spelling standpoint.  :-)","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"   For information on back ends that provide the functionality see"},{"line_number":40,"context_line":"   :ref:`back-end-support`."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Multiattach volume type"},{"line_number":43,"context_line":"-----------------------"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_45a3b900","line":40,"range":{"start_line":40,"start_character":3,"end_line":40,"end_character":26},"updated":"2018-02-13 19:53:07.000000000","message":"Titles are implicit links, so just `Back end support`_ I think works.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":37,"context_line":".. note::"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"   For information on back ends that provide the functionality see"},{"line_number":40,"context_line":"   :ref:`back-end-support`."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Multiattach volume type"},{"line_number":43,"context_line":"-----------------------"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_68a00c43","line":40,"range":{"start_line":40,"start_character":3,"end_line":40,"end_character":26},"in_reply_to":"3fa0c359_45a3b900","updated":"2018-02-14 11:38:17.000000000","message":"Worth a try. Thanks.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":54,"context_line":""},{"line_number":55,"context_line":".. note::"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"   Creating a new volume type is an admin-only operation by default, you need"},{"line_number":58,"context_line":"   to change the settings in the \u0027policy.json\u0027 configuration file."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"To create the volume you need to use the volume type you created earlier, like"},{"line_number":61,"context_line":"this:"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_a5895d75","line":58,"range":{"start_line":57,"start_character":67,"end_line":58,"end_character":66},"updated":"2018-02-13 19:53:07.000000000","message":"This reads a bit funny, maybe:\n\n\"Creating a new volume type is an admin-only operation by default, which can be changed via the *policy.json* configuration file.\"","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":54,"context_line":""},{"line_number":55,"context_line":".. note::"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"   Creating a new volume type is an admin-only operation by default, you need"},{"line_number":58,"context_line":"   to change the settings in the \u0027policy.json\u0027 configuration file."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"To create the volume you need to use the volume type you created earlier, like"},{"line_number":61,"context_line":"this:"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_0862a80a","line":58,"range":{"start_line":57,"start_character":67,"end_line":58,"end_character":66},"in_reply_to":"3fa0c359_a5895d75","updated":"2018-02-14 11:38:17.000000000","message":"LOL, it\u0027s not really what I wanted to write... :)","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: console"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --volume-type \u003cvolume_type_uuid\u003e"},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":68,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_059a91b7","line":65,"updated":"2018-02-13 19:53:07.000000000","message":"I still think you should use the OSC CLIs but it\u0027s fine either way.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":98,"context_line":"Back end support"},{"line_number":99,"context_line":"~~~~~~~~~~~~~~~~"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"In order to have the feature available multi-attach needs to be supported by"},{"line_number":102,"context_line":"the chosen back end which is indicated through capabilities in the"},{"line_number":103,"context_line":"corresponding volume driver."},{"line_number":104,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_05c851a3","line":101,"range":{"start_line":101,"start_character":29,"end_line":101,"end_character":38},"updated":"2018-02-13 19:53:07.000000000","message":"available,","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"32280bdeabfcd1e9efb1b74f7643b1516f92a977","unresolved":false,"context_lines":[{"line_number":99,"context_line":"~~~~~~~~~~~~~~~~"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"In order to have the feature available multi-attach needs to be supported by"},{"line_number":102,"context_line":"the chosen back end which is indicated through capabilities in the"},{"line_number":103,"context_line":"corresponding volume driver."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"The reference implementation is available on LVM in the Queens release. You can"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_2ff68ed8","line":102,"range":{"start_line":102,"start_character":11,"end_line":102,"end_character":19},"updated":"2018-02-13 18:42:12.000000000","message":"backend","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"d562a31690491fa98221ea7884d3a10658973a51","unresolved":false,"context_lines":[{"line_number":99,"context_line":"~~~~~~~~~~~~~~~~"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"In order to have the feature available multi-attach needs to be supported by"},{"line_number":102,"context_line":"the chosen back end which is indicated through capabilities in the"},{"line_number":103,"context_line":"corresponding volume driver."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"The reference implementation is available on LVM in the Queens release. You can"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_6f01f669","line":102,"range":{"start_line":102,"start_character":11,"end_line":102,"end_character":19},"in_reply_to":"3fa0c359_2ff68ed8","updated":"2018-02-13 18:55:09.000000000","message":"See my comment above.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":116,"context_line":"Multiattach policy"},{"line_number":117,"context_line":"------------------"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"This is a general policy to allow the creation or retyping of multiattach"},{"line_number":120,"context_line":"volumes is a volume create policy with the name ``volume:multiattach``."},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"The default setting of this policy is ``rule:admin_or_owner``."},{"line_number":123,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_453f3986","line":120,"range":{"start_line":119,"start_character":0,"end_line":120,"end_character":47},"updated":"2018-02-13 19:53:07.000000000","message":"This is hard to read, maybe:\n\n\"The general policy rule to allow the creation or retyping of multiattach volumes is named ``volume:multiattach``.\"","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":116,"context_line":"Multiattach policy"},{"line_number":117,"context_line":"------------------"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"This is a general policy to allow the creation or retyping of multiattach"},{"line_number":120,"context_line":"volumes is a volume create policy with the name ``volume:multiattach``."},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"The default setting of this policy is ``rule:admin_or_owner``."},{"line_number":123,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_63202d9c","line":120,"range":{"start_line":119,"start_character":0,"end_line":120,"end_character":47},"in_reply_to":"3fa0c359_453f3986","updated":"2018-02-14 11:38:17.000000000","message":"Done","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4700c7c810a6f908a08880748655ef7f03e91391","unresolved":false,"context_lines":[{"line_number":134,"context_line":"~~~~~~~~~~~~"},{"line_number":135,"context_line":".. todo:: Clarify what issues we\u0027re facing right now on the Cinder side."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"- retype with a multiattach volume is not supported (this is in the cinder"},{"line_number":138,"context_line":"  api reference already); however, there is no api-ref for volume migration"},{"line_number":139,"context_line":"  which is the admin-level operation but does a swap volume underneath."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":".. _`Cinder`: https://specs.openstack.org/openstack/cinder-specs/specs/queens/enable-multiattach.html"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_e54d253b","line":138,"range":{"start_line":137,"start_character":52,"end_line":138,"end_character":25},"updated":"2018-02-13 19:53:07.000000000","message":"You could remove this, it was a note to myself when writing the first draft.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":134,"context_line":"~~~~~~~~~~~~"},{"line_number":135,"context_line":".. todo:: Clarify what issues we\u0027re facing right now on the Cinder side."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"- retype with a multiattach volume is not supported (this is in the cinder"},{"line_number":138,"context_line":"  api reference already); however, there is no api-ref for volume migration"},{"line_number":139,"context_line":"  which is the admin-level operation but does a swap volume underneath."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":".. _`Cinder`: https://specs.openstack.org/openstack/cinder-specs/specs/queens/enable-multiattach.html"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3fa0c359_0344c945","line":138,"range":{"start_line":137,"start_character":52,"end_line":138,"end_character":25},"in_reply_to":"3fa0c359_e54d253b","updated":"2018-02-14 11:38:17.000000000","message":"Not sure how much sense this all means to a user as I still couldn\u0027t get volume migration straight in my head overall... :/\n\nEspecially that you\u0027re supposed to create a multiattach volume with using volume types, where retyping is fine if the volume is \u0027available\u0027.\n\nI\u0027m happy to take any further suggestions on this one.","commit_id":"3a9aeb61dcc4c0d6fd31b2a8be588fee1dfab636"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"e90f47e9cb3d4847d1848fce17b59d865360b2d1","unresolved":false,"context_lines":[{"line_number":24,"context_line":"In case you use Cinder together with Nova, compute API calls were switched to"},{"line_number":25,"context_line":"using the new block storage volume attachment APIs in Queens, if the required"},{"line_number":26,"context_line":"block storage API microversion is available."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"How to create a \u0027multiattach\u0027 volume"},{"line_number":29,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":30,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"3fa0c359_83b3f9e8","line":27,"updated":"2018-02-13 21:22:06.000000000","message":"I would add a short little reference to the nova docs, something like:\n\nFor more information on using multiattach volumes with the compute service, refer to the `compute admin guide \u003chttps://docs.openstack.org/nova/latest/admin/manage-volumes.html#volume-multi-attach\u003e`_.","commit_id":"ac10cb462c42e154356f22d53075e38055e1fcea"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"e90f47e9cb3d4847d1848fce17b59d865360b2d1","unresolved":false,"context_lines":[{"line_number":54,"context_line":""},{"line_number":55,"context_line":".. note::"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"   Creating a new volume type is an admin-only operation by default, you can"},{"line_number":58,"context_line":"   can change the settings in the \u0027policy.json\u0027 configuration file in case"},{"line_number":59,"context_line":"   needed."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To create the volume you need to use the volume type you created earlier, like"}],"source_content_type":"text/x-rst","patch_set":9,"id":"3fa0c359_83ac599f","line":58,"range":{"start_line":57,"start_character":73,"end_line":58,"end_character":6},"updated":"2018-02-13 21:22:06.000000000","message":"can","commit_id":"ac10cb462c42e154356f22d53075e38055e1fcea"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"e90f47e9cb3d4847d1848fce17b59d865360b2d1","unresolved":false,"context_lines":[{"line_number":55,"context_line":".. note::"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"   Creating a new volume type is an admin-only operation by default, you can"},{"line_number":58,"context_line":"   can change the settings in the \u0027policy.json\u0027 configuration file in case"},{"line_number":59,"context_line":"   needed."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To create the volume you need to use the volume type you created earlier, like"}],"source_content_type":"text/x-rst","patch_set":9,"id":"3fa0c359_e39c3d6b","line":58,"range":{"start_line":58,"start_character":67,"end_line":58,"end_character":74},"updated":"2018-02-13 21:22:06.000000000","message":"s/in case/if/","commit_id":"ac10cb462c42e154356f22d53075e38055e1fcea"},{"author":{"_account_id":11904,"name":"Sean McGinnis","email":"sean.mcginnis@gmail.com","username":"SeanM"},"change_message_id":"68decfb310495c044f7bb91952cf1abb41307ef2","unresolved":false,"context_lines":[{"line_number":69,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --volume-type \u003cvolume_type_uuid\u003e"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":72,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"},{"line_number":73,"context_line":"``available``."},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"The reasoning behind the limitation is that some consumers/hypervisors need to"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_7e368253","line":72,"range":{"start_line":72,"start_character":62,"end_line":72,"end_character":66},"updated":"2018-02-13 22:03:39.000000000","message":"its","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":69,"context_line":"   $ cinder create \u003cvolume_size\u003e --name \u003cvolume_name\u003e --volume-type \u003cvolume_type_uuid\u003e"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"In addition, it is possible to retype a volume to be (or not to be) multiattach"},{"line_number":72,"context_line":"capable. Currently however we only allow retyping a volume if it\u0027s status is"},{"line_number":73,"context_line":"``available``."},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"The reasoning behind the limitation is that some consumers/hypervisors need to"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_e4143946","line":72,"range":{"start_line":72,"start_character":62,"end_line":72,"end_character":66},"in_reply_to":"3fa0c359_7e368253","updated":"2018-02-14 11:38:17.000000000","message":"Nice catch!","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":11904,"name":"Sean McGinnis","email":"sean.mcginnis@gmail.com","username":"SeanM"},"change_message_id":"68decfb310495c044f7bb91952cf1abb41307ef2","unresolved":false,"context_lines":[{"line_number":123,"context_line":""},{"line_number":124,"context_line":"The default setting of this policy is ``rule:admin_or_owner``."},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Multiattach policy for bootable volumes"},{"line_number":127,"context_line":"---------------------------------------"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"This is a policy to disallow the ability to create multiple attachments on a"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_9e7b4ef3","line":126,"updated":"2018-02-13 22:03:39.000000000","message":"It seems like we should have more in here about the multiattach boot volume scenario, but I don\u0027t know any details about how that is supposed to work. I think John Garbutt had a use case in Denver, but I don\u0027t have any experience with that to provide any recommendations.","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"dbf781f792a4bbffcf3d0ed04e84c29e6a57f42e","unresolved":false,"context_lines":[{"line_number":123,"context_line":""},{"line_number":124,"context_line":"The default setting of this policy is ``rule:admin_or_owner``."},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Multiattach policy for bootable volumes"},{"line_number":127,"context_line":"---------------------------------------"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"This is a policy to disallow the ability to create multiple attachments on a"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_ddfb19bb","line":126,"in_reply_to":"3fa0c359_9e7b4ef3","updated":"2018-02-14 02:13:25.000000000","message":"Looks like that was the discussion starting on L59 here:\n\nhttps://etherpad.openstack.org/p/cinder-ptg-queens-thursday-notes\n\nBut nothing really stands out to me in there except for saying we wanted policy controls in place so operators could disable it, which we have. The only thing mentioned in the etherpad that we don\u0027t have is policy rules that are granular down to the level of attach mode for boot from volume. During the nova spec review I think we just decided to punt on that.\n\nhttps://review.openstack.org/#/c/499777/5/specs/queens/approved/cinder-volume-multi-attach.rst@87\n\nIt could have also been during one of the weekly meetings.","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":123,"context_line":""},{"line_number":124,"context_line":"The default setting of this policy is ``rule:admin_or_owner``."},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Multiattach policy for bootable volumes"},{"line_number":127,"context_line":"---------------------------------------"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"This is a policy to disallow the ability to create multiple attachments on a"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_a4b6313d","line":126,"in_reply_to":"3fa0c359_ddfb19bb","updated":"2018-02-14 11:38:17.000000000","message":"What we were discussing back and forth is to boot from a volume that\u0027s attached with RW in every case and whether or not it is a wise idea. Then we ended up with the conclusion of letting anyone shoot themselves in the foot if that\u0027s what they wish and give the opportunity to turn this off to everyone else.\n\nI can add a note about booting multiple instances from the same volume attached in RW and think about it twice if you think that\u0027s needed?","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":11904,"name":"Sean McGinnis","email":"sean.mcginnis@gmail.com","username":"SeanM"},"change_message_id":"68decfb310495c044f7bb91952cf1abb41307ef2","unresolved":false,"context_lines":[{"line_number":136,"context_line":"~~~~~~~~~~~~"},{"line_number":137,"context_line":".. todo:: Clarify what issues we\u0027re facing right now on the Cinder side."},{"line_number":138,"context_line":""},{"line_number":139,"context_line":"- retype with a multiattach volume is not supported; however, there is no"},{"line_number":140,"context_line":"  api-ref for volume migration which is the admin-level operation but does a"},{"line_number":141,"context_line":"  swap volume underneath."},{"line_number":142,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_7e8442d3","line":139,"range":{"start_line":139,"start_character":2,"end_line":139,"end_character":51},"updated":"2018-02-13 22:03:39.000000000","message":"We just said on line 71 that it is supported.","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"dbf781f792a4bbffcf3d0ed04e84c29e6a57f42e","unresolved":false,"context_lines":[{"line_number":136,"context_line":"~~~~~~~~~~~~"},{"line_number":137,"context_line":".. todo:: Clarify what issues we\u0027re facing right now on the Cinder side."},{"line_number":138,"context_line":""},{"line_number":139,"context_line":"- retype with a multiattach volume is not supported; however, there is no"},{"line_number":140,"context_line":"  api-ref for volume migration which is the admin-level operation but does a"},{"line_number":141,"context_line":"  swap volume underneath."},{"line_number":142,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_fd237554","line":139,"range":{"start_line":139,"start_character":2,"end_line":139,"end_character":51},"in_reply_to":"3fa0c359_7e8442d3","updated":"2018-02-14 02:13:25.000000000","message":"Good point, it\u0027s more specific when it\u0027s not supported. From the API reference:\n\nhttps://developer.openstack.org/api-ref/block-storage/v3/#retype-a-volume\n\n\"Retyping an in-use volume from a multiattach-capable type to a non-multiattach-capable type, or vice-versa, is not supported. It is generally not recommended to retype an in-use multiattach volume if that volume has more than one active read/write attachment.\"\n\nSo that\u0027s likely what we should put here (just copy the API reference note).","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"52668cff0718d425ffccc3cec6333d133941ea4c","unresolved":false,"context_lines":[{"line_number":136,"context_line":"~~~~~~~~~~~~"},{"line_number":137,"context_line":".. todo:: Clarify what issues we\u0027re facing right now on the Cinder side."},{"line_number":138,"context_line":""},{"line_number":139,"context_line":"- retype with a multiattach volume is not supported; however, there is no"},{"line_number":140,"context_line":"  api-ref for volume migration which is the admin-level operation but does a"},{"line_number":141,"context_line":"  swap volume underneath."},{"line_number":142,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"3fa0c359_a452b1dc","line":139,"range":{"start_line":139,"start_character":2,"end_line":139,"end_character":51},"in_reply_to":"3fa0c359_fd237554","updated":"2018-02-14 11:38:17.000000000","message":"Done","commit_id":"6382a5a2abd30694d98f338d0c9885e99c6a446e"},{"author":{"_account_id":11536,"name":"hongbin","email":"hongbin034@gmail.com","username":"hongbin"},"change_message_id":"99f6785799c2b0f3acf34ad295d4a5f577d71607","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":".. warning::"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"   It is the responsibility of the user to ensure that a multiattach or"},{"line_number":16,"context_line":"   clustered file system is used on the volumes. Otherwise there may be a high"},{"line_number":17,"context_line":"   probability of data corruption."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"In Cinder the functionality is available from microversion \u00273.50\u0027 or higher."}],"source_content_type":"text/x-rst","patch_set":11,"id":"3f79a3b5_ebfe4704","line":16,"range":{"start_line":15,"start_character":57,"end_line":16,"end_character":24},"updated":"2018-09-08 23:24:23.000000000","message":"It is true this is the user responsibility but I think providing more guidance on this would be nice.","commit_id":"cb361631eda6df5a989b6543fb27533bd9f5fdfe"}],"doc/source/admin/multiattach.rst":[{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"078f78ae19ac747240ab2ad7d833e1007e7adae6","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Volume multi-attach"},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":".. todo:: Give a brief overview of what it is and in what releases for cinder"},{"line_number":6,"context_line":"          and nova it was added. Could probably copy some wording out of the"},{"line_number":7,"context_line":"          nova or cinder specs (also link to the respective specs for more"},{"line_number":8,"context_line":"          details)."}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa0c359_03f8f7e2","line":5,"range":{"start_line":5,"start_character":3,"end_line":5,"end_character":7},"updated":"2018-02-06 22:58:56.000000000","message":"This directive fails for some reason:\n\nhttp://logs.openstack.org/47/540047/1/check/build-openstack-sphinx-docs/59d3299/job-output.txt.gz#_2018-02-01_17_29_01_740170\n\nNot sure why since this extension is defined:\n\nhttps://github.com/openstack/cinder/blob/master/doc/source/conf.py#L81","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"fc833075bcfe7abe0edd143108d6c5a90442c373","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Volume multi-attach"},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":".. todo:: Give a brief overview of what it is and in what releases for cinder"},{"line_number":6,"context_line":"          and nova it was added. Could probably copy some wording out of the"},{"line_number":7,"context_line":"          nova or cinder specs (also link to the respective specs for more"},{"line_number":8,"context_line":"          details)."}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa0c359_fe07961b","line":5,"range":{"start_line":5,"start_character":3,"end_line":5,"end_character":7},"in_reply_to":"3fa0c359_03f8f7e2","updated":"2018-02-07 08:39:15.000000000","message":"When a note/todo is multi-line you need a different formatting and it also seems the extension was missing from the list in conf.py.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"7ff628311cd0212804df804150bb62de6dec4eae","unresolved":false,"context_lines":[{"line_number":6,"context_line":"          and nova it was added. Could probably copy some wording out of the"},{"line_number":7,"context_line":"          nova or cinder specs (also link to the respective specs for more"},{"line_number":8,"context_line":"          details)."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"How to create a multiattach volume type"},{"line_number":11,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":12,"context_line":"TODO - CLI examples; also should probably mention that you can create a"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f93b717_d57f8963","line":9,"updated":"2018-02-01 18:32:29.000000000","message":"Like below we should include info on the microversions.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"fc833075bcfe7abe0edd143108d6c5a90442c373","unresolved":false,"context_lines":[{"line_number":7,"context_line":"          nova or cinder specs (also link to the respective specs for more"},{"line_number":8,"context_line":"          details)."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"How to create a multiattach volume type"},{"line_number":11,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":12,"context_line":"TODO - CLI examples; also should probably mention that you can create a"},{"line_number":13,"context_line":"multiattach volume without a specific volume type, but that ability will"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa0c359_11bb530e","line":10,"range":{"start_line":10,"start_character":0,"end_line":10,"end_character":39},"updated":"2018-02-07 08:39:15.000000000","message":"BTW John wrote up a short section on this: https://docs.openstack.org/cinder/latest/admin/blockstorage-volume-multiattach.html\n\nI will merge the two.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"7ff628311cd0212804df804150bb62de6dec4eae","unresolved":false,"context_lines":[{"line_number":12,"context_line":"TODO - CLI examples; also should probably mention that you can create a"},{"line_number":13,"context_line":"multiattach volume without a specific volume type, but that ability will"},{"line_number":14,"context_line":"likely be deprecated in the REST API in the future."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"RO / RW caveats (the secondary RW attachment issue)"},{"line_number":17,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":18,"context_line":"By default, secondary volume attachments are made in read/write mode"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f93b717_558b7966","line":15,"updated":"2018-02-01 18:32:29.000000000","message":"Should maybe have a note about retyping a volume to enable multiattach.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"fc833075bcfe7abe0edd143108d6c5a90442c373","unresolved":false,"context_lines":[{"line_number":12,"context_line":"TODO - CLI examples; also should probably mention that you can create a"},{"line_number":13,"context_line":"multiattach volume without a specific volume type, but that ability will"},{"line_number":14,"context_line":"likely be deprecated in the REST API in the future."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"RO / RW caveats (the secondary RW attachment issue)"},{"line_number":17,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":18,"context_line":"By default, secondary volume attachments are made in read/write mode"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa0c359_b137ffb0","line":15,"in_reply_to":"5f93b717_558b7966","updated":"2018-02-07 08:39:15.000000000","message":"See my previous comment.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":11904,"name":"Sean McGinnis","email":"sean.mcginnis@gmail.com","username":"SeanM"},"change_message_id":"86dff8a424972639b642e9f165e836f3873b6632","unresolved":false,"context_lines":[{"line_number":41,"context_line":"~~~~~~~~~~~~"},{"line_number":42,"context_line":"Describe the various policy rules for volume multiattach in Cinder."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Known issues"},{"line_number":45,"context_line":"~~~~~~~~~~~~"},{"line_number":46,"context_line":"- retype with a multiattach volume is not supported (this is in the cinder"},{"line_number":47,"context_line":"  api reference already); however, there is no api-ref for volume migration"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f93b717_5f44f846","line":44,"updated":"2018-02-01 17:23:27.000000000","message":"Not sure where, but I think we need something explicit in here about using a clustered filesystem or other control to prevent data corruption from the multiple nodes writing to the same volume.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":7198,"name":"Jay Bryant","email":"jungleboyj@electronicjungle.net","username":"jsbryant"},"change_message_id":"7ff628311cd0212804df804150bb62de6dec4eae","unresolved":false,"context_lines":[{"line_number":41,"context_line":"~~~~~~~~~~~~"},{"line_number":42,"context_line":"Describe the various policy rules for volume multiattach in Cinder."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Known issues"},{"line_number":45,"context_line":"~~~~~~~~~~~~"},{"line_number":46,"context_line":"- retype with a multiattach volume is not supported (this is in the cinder"},{"line_number":47,"context_line":"  api reference already); however, there is no api-ref for volume migration"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f93b717_95aca1ed","line":44,"in_reply_to":"5f93b717_5f44f846","updated":"2018-02-01 18:32:29.000000000","message":"Yes.  A big \u0027WARNING\u0027 block.","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"fc833075bcfe7abe0edd143108d6c5a90442c373","unresolved":false,"context_lines":[{"line_number":48,"context_line":"  which is the admin-level operation but does a swap volume underneath."},{"line_number":49,"context_line":"- libvirt/qemu version restrictions; libvirt\u003e\u003d3.10 or qemu\u003c2.10."},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"Testing"},{"line_number":52,"context_line":"~~~~~~~"},{"line_number":53,"context_line":"Some words about the nova-multiattach job, what it tests, and where it\u0027s"},{"line_number":54,"context_line":"defined (nova repo - link)."}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa0c359_f16d8798","line":51,"range":{"start_line":51,"start_character":0,"end_line":51,"end_character":7},"updated":"2018-02-07 08:39:15.000000000","message":"As it\u0027s about the test job, is this admin guide or rather developer guide content?","commit_id":"5f4fd2be50b73326dd2499e88aed98e6f0b54ce4"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"40c10115d34e43a70870d60ad5c12d9a62449732","unresolved":false,"context_lines":[{"line_number":38,"context_line":"- boot from volume and normal attach are supported"},{"line_number":39,"context_line":"- volume attach to a shelved offloaded instance is not supported"},{"line_number":40,"context_line":"- the compute hosting the instance must be new enough to support multiattach"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Policy rules"},{"line_number":43,"context_line":"~~~~~~~~~~~~"},{"line_number":44,"context_line":"Describe the various policy rules for volume multiattach in Cinder."}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa0c359_80903d50","line":41,"updated":"2018-02-08 18:26:26.000000000","message":"Can\u0027t create multiple instances in the same server create request with the same volume:\n\nhttps://bugs.launchpad.net/nova/+bug/1747985","commit_id":"675e8d161819572988e8867539bdab7a5ca87534"}],"doc/source/conf.py":[{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"47f518f8de911275c7bd290eef3fa2d36bb3d01c","unresolved":false,"context_lines":[{"line_number":56,"context_line":"              \u0027sphinx.ext.coverage\u0027,"},{"line_number":57,"context_line":"              \u0027sphinx.ext.ifconfig\u0027,"},{"line_number":58,"context_line":"              \u0027sphinx.ext.graphviz\u0027,"},{"line_number":59,"context_line":"              \u0027sphinx.ext.todo\u0027,"},{"line_number":60,"context_line":"              \u0027openstackdocstheme\u0027,"},{"line_number":61,"context_line":"              \u0027stevedore.sphinxext\u0027,"},{"line_number":62,"context_line":"              \u0027oslo_config.sphinxconfiggen\u0027,"}],"source_content_type":"text/x-python","patch_set":7,"id":"3fa0c359_42fbb2bf","line":59,"updated":"2018-02-13 17:22:17.000000000","message":"Can probably remove this if you\u0027re not trying to use a todo declaration.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"2f204b01489b7876624b8f73f64df4bb7b53be6b","unresolved":false,"context_lines":[{"line_number":56,"context_line":"              \u0027sphinx.ext.coverage\u0027,"},{"line_number":57,"context_line":"              \u0027sphinx.ext.ifconfig\u0027,"},{"line_number":58,"context_line":"              \u0027sphinx.ext.graphviz\u0027,"},{"line_number":59,"context_line":"              \u0027sphinx.ext.todo\u0027,"},{"line_number":60,"context_line":"              \u0027openstackdocstheme\u0027,"},{"line_number":61,"context_line":"              \u0027stevedore.sphinxext\u0027,"},{"line_number":62,"context_line":"              \u0027oslo_config.sphinxconfiggen\u0027,"}],"source_content_type":"text/x-python","patch_set":7,"id":"3fa0c359_fd485f5c","line":59,"in_reply_to":"3fa0c359_42fbb2bf","updated":"2018-02-13 18:29:59.000000000","message":"Yeah, can fix it in another patch.","commit_id":"a0be477b277899d2dbb5d86f7e9770045b2a38bd"}]}