)]}'
{"doc/admin-guide-cloud/blockstorage/section_volume-backups.xml":[{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"a264bb3a8dc2041ad8f3a6249f9527cf60671655","unresolved":false,"context_lines":[{"line_number":26,"context_line":"  \u003cpara\u003eIf instead you want to use an NFS export as the backup repository, add the following configuration parameters to the \u003cliteral\u003e[DEFAULT]\u003c/literal\u003e section of the \u003cfilename\u003ecinder.conf\u003c/filename\u003e file and restart the Block Storage services:"},{"line_number":27,"context_line":"  \u003c/para\u003e"},{"line_number":28,"context_line":"  \u003cprogramlisting language\u003d\"ini\"\u003e"},{"line_number":29,"context_line":"    backup_driver\u003dcinder.backup.drivers.nfs"},{"line_number":30,"context_line":"    backup_share\u003d\u003creplaceable\u003eHOST\u003c/replaceable\u003e:\u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e"},{"line_number":31,"context_line":"  \u003c/programlisting\u003e"},{"line_number":32,"context_line":"  \u003cpara\u003eFor the \u003coption\u003ebackup_share\u003c/option\u003e parameter, replace \u003creplaceable\u003eHOST\u003c/replaceable\u003e by the DNS resolvable host name or the IP address of the storage server for the NFS share, and \u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e with the path to that share.  If your environment requires that non-default mount options be specified for the share, set these as follows:"}],"source_content_type":"application/xml","patch_set":2,"id":"dac4157f_2219f988","line":29,"updated":"2015-04-21 19:02:16.000000000","message":"Remove initial withspace and wrap this as documented in:\nhttps://wiki.openstack.org/wiki/Documentation/Markup_conventions#Avoiding_empty_lines_in_screen_and_programlistings\n\nAlso add spaces around \"\u003d\"","commit_id":"4204f871740baa5feb6050e3b7bec6dc472e0781"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":28,"context_line":"  \u003cpara\u003eBy default, the Swift object store is used for the backup repository.\u003c/para\u003e"},{"line_number":29,"context_line":"  \u003cpara\u003e"},{"line_number":30,"context_line":"    If instead you want to use an NFS export as the backup repository,"},{"line_number":31,"context_line":"    add the following configuration parameters to the"},{"line_number":32,"context_line":"    \u003cliteral\u003e[DEFAULT]\u003c/literal\u003e section of the"},{"line_number":33,"context_line":"    \u003cfilename\u003ecinder.conf\u003c/filename\u003e file and restart the Block"},{"line_number":34,"context_line":"    Storage services:"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_55b1708e","line":31,"updated":"2015-04-23 17:59:02.000000000","message":"options","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":36,"context_line":"  \u003cprogramlisting language\u003d\"ini\"\u003ebackup_driver \u003d cinder.backup.drivers.nfs"},{"line_number":37,"context_line":"backup_share \u003d \u003creplaceable\u003eHOST\u003c/replaceable\u003e:\u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e\u003c/programlisting\u003e"},{"line_number":38,"context_line":"  \u003cpara\u003e"},{"line_number":39,"context_line":"    For the \u003coption\u003ebackup_share\u003c/option\u003e parameter, replace"},{"line_number":40,"context_line":"    \u003creplaceable\u003eHOST\u003c/replaceable\u003e by the DNS resolvable host name or"},{"line_number":41,"context_line":"    the IP address of the storage server for the NFS share, and"},{"line_number":42,"context_line":"    \u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e with the path to that"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_15abf81e","line":39,"updated":"2015-04-23 17:59:02.000000000","message":"option","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":40,"context_line":"    \u003creplaceable\u003eHOST\u003c/replaceable\u003e by the DNS resolvable host name or"},{"line_number":41,"context_line":"    the IP address of the storage server for the NFS share, and"},{"line_number":42,"context_line":"    \u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e with the path to that"},{"line_number":43,"context_line":"    share.  If your environment requires that non-default mount"},{"line_number":44,"context_line":"    options be specified for the share, set these as follows:"},{"line_number":45,"context_line":"  \u003c/para\u003e"},{"line_number":46,"context_line":"  \u003cprogramlisting language\u003d\"ini\"\u003ebackup_mount_options \u003d \u003creplaceable\u003eMOUNT_OPTIONS\u003c/replaceable\u003e\u003c/programlisting\u003e"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_7549148b","line":43,"updated":"2015-04-23 17:59:02.000000000","message":"Only one space.","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":48,"context_line":"    Here \u003creplaceable\u003eMOUNT_OPTIONS\u003c/replaceable\u003e is a comma-separated"},{"line_number":49,"context_line":"    string of NFS mount options as detailed in the NFS man page."},{"line_number":50,"context_line":"  \u003c/para\u003e"},{"line_number":51,"context_line":"  \u003cpara\u003eThere are several other parameters whose default values may be overriden as appropriate for your environment:"},{"line_number":52,"context_line":"  \u003c/para\u003e"},{"line_number":53,"context_line":"  \u003cprogramlisting language\u003d\"ini\"\u003ebackup_compression_algorithm \u003d zlib"},{"line_number":54,"context_line":"backup_sha_block_size_bytes \u003d 32768"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_d5634019","line":51,"updated":"2015-04-23 17:59:02.000000000","message":"options","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":62,"context_line":"  \u003c/para\u003e"},{"line_number":63,"context_line":"  \u003cpara\u003e"},{"line_number":64,"context_line":"    The option \u003coption\u003ebackup_file_size\u003c/option\u003e must be a multiple of"},{"line_number":65,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e.  It is effectively"},{"line_number":66,"context_line":"    the maximum file size to be used, given your environment, to hold"},{"line_number":67,"context_line":"    backup data.  Volumes larger than this will be stored in multiple"},{"line_number":68,"context_line":"    files in the backup repository.  The option"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_d518e086","line":65,"updated":"2015-04-23 17:59:02.000000000","message":"Only one space.","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":64,"context_line":"    The option \u003coption\u003ebackup_file_size\u003c/option\u003e must be a multiple of"},{"line_number":65,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e.  It is effectively"},{"line_number":66,"context_line":"    the maximum file size to be used, given your environment, to hold"},{"line_number":67,"context_line":"    backup data.  Volumes larger than this will be stored in multiple"},{"line_number":68,"context_line":"    files in the backup repository.  The option"},{"line_number":69,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e determines the size"},{"line_number":70,"context_line":"    of blocks from the Cinder volume being backed up on which digital"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_60427440","line":67,"updated":"2015-04-23 17:59:02.000000000","message":"Only one space.","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"df7d75441f2924ec3d79911fc481c83c1c8d0944","unresolved":false,"context_lines":[{"line_number":65,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e.  It is effectively"},{"line_number":66,"context_line":"    the maximum file size to be used, given your environment, to hold"},{"line_number":67,"context_line":"    backup data.  Volumes larger than this will be stored in multiple"},{"line_number":68,"context_line":"    files in the backup repository.  The option"},{"line_number":69,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e determines the size"},{"line_number":70,"context_line":"    of blocks from the Cinder volume being backed up on which digital"},{"line_number":71,"context_line":"    signatures are calculated in order to enable a future incremental"}],"source_content_type":"application/xml","patch_set":3,"id":"bab921fb_201ebc63","line":68,"updated":"2015-04-23 17:59:02.000000000","message":"Only one space.","commit_id":"be239f7f7525efb4db503cda68d6ebc5714272dc"},{"author":{"_account_id":6491,"name":"xing-yang","email":"xingyang105@gmail.com","username":"xing-yang"},"change_message_id":"152c86356d11c8023ef6151d399ea7a6a4b8c9c0","unresolved":false,"context_lines":[{"line_number":68,"context_line":"    files in the backup repository. The option"},{"line_number":69,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e determines the size"},{"line_number":70,"context_line":"    of blocks from the Cinder volume being backed up on which digital"},{"line_number":71,"context_line":"    signatures are calculated in order to enable a future incremental"},{"line_number":72,"context_line":"    backup capability."},{"line_number":73,"context_line":"  \u003c/para\u003e"},{"line_number":74,"context_line":"\u003c/section\u003e"}],"source_content_type":"application/xml","patch_set":4,"id":"bab921fb_e3aa0b70","line":71,"updated":"2015-04-23 19:31:19.000000000","message":"Tom,\n\nI think \u0027future\u0027 should be removed because incremental backup is an existing functionality.","commit_id":"c79ee8a8ae2c98596cadbecac7f7f835f883646a"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"7d6d43ca4a97b94ca1afea2a24c0052f6b47fc74","unresolved":false,"context_lines":[{"line_number":68,"context_line":"    files in the backup repository. The option"},{"line_number":69,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e determines the size"},{"line_number":70,"context_line":"    of blocks from the Cinder volume being backed up on which digital"},{"line_number":71,"context_line":"    signatures are calculated in order to enable a future incremental"},{"line_number":72,"context_line":"    backup capability."},{"line_number":73,"context_line":"  \u003c/para\u003e"},{"line_number":74,"context_line":"\u003c/section\u003e"}],"source_content_type":"application/xml","patch_set":4,"id":"bab921fb_8658fdfb","line":71,"in_reply_to":"bab921fb_e3aa0b70","updated":"2015-04-23 19:51:47.000000000","message":"Agreed.","commit_id":"c79ee8a8ae2c98596cadbecac7f7f835f883646a"},{"author":{"_account_id":9382,"name":"Shilla Saebi","email":"shilla.saebi@gmail.com","username":"shillasaebi"},"change_message_id":"f18f1e37df6f6d6e2a9336a91b8cb017e3551aee","unresolved":false,"context_lines":[{"line_number":25,"context_line":"    \u003cpara\u003eFor more information about how to export and import volume backup metadata, see \u003cxref"},{"line_number":26,"context_line":"        linkend\u003d\"volume-backup-restore-export-import\"/\u003e.\u003c/para\u003e"},{"line_number":27,"context_line":"  \u003c/note\u003e"},{"line_number":28,"context_line":"  \u003cpara\u003eBy default, the Swift object store is used for the backup repository.\u003c/para\u003e"},{"line_number":29,"context_line":"  \u003cpara\u003e"},{"line_number":30,"context_line":"    If instead you want to use an NFS export as the backup repository,"},{"line_number":31,"context_line":"    add the following configuration options to the"}],"source_content_type":"application/xml","patch_set":5,"id":"bab921fb_0c892e75","line":28,"updated":"2015-04-27 03:48:04.000000000","message":"Swift should be swift (not upper case) \nplease see the wiki doc conventions for more details:\n\nhttps://wiki.openstack.org/wiki/Documentation/Conventions","commit_id":"1fde2678f46f79ba7224287eac3bd990b4993350"},{"author":{"_account_id":9382,"name":"Shilla Saebi","email":"shilla.saebi@gmail.com","username":"shillasaebi"},"change_message_id":"f18f1e37df6f6d6e2a9336a91b8cb017e3551aee","unresolved":false,"context_lines":[{"line_number":57,"context_line":"    The option \u003coption\u003ebackup_compression_algorithm\u003c/option\u003e may be"},{"line_number":58,"context_line":"    set to \u003cliteral\u003ebz2\u003c/literal\u003e or \u003cliteral\u003eNone\u003c/literal\u003e. The"},{"line_number":59,"context_line":"    latter can be a useful setting when the server providing the share"},{"line_number":60,"context_line":"    for the backend repository itself performs deduplication or"},{"line_number":61,"context_line":"    compression on the backup data."},{"line_number":62,"context_line":"  \u003c/para\u003e"},{"line_number":63,"context_line":"  \u003cpara\u003e"}],"source_content_type":"application/xml","patch_set":5,"id":"bab921fb_cc7e9669","line":60,"updated":"2015-04-27 03:48:04.000000000","message":"backend should not be used:\n\nIn general, avoid. Use a more specific term such as server, operating system, or network.\n\nHowever, if you do use it, use back end for the noun and back-end for the adjective.\n\nDo not use backend.","commit_id":"1fde2678f46f79ba7224287eac3bd990b4993350"},{"author":{"_account_id":9382,"name":"Shilla Saebi","email":"shilla.saebi@gmail.com","username":"shillasaebi"},"change_message_id":"f18f1e37df6f6d6e2a9336a91b8cb017e3551aee","unresolved":false,"context_lines":[{"line_number":67,"context_line":"    backup data. Volumes larger than this will be stored in multiple"},{"line_number":68,"context_line":"    files in the backup repository. The option"},{"line_number":69,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e determines the size"},{"line_number":70,"context_line":"    of blocks from the Cinder volume being backed up on which digital"},{"line_number":71,"context_line":"    signatures are calculated in order to enable incremental"},{"line_number":72,"context_line":"    backup capability."},{"line_number":73,"context_line":"  \u003c/para\u003e"}],"source_content_type":"application/xml","patch_set":5,"id":"bab921fb_ec795a83","line":70,"updated":"2015-04-27 03:48:04.000000000","message":"same thing here, lowercase cinder","commit_id":"1fde2678f46f79ba7224287eac3bd990b4993350"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"ddabc2eb9ab017d75a2e69efae04b4f04e90de44","unresolved":false,"context_lines":[{"line_number":37,"context_line":"backup_share \u003d \u003creplaceable\u003eHOST\u003c/replaceable\u003e:\u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e\u003c/programlisting\u003e"},{"line_number":38,"context_line":"  \u003cpara\u003e"},{"line_number":39,"context_line":"    For the \u003coption\u003ebackup_share\u003c/option\u003e option, replace"},{"line_number":40,"context_line":"    \u003creplaceable\u003eHOST\u003c/replaceable\u003e by the DNS resolvable host name or"},{"line_number":41,"context_line":"    the IP address of the storage server for the NFS share, and"},{"line_number":42,"context_line":"    \u003creplaceable\u003eEXPORT_PATH\u003c/replaceable\u003e with the path to that"},{"line_number":43,"context_line":"    share. If your environment requires that non-default mount"}],"source_content_type":"application/xml","patch_set":6,"id":"3acd31a7_f65ab829","line":40,"updated":"2015-05-01 03:25:46.000000000","message":"s/by/with","commit_id":"bd8fb496a02cfe77d9b3eb5956bb646bc5cc46b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"ddabc2eb9ab017d75a2e69efae04b4f04e90de44","unresolved":false,"context_lines":[{"line_number":45,"context_line":"  \u003c/para\u003e"},{"line_number":46,"context_line":"  \u003cprogramlisting language\u003d\"ini\"\u003ebackup_mount_options \u003d \u003creplaceable\u003eMOUNT_OPTIONS\u003c/replaceable\u003e\u003c/programlisting\u003e"},{"line_number":47,"context_line":"  \u003cpara\u003e"},{"line_number":48,"context_line":"    Here \u003creplaceable\u003eMOUNT_OPTIONS\u003c/replaceable\u003e is a comma-separated"},{"line_number":49,"context_line":"    string of NFS mount options as detailed in the NFS man page."},{"line_number":50,"context_line":"  \u003c/para\u003e"},{"line_number":51,"context_line":"  \u003cpara\u003eThere are several other options whose default values may be overriden as appropriate for your environment:"}],"source_content_type":"application/xml","patch_set":6,"id":"3acd31a7_d6421c3e","line":48,"updated":"2015-05-01 03:25:46.000000000","message":"Remove \"here\" (or, if you want to keep it, change to something like \"in this example\"","commit_id":"bd8fb496a02cfe77d9b3eb5956bb646bc5cc46b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"ddabc2eb9ab017d75a2e69efae04b4f04e90de44","unresolved":false,"context_lines":[{"line_number":54,"context_line":"backup_sha_block_size_bytes \u003d 32768"},{"line_number":55,"context_line":"backup_file_size \u003d 1999994880\u003c/programlisting\u003e"},{"line_number":56,"context_line":"  \u003cpara\u003e"},{"line_number":57,"context_line":"    The option \u003coption\u003ebackup_compression_algorithm\u003c/option\u003e may be"},{"line_number":58,"context_line":"    set to \u003cliteral\u003ebz2\u003c/literal\u003e or \u003cliteral\u003eNone\u003c/literal\u003e. The"},{"line_number":59,"context_line":"    latter can be a useful setting when the server providing the share"},{"line_number":60,"context_line":"    for the backup repository itself performs deduplication or"}],"source_content_type":"application/xml","patch_set":6,"id":"3acd31a7_b63d60bd","line":57,"updated":"2015-05-01 03:25:46.000000000","message":"s/may/can","commit_id":"bd8fb496a02cfe77d9b3eb5956bb646bc5cc46b2"},{"author":{"_account_id":7923,"name":"Gauvain Pocentek","email":"gauvainpocentek@gmail.com","username":"gpocentek"},"change_message_id":"7c6f2b9da16431c0a1aed9ac37b498a2fcb99c89","unresolved":false,"context_lines":[{"line_number":56,"context_line":"  \u003cpara\u003e"},{"line_number":57,"context_line":"    The option \u003coption\u003ebackup_compression_algorithm\u003c/option\u003e may be"},{"line_number":58,"context_line":"    set to \u003cliteral\u003ebz2\u003c/literal\u003e or \u003cliteral\u003eNone\u003c/literal\u003e. The"},{"line_number":59,"context_line":"    latter can be a useful setting when the server providing the share"},{"line_number":60,"context_line":"    for the backup repository itself performs deduplication or"},{"line_number":61,"context_line":"    compression on the backup data."},{"line_number":62,"context_line":"  \u003c/para\u003e"}],"source_content_type":"application/xml","patch_set":6,"id":"5ad0253b_45d55f41","line":59,"updated":"2015-05-01 07:12:00.000000000","message":"latter -\u003e later","commit_id":"bd8fb496a02cfe77d9b3eb5956bb646bc5cc46b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"ddabc2eb9ab017d75a2e69efae04b4f04e90de44","unresolved":false,"context_lines":[{"line_number":66,"context_line":"    the maximum file size to be used, given your environment, to hold"},{"line_number":67,"context_line":"    backup data. Volumes larger than this will be stored in multiple"},{"line_number":68,"context_line":"    files in the backup repository. The option"},{"line_number":69,"context_line":"    \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e determines the size"},{"line_number":70,"context_line":"    of blocks from the cinder volume being backed up on which digital"},{"line_number":71,"context_line":"    signatures are calculated in order to enable incremental"},{"line_number":72,"context_line":"    backup capability."}],"source_content_type":"application/xml","patch_set":6,"id":"3acd31a7_5675ec95","line":69,"updated":"2015-05-01 03:25:46.000000000","message":"\"The \u003coption\u003ebackup_sha_block_size_bytes\u003c/option\u003e option\"","commit_id":"bd8fb496a02cfe77d9b3eb5956bb646bc5cc46b2"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"260309f416d134a63a7df6ffcd999854999c0961","unresolved":false,"context_lines":[{"line_number":56,"context_line":"  \u003cpara\u003e"},{"line_number":57,"context_line":"    The option \u003coption\u003ebackup_compression_algorithm\u003c/option\u003e can be"},{"line_number":58,"context_line":"    set to \u003cliteral\u003ebz2\u003c/literal\u003e or \u003cliteral\u003eNone\u003c/literal\u003e. The"},{"line_number":59,"context_line":"    later can be a useful setting when the server providing the share"},{"line_number":60,"context_line":"    for the backup repository itself performs deduplication or"},{"line_number":61,"context_line":"    compression on the backup data."},{"line_number":62,"context_line":"  \u003c/para\u003e"}],"source_content_type":"application/xml","patch_set":7,"id":"3acd31a7_b99f904f","line":59,"updated":"2015-05-01 12:12:50.000000000","message":"\u0027The latter\u0027 was intended and is in fact correct.","commit_id":"3825c000b18d23851f095c9e91de29190574ae02"}]}