)]}'
{"doc/source/admin/cephfs_driver.rst":[{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"07608e4d3565f2ec243b54646292d0dd6e323893","unresolved":true,"context_lines":[{"line_number":147,"context_line":"to use:"},{"line_number":148,"context_line":""},{"line_number":149,"context_line":".. code-block:: console"},{"line_number":150,"context_line":""},{"line_number":151,"context_line":"    read -d \u0027\u0027 MON_CAPS \u003c\u003c EOF"},{"line_number":152,"context_line":"    allow r,"},{"line_number":153,"context_line":"    allow command \"auth del\","},{"line_number":154,"context_line":"    allow command \"auth caps\","},{"line_number":155,"context_line":"    allow command \"auth get\","},{"line_number":156,"context_line":"    allow command \"auth get-or-create\""},{"line_number":157,"context_line":"    EOF"},{"line_number":158,"context_line":""},{"line_number":159,"context_line":"    ceph auth get-or-create client.manila -o manila.keyring \\"},{"line_number":160,"context_line":"    mds \u0027allow *\u0027 \\"},{"line_number":161,"context_line":"    osd \u0027allow rw\u0027 \\"},{"line_number":162,"context_line":"    mgr \u0027allow r\u0027 \\"},{"line_number":163,"context_line":"    mon \"$MON_CAPS\""},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"From Wallaby and above, we are issuing rados mgr volume commands via a rados client,"},{"line_number":166,"context_line":"using the pool name set with the config option \"ganesha_rados_store_pool_name\"."},{"line_number":167,"context_line":"For enhanced security, the auth ID should be set as follows:"},{"line_number":168,"context_line":""},{"line_number":169,"context_line":".. code-block:: console"},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"    ceph auth get-or-create client.manila -o manila.keyring \\"},{"line_number":172,"context_line":"      osd \u0027allow rw pool\u003d\u003cganesha_rados_store_pool_name\u003e\" \\"},{"line_number":173,"context_line":"      mgr \u0027allow rw\u0027 \\"},{"line_number":174,"context_line":"      mon \u0027allow r\u0027"},{"line_number":175,"context_line":""},{"line_number":176,"context_line":"``manila.keyring``, along with your ``ceph.conf`` file, will then need to be"},{"line_number":177,"context_line":"placed on the server running the :term:`manila-share` service."}],"source_content_type":"text/x-rst","patch_set":1,"id":"bd5e4959_70b102e3","line":174,"range":{"start_line":150,"start_character":0,"end_line":174,"end_character":19},"updated":"2021-04-09 22:44:14.000000000","message":"These docs are versioned, so we don\u0027t need the older caps.","commit_id":"dfe90c149eeaf2ef5e38c9071ccc26ca481cf743"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"07608e4d3565f2ec243b54646292d0dd6e323893","unresolved":true,"context_lines":[{"line_number":535,"context_line":"  restricted to access only that particular RADOS namespace."},{"line_number":536,"context_line":"  https://docs.ceph.com/docs/nautilus/cephfs/file-layouts/"},{"line_number":537,"context_line":""},{"line_number":538,"context_line":"- An additional level of resource isolation can be provided by mapping a"},{"line_number":539,"context_line":"  share\u0027s contents to a separate RADOS pool. This layout would be preferred"},{"line_number":540,"context_line":"  only for cloud deployments with a limited number of shares needing strong"},{"line_number":541,"context_line":"  resource separation. You can do this by setting a share type specification,"},{"line_number":542,"context_line":"  ``cephfs:data_isolated`` for the share type used by the cephfs driver."},{"line_number":543,"context_line":""},{"line_number":544,"context_line":"  .. code-block:: console"},{"line_number":545,"context_line":""},{"line_number":546,"context_line":"    manila type-key cephfstype set cephfs:data_isolated\u003dTrue"},{"line_number":547,"context_line":""},{"line_number":548,"context_line":".. _security_cephfs_native:"},{"line_number":549,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"b70506cd_d98682dd","line":546,"range":{"start_line":538,"start_character":0,"end_line":546,"end_character":60},"updated":"2021-04-09 22:44:14.000000000","message":"we can remove this now","commit_id":"dfe90c149eeaf2ef5e38c9071ccc26ca481cf743"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"51c0b7fbc7ef46cce26d97f11321f05199137239","unresolved":true,"context_lines":[{"line_number":239,"context_line":"using the section name. In this example we are also including another backend"},{"line_number":240,"context_line":"(\"generic1\"), you would include whatever other backends you have configured."},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"Finally, edit ``cephfs_filesystem_name`` with the name of the ceph volume"},{"line_number":243,"context_line":"you want to use. By default, this value is set to \"cephfs\"."},{"line_number":244,"context_line":""},{"line_number":245,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"800e5577_7866a222","line":242,"updated":"2021-04-22 18:14:31.000000000","message":"s/ceph volume/Ceph file system (also referred to as a Ceph FS volume)/","commit_id":"c1e65a45472830849bdb3d8eeb5385945129ad51"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"c67ab74cca892db152c765733dd771b425aba3b6","unresolved":false,"context_lines":[{"line_number":239,"context_line":"using the section name. In this example we are also including another backend"},{"line_number":240,"context_line":"(\"generic1\"), you would include whatever other backends you have configured."},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"Finally, edit ``cephfs_filesystem_name`` with the name of the ceph volume"},{"line_number":243,"context_line":"you want to use. By default, this value is set to \"cephfs\"."},{"line_number":244,"context_line":""},{"line_number":245,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"7cc977ac_e2794845","line":242,"in_reply_to":"800e5577_7866a222","updated":"2021-04-22 19:32:31.000000000","message":"Done","commit_id":"c1e65a45472830849bdb3d8eeb5385945129ad51"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"51c0b7fbc7ef46cce26d97f11321f05199137239","unresolved":true,"context_lines":[{"line_number":240,"context_line":"(\"generic1\"), you would include whatever other backends you have configured."},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"Finally, edit ``cephfs_filesystem_name`` with the name of the ceph volume"},{"line_number":243,"context_line":"you want to use. By default, this value is set to \"cephfs\"."},{"line_number":244,"context_line":""},{"line_number":245,"context_line":""},{"line_number":246,"context_line":".. code-block:: ini"}],"source_content_type":"text/x-rst","patch_set":3,"id":"4667cba1_7440949d","line":243,"updated":"2021-04-22 18:14:31.000000000","message":"The code does not set a default value.\n\nIf you\u0027ve more than one Ceph file system in the cluster, you need to set this option.","commit_id":"c1e65a45472830849bdb3d8eeb5385945129ad51"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"c67ab74cca892db152c765733dd771b425aba3b6","unresolved":false,"context_lines":[{"line_number":240,"context_line":"(\"generic1\"), you would include whatever other backends you have configured."},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"Finally, edit ``cephfs_filesystem_name`` with the name of the ceph volume"},{"line_number":243,"context_line":"you want to use. By default, this value is set to \"cephfs\"."},{"line_number":244,"context_line":""},{"line_number":245,"context_line":""},{"line_number":246,"context_line":".. code-block:: ini"}],"source_content_type":"text/x-rst","patch_set":3,"id":"4c605601_3c3b4589","line":243,"in_reply_to":"4667cba1_7440949d","updated":"2021-04-22 19:32:31.000000000","message":"Done","commit_id":"c1e65a45472830849bdb3d8eeb5385945129ad51"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"51c0b7fbc7ef46cce26d97f11321f05199137239","unresolved":true,"context_lines":[{"line_number":317,"context_line":"  the ``ganesha_rados_store_enable`` option to True. If you want to use"},{"line_number":318,"context_line":"  one of the backend CephFS\u0027s RADOS pools, then using CephFS\u0027s data pool is"},{"line_number":319,"context_line":"  preferred over using its metadata pool."},{"line_number":320,"context_line":""},{"line_number":321,"context_line":"Edit ``enabled_share_backends`` to point to the driver\u0027s backend section"},{"line_number":322,"context_line":"using the section name, ``cephfsnfs1``."},{"line_number":323,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ed2ed521_4e535f7c","line":320,"updated":"2021-04-22 18:14:31.000000000","message":"* ``cephfs_filesystem_name`` to the name of the Ceph file system (also known as a Ceph FS volume) to use. Set this if you\u0027ve multiple file systems in the cluster.","commit_id":"c1e65a45472830849bdb3d8eeb5385945129ad51"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"c67ab74cca892db152c765733dd771b425aba3b6","unresolved":false,"context_lines":[{"line_number":317,"context_line":"  the ``ganesha_rados_store_enable`` option to True. If you want to use"},{"line_number":318,"context_line":"  one of the backend CephFS\u0027s RADOS pools, then using CephFS\u0027s data pool is"},{"line_number":319,"context_line":"  preferred over using its metadata pool."},{"line_number":320,"context_line":""},{"line_number":321,"context_line":"Edit ``enabled_share_backends`` to point to the driver\u0027s backend section"},{"line_number":322,"context_line":"using the section name, ``cephfsnfs1``."},{"line_number":323,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"2a9c2a1d_f7a411d0","line":320,"in_reply_to":"ed2ed521_4e535f7c","updated":"2021-04-22 19:32:31.000000000","message":"Done","commit_id":"c1e65a45472830849bdb3d8eeb5385945129ad51"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"781d52b67ec4a765764d042b215c35380801ebd1","unresolved":true,"context_lines":[{"line_number":102,"context_line":"+-------------------+----------+----------------------+-----------+"},{"line_number":103,"context_line":"| Victoria          | Nautilus | Nautilus, Octopus    | Nautilus  |"},{"line_number":104,"context_line":"+-------------------+----------+----------------------+-----------+"},{"line_number":105,"context_line":"| Wallaby           | Octopus  | Nautilus, Octopus    | Nautilus  |"},{"line_number":106,"context_line":"+-------------------+----------+----------------------+-----------+"},{"line_number":107,"context_line":""},{"line_number":108,"context_line":"Additionally, it is expected that the version of the Ceph client"}],"source_content_type":"text/x-rst","patch_set":4,"id":"0e18a384_b9bf1058","line":105,"range":{"start_line":105,"start_character":56,"end_line":105,"end_character":64},"updated":"2021-04-26 17:55:04.000000000","message":"Pacific","commit_id":"0d42503e6712103ef22f35c5fb5a0a81dfe4b667"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"781d52b67ec4a765764d042b215c35380801ebd1","unresolved":true,"context_lines":[{"line_number":143,"context_line":"Authorizing the driver to communicate with Ceph"},{"line_number":144,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"From Wallaby and above, we are issuing rados mgr volume commands via a rados client,"},{"line_number":147,"context_line":"using the pool name set with the config option \"ganesha_rados_store_pool_name\"."},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"For enhanced security, the auth ID does not need any MDS capability, it"},{"line_number":150,"context_line":"requires reduced MON and OSD capability, and extra write capability for MGR."}],"source_content_type":"text/x-rst","patch_set":4,"id":"19c41846_b683df2b","line":147,"range":{"start_line":146,"start_character":83,"end_line":147,"end_character":79},"updated":"2021-04-26 17:55:04.000000000","message":"This is only applicable to Ceph-NFS. \n\nDoes this also mean that \"osd\" caps for this specific pool are necessary only if using the NFS protocol?\n\nPerhaps we should call that out. \n\n\nI suggest adding a prominent section (perhaps with \"..important\") for \"Wallaby Upgrade\" and adding two notes.\n\nIf upgrading from a prior version of manila to the Wallaby release\n- Capabilities required for the manila user have changed. The client user configured no longer needs any MDS capability. The MON and OSD capabilities can be reduced as well. However new MGR capabilities are now required. If not accorded, the driver cannot communicate to the Ceph Cluster.\n- Prior to upgrading to Wallaby, please ensure that you\u0027re running at least the following versions of Ceph:\n\n\n  +----------+-----------------+\n  | RELEASE  | MINIMUM VERSION |\n  +----------+-----------------+\n  | Nautilus | 14.2.20         |\n  +----------+-----------------+\n  | Octopus  | 15.2.11         |\n  +----------+-----------------+\n  | Pacific  | 16.2.1          |\n  +----------+-----------------+","commit_id":"0d42503e6712103ef22f35c5fb5a0a81dfe4b667"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"ac8c421689ff4df63a38d370a7318f6369b95ea3","unresolved":true,"context_lines":[{"line_number":143,"context_line":"Authorizing the driver to communicate with Ceph"},{"line_number":144,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"From Wallaby and above, we are issuing rados mgr volume commands via a rados client,"},{"line_number":147,"context_line":"using the pool name set with the config option \"ganesha_rados_store_pool_name\"."},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"For enhanced security, the auth ID does not need any MDS capability, it"},{"line_number":150,"context_line":"requires reduced MON and OSD capability, and extra write capability for MGR."}],"source_content_type":"text/x-rst","patch_set":4,"id":"8d626d66_01ac9057","line":147,"range":{"start_line":146,"start_character":83,"end_line":147,"end_character":79},"in_reply_to":"19c41846_b683df2b","updated":"2021-04-26 20:14:22.000000000","message":"\u003e This is only applicable to Ceph-NFS. \n\u003e \n\u003e Does this also mean that \"osd\" caps for this specific pool are necessary only if using the NFS protocol?\n\u003e \n\nYes.\n\n\u003e Perhaps we should call that out. \n\u003e \n\u003e \n\u003e I suggest adding a prominent section (perhaps with \"..important\") for \"Wallaby Upgrade\" and adding two notes.\n\u003e \n\u003e If upgrading from a prior version of manila to the Wallaby release\n\u003e - Capabilities required for the manila user have changed. The client user configured no longer needs any MDS capability. The MON and OSD capabilities can be reduced as well. However new MGR capabilities are now required. If not accorded, the driver cannot communicate to the Ceph Cluster.\n\nAgree that the above point need to be highlighted.\n\n\u003e - Prior to upgrading to Wallaby, please ensure that you\u0027re running at least the following versions of Ceph:\n\u003e \n\u003e \n\u003e   +----------+-----------------+\n\u003e   | RELEASE  | MINIMUM VERSION |\n\u003e   +----------+-----------------+\n\u003e   | Nautilus | 14.2.20         |\n\u003e   +----------+-----------------+\n\u003e   | Octopus  | 15.2.11         |\n\u003e   +----------+-----------------+\n\u003e   | Pacific  | 16.2.1          |\n\u003e   +----------+-----------------+","commit_id":"0d42503e6712103ef22f35c5fb5a0a81dfe4b667"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"6c200322b011c4e28e104c3567b3eb0693d88990","unresolved":true,"context_lines":[{"line_number":143,"context_line":"Authorizing the driver to communicate with Ceph"},{"line_number":144,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"From Wallaby and above, we are issuing rados mgr volume commands via a rados client,"},{"line_number":147,"context_line":"using the pool name set with the config option \"ganesha_rados_store_pool_name\"."},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"For enhanced security, the auth ID does not need any MDS capability, it"},{"line_number":150,"context_line":"requires reduced MON and OSD capability, and extra write capability for MGR."}],"source_content_type":"text/x-rst","patch_set":4,"id":"21f60cf7_09fafd5d","line":147,"range":{"start_line":146,"start_character":83,"end_line":147,"end_character":79},"in_reply_to":"8d626d66_01ac9057","updated":"2021-04-26 23:15:32.000000000","message":"Just to clarify.\n\nFor CephFS Native the required caps are \n\n    ceph auth get-or-create client.manila -o manila.keyring \\\n      osd \u0027allow rw\" \\\n      mgr \u0027allow rw\u0027 \\\n      mon \u0027allow r\u0027\n\nFor CephFS NFS the required caps are\n\n    ceph auth get-or-create client.manila -o manila.keyring \\\n      osd \u0027allow rw pool\u003d\u003cganesha_rados_store_pool_name\u003e\" \\\n      mgr \u0027allow rw\u0027 \\\n      mon \u0027allow r\u0027\n\nWe have the latter running on our CI and it\u0027s passing tempest tests for both Native and NFS. Is this an expected behavior?","commit_id":"0d42503e6712103ef22f35c5fb5a0a81dfe4b667"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"ac8c421689ff4df63a38d370a7318f6369b95ea3","unresolved":true,"context_lines":[{"line_number":243,"context_line":"(also referred to as a CephFS volume) you want to use."},{"line_number":244,"context_line":"If you have more than one Ceph filesystem in the cluster, you need to set this"},{"line_number":245,"context_line":"option."},{"line_number":246,"context_line":""},{"line_number":247,"context_line":""},{"line_number":248,"context_line":".. code-block:: ini"},{"line_number":249,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"f074fb28_f25dab23","line":246,"updated":"2021-04-26 20:14:22.000000000","message":"Maybe say that multiple file systems is stable since pacific\nhttps://ceph.io/community/new-in-pacific-cephfs-updates/","commit_id":"0d42503e6712103ef22f35c5fb5a0a81dfe4b667"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"f7e8a069150560bbeadfb56e08914e074da35575","unresolved":true,"context_lines":[{"line_number":115,"context_line":".. important::"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"    From the Wallaby cycle, both CephFS Native and CephFS NFS drivers"},{"line_number":118,"context_line":"    depend on specific Ceph versions to work properly."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"    If running Nautilus, ensure to have the v14.2.19"},{"line_number":121,"context_line":"    If running Octopus, make sure to have the v15.2.10"}],"source_content_type":"text/x-rst","patch_set":5,"id":"be42c098_8d7d7991","line":118,"updated":"2021-04-27 03:33:03.000000000","message":"This is confusing. It reads like you need one particular version of a release. Maybe instead say,\n\n\"\"\"\nIt\u0027s recommended to install the latest stable version of Ceph nautilus/octopus/pacific release. See, https://docs.ceph.com/en/latest/releases/index.html\n\nStable versions required for different releases:\n\n- nautilus \u003e\u003d 14.2.20\n- octopus  \u003e\u003d 15.2.11\n- pacific  \u003e\u003d 16.2.1 \n\n\"\"\"","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":true,"context_lines":[{"line_number":115,"context_line":".. important::"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"    From the Wallaby cycle, both CephFS Native and CephFS NFS drivers"},{"line_number":118,"context_line":"    depend on specific Ceph versions to work properly."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"    If running Nautilus, ensure to have the v14.2.19"},{"line_number":121,"context_line":"    If running Octopus, make sure to have the v15.2.10"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9781de72_24e2e6c6","line":118,"in_reply_to":"be42c098_8d7d7991","updated":"2021-04-28 09:24:26.000000000","message":"You are right, let me change that","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"feefce4ad3980a53f1759e77dc2149416400a64f","unresolved":true,"context_lines":[{"line_number":117,"context_line":"    From the Wallaby cycle, both CephFS Native and CephFS NFS drivers"},{"line_number":118,"context_line":"    depend on specific Ceph versions to work properly."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"    If running Nautilus, ensure to have the v14.2.19"},{"line_number":121,"context_line":"    If running Octopus, make sure to have the v15.2.10"},{"line_number":122,"context_line":"    If running Pacific, you are good with v16.0.0"},{"line_number":123,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"5056c167_54e2da15","line":120,"updated":"2021-04-26 23:36:11.000000000","message":"@Goutham I saw your indicated older versions, IIRC changes landed earlier.","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":true,"context_lines":[{"line_number":117,"context_line":"    From the Wallaby cycle, both CephFS Native and CephFS NFS drivers"},{"line_number":118,"context_line":"    depend on specific Ceph versions to work properly."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"    If running Nautilus, ensure to have the v14.2.19"},{"line_number":121,"context_line":"    If running Octopus, make sure to have the v15.2.10"},{"line_number":122,"context_line":"    If running Pacific, you are good with v16.0.0"},{"line_number":123,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"aad05c11_b565c70b","line":120,"in_reply_to":"5056c167_54e2da15","updated":"2021-04-28 09:24:26.000000000","message":"Saw that Ramana specifies the same versions, so I\u0027ll use those","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"f7e8a069150560bbeadfb56e08914e074da35575","unresolved":true,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"- A Ceph cluster with a filesystem configured (See `Create ceph filesystem`_ on"},{"line_number":130,"context_line":"  how to create a filesystem.)"},{"line_number":131,"context_line":"- ``ceph-common`` package installed in the servers running the"},{"line_number":132,"context_line":"  :term:`manila-share` service."},{"line_number":133,"context_line":"- Network connectivity between your Ceph cluster\u0027s public network and the"},{"line_number":134,"context_line":"  servers running the :term:`manila-share` service."}],"source_content_type":"text/x-rst","patch_set":5,"id":"792f5444_1d6180f2","line":131,"updated":"2021-04-27 03:33:03.000000000","message":"Sorry! Missed this earlier.\n\nWe only import the following ceph libraries for the driver,\n\nimport rados\nimport ceph_argparse\n\n\nSo \u0027python3-rados\u0027 and \u0027python3-ceph-argparse\u0027 packages should be sufficient. Installing \u0027ceph-common\u0027 package installs the above libraries and many other unnecessary ones.","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":false,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"- A Ceph cluster with a filesystem configured (See `Create ceph filesystem`_ on"},{"line_number":130,"context_line":"  how to create a filesystem.)"},{"line_number":131,"context_line":"- ``ceph-common`` package installed in the servers running the"},{"line_number":132,"context_line":"  :term:`manila-share` service."},{"line_number":133,"context_line":"- Network connectivity between your Ceph cluster\u0027s public network and the"},{"line_number":134,"context_line":"  servers running the :term:`manila-share` service."}],"source_content_type":"text/x-rst","patch_set":5,"id":"bc54e166_3c1f2144","line":131,"in_reply_to":"792f5444_1d6180f2","updated":"2021-04-28 09:24:26.000000000","message":"Ack","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"f7e8a069150560bbeadfb56e08914e074da35575","unresolved":true,"context_lines":[{"line_number":156,"context_line":""},{"line_number":157,"context_line":"Capabilities required for the manila user have changed from the Wallaby"},{"line_number":158,"context_line":"release. The client user configured no longer needs any MDS capability."},{"line_number":159,"context_line":"The MON and OSD capabilities can be reduced as well. However new MGR"},{"line_number":160,"context_line":"capabilities are now required. If not accorded, the driver cannot"},{"line_number":161,"context_line":"communicate to the Ceph Cluster."},{"line_number":162,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"4e551253_5051f543","line":159,"updated":"2021-04-27 03:33:03.000000000","message":"Sorry, I missed this earlier. The terms \u0027manila user\u0027 and \u0027client user\u0027 are confusing. The original wording makes more sense to me. Maybe stick to that? And in the \"important\" section say,\n\nThe driver in the Wallaby (or later) release requires a Ceph identity with a different set of Ceph capabilities when compared to the driver in a pre-Wallaby release. When upgrading to Wallaby you\u0027ll also have to update the capabilities of the Ceph identity used by the driver, https://docs.ceph.com/en/octopus/rados/operations/user-management/#modify-user-capabilities e.g. a native driver that already uses `client.manila` Ceph identity, issue command `ceph auth caps client.manila mon \u0027allow r\u0027 mgr \u0027allow rw\u0027`","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":true,"context_lines":[{"line_number":156,"context_line":""},{"line_number":157,"context_line":"Capabilities required for the manila user have changed from the Wallaby"},{"line_number":158,"context_line":"release. The client user configured no longer needs any MDS capability."},{"line_number":159,"context_line":"The MON and OSD capabilities can be reduced as well. However new MGR"},{"line_number":160,"context_line":"capabilities are now required. If not accorded, the driver cannot"},{"line_number":161,"context_line":"communicate to the Ceph Cluster."},{"line_number":162,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"bfe3a4a8_eb174d83","line":159,"in_reply_to":"4e551253_5051f543","updated":"2021-04-28 09:24:26.000000000","message":"Would Ceph manila identity work? \"Ceph identity for a driver instance to use\" is correct but not too complicated.","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"045ef83ad0d8f148f78ac4ca5ea28bef32b740fa","unresolved":true,"context_lines":[{"line_number":172,"context_line":"    ceph auth get-or-create client.manila -o manila.keyring \\"},{"line_number":173,"context_line":"      osd \u0027allow rw\u0027 \\"},{"line_number":174,"context_line":"      mgr \u0027allow rw\u0027 \\"},{"line_number":175,"context_line":"      mon \u0027allow r\u0027"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"For the CephFS NFS driver, we use a specific pool to store exports"},{"line_number":178,"context_line":"(configurable with the config option \"ganesha_rados_store_pool_name\")."}],"source_content_type":"text/x-rst","patch_set":5,"id":"e4352ea6_99cd8954","line":175,"updated":"2021-04-27 00:49:31.000000000","message":"For native driver, you don\u0027t need any  OSD caps. You only need \u0027r\u0027 access to ceph monitor \u0027rw\u0027 access to the ceph manager. Just remove line 174.\n\nFor NFS driver, we need additional OSD \u0027rw\u0027 capabilities to the ganesha rados pool as we get/put export objects, counter and index.\n\nhttps://docs.ceph.com/en/latest/rados/operations/user-management/#authorization-capabilities","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":true,"context_lines":[{"line_number":172,"context_line":"    ceph auth get-or-create client.manila -o manila.keyring \\"},{"line_number":173,"context_line":"      osd \u0027allow rw\u0027 \\"},{"line_number":174,"context_line":"      mgr \u0027allow rw\u0027 \\"},{"line_number":175,"context_line":"      mon \u0027allow r\u0027"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"For the CephFS NFS driver, we use a specific pool to store exports"},{"line_number":178,"context_line":"(configurable with the config option \"ganesha_rados_store_pool_name\")."}],"source_content_type":"text/x-rst","patch_set":5,"id":"5316ab2e_9aff5623","line":175,"in_reply_to":"e4352ea6_99cd8954","updated":"2021-04-28 09:24:26.000000000","message":"Got it now, thanks for the clarification.","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"f7e8a069150560bbeadfb56e08914e074da35575","unresolved":true,"context_lines":[{"line_number":542,"context_line":"Upgrade to Wallaby considerations"},{"line_number":543,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":544,"context_line":""},{"line_number":545,"context_line":"Both CephFS Native and CephFS NFS drivers depend on specific Ceph versions"},{"line_number":546,"context_line":"to work properly."},{"line_number":547,"context_line":""},{"line_number":548,"context_line":"Precisely, the following operations have been added in those"}],"source_content_type":"text/x-rst","patch_set":5,"id":"ce4a5ec0_3efdf380","line":545,"updated":"2021-04-27 03:33:03.000000000","message":"Do you need to mention the specific features/PRs needed?\n\nMentioning the required minimum stable versions of the releases, and the changes in the authorization capabilities of the cephx auth ID used by the driver, should be sufficient.","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":true,"context_lines":[{"line_number":542,"context_line":"Upgrade to Wallaby considerations"},{"line_number":543,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":544,"context_line":""},{"line_number":545,"context_line":"Both CephFS Native and CephFS NFS drivers depend on specific Ceph versions"},{"line_number":546,"context_line":"to work properly."},{"line_number":547,"context_line":""},{"line_number":548,"context_line":"Precisely, the following operations have been added in those"}],"source_content_type":"text/x-rst","patch_set":5,"id":"e5bf7001_151c6edd","line":545,"in_reply_to":"ce4a5ec0_3efdf380","updated":"2021-04-28 09:24:26.000000000","message":"Yeah, it\u0027s actually not needed. Will remove this section.","commit_id":"89315de81070242af02f4d35dfda3677b7e0dad1"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"9b2ccc5bbaccb979a844ee8f5212193be713bcd1","unresolved":true,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"   Prior to upgrading to Wallaby, please ensure that you\u0027re running at least the following versions of Ceph:"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"        +----------+-----------------+"},{"line_number":123,"context_line":"        | RELEASE  | MINIMUM VERSION |"},{"line_number":124,"context_line":"        +----------+-----------------+"},{"line_number":125,"context_line":"        | Nautilus | 14.2.20         |"}],"source_content_type":"text/x-rst","patch_set":6,"id":"b30e58f8_08d3c935","line":122,"range":{"start_line":122,"start_character":2,"end_line":122,"end_character":8},"updated":"2021-04-27 22:22:30.000000000","message":"This extra space isn\u0027t required - it affects the way the table is rendered. See: https://969a09e50621f00ba282-7a435d8b6671949964eefa8586127100.ssl.cf5.rackcdn.com/782871/6/check/openstack-tox-docs/8e6f21c/docs/admin/cephfs_driver.html#ceph-testing-matrix","commit_id":"de629154df32e6b36f9bd1c96460bd60e605fbe2"},{"author":{"_account_id":6413,"name":"Victoria Martinez de la Cruz","email":"victoria@redhat.com","username":"vkmc"},"change_message_id":"01db9470141823bbd87a6b45382bde11cf4ed5d1","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"   Prior to upgrading to Wallaby, please ensure that you\u0027re running at least the following versions of Ceph:"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"        +----------+-----------------+"},{"line_number":123,"context_line":"        | RELEASE  | MINIMUM VERSION |"},{"line_number":124,"context_line":"        +----------+-----------------+"},{"line_number":125,"context_line":"        | Nautilus | 14.2.20         |"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bda0d893_b70852e5","line":122,"range":{"start_line":122,"start_character":2,"end_line":122,"end_character":8},"in_reply_to":"b30e58f8_08d3c935","updated":"2021-04-28 09:24:26.000000000","message":"Done","commit_id":"de629154df32e6b36f9bd1c96460bd60e605fbe2"}]}