)]}'
{"doc/source/overview_policies.rst":[{"author":{"_account_id":15343,"name":"Tim Burke","email":"tburke@nvidia.com","username":"tburke"},"change_message_id":"fc1f362c6192f9c26b84dba8959a1f35ec1f29e1","unresolved":false,"context_lines":[{"line_number":276,"context_line":"      defined, Swift will create a default policy with index ``0``."},{"line_number":277,"context_line":"    * The policy index must be a non-negative integer."},{"line_number":278,"context_line":"    * Policy indexes must be unique."},{"line_number":279,"context_line":"    * You cannot change the index of a policy once it has been created."},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"Each policy section contains the following options:"},{"line_number":282,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_6b20a5f8","line":279,"updated":"2017-05-26 16:25:59.000000000","message":"Is this one actually *enforced*? I can\u0027t imagine how any process would know... but things would definitely be rather terrible if you swapped policy indices.","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":276,"context_line":"      defined, Swift will create a default policy with index ``0``."},{"line_number":277,"context_line":"    * The policy index must be a non-negative integer."},{"line_number":278,"context_line":"    * Policy indexes must be unique."},{"line_number":279,"context_line":"    * You cannot change the index of a policy once it has been created."},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"Each policy section contains the following options:"},{"line_number":282,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_83817d4d","line":279,"in_reply_to":"ff0f0b1f_6b20a5f8","updated":"2017-05-31 10:12:16.000000000","message":"I can\u0027t see how it would be enforced but yes it would be a bad idea. I will separate this bullet point to a warning.","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"b918c11ce43290ecad962f36b6cf7ee5775b932c","unresolved":false,"context_lines":[{"line_number":292,"context_line":"        - A comma-separated list of alternative names for the policy."},{"line_number":293,"context_line":"        - All alias names must follow the rules for the ``name`` option."},{"line_number":294,"context_line":"        - Aliases can be added to and removed from the list."},{"line_number":295,"context_line":"        - Aliases may be added or removed programmatically.  If the primary"},{"line_number":296,"context_line":"          name of a policy is removed the next available alias in list order"},{"line_number":297,"context_line":"          will be adopted as the primary name. A policy must always have at"},{"line_number":298,"context_line":"          least one name and/or alias."},{"line_number":299,"context_line":"    * ``deprecated \u003d [true|false]`` (optional)"},{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_d9779608","line":297,"range":{"start_line":295,"start_character":10,"end_line":297,"end_character":45},"updated":"2017-05-26 11:03:17.000000000","message":"Reviewers: (see original text at line 319) I\u0027m not actually sure what this text is saying, but it was in the original and I have relocated it. I\u0027ve added \u0027programatically\u0027 to try to make sense of it - there is an API for add/remove names. But you *must* have a name in swift.conf, so I\u0027m not sure what is meant by removing the primary name.\n\nIf this is only possible via the API then should it be mentioned in the configuration guide?\n\nThoughts?","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":292,"context_line":"        - A comma-separated list of alternative names for the policy."},{"line_number":293,"context_line":"        - All alias names must follow the rules for the ``name`` option."},{"line_number":294,"context_line":"        - Aliases can be added to and removed from the list."},{"line_number":295,"context_line":"        - Aliases may be added or removed programmatically.  If the primary"},{"line_number":296,"context_line":"          name of a policy is removed the next available alias in list order"},{"line_number":297,"context_line":"          will be adopted as the primary name. A policy must always have at"},{"line_number":298,"context_line":"          least one name and/or alias."},{"line_number":299,"context_line":"    * ``deprecated \u003d [true|false]`` (optional)"},{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_a3d121d0","line":297,"range":{"start_line":295,"start_character":10,"end_line":297,"end_character":45},"in_reply_to":"ff0f0b1f_abb0fd8c","updated":"2017-05-31 10:12:16.000000000","message":"What did you have in mind here \"Might be worth adding a line about aliases being useful when changing primary policy names, though.\" ?\n\nI can see how aliases would allow you to retain an \u0027old\u0027 primary name when changing to a \u0027new\u0027 primary name. But in practice is there any need to switch the primary name vs. just introducing the \u0027new\u0027 name as an alias. Hmmm, when does th primary name get favoured?\n\nI\u0027ll try some words and see if it matches what you were thinking.","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":15343,"name":"Tim Burke","email":"tburke@nvidia.com","username":"tburke"},"change_message_id":"fc1f362c6192f9c26b84dba8959a1f35ec1f29e1","unresolved":false,"context_lines":[{"line_number":292,"context_line":"        - A comma-separated list of alternative names for the policy."},{"line_number":293,"context_line":"        - All alias names must follow the rules for the ``name`` option."},{"line_number":294,"context_line":"        - Aliases can be added to and removed from the list."},{"line_number":295,"context_line":"        - Aliases may be added or removed programmatically.  If the primary"},{"line_number":296,"context_line":"          name of a policy is removed the next available alias in list order"},{"line_number":297,"context_line":"          will be adopted as the primary name. A policy must always have at"},{"line_number":298,"context_line":"          least one name and/or alias."},{"line_number":299,"context_line":"    * ``deprecated \u003d [true|false]`` (optional)"},{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_abb0fd8c","line":297,"range":{"start_line":295,"start_character":10,"end_line":297,"end_character":45},"in_reply_to":"ff0f0b1f_d9779608","updated":"2017-05-26 16:25:59.000000000","message":"Yeah, I think I\u0027d be fine with striking all of this; while the API at https://github.com/openstack/swift/blob/2.14.0/swift/common/storage_policy.py#L310-L354 let\u0027s you manipulate names/aliases in-memory, it never causes anything to be written to disk, and this document is very much concerned with on-disk formats.\n\nMight be worth adding a line about aliases being useful when changing primary policy names, though.","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":15343,"name":"Tim Burke","email":"tburke@nvidia.com","username":"tburke"},"change_message_id":"fc1f362c6192f9c26b84dba8959a1f35ec1f29e1","unresolved":false,"context_lines":[{"line_number":296,"context_line":"          name of a policy is removed the next available alias in list order"},{"line_number":297,"context_line":"          will be adopted as the primary name. A policy must always have at"},{"line_number":298,"context_line":"          least one name and/or alias."},{"line_number":299,"context_line":"    * ``deprecated \u003d [true|false]`` (optional)"},{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."},{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_4b7cc1b4","line":299,"updated":"2017-05-26 16:25:59.000000000","message":"...and the default is...?","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":296,"context_line":"          name of a policy is removed the next available alias in list order"},{"line_number":297,"context_line":"          will be adopted as the primary name. A policy must always have at"},{"line_number":298,"context_line":"          least one name and/or alias."},{"line_number":299,"context_line":"    * ``deprecated \u003d [true|false]`` (optional)"},{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."},{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_432005b1","line":299,"in_reply_to":"ff0f0b1f_4b7cc1b4","updated":"2017-05-31 10:12:16.000000000","message":"Done","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."},{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"},{"line_number":303,"context_line":"          be declared the default, and you must specify a default - so you"},{"line_number":304,"context_line":"          must have policy which is not deprecated at all times."},{"line_number":305,"context_line":"        - See :ref:`deprecate-policy` for more information."},{"line_number":306,"context_line":"    * ``default \u003d [true|false]`` (optional)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_7e4ba02a","line":303,"range":{"start_line":303,"start_character":39,"end_line":303,"end_character":42},"updated":"2017-05-31 10:12:16.000000000","message":"I\u0027d prefer this to be written in third person","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":15343,"name":"Tim Burke","email":"tburke@nvidia.com","username":"tburke"},"change_message_id":"fc1f362c6192f9c26b84dba8959a1f35ec1f29e1","unresolved":false,"context_lines":[{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."},{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"},{"line_number":303,"context_line":"          be declared the default, and you must specify a default - so you"},{"line_number":304,"context_line":"          must have policy which is not deprecated at all times."},{"line_number":305,"context_line":"        - See :ref:`deprecate-policy` for more information."},{"line_number":306,"context_line":"    * ``default \u003d [true|false]`` (optional)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_eb3955f2","line":303,"range":{"start_line":303,"start_character":58,"end_line":303,"end_character":65},"updated":"2017-05-26 16:25:59.000000000","message":"Worth having the description for default above this, then?","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":300,"context_line":"        - If ``true`` then new containers cannot be created using this policy."},{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"},{"line_number":303,"context_line":"          be declared the default, and you must specify a default - so you"},{"line_number":304,"context_line":"          must have policy which is not deprecated at all times."},{"line_number":305,"context_line":"        - See :ref:`deprecate-policy` for more information."},{"line_number":306,"context_line":"    * ``default \u003d [true|false]`` (optional)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_9e0c343c","line":303,"range":{"start_line":303,"start_character":58,"end_line":303,"end_character":65},"in_reply_to":"ff0f0b1f_eb3955f2","updated":"2017-05-31 10:12:16.000000000","message":"Yes but the default option refers to deprecated. Probably more intuitive to have default first however.","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":15343,"name":"Tim Burke","email":"tburke@nvidia.com","username":"tburke"},"change_message_id":"fc1f362c6192f9c26b84dba8959a1f35ec1f29e1","unresolved":false,"context_lines":[{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"},{"line_number":303,"context_line":"          be declared the default, and you must specify a default - so you"},{"line_number":304,"context_line":"          must have policy which is not deprecated at all times."},{"line_number":305,"context_line":"        - See :ref:`deprecate-policy` for more information."},{"line_number":306,"context_line":"    * ``default \u003d [true|false]`` (optional)"},{"line_number":307,"context_line":"        - The default policy can be changed at any time, by adding the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_8b5bf952","line":304,"range":{"start_line":304,"start_character":15,"end_line":304,"end_character":26},"updated":"2017-05-26 16:25:59.000000000","message":"have at least one policy","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":301,"context_line":"        - Any policy may be deprecated by adding the deprecated option to"},{"line_number":302,"context_line":"          the desired policy section, but a deprecated policy may not also"},{"line_number":303,"context_line":"          be declared the default, and you must specify a default - so you"},{"line_number":304,"context_line":"          must have policy which is not deprecated at all times."},{"line_number":305,"context_line":"        - See :ref:`deprecate-policy` for more information."},{"line_number":306,"context_line":"    * ``default \u003d [true|false]`` (optional)"},{"line_number":307,"context_line":"        - The default policy can be changed at any time, by adding the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_9ecf94af","line":304,"range":{"start_line":304,"start_character":15,"end_line":304,"end_character":26},"in_reply_to":"ff0f0b1f_8b5bf952","updated":"2017-05-31 10:12:16.000000000","message":"Done","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":9625,"name":"Thiago da Silva","email":"thiagodasilva@gmail.com","username":"thiago"},"change_message_id":"61f2ddfd226987a312b41cf745c2c70037b2fe3c","unresolved":false,"context_lines":[{"line_number":318,"context_line":"        - When defining an EC policy use the value ``erasure_coding``."},{"line_number":319,"context_line":""},{"line_number":320,"context_line":"The EC policy type has additional required options. See"},{"line_number":321,"context_line":":doc:`overview_erasure_code` for details."},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"The following is an example of a properly configured ``swift.conf`` file. See"},{"line_number":324,"context_line":":doc:`policies_saio` for full instructions on setting up an all-in-one with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_ccdc5876","line":321,"range":{"start_line":321,"start_character":6,"end_line":321,"end_character":27},"updated":"2017-05-30 17:39:21.000000000","message":"would it make sense to link directly to overview_erasure_code.html#using-an-erasure-code-policy","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":318,"context_line":"        - When defining an EC policy use the value ``erasure_coding``."},{"line_number":319,"context_line":""},{"line_number":320,"context_line":"The EC policy type has additional required options. See"},{"line_number":321,"context_line":":doc:`overview_erasure_code` for details."},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"The following is an example of a properly configured ``swift.conf`` file. See"},{"line_number":324,"context_line":":doc:`policies_saio` for full instructions on setting up an all-in-one with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_dec18ce6","line":321,"range":{"start_line":321,"start_character":6,"end_line":321,"end_character":27},"in_reply_to":"df140735_ccdc5876","updated":"2017-05-31 10:12:16.000000000","message":"good idea. Done","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":15343,"name":"Tim Burke","email":"tburke@nvidia.com","username":"tburke"},"change_message_id":"fc1f362c6192f9c26b84dba8959a1f35ec1f29e1","unresolved":false,"context_lines":[{"line_number":355,"context_line":"policy index ``1``::"},{"line_number":356,"context_line":""},{"line_number":357,"context_line":"        swift-ring-builder object-1.builder create 10 3 1"},{"line_number":358,"context_line":"        \u003cand add devices, rebalance using the same naming convention\u003e"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":".. note::"},{"line_number":361,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_7d3aaccd","line":358,"range":{"start_line":358,"start_character":9,"end_line":358,"end_character":12},"updated":"2017-05-26 16:25:59.000000000","message":"Apparently we can get Sphinx to stop making that \"and\" bold by including a\n\n .. highlight:: none\n\ndirective: http://build-me-the-docs-please.readthedocs.io/en/latest/Using_Sphinx/ShowingCodeExamplesInSphinx.html#highlight-directive","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":7847,"name":"Alistair Coles","email":"alistairncoles@gmail.com","username":"acoles"},"change_message_id":"97f288a4df519a638be749d9c14f1a4afdb32ee2","unresolved":false,"context_lines":[{"line_number":355,"context_line":"policy index ``1``::"},{"line_number":356,"context_line":""},{"line_number":357,"context_line":"        swift-ring-builder object-1.builder create 10 3 1"},{"line_number":358,"context_line":"        \u003cand add devices, rebalance using the same naming convention\u003e"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":".. note::"},{"line_number":361,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_b9571203","line":358,"range":{"start_line":358,"start_character":9,"end_line":358,"end_character":12},"in_reply_to":"ff0f0b1f_7d3aaccd","updated":"2017-05-31 10:12:16.000000000","message":"now you point it out, I think we can do better than have the \u003c...\u003e text which looks like it is some continuation of the command line.","commit_id":"4282836475c3b4a7d771a490b83d8953faa031ef"},{"author":{"_account_id":9625,"name":"Thiago da Silva","email":"thiagodasilva@gmail.com","username":"thiago"},"change_message_id":"1d6d94ec90acf65a0af157c8f53c11bf928ec3cf","unresolved":false,"context_lines":[{"line_number":302,"context_line":"    * ``default \u003d [true|false]`` (optional)"},{"line_number":303,"context_line":"        - If ``true`` then this policy will be used when the client does not"},{"line_number":304,"context_line":"          specify a policy."},{"line_number":305,"context_line":"        - The default value is ``false``."},{"line_number":306,"context_line":"        - The default policy can be changed at any time, by setting"},{"line_number":307,"context_line":"          ``default \u003d true`` in the desired policy section."},{"line_number":308,"context_line":"        - If no policy is declared as the default and no other policies are"}],"source_content_type":"text/x-rst","patch_set":2,"id":"df140735_e07ed817","line":305,"range":{"start_line":305,"start_character":10,"end_line":305,"end_character":40},"updated":"2017-05-31 20:58:20.000000000","message":"wait, the default value of the default option is false? this is weird??? ;)\n\nIsn\u0027t it better to just leave it with the 4th bullet point, I think that explains it better...\n\n...w/e it\u0027s fine.","commit_id":"37ba21face333b710dea559fa00faf388a5d91fc"}]}