)]}'
{"doc/admin-guide-cloud-rst/source/objectstorage-troubleshoot.rst":[{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"03d55d19ad3da19b36c1bd2aced2bb4b25e2e635","unresolved":false,"context_lines":[{"line_number":16,"context_line":"be replaced immediately, then it is just best to replace the drive,"},{"line_number":17,"context_line":"format it, remount it, and let replication fill it up."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"If the drive can\u0027t be replaced immediately, then it is best to leave it"},{"line_number":20,"context_line":"unmounted, and remove the drive from the ring. This will allow all the"},{"line_number":21,"context_line":"replicas that were on that drive to be replicated elsewhere until the"},{"line_number":22,"context_line":"drive is replaced. Once the drive is replaced, it can be re-added to the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_5a087d2d","line":19,"updated":"2015-08-11 03:53:33.000000000","message":"This is just a drive-by comment - but if you could possibly remove the contraction, thanks.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"3b9f6265a7de9384921e19e2ecfa66dd9eceacec","unresolved":false,"context_lines":[{"line_number":55,"context_line":"Storage can work around it. The script takes a configuration file with"},{"line_number":56,"context_line":"the following settings:"},{"line_number":57,"context_line":""},{"line_number":58,"context_line":".. list-table:: Description of configuration options for [drive-audit] in drive-audit.conf"},{"line_number":59,"context_line":"   :header-rows: 1"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"   * - Configuration option \u003d Default value"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_b2579d25","line":58,"updated":"2015-08-10 07:30:14.000000000","message":"could you please make the table heading bold?","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"b233741f425bcb998ecb50e6f1b84d66c74b80cc","unresolved":false,"context_lines":[{"line_number":68,"context_line":"     - Location where syslog sends the logs to"},{"line_number":69,"context_line":"   * - log_facility \u003d *LOG_LOCAL0*"},{"line_number":70,"context_line":"     - Syslog log facility"},{"line_number":71,"context_line":"   * - log_file_pattern \u003d */var/log/kern.*[!.][!g][!z]*"},{"line_number":72,"context_line":"     - Location of the log file with globbing pattern to check against device"},{"line_number":73,"context_line":"       errors locate device blocks with errors in the log file"},{"line_number":74,"context_line":"   * - log_level \u003d *INFO*"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_93aa75d1","line":71,"updated":"2015-08-11 01:51:20.000000000","message":"*/var/log/kern.\\*[!.][!g][!z]*","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":12686,"name":"Brian Moss","email":"kallimachos@gmail.com","username":"bmoss"},"change_message_id":"317f17b90c129167dc3943f66f9d916cf180400e","unresolved":false,"context_lines":[{"line_number":68,"context_line":"     - Location where syslog sends the logs to"},{"line_number":69,"context_line":"   * - log_facility \u003d *LOG_LOCAL0*"},{"line_number":70,"context_line":"     - Syslog log facility"},{"line_number":71,"context_line":"   * - log_file_pattern \u003d */var/log/kern.*[!.][!g][!z]*"},{"line_number":72,"context_line":"     - Location of the log file with globbing pattern to check against device"},{"line_number":73,"context_line":"       errors locate device blocks with errors in the log file"},{"line_number":74,"context_line":"   * - log_level \u003d *INFO*"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa1b9901_b03c8c94","line":71,"in_reply_to":"1a4dcd0f_93aa75d1","updated":"2015-08-18 02:41:00.000000000","message":"Thanks Kato, I did forget the escape character. Thinking about it a bit more, I think I\u0027ll go with Olga\u0027s suggestion and mark these as code with ``, which nicely avoids the need to escape the *.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"b233741f425bcb998ecb50e6f1b84d66c74b80cc","unresolved":false,"context_lines":[{"line_number":82,"context_line":"     - Number of minutes to look back in :file:`/var/log/kern.log`"},{"line_number":83,"context_line":"   * - recon_cache_path \u003d */var/cache/swift*"},{"line_number":84,"context_line":"     - Directory where stats for a few items will be stored"},{"line_number":85,"context_line":"   * - regex_pattern_1 \u003d *\\berror\\b.*\\b(dm-[0-9]{1,2}\\d?)\\b*"},{"line_number":86,"context_line":"     - No help text available for this option."},{"line_number":87,"context_line":"   * - unmount_failed_device \u003d *True*"},{"line_number":88,"context_line":"     - No help text available for this option."}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_9391159d","line":85,"updated":"2015-08-11 01:51:20.000000000","message":"*\\\\berror\\\\b.\\*\\\\b(dm-[0-9]{1,2}\\\\d?)\\\\b*","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"14f533858184edf8a91970e5ce65e410d4af8a8d","unresolved":false,"context_lines":[{"line_number":82,"context_line":"     - Number of minutes to look back in :file:`/var/log/kern.log`"},{"line_number":83,"context_line":"   * - recon_cache_path \u003d */var/cache/swift*"},{"line_number":84,"context_line":"     - Directory where stats for a few items will be stored"},{"line_number":85,"context_line":"   * - regex_pattern_1 \u003d *\\berror\\b.*\\b(dm-[0-9]{1,2}\\d?)\\b*"},{"line_number":86,"context_line":"     - No help text available for this option."},{"line_number":87,"context_line":"   * - unmount_failed_device \u003d *True*"},{"line_number":88,"context_line":"     - No help text available for this option."}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_6dcff8b3","line":85,"updated":"2015-08-10 07:41:25.000000000","message":"This[1] looks different from original[2]. Please recheck usage of \"*\" (maybe need escape).\n\n[1] http://docs-draft.openstack.org/95/210995/1/check/gate-openstack-manuals-tox-doc-publish-checkbuild/95f5cfa//publish-docs/draft/admin-guide-cloud-rst/objectstorage-troubleshoot.html#detect-failed-drives\n\n[2] http://docs.openstack.org/admin-guide-cloud/content/detect-failed-drives.html","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"786dec85b5234292f1e2e8fb84f8b7c236d61546","unresolved":false,"context_lines":[{"line_number":82,"context_line":"     - Number of minutes to look back in :file:`/var/log/kern.log`"},{"line_number":83,"context_line":"   * - recon_cache_path \u003d */var/cache/swift*"},{"line_number":84,"context_line":"     - Directory where stats for a few items will be stored"},{"line_number":85,"context_line":"   * - regex_pattern_1 \u003d *\\berror\\b.*\\b(dm-[0-9]{1,2}\\d?)\\b*"},{"line_number":86,"context_line":"     - No help text available for this option."},{"line_number":87,"context_line":"   * - unmount_failed_device \u003d *True*"},{"line_number":88,"context_line":"     - No help text available for this option."}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_59a5e201","line":85,"in_reply_to":"1a4dcd0f_9391159d","updated":"2015-08-11 07:26:09.000000000","message":"I think there is no need in emphasizing values of the options. You can wrap option \u003d value in double back ticks so that it is treated as code, for example, ``regex_pattern_1 \u003d \\berror\\b.*\\b(dm-[0-9]{1,2}\\d?)\\b``","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"03d55d19ad3da19b36c1bd2aced2bb4b25e2e635","unresolved":false,"context_lines":[{"line_number":92,"context_line":"This script has only been tested on Ubuntu 10.04, so if you are using a"},{"line_number":93,"context_line":"different distro or OS, some care should be taken before using in"},{"line_number":94,"context_line":"production."},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"Emergency recovery of ring builder files"},{"line_number":97,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":98,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_dd024709","line":95,"updated":"2015-08-11 03:53:33.000000000","message":"Should the above be in a note?","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"ff044f2bd77a58b7fcddcaee427a82740bf7d372","unresolved":false,"context_lines":[{"line_number":92,"context_line":"This script has only been tested on Ubuntu 10.04, so if you are using a"},{"line_number":93,"context_line":"different distro or OS, some care should be taken before using in"},{"line_number":94,"context_line":"production."},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"Emergency recovery of ring builder files"},{"line_number":97,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":98,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_cb9b61c8","line":95,"updated":"2015-08-11 05:06:50.000000000","message":"The .xml version has this final comment as a paragraph - http://docs.openstack.org/admin-guide-cloud/content/detect-failed-drives.html\n\nWe can leave as is, change it to a note now, or add a work item to check consistent use of Notes in the guides as a task: https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides#The_List_of_Tasks","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":12686,"name":"Brian Moss","email":"kallimachos@gmail.com","username":"bmoss"},"change_message_id":"317f17b90c129167dc3943f66f9d916cf180400e","unresolved":false,"context_lines":[{"line_number":92,"context_line":"This script has only been tested on Ubuntu 10.04, so if you are using a"},{"line_number":93,"context_line":"different distro or OS, some care should be taken before using in"},{"line_number":94,"context_line":"production."},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"Emergency recovery of ring builder files"},{"line_number":97,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":98,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa1b9901_104c5841","line":95,"in_reply_to":"1a4dcd0f_cb9b61c8","updated":"2015-08-18 02:41:00.000000000","message":"In fact, this should be a warning, since it could cause problems if used in production. I\u0027ll mark it accordingly.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"14f533858184edf8a91970e5ce65e410d4af8a8d","unresolved":false,"context_lines":[{"line_number":112,"context_line":""},{"line_number":113,"context_line":"#. Load the ring and a new ringbuilder object in a Python REPL:"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"   .. code-block:: python"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"      \u003e\u003e\u003e from swift.common.ring import RingData, RingBuilder"},{"line_number":118,"context_line":"      \u003e\u003e\u003e ring \u003d RingData.load(\u0027/path/to/account.ring.gz\u0027)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_6d3618b6","line":115,"updated":"2015-08-10 07:41:25.000000000","message":"The original has line numbers. No need?","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"786dec85b5234292f1e2e8fb84f8b7c236d61546","unresolved":false,"context_lines":[{"line_number":112,"context_line":""},{"line_number":113,"context_line":"#. Load the ring and a new ringbuilder object in a Python REPL:"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"   .. code-block:: python"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"      \u003e\u003e\u003e from swift.common.ring import RingData, RingBuilder"},{"line_number":118,"context_line":"      \u003e\u003e\u003e ring \u003d RingData.load(\u0027/path/to/account.ring.gz\u0027)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_59f3a20a","line":115,"in_reply_to":"1a4dcd0f_6d3618b6","updated":"2015-08-11 07:26:09.000000000","message":"+1","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":12686,"name":"Brian Moss","email":"kallimachos@gmail.com","username":"bmoss"},"change_message_id":"317f17b90c129167dc3943f66f9d916cf180400e","unresolved":false,"context_lines":[{"line_number":112,"context_line":""},{"line_number":113,"context_line":"#. Load the ring and a new ringbuilder object in a Python REPL:"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"   .. code-block:: python"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"      \u003e\u003e\u003e from swift.common.ring import RingData, RingBuilder"},{"line_number":118,"context_line":"      \u003e\u003e\u003e ring \u003d RingData.load(\u0027/path/to/account.ring.gz\u0027)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa1b9901_307abc25","line":115,"in_reply_to":"1a4dcd0f_6d3618b6","updated":"2015-08-18 02:41:00.000000000","message":"I\u0027ll add it in to match the original, although I wonder if we should develop a convention around line numbers. I usually feel that adding numbers to code blocks shorter than 5 lines is not helpful. For example, the original document also has line numbers for the single-line code blocks in this procedure, which is not informative: http://docs.openstack.org/admin-guide-cloud/content/recover-ring-builder-file.html","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"d8e0887e6667bff83b94962bbde94313fd085c95","unresolved":false,"context_lines":[{"line_number":112,"context_line":""},{"line_number":113,"context_line":"#. Load the ring and a new ringbuilder object in a Python REPL:"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"   .. code-block:: python"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"      \u003e\u003e\u003e from swift.common.ring import RingData, RingBuilder"},{"line_number":118,"context_line":"      \u003e\u003e\u003e ring \u003d RingData.load(\u0027/path/to/account.ring.gz\u0027)"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa1b9901_ad5d07eb","line":115,"in_reply_to":"fa1b9901_307abc25","updated":"2015-08-18 08:48:06.000000000","message":"+1 for discussing this and adding the rule to conventions.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"3b9f6265a7de9384921e19e2ecfa66dd9eceacec","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"#. Start copying the data we have in the ring into the builder:"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"   .. code-block:: python"},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"      \u003e\u003e\u003e import math"},{"line_number":125,"context_line":"      \u003e\u003e\u003e partitions \u003d len(ring._replica2part2dev_id[0])"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_32114d5e","line":122,"updated":"2015-08-10 07:30:14.000000000","message":"Could you please add :linenos: markup (under the code-block markup) to enumerate the lines here.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"03d55d19ad3da19b36c1bd2aced2bb4b25e2e635","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"#. Start copying the data we have in the ring into the builder:"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"   .. code-block:: python"},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"      \u003e\u003e\u003e import math"},{"line_number":125,"context_line":"      \u003e\u003e\u003e partitions \u003d len(ring._replica2part2dev_id[0])"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_dd29e78a","line":122,"in_reply_to":"1a4dcd0f_32114d5e","updated":"2015-08-11 03:53:33.000000000","message":"+1","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"03d55d19ad3da19b36c1bd2aced2bb4b25e2e635","unresolved":false,"context_lines":[{"line_number":140,"context_line":""},{"line_number":141,"context_line":"      This is the extent of the recoverable fields."},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"#. For ``min_part_hours`` you\u0027ll either have to remember what the value you"},{"line_number":144,"context_line":"   used was, or just make up a new one:"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"   .. code-block:: python"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_7d20d39b","line":143,"updated":"2015-08-11 03:53:33.000000000","message":"Please remove the contraction","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"03d55d19ad3da19b36c1bd2aced2bb4b25e2e635","unresolved":false,"context_lines":[{"line_number":154,"context_line":""},{"line_number":155,"context_line":"      \u003e\u003e\u003e builder.validate()"},{"line_number":156,"context_line":""},{"line_number":157,"context_line":"#. After it validates, you\u0027re ready to save the builder and"},{"line_number":158,"context_line":"   create a new ``account.builder``:"},{"line_number":159,"context_line":""},{"line_number":160,"context_line":"   .. code-block:: python"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_1d30afe7","line":157,"updated":"2015-08-11 03:53:33.000000000","message":"Contraction.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"14f533858184edf8a91970e5ce65e410d4af8a8d","unresolved":false,"context_lines":[{"line_number":164,"context_line":"      \u003e\u003e\u003e exit ()"},{"line_number":165,"context_line":""},{"line_number":166,"context_line":"#. You should now have a file called :file:`account.builder` in the current"},{"line_number":167,"context_line":"   working directory. Run ``swift-ring-builder account.builder write_ring`` and"},{"line_number":168,"context_line":"   compare the new :file:`account.ring.gz` to the :file:`account.ring.gz`"},{"line_number":169,"context_line":"   that you started from. They probably won\u0027t be byte-for-byte identical, but"},{"line_number":170,"context_line":"   if you load them up in a REPL and their ``_replica2part2dev_id`` and"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_2d25705b","line":167,"updated":"2015-08-10 07:41:25.000000000","message":":command:`swift-ring-builder account.builder write_ring`","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"03d55d19ad3da19b36c1bd2aced2bb4b25e2e635","unresolved":false,"context_lines":[{"line_number":169,"context_line":"   that you started from. They probably won\u0027t be byte-for-byte identical, but"},{"line_number":170,"context_line":"   if you load them up in a REPL and their ``_replica2part2dev_id`` and"},{"line_number":171,"context_line":"   ``devs`` attributes are the same (or nearly so), then you\u0027re in good shape."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"#. Repeat the procedure for :file:`container.ring.gz` and"},{"line_number":174,"context_line":"   :file:`object.ring.gz`, and you might get usable builder files."}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_1db50f30","line":172,"updated":"2015-08-11 03:53:33.000000000","message":"Contractions here too.","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"786dec85b5234292f1e2e8fb84f8b7c236d61546","unresolved":false,"context_lines":[{"line_number":169,"context_line":"   that you started from. They probably won\u0027t be byte-for-byte identical, but"},{"line_number":170,"context_line":"   if you load them up in a REPL and their ``_replica2part2dev_id`` and"},{"line_number":171,"context_line":"   ``devs`` attributes are the same (or nearly so), then you\u0027re in good shape."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"#. Repeat the procedure for :file:`container.ring.gz` and"},{"line_number":174,"context_line":"   :file:`object.ring.gz`, and you might get usable builder files."}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a4dcd0f_59cac2a2","line":172,"in_reply_to":"1a4dcd0f_1db50f30","updated":"2015-08-11 07:26:09.000000000","message":"+1\nplease check the whole file for contractions","commit_id":"878aef73595093e6c59288cf5bb63392116cdec7"}]}