)]}'
{"doc/source/configuration/block-storage/drivers/emc-vmax-driver.rst":[{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"The Cinder driver supports the VMAX-3 series and VMAX All-Flash arrays."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Solutions Enabler 8.4.0.8 or later, and Unisphere for VMAX 8.4.0.8 or later"},{"line_number":21,"context_line":"are required."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"You can download Solutions Enabler and Unisphere from the Dell EMC\u0027s support"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_3e2c1798","line":20,"range":{"start_line":20,"start_character":18,"end_line":20,"end_character":25},"updated":"2017-07-21 10:09:10.000000000","message":"8.4.0.0","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":197,"context_line":"   extra specification indicating the service level/ workload combination to"},{"line_number":198,"context_line":"   be used for that volume type."},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"   There is also the option to assign a port group to a volume type."},{"line_number":201,"context_line":""},{"line_number":202,"context_line":"``ServiceLevel``"},{"line_number":203,"context_line":"   The Service Level manages the underlying storage to provide expected"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_a3aa5416","line":200,"range":{"start_line":200,"start_character":67,"end_line":200,"end_character":68},"updated":"2017-07-21 10:09:10.000000000","message":"by setting the \u0027storagetype:portgroupname\u0027 extra specification","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":244,"context_line":"   $ openstack volume type create VMAX_ISCI_SILVER_OLTP"},{"line_number":245,"context_line":"   $ openstack volume type set --property volume_backend_name\u003dISCSI_backend \\"},{"line_number":246,"context_line":"                               --property pool_name\u003dSilver+OLTP+SRP_1+000197800123 \\"},{"line_number":247,"context_line":"                               --property port_group_name\u003dOS-PG2 \\"},{"line_number":248,"context_line":"                               VMAX_ ISCI_SILVER_OLTP"},{"line_number":249,"context_line":"   $ openstack volume type create VMAX_FC_DIAMOND_DSS"},{"line_number":250,"context_line":"   $ openstack volume type set --property volume_backend_name\u003dFC_backend \\"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_03eea887","line":247,"range":{"start_line":247,"start_character":42,"end_line":247,"end_character":57},"updated":"2017-07-21 10:09:10.000000000","message":"storagetype:portgroupname","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":245,"context_line":"   $ openstack volume type set --property volume_backend_name\u003dISCSI_backend \\"},{"line_number":246,"context_line":"                               --property pool_name\u003dSilver+OLTP+SRP_1+000197800123 \\"},{"line_number":247,"context_line":"                               --property port_group_name\u003dOS-PG2 \\"},{"line_number":248,"context_line":"                               VMAX_ ISCI_SILVER_OLTP"},{"line_number":249,"context_line":"   $ openstack volume type create VMAX_FC_DIAMOND_DSS"},{"line_number":250,"context_line":"   $ openstack volume type set --property volume_backend_name\u003dFC_backend \\"},{"line_number":251,"context_line":"                               --property pool_name\u003dDiamond+DSS+SRP_1+000197800123 \\"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_638e7c28","line":248,"range":{"start_line":248,"start_character":36,"end_line":248,"end_character":37},"updated":"2017-07-21 10:09:10.000000000","message":"Please remove this space.","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":249,"context_line":"   $ openstack volume type create VMAX_FC_DIAMOND_DSS"},{"line_number":250,"context_line":"   $ openstack volume type set --property volume_backend_name\u003dFC_backend \\"},{"line_number":251,"context_line":"                               --property pool_name\u003dDiamond+DSS+SRP_1+000197800123 \\"},{"line_number":252,"context_line":"                                --property port_group_name\u003dOS-PG1 \\"},{"line_number":253,"context_line":"                               VMAX_FC_DIAMOND_DSS"},{"line_number":254,"context_line":""},{"line_number":255,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_a3e374a4","line":252,"range":{"start_line":252,"start_character":43,"end_line":252,"end_character":58},"updated":"2017-07-21 10:09:10.000000000","message":"storagetype:portgroupname","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":483,"context_line":"Interval and Retries"},{"line_number":484,"context_line":"--------------------"},{"line_number":485,"context_line":""},{"line_number":486,"context_line":"By default, ``interval`` and ``retries`` are ``5`` seconds and ``120`` retries"},{"line_number":487,"context_line":"respectively. These determine how long (``interval``) and how many times"},{"line_number":488,"context_line":"(``retries``) a user is willing to wait for a single Rest call,"},{"line_number":489,"context_line":"``5*120\u003d600seconds``. Depending on usage, these may need to be overriden by"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_8344f8b8","line":486,"range":{"start_line":486,"start_character":65,"end_line":486,"end_character":68},"updated":"2017-07-21 10:09:10.000000000","message":"200","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":483,"context_line":"Interval and Retries"},{"line_number":484,"context_line":"--------------------"},{"line_number":485,"context_line":""},{"line_number":486,"context_line":"By default, ``interval`` and ``retries`` are ``5`` seconds and ``120`` retries"},{"line_number":487,"context_line":"respectively. These determine how long (``interval``) and how many times"},{"line_number":488,"context_line":"(``retries``) a user is willing to wait for a single Rest call,"},{"line_number":489,"context_line":"``5*120\u003d600seconds``. Depending on usage, these may need to be overriden by"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_a347f4bc","line":486,"range":{"start_line":486,"start_character":47,"end_line":486,"end_character":48},"updated":"2017-07-21 10:09:10.000000000","message":"This has been changed to 3 seconds.","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":486,"context_line":"By default, ``interval`` and ``retries`` are ``5`` seconds and ``120`` retries"},{"line_number":487,"context_line":"respectively. These determine how long (``interval``) and how many times"},{"line_number":488,"context_line":"(``retries``) a user is willing to wait for a single Rest call,"},{"line_number":489,"context_line":"``5*120\u003d600seconds``. Depending on usage, these may need to be overriden by"},{"line_number":490,"context_line":"the user in the cinder.conf. For example, if performance is a factor, then the"},{"line_number":491,"context_line":"``interval`` should be decreased to check the job status more frequently, and"},{"line_number":492,"context_line":"if multiple concurrent provisioning requests are issued then ``retries``"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_431820d2","line":489,"range":{"start_line":489,"start_character":2,"end_line":489,"end_character":7},"updated":"2017-07-21 10:09:10.000000000","message":"3*200","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"},{"author":{"_account_id":23414,"name":"Ciara Stacke","email":"ciara.stacke@emc.com","username":"cstacke"},"change_message_id":"44e38670c63269b28b9238ba2fe35c147e641c40","unresolved":false,"context_lines":[{"line_number":506,"context_line":"   interval \u003d 3"},{"line_number":507,"context_line":"   retries \u003d 150"},{"line_number":508,"context_line":""},{"line_number":509,"context_line":"Oversubscription support"},{"line_number":510,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":511,"context_line":""},{"line_number":512,"context_line":"Oversubscription support requires the ``/etc/cinder/cinder.conf`` to be"},{"line_number":513,"context_line":"updated with two additional tags ``max_over_subscription_ratio`` and"},{"line_number":514,"context_line":"``reserved_percentage``. In the sample below, the value of 2.0 for"},{"line_number":515,"context_line":"``max_over_subscription_ratio`` means that the pools in oversubscribed by a"},{"line_number":516,"context_line":"factor of 2, or 200% oversubscribed. The ``reserved_percentage`` is the high"},{"line_number":517,"context_line":"water mark where by the physical remaining space cannot be exceeded."},{"line_number":518,"context_line":"For example, if there is only 4% of physical space left and the reserve"},{"line_number":519,"context_line":"percentage is 5, the free space will equate to zero. This is a safety"},{"line_number":520,"context_line":"mechanism to prevent a scenario where a provisioning request fails due to"},{"line_number":521,"context_line":"insufficient raw space."},{"line_number":522,"context_line":""},{"line_number":523,"context_line":"The parameter ``max_over_subscription_ratio`` and ``reserved_percentage`` are"},{"line_number":524,"context_line":"optional."},{"line_number":525,"context_line":""},{"line_number":526,"context_line":"To set these parameter go to the configuration group of the volume type in"},{"line_number":527,"context_line":":file:`/etc/cinder/cinder.conf`."},{"line_number":528,"context_line":""},{"line_number":529,"context_line":".. code-block:: ini"},{"line_number":530,"context_line":""},{"line_number":531,"context_line":"    [VMAX_ISCSI_SILVER]"},{"line_number":532,"context_line":"    cinder_emc_config_file \u003d /etc/cinder/cinder_emc_config_VMAX_ISCSI_SILVER.xml"},{"line_number":533,"context_line":"    volume_driver \u003d cinder.volume.drivers.dell_emc.vmax.iscsi.VMAXISCSIDriver"},{"line_number":534,"context_line":"    volume_backend_name \u003d VMAX_ISCSI_SILVER"},{"line_number":535,"context_line":"    max_over_subscription_ratio \u003d 2.0"},{"line_number":536,"context_line":"    reserved_percentage \u003d 10"},{"line_number":537,"context_line":""},{"line_number":538,"context_line":"For the second iteration of over subscription, take into account the"},{"line_number":539,"context_line":"EMCMaxSubscriptionPercent property on the pool. This value is the highest"},{"line_number":540,"context_line":"that a pool can be oversubscribed."},{"line_number":541,"context_line":""},{"line_number":542,"context_line":"Scenario 1"},{"line_number":543,"context_line":"----------"},{"line_number":544,"context_line":""},{"line_number":545,"context_line":"``EMCMaxSubscriptionPercent`` is 200 and the user defined"},{"line_number":546,"context_line":"``max_over_subscription_ratio`` is 2.5, the latter is ignored."},{"line_number":547,"context_line":"Oversubscription is 200%."},{"line_number":548,"context_line":""},{"line_number":549,"context_line":"Scenario 2"},{"line_number":550,"context_line":"----------"},{"line_number":551,"context_line":""},{"line_number":552,"context_line":"``EMCMaxSubscriptionPercent`` is 200 and the user defined"},{"line_number":553,"context_line":"``max_over_subscription_ratio`` is 1.5, 1.5 equates to 150% and is less than"},{"line_number":554,"context_line":"the value set on the pool. Oversubscription is 150%."},{"line_number":555,"context_line":""},{"line_number":556,"context_line":"Scenario 3"},{"line_number":557,"context_line":"----------"},{"line_number":558,"context_line":""},{"line_number":559,"context_line":"``EMCMaxSubscriptionPercent`` is 0. This means there is no upper limit on the"},{"line_number":560,"context_line":"pool. The user defined ``max_over_subscription_ratio`` is 1.5."},{"line_number":561,"context_line":"Oversubscription is 150%."},{"line_number":562,"context_line":""},{"line_number":563,"context_line":"Scenario 4"},{"line_number":564,"context_line":"----------"},{"line_number":565,"context_line":""},{"line_number":566,"context_line":"``EMCMaxSubscriptionPercent`` is 0. ``max_over_subscription_ratio`` is not"},{"line_number":567,"context_line":"set by the user. We recommend to default to upper limit, this is 150%."},{"line_number":568,"context_line":""},{"line_number":569,"context_line":".. note::"},{"line_number":570,"context_line":"   If FAST is set and multiple pools are associated with a FAST policy,"},{"line_number":571,"context_line":"   then the same rules apply. The difference is, the TotalManagedSpace and"},{"line_number":572,"context_line":"   EMCSubscribedCapacity for each pool associated with the FAST policy are"},{"line_number":573,"context_line":"   aggregated."},{"line_number":574,"context_line":""},{"line_number":575,"context_line":"Scenario 5"},{"line_number":576,"context_line":"----------"},{"line_number":577,"context_line":""},{"line_number":578,"context_line":"``EMCMaxSubscriptionPercent`` is 200 on one pool. It is 300 on another pool."},{"line_number":579,"context_line":"The user defined ``max_over_subscription_ratio`` is 2.5. Oversubscription is"},{"line_number":580,"context_line":"200% on the first pool and 250% on the other."},{"line_number":581,"context_line":""},{"line_number":582,"context_line":"QoS (Quality of Service) support"},{"line_number":583,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f1a1f67_2382c4c9","line":580,"range":{"start_line":509,"start_character":0,"end_line":580,"end_character":45},"updated":"2017-07-21 10:09:10.000000000","message":"This can be removed - oversubscription is now supported as standard.","commit_id":"d416e7eba83c937aa477766694aec3e0f64896a1"}]}