)]}'
{"doc/source/upgrade-guide/manual-upgrade.rst":[{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _upgrading-manually:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"Upgrading manually"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Deployers can run the upgrade steps manually. Manual upgrade is useful for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_69aff27c","line":4,"range":{"start_line":4,"start_character":0,"end_line":4,"end_character":18},"updated":"2016-11-29 04:03:43.000000000","message":"I would restructure this whole section to be a single procedure /numbered list. So each of the section headings below would be a step. This is to emphasize the importance of following the order and provide a frame of reference for users.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"70e70eb604b933d409e91b745ce9993cc8a3b6ed","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _upgrading-manually:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"Upgrading manually"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Deployers can run the upgrade steps manually. Manual upgrade is useful for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_08f580eb","line":4,"range":{"start_line":4,"start_character":0,"end_line":4,"end_character":18},"in_reply_to":"5a74a57a_69aff27c","updated":"2016-11-29 13:47:25.000000000","message":"Good suggestion - this is just edits for now, let\u0027s discuss this when we consider a restructure?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Upgrading manually"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Deployers can run the upgrade steps manually. Manual upgrade is useful for"},{"line_number":8,"context_line":"scoping the changes in the upgrade process (for example, in very large"},{"line_number":9,"context_line":"deployments with strict SLA requirements), or other upgrade automation beyond"},{"line_number":10,"context_line":"what OpenStack-Ansible provides."}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_e424110e","line":7,"updated":"2016-11-28 22:56:54.000000000","message":"perhaps \"A manual upgrad\"?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Deployers can run the upgrade steps manually. Manual upgrade is useful for"},{"line_number":8,"context_line":"scoping the changes in the upgrade process (for example, in very large"},{"line_number":9,"context_line":"deployments with strict SLA requirements), or other upgrade automation beyond"},{"line_number":10,"context_line":"what OpenStack-Ansible provides."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The steps detailed here match those performed by the ``run-upgrade.sh``"},{"line_number":13,"context_line":"script. Any of these steps can be run safely multiple times."}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_04202df6","line":10,"updated":"2016-11-28 22:56:54.000000000","message":"s/what/that which/?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":10,"context_line":"what OpenStack-Ansible provides."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The steps detailed here match those performed by the ``run-upgrade.sh``"},{"line_number":13,"context_line":"script. Any of these steps can be run safely multiple times."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Check out the |current_release_formal_name| release"},{"line_number":16,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_241b69cb","line":13,"updated":"2016-11-28 22:56:54.000000000","message":"s/run safely multiple times/safely run multiple times/ ?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"7356e4c506bf816962acd1f643783e74575379a9","unresolved":false,"context_lines":[{"line_number":10,"context_line":"what OpenStack-Ansible provides."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The steps detailed here match those performed by the ``run-upgrade.sh``"},{"line_number":13,"context_line":"script. Any of these steps can be run safely multiple times."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Check out the |current_release_formal_name| release"},{"line_number":16,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_781fc25a","line":13,"in_reply_to":"5a74a57a_241b69cb","updated":"2016-11-29 01:13:08.000000000","message":"This short sentence could work in active voice, with the second person (and the adverb \u0027safely\u0027 moved before the verb):\n\n You can safely run these steps multiple times.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":70,"context_line":"Clean up old facts"},{"line_number":71,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Some configurations have changed, so purge old facts should be purged before"},{"line_number":74,"context_line":"the upgrade. For more information, see :ref:`fact-cleanup-playbook`."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_e96b0283","line":73,"range":{"start_line":73,"start_character":5,"end_line":73,"end_character":19},"updated":"2016-11-29 04:03:43.000000000","message":"configuration options or configuration default parameters?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":70,"context_line":"Clean up old facts"},{"line_number":71,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Some configurations have changed, so purge old facts should be purged before"},{"line_number":74,"context_line":"the upgrade. For more information, see :ref:`fact-cleanup-playbook`."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_447ce5eb","line":73,"updated":"2016-11-28 22:56:54.000000000","message":"s/so purge old facts should be purged before should be/so old facts old facts should be purged before/","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":70,"context_line":"Clean up old facts"},{"line_number":71,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Some configurations have changed, so purge old facts should be purged before"},{"line_number":74,"context_line":"the upgrade. For more information, see :ref:`fact-cleanup-playbook`."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_292fba3f","line":73,"in_reply_to":"5a74a57a_447ce5eb","updated":"2016-11-29 04:03:43.000000000","message":"Or \"so purge old facts before..\"","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"    # openstack-ansible haproxy-install.yml"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"Update repo servers"},{"line_number":166,"context_line":"~~~~~~~~~~~~~~~~~~~"},{"line_number":167,"context_line":""},{"line_number":168,"context_line":"Update the configuration of the repo servers and build new packages required by"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_49c07650","line":165,"range":{"start_line":165,"start_character":7,"end_line":165,"end_character":11},"updated":"2016-11-29 04:03:43.000000000","message":"s/repo/repository","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":165,"context_line":"Update repo servers"},{"line_number":166,"context_line":"~~~~~~~~~~~~~~~~~~~"},{"line_number":167,"context_line":""},{"line_number":168,"context_line":"Update the configuration of the repo servers and build new packages required by"},{"line_number":169,"context_line":"the |current_release_formal_name| release."},{"line_number":170,"context_line":""},{"line_number":171,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_29a41ab8","line":168,"range":{"start_line":168,"start_character":32,"end_line":168,"end_character":36},"updated":"2016-11-29 04:03:43.000000000","message":"s/repo/repository","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":175,"context_line":"Upgrade the MariaDB version"},{"line_number":176,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":177,"context_line":""},{"line_number":178,"context_line":"Update MariaDB to the most recent 10.x minor release across the cluster."},{"line_number":179,"context_line":""},{"line_number":180,"context_line":".. code-block:: console"},{"line_number":181,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_647f21e0","line":178,"updated":"2016-11-28 22:56:54.000000000","message":"s/Update/Upgrade/ for consistency?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":207,"context_line":"Flush Memcached cache"},{"line_number":208,"context_line":"~~~~~~~~~~~~~~~~~~~~~"},{"line_number":209,"context_line":""},{"line_number":210,"context_line":"Flush all of the cache in Memcached. For more information,"},{"line_number":211,"context_line":"see :ref:`memcached-flush`."},{"line_number":212,"context_line":""},{"line_number":213,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_84827dc6","line":210,"updated":"2016-11-28 22:56:54.000000000","message":"I think this should be either \"all of the caches\" or just \"the cache\"","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":15993,"name":"Amy Marrich","display_name":"Amy Marrich (spotz)","email":"amy@demarco.com","username":"amarrich"},"change_message_id":"70e314e1fb91c0b2bd341c7192e5da684d9d04fd","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Upgrading manually"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Deployers can run the upgrade steps manually. A manual upgrade is useful for"},{"line_number":8,"context_line":"scoping the changes in the upgrade process (for example, in very large"},{"line_number":9,"context_line":"deployments with strict SLA requirements), or other upgrade automation beyond"},{"line_number":10,"context_line":"what OpenStack-Ansible provides."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a74a57a_a66d5dce","line":7,"range":{"start_line":7,"start_character":44,"end_line":7,"end_character":62},"updated":"2016-11-30 15:43:07.000000000","message":"Reads awkward. Maybe \u0027manually, this is....\u0027","commit_id":"7bd60d185296fcbd752750a52668433a63c90c5e"},{"author":{"_account_id":15993,"name":"Amy Marrich","display_name":"Amy Marrich (spotz)","email":"amy@demarco.com","username":"amarrich"},"change_message_id":"70e314e1fb91c0b2bd341c7192e5da684d9d04fd","unresolved":false,"context_lines":[{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Deployers can run the upgrade steps manually. A manual upgrade is useful for"},{"line_number":8,"context_line":"scoping the changes in the upgrade process (for example, in very large"},{"line_number":9,"context_line":"deployments with strict SLA requirements), or other upgrade automation beyond"},{"line_number":10,"context_line":"what OpenStack-Ansible provides."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The steps detailed here match those performed by the ``run-upgrade.sh``"},{"line_number":13,"context_line":"script. You can safely run these steps multiple times."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a74a57a_06f611d7","line":10,"range":{"start_line":9,"start_character":46,"end_line":10,"end_character":32},"updated":"2016-11-30 15:43:07.000000000","message":"Neil\u0027s suggestion is valid but still might read oddly. \nor other upgrade automation beyond what is provided by OpenStack-Ansible","commit_id":"7bd60d185296fcbd752750a52668433a63c90c5e"}],"doc/source/upgrade-guide/minor-upgrade.rst":[{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Upgrading to a minor version"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Upgrades between minor version of OpenStack-Ansible require updating the"},{"line_number":8,"context_line":"repository clone to the latest minor release tag, and then running playbooks"},{"line_number":9,"context_line":"against the target hosts. This section provides instructions for those tasks."},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_2907ba82","line":7,"range":{"start_line":7,"start_character":23,"end_line":7,"end_character":30},"updated":"2016-11-29 04:03:43.000000000","message":"versions","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Upgrades between minor version of OpenStack-Ansible require updating the"},{"line_number":8,"context_line":"repository clone to the latest minor release tag, and then running playbooks"},{"line_number":9,"context_line":"against the target hosts. This section provides instructions for those tasks."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Prerequisites"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_24728911","line":8,"updated":"2016-11-28 22:56:54.000000000","message":"perhaps just repository rather than repository clone?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"To avoid issues and simplify troubleshooting during the upgrade, disable the"},{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_44630542","line":16,"updated":"2016-11-28 22:56:54.000000000","message":"Should probably recommend re-applying the security hardening at some point","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"44d5955c9a9e4f6b1463d3d9d2d4677ac0f7c29c","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"To avoid issues and simplify troubleshooting during the upgrade, disable the"},{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_d7294ef4","line":16,"in_reply_to":"5a74a57a_28c79c96","updated":"2016-11-29 23:54:57.000000000","message":"After the upgrade.  Would probably be best to get Major\u0027s input on this. My concern is that upgraders may think they are secure when they are not. Presumably this won\u0027t remove existing security hardening, but they will miss out on hardening for new services, or any new additions to the security profile.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"70e70eb604b933d409e91b745ce9993cc8a3b6ed","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"To avoid issues and simplify troubleshooting during the upgrade, disable the"},{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_28c79c96","line":16,"in_reply_to":"5a74a57a_292edafa","updated":"2016-11-29 13:47:25.000000000","message":"Good question - Neill, do you have much context for this section? Are you able to help us flesh it out?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"To avoid issues and simplify troubleshooting during the upgrade, disable the"},{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_292edafa","line":16,"in_reply_to":"5a74a57a_44630542","updated":"2016-11-29 04:03:43.000000000","message":"When? After the upgrade?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":538,"name":"Major Hayden","email":"major@mhtx.net","username":"rackerhacker"},"change_message_id":"b56dc38eec42d620dd696cc5b9b09ad94cf58539","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"To avoid issues and simplify troubleshooting during the upgrade, disable the"},{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_e73f5cd4","line":16,"in_reply_to":"5a74a57a_d7294ef4","updated":"2016-11-30 13:14:13.000000000","message":"So any existing hardening configurations that were set before the upgrade *will remain* in place after the upgrade is done. However, any new or improved configurations from the new version of the role won\u0027t be applied.\n\nPerhaps we need something here (or later in the docs) that says to remove this variable and re-run the security role only.\n\nHowever, the role itself has been quite stable, so I don\u0027t see why it couldn\u0027t remain in place during an upgrade.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0469a4b67a2486627cb916a8ca9f4698eff0245e","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"To avoid issues and simplify troubleshooting during the upgrade, disable the"},{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a71b18c_313a97ce","line":16,"in_reply_to":"5a74a57a_e73f5cd4","updated":"2016-12-01 10:42:43.000000000","message":"Thanks Major - I think I\u0027ll keep this as a note for later when we work on the upgrade doc as a whole (and not just edits)","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":20,"context_line":""},{"line_number":21,"context_line":"A minor upgrade typically requires the following steps:"},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"#. Change directory to the repository clone root directory:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   .. code-block:: console"},{"line_number":26,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_64664152","line":23,"updated":"2016-11-28 22:56:54.000000000","message":"I really don\u0027t like the phrase repository clone, but I can\u0027t offer anything much better. \"repository root dirctory\" doesn\u0027t sound quite right either.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":20,"context_line":""},{"line_number":21,"context_line":"A minor upgrade typically requires the following steps:"},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"#. Change directory to the repository clone root directory:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   .. code-block:: console"},{"line_number":26,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_a942eaab","line":23,"in_reply_to":"5a74a57a_64664152","updated":"2016-11-29 04:03:43.000000000","message":"or \"cloned repository root directory\"?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":94,"context_line":"      Skipping the ``nova-key`` tag is necessary so that the keys on"},{"line_number":95,"context_line":"      all Compute hosts are not gathered."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"To see which hosts belong to which groups, the ``inventory-manage.py``"},{"line_number":98,"context_line":"script to show all groups and their hosts. For example:"},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"#. Change directory to the repository clone root directory:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_84599d90","line":97,"updated":"2016-11-28 22:56:54.000000000","message":"s/groups, the/groups, use the/","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":15993,"name":"Amy Marrich","display_name":"Amy Marrich (spotz)","email":"amy@demarco.com","username":"amarrich"},"change_message_id":"70e314e1fb91c0b2bd341c7192e5da684d9d04fd","unresolved":false,"context_lines":[{"line_number":20,"context_line":""},{"line_number":21,"context_line":"A minor upgrade typically requires the following steps:"},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"#. Change directory to the cloned repository root directory:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   .. code-block:: console"},{"line_number":26,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a74a57a_86d78122","line":23,"range":{"start_line":23,"start_character":43,"end_line":23,"end_character":45},"updated":"2016-11-30 15:43:07.000000000","message":"repository\u0027s","commit_id":"7bd60d185296fcbd752750a52668433a63c90c5e"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"bc9f9642d380b4a86426e709b702a5e2dbbf0d02","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _upgrading-to-a-minor-version:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"Upgrading to a minor version"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Upgrades between minor versions of OpenStack-Ansible require updating the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a71b18c_afaac26e","line":4,"range":{"start_line":4,"start_character":0,"end_line":4,"end_character":28},"updated":"2016-12-01 11:27:33.000000000","message":"This changes the meaning a bit... it should be something like \u0027Executing a minor version upgrade\u0027 and the major version upgrade heading should likely use the same wording with obviously s/minor/major/","commit_id":"d5cf40214f08e0ebd6e0a5615f4cde1967acfb43"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"bc9f9642d380b4a86426e709b702a5e2dbbf0d02","unresolved":false,"context_lines":[{"line_number":15,"context_line":"security hardening role by setting the ``apply_security_hardening`` variable"},{"line_number":16,"context_line":"to ``False`` in the :file:`user_variables.yml` file."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Upgrade to a minor version"},{"line_number":19,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"A minor upgrade typically requires the following steps:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a71b18c_efbafabf","line":18,"range":{"start_line":18,"start_character":0,"end_line":18,"end_character":26},"updated":"2016-12-01 11:27:33.000000000","message":"As above, I don\u0027t think this heading makes sense.","commit_id":"d5cf40214f08e0ebd6e0a5615f4cde1967acfb43"}],"doc/source/upgrade-guide/overview.rst":[{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":14,"context_line":":ref:`upgrading-to-a-minor-version`."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"For upgrades between major versions, the OpenStack-Ansible repository provides"},{"line_number":17,"context_line":"playbooks and scripts to use to upgrade an environment. The ``run-upgrade.sh``"},{"line_number":18,"context_line":"script runs each upgrade playbook in the correct order, or playbooks can be run"},{"line_number":19,"context_line":"individually if necessary. Alternatively, a deployer can upgrade manually. A"},{"line_number":20,"context_line":"major upgrade process performs the following actions:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_04774d02","line":17,"updated":"2016-11-28 22:56:54.000000000","message":"delete to use?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":14,"context_line":":ref:`upgrading-to-a-minor-version`."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"For upgrades between major versions, the OpenStack-Ansible repository provides"},{"line_number":17,"context_line":"playbooks and scripts to use to upgrade an environment. The ``run-upgrade.sh``"},{"line_number":18,"context_line":"script runs each upgrade playbook in the correct order, or playbooks can be run"},{"line_number":19,"context_line":"individually if necessary. Alternatively, a deployer can upgrade manually. A"},{"line_number":20,"context_line":"major upgrade process performs the following actions:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_913f18b3","line":17,"in_reply_to":"5a74a57a_04774d02","updated":"2016-11-29 04:03:43.000000000","message":"+1","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"}],"doc/source/upgrade-guide/reference-scripts.rst":[{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"This section describes in detail the scripts that are used in the upgrade"},{"line_number":6,"context_line":"process in detail."},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"Within the main :file:`scripts` directory there is an :file:`upgrade-utilities`"},{"line_number":9,"context_line":"directory, which contains additional scripts that facilitate the initial"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_a485b9cf","line":6,"updated":"2016-11-28 22:56:54.000000000","message":"delete \"in detail\" at end of sentence.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"7356e4c506bf816962acd1f643783e74575379a9","unresolved":false,"context_lines":[{"line_number":16,"context_line":"deployers who do not want to upgrade manually. It provides the following"},{"line_number":17,"context_line":"environment variables:"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"* ``SCRIPTS_PATH`` - Path to the top level scripts directory"},{"line_number":20,"context_line":"* ``MAIN_PATH`` - The `openstack_ansible` root directory."},{"line_number":21,"context_line":"* ``UPGRADE_PLAYBOOKS`` - Path to the playbooks used in upgrading"},{"line_number":22,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_188b2e69","line":19,"updated":"2016-11-29 01:13:08.000000000","message":"Add in the definite article - \"The path to the top level...\"","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":17,"context_line":"environment variables:"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"* ``SCRIPTS_PATH`` - Path to the top level scripts directory"},{"line_number":20,"context_line":"* ``MAIN_PATH`` - The `openstack_ansible` root directory."},{"line_number":21,"context_line":"* ``UPGRADE_PLAYBOOKS`` - Path to the playbooks used in upgrading"},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"The upgrade script also bootstraps OpenStack-Ansible (using"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_c470f50d","line":20,"updated":"2016-11-28 22:56:54.000000000","message":"is this the same as the repository clone directory?","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"7356e4c506bf816962acd1f643783e74575379a9","unresolved":false,"context_lines":[{"line_number":18,"context_line":""},{"line_number":19,"context_line":"* ``SCRIPTS_PATH`` - Path to the top level scripts directory"},{"line_number":20,"context_line":"* ``MAIN_PATH`` - The `openstack_ansible` root directory."},{"line_number":21,"context_line":"* ``UPGRADE_PLAYBOOKS`` - Path to the playbooks used in upgrading"},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"The upgrade script also bootstraps OpenStack-Ansible (using"},{"line_number":24,"context_line":"``bootstrap-ansible.sh``) in order to provide the new role dependencies"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_d8db767a","line":21,"updated":"2016-11-29 01:13:08.000000000","message":"And also here, to be consistent with lines 19 and 20 - \"The path to the playbooks...\"","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"7356e4c506bf816962acd1f643783e74575379a9","unresolved":false,"context_lines":[{"line_number":36,"context_line":"Variable names within comments are updated."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"This script creates files in the form ``VARS_MIGRATED_\u003cfilename\u003e`` and"},{"line_number":39,"context_line":"places them in |upgrade_backup_dir| direcotry."},{"line_number":40,"context_line":"For example, after the script processes the"},{"line_number":41,"context_line":"``/etc/openstack_deploy/user_variables.yml`` file, it creates the"},{"line_number":42,"context_line":"``VARS_MIGRATED_user_variables.yml`` file in the |upgrade_backup_dir|"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_38d38a61","line":39,"updated":"2016-11-29 01:13:08.000000000","message":"fix typo - directory.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"}],"doc/source/upgrade-guide/reference-upgrade-playbooks.rst":[{"author":{"_account_id":10881,"name":"Neill Cox","email":"neill@ingenious.com.au","username":"neillc"},"change_message_id":"8525ae3643a051e8d139517e2f0b6bb388072d2e","unresolved":false,"context_lines":[{"line_number":71,"context_line":".. note::"},{"line_number":72,"context_line":"    The RabbitMQ server role installs patch releases automatically,"},{"line_number":73,"context_line":"    regardless of the value of ``rabbitmq_upgrade``. This variable"},{"line_number":74,"context_line":"    controls upgrading only the major or minor versions."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"    Upgrading RabbitMQ in the |current_release_formal_name| release is optional. The"},{"line_number":77,"context_line":"    ``run-upgrade.sh`` script does not automatically upgrade it. To upgrade"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_e46b311c","line":74,"updated":"2016-11-28 22:56:54.000000000","message":"I\u0027m finding this wording a little confusing, but that may just be me.","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"f3f68457c9eca74d7892369476d2167da5cea063","unresolved":false,"context_lines":[{"line_number":71,"context_line":".. note::"},{"line_number":72,"context_line":"    The RabbitMQ server role installs patch releases automatically,"},{"line_number":73,"context_line":"    regardless of the value of ``rabbitmq_upgrade``. This variable"},{"line_number":74,"context_line":"    controls upgrading only the major or minor versions."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"    Upgrading RabbitMQ in the |current_release_formal_name| release is optional. The"},{"line_number":77,"context_line":"    ``run-upgrade.sh`` script does not automatically upgrade it. To upgrade"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a74a57a_31f2c406","line":74,"in_reply_to":"5a74a57a_e46b311c","updated":"2016-11-29 04:03:43.000000000","message":"+1","commit_id":"876dd64e7411ef5417a530123810f5abf9076237"}],"doc/source/upgrade-guide/reference.rst":[{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"f1289c727250c3577d60e9c4a359bcf1740e6f6b","unresolved":false,"context_lines":[{"line_number":1,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":2,"context_line":"Reference information for the upgrade"},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\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":".. toctree::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a71b18c_cf5ffe73","line":2,"updated":"2016-12-01 11:31:28.000000000","message":"s?","commit_id":"d5cf40214f08e0ebd6e0a5615f4cde1967acfb43"}]}