)]}'
{"doc/source/configuration/shared-file-systems/drivers/dell-emc-unity-driver.rst":[{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"391e08e0741882e72ff90af2cb510cbc73431adf","unresolved":false,"context_lines":[{"line_number":341,"context_line":"- EMC Unity does not support the same IP in different VLANs."},{"line_number":342,"context_line":"- Only IP access type is supported for NFS."},{"line_number":343,"context_line":"- Only user access type is supported for CIFS."},{"line_number":344,"context_line":"- Unity does not support the file system creation with size less than 3GB, if"},{"line_number":345,"context_line":"  the size of share user create less than 3GB, driver will supplement the size"},{"line_number":346,"context_line":"  to 3GB in Unity."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"API Implementations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_e07054dd","line":346,"range":{"start_line":344,"start_character":2,"end_line":346,"end_character":18},"updated":"2019-11-08 22:05:55.000000000","message":"We have a framework for this sort of thing - adding this in the documentation may be insufficient. Consider a cloud with EMC Unity and Vendor XYZ storage:\n\na user creates two shares of 2 GB each - assume one each on each of the backends - when they mount these shares, they\u0027ll see that one of the shares is 2GB and the other is 3GB\n\n\nhttps://opendev.org/openstack/manila/src/commit/fd23a6387c92b288a4a5f64a3e0190895e14f85f/manila/share/drivers/hitachi/hsp/driver.py#L365-L366","commit_id":"9bb08f76b4d1a59ae324fd7221eaa57ab9940da7"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"155b07c75933d1ed45a709ead8d4b304d8e6b5b2","unresolved":false,"context_lines":[{"line_number":341,"context_line":"- EMC Unity does not support the same IP in different VLANs."},{"line_number":342,"context_line":"- Only IP access type is supported for NFS."},{"line_number":343,"context_line":"- Only user access type is supported for CIFS."},{"line_number":344,"context_line":"- Unity does not support the file system creation with size less than 3GB, if"},{"line_number":345,"context_line":"  the size of share user create less than 3GB, driver will supplement the size"},{"line_number":346,"context_line":"  to 3GB in Unity."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"API Implementations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1fa4df85_c2eea7b3","line":346,"range":{"start_line":344,"start_character":2,"end_line":346,"end_character":18},"in_reply_to":"1fa4df85_1ef30176","updated":"2020-03-11 15:54:12.000000000","message":"I see. While this behavior can be consistent in a cloud environment with *only* Unity storage, it will be inconsistent in an environment with heterogeneous backends.  \n\nIs there any way you can make this share size inflation optional? \n\nPossibly by means of a configuration option in the Unity backend section that determines whether the default driver filter function that I suggested earlier will be reported to the scheduler or not. \n\nSo, by default Unity could report the default filter function, but, administrators will have a way to disable that and allow inflating share sizes if they are less than 2GB.","commit_id":"9bb08f76b4d1a59ae324fd7221eaa57ab9940da7"},{"author":{"_account_id":26114,"name":"Yong Huang","email":"yong.huang@emc.com","username":"yong.huang"},"change_message_id":"508fe6483146b928fcceedd2e564957b59250366","unresolved":false,"context_lines":[{"line_number":341,"context_line":"- EMC Unity does not support the same IP in different VLANs."},{"line_number":342,"context_line":"- Only IP access type is supported for NFS."},{"line_number":343,"context_line":"- Only user access type is supported for CIFS."},{"line_number":344,"context_line":"- Unity does not support the file system creation with size less than 3GB, if"},{"line_number":345,"context_line":"  the size of share user create less than 3GB, driver will supplement the size"},{"line_number":346,"context_line":"  to 3GB in Unity."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"API Implementations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1fa4df85_1ef30176","line":346,"range":{"start_line":344,"start_character":2,"end_line":346,"end_character":18},"in_reply_to":"1fa4df85_60863416","updated":"2020-03-06 08:54:23.000000000","message":"Hi Goutham,\n\nSorry for the late response.\n\nIn Unity, when new share/filesystem created, some additional disk will be reversed for metadata storing, so in Unity driver, some additional disk will be added, for the share which size \u003c 1.5GB, it will be added to 3GB, for the others, 1.5GB additional disk will be added. actually customer doesn\u0027t know the changes. When the customer creates a 2GB share, the share size is 2GB in OpenStack, in Unity, the corresponding share size is 3.5GB.\n\nthis is the source code:\ndef supplement_filesystem(old_size, user_cap\u003dFalse):\n    \"\"\"Return new size accounting for the metadata.\"\"\"\n    new_size \u003d old_size\n    if user_cap:\n        if old_size \u003c\u003d _GiB_to_Byte(1.5):\n            new_size \u003d _GiB_to_Byte(3)\n        else:\n            new_size +\u003d _GiB_to_Byte(1.5)\n    return int(new_size)\n\nFor your suggestion, to implement the get_default_filter_function method in Unity driver, it will cause another issue, if the cloud only contains Unity backends, the \u003c3GB share will no longer be created.\n\nSo my changes in the doc are not accurate. But the description above is too detail for the customer to read, so I think maybe I shuold abondon this change, what do you think?\n\nThanks","commit_id":"9bb08f76b4d1a59ae324fd7221eaa57ab9940da7"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"683a738deb79ab1ac8a32ae12aa68bc3ba192d3e","unresolved":false,"context_lines":[{"line_number":341,"context_line":"- EMC Unity does not support the same IP in different VLANs."},{"line_number":342,"context_line":"- Only IP access type is supported for NFS."},{"line_number":343,"context_line":"- Only user access type is supported for CIFS."},{"line_number":344,"context_line":"- Unity does not support the file system creation with size less than 3GB, if"},{"line_number":345,"context_line":"  the size of share user create less than 3GB, driver will supplement the size"},{"line_number":346,"context_line":"  to 3GB in Unity."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"API Implementations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1fa4df85_60863416","line":346,"range":{"start_line":344,"start_character":2,"end_line":346,"end_character":18},"in_reply_to":"3fa7e38b_73bfdcfb","updated":"2020-03-04 17:08:53.000000000","message":"Hi Yong, any update on this?","commit_id":"9bb08f76b4d1a59ae324fd7221eaa57ab9940da7"},{"author":{"_account_id":26114,"name":"Yong Huang","email":"yong.huang@emc.com","username":"yong.huang"},"change_message_id":"54d4c154833ce459d7b7b1d3009b66411fc64efc","unresolved":false,"context_lines":[{"line_number":341,"context_line":"- EMC Unity does not support the same IP in different VLANs."},{"line_number":342,"context_line":"- Only IP access type is supported for NFS."},{"line_number":343,"context_line":"- Only user access type is supported for CIFS."},{"line_number":344,"context_line":"- Unity does not support the file system creation with size less than 3GB, if"},{"line_number":345,"context_line":"  the size of share user create less than 3GB, driver will supplement the size"},{"line_number":346,"context_line":"  to 3GB in Unity."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"API Implementations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_e3965394","line":346,"range":{"start_line":344,"start_character":2,"end_line":346,"end_character":18},"in_reply_to":"3fa7e38b_e07054dd","updated":"2019-11-26 03:12:04.000000000","message":"This is the limitation of Unity, the minimum size of file system is 3GB even though Unity has enough space, it can\u0027t be fixed from driver side, now the workaround is supplementing it to 3GB.\nThe purpose of updating this doc is to note end uses of this limitation.","commit_id":"9bb08f76b4d1a59ae324fd7221eaa57ab9940da7"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"ac4e4919b7b73b601dca24cac4f89b0ada5b75c0","unresolved":false,"context_lines":[{"line_number":341,"context_line":"- EMC Unity does not support the same IP in different VLANs."},{"line_number":342,"context_line":"- Only IP access type is supported for NFS."},{"line_number":343,"context_line":"- Only user access type is supported for CIFS."},{"line_number":344,"context_line":"- Unity does not support the file system creation with size less than 3GB, if"},{"line_number":345,"context_line":"  the size of share user create less than 3GB, driver will supplement the size"},{"line_number":346,"context_line":"  to 3GB in Unity."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"API Implementations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_73bfdcfb","line":346,"range":{"start_line":344,"start_character":2,"end_line":346,"end_character":18},"in_reply_to":"3fa7e38b_e3965394","updated":"2020-01-20 23:56:40.000000000","message":"Hi, \n\nYes, I understand that this is a limitation in the Unity backend that the Unity driver cannot circumvent. I am asking you to take a look at the \"default filter function\" feature provided by manila\u0027s filter scheduler. \n\nSee an example usage in this link: https://opendev.org/openstack/manila/src/commit/fd23a6387c92b288a4a5f64a3e0190895e14f85f/manila/share/drivers/hitachi/hsp/driver.py#L365-L366\n\n\nIf you implement that method in your driver, the manila scheduler will automatically disallow shares smaller than 3GB from being scheduled to your driver. \n\nThis is the way we can ensure uniformity and compatibility amongst the different backends and their capablities.","commit_id":"9bb08f76b4d1a59ae324fd7221eaa57ab9940da7"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"1d41140216bbbb6d5fdf4312dae4de345b3a23d0","unresolved":false,"context_lines":[{"line_number":194,"context_line":"    the driver is in `DHSS\u003dFalse` mode."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"- `report_default_filter_function`"},{"line_number":197,"context_line":"    Whether or not report default filter function. Default value is"},{"line_number":198,"context_line":"    False."},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Restart of :term:`manila-share` service is needed for the configuration"},{"line_number":201,"context_line":"changes to take effect."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1f493fa4_15f6fad7","line":198,"range":{"start_line":197,"start_character":51,"end_line":198,"end_character":10},"updated":"2020-04-29 19:12:48.000000000","message":"suggest adding for completeness sake:\n\n However, this value will be changed to True in a future release to\n ensure compliance with design expectations in Manila. So we \n  recommend always setting this option in your deployment to True\n or False per your desired behavior.\n\n\nWhat do you think?","commit_id":"53cda2615d12b894ad7e8d59a23d2f617a63b426"},{"author":{"_account_id":26114,"name":"Yong Huang","email":"yong.huang@emc.com","username":"yong.huang"},"change_message_id":"4cda2fa575bbf7a3b2a75696d87b5b203b6667d5","unresolved":false,"context_lines":[{"line_number":194,"context_line":"    the driver is in `DHSS\u003dFalse` mode."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"- `report_default_filter_function`"},{"line_number":197,"context_line":"    Whether or not report default filter function. Default value is"},{"line_number":198,"context_line":"    False."},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Restart of :term:`manila-share` service is needed for the configuration"},{"line_number":201,"context_line":"changes to take effect."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1f493fa4_6a2035f8","line":198,"range":{"start_line":197,"start_character":51,"end_line":198,"end_character":10},"in_reply_to":"1f493fa4_15f6fad7","updated":"2020-04-30 03:42:18.000000000","message":"Updated, thanks for the comments, Goutham.","commit_id":"53cda2615d12b894ad7e8d59a23d2f617a63b426"}],"releasenotes/notes/unity-default-filter-function-support-2eefc8044a5add5d.yaml":[{"author":{"_account_id":18742,"name":"Ryan Liang","email":"ryan.liang@emc.com","username":"RyanLiang"},"change_message_id":"ab5cb0bdc5e2682f75b6951dff7797e5b115fafd","unresolved":false,"context_lines":[{"line_number":1,"context_line":"---"},{"line_number":2,"context_line":"features:"},{"line_number":3,"context_line":"  - Default filter function support for Dell EMC Unity Manila driver."}],"source_content_type":"text/x-yaml","patch_set":3,"id":"1f493fa4_81eac7d4","line":3,"updated":"2020-04-30 05:52:05.000000000","message":"s/Default filter function support for Dell EMC Unity Manila driver./Dell EMC Unity: Default filter function support for 3GB share size.","commit_id":"8c019302e8fb64e1eb9013224473db39068230df"},{"author":{"_account_id":26114,"name":"Yong Huang","email":"yong.huang@emc.com","username":"yong.huang"},"change_message_id":"5e66c343b5434f5edb742525b1cda69960b6c8a6","unresolved":false,"context_lines":[{"line_number":1,"context_line":"---"},{"line_number":2,"context_line":"features:"},{"line_number":3,"context_line":"  - Default filter function support for Dell EMC Unity Manila driver."}],"source_content_type":"text/x-yaml","patch_set":3,"id":"1f493fa4_94d96323","line":3,"in_reply_to":"1f493fa4_81eac7d4","updated":"2020-04-30 07:01:39.000000000","message":"Done","commit_id":"8c019302e8fb64e1eb9013224473db39068230df"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"4db5ce44885af11ebd13c95ee2338e93cf93adef","unresolved":false,"context_lines":[{"line_number":1,"context_line":"---"},{"line_number":2,"context_line":"features:"},{"line_number":3,"context_line":"  - |"},{"line_number":4,"context_line":"    Dell EMC Unity: Default filter function support for 3GB share size."}],"source_content_type":"text/x-yaml","patch_set":4,"id":"1f493fa4_3f9ad112","line":4,"range":{"start_line":4,"start_character":70,"end_line":4,"end_character":71},"updated":"2020-05-01 06:28:34.000000000","message":"Thanks for adding this note, can you also add an \"upgrade\" section to call out the config option, perhaps something along the lines of:\n\n upgrade:\n     - |\n       A new configuration option called ``report_default_filter_function`` has been\n       added to the Dell EMC Unity driver. It can be set to True or False, and the default\n       value is False. When set to True, the scheduler will disallow the creation of\n       shares smaller than 3 GiB on the Dell EMC Unity back end. The default value\n       of this option will be changed to ``True`` in a future release, so always set\n       the desired value in your manila.conf per your expectations.","commit_id":"a5adb0bd11da734a14bfc9b51f128be90be3bab3"},{"author":{"_account_id":26114,"name":"Yong Huang","email":"yong.huang@emc.com","username":"yong.huang"},"change_message_id":"0330addb73ebdc5a5acc40d97c6a9640c8013e05","unresolved":false,"context_lines":[{"line_number":1,"context_line":"---"},{"line_number":2,"context_line":"features:"},{"line_number":3,"context_line":"  - |"},{"line_number":4,"context_line":"    Dell EMC Unity: Default filter function support for 3GB share size."}],"source_content_type":"text/x-yaml","patch_set":4,"id":"ff570b3c_59d983f2","line":4,"range":{"start_line":4,"start_character":70,"end_line":4,"end_character":71},"in_reply_to":"1f493fa4_3f9ad112","updated":"2020-05-25 07:08:04.000000000","message":"Hi Goutham, a new patch is submitted to update the release note: https://review.opendev.org/#/c/730562/","commit_id":"a5adb0bd11da734a14bfc9b51f128be90be3bab3"}]}