tyler/proxmox-backup
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: troubleshooting: reformat & adapt

Browse Source 
Text-width should be 80 cc in the docs.

Avoid using relative paths in examples, they only confuse users as
one has less of a specific idea what the example may do. Rather use a
"descriptive" example path.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht 2021-09-22 07:41:45 +02:00
parent 5a83930667
commit a294588409
1 changed files with 30 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
docs/technical-overview.rst
View File

@ -168,20 +168,21 @@ verify its content against it. Instead only the CRC-32 checksum gets checked.
Troubleshooting Troubleshooting
--------------- ---------------
Index files(.fidx, .didx) contain information about how to rebuild a file, more precisely, they Index files(.fidx, .didx) contain information about how to rebuild a file, more
contain an ordered list of references to the chunks the original file was split up precisely, they contain an ordered list of references to the chunks the original
in. If there is something wrong with a snapshot it might be useful to find out file was split up in. If there is something wrong with a snapshot it might be
which chunks are referenced in this specific snapshot, and check wheather all of useful to find out which chunks are referenced in this specific snapshot, and
them are present and intact. The command for getting the list of referenced chunks check wheather all of them are present and intact. The command for getting the
could look something like this: list of referenced chunks could look something like this:
.. code-block:: console .. code-block:: console
# proxmox-backup-debug inspect file drive-scsi0.img.fidx # proxmox-backup-debug inspect file drive-scsi0.img.fidx
The same command can be used to look at .blob file, without ``--decode`` just the size The same command can be used to look at .blob file, without ``--decode`` just
and the encryption type, if any, is printed. If ``--decode`` is set the blob file is the size and the encryption type, if any, is printed. If ``--decode`` is set the
decoded into the specified file('-' will decode it directly into stdout). blob file is decoded into the specified file('-' will decode it directly into
stdout).
.. code-block:: console .. code-block:: console
@ -196,29 +197,33 @@ with:
.. code-block:: console .. code-block:: console
# proxmox-backup-debug inspect chunk b531d3ffc9bd7c65748a61198c060678326a431db7eded874c327b7986e595e0 --reference-filter ../../ # proxmox-backup-debug inspect chunk b531d3ffc9bd7c65748a61198c060678326a431db7eded874c327b7986e595e0 --reference-filter /path/in/a/datastore/directory
Here ``--reference-filter`` specifies where index files should be searched, this can be an Here ``--reference-filter`` specifies where index files should be searched, this
arbitrary path. If, for some reason, the filename of the chunk was changed you can explicitly can be an arbitrary path. If, for some reason, the filename of the chunk was
specify the digest using ``--digest``, by default the chunk filename is used as the digest changed you can explicitly specify the digest using ``--digest``, by default the
to look for. Specifying no ``--reference-filter`` will just print the CRC and encryption status chunk filename is used as the digest to look for. Specifying no
of the chunk. You can also decode chunks, to do so ``--decode`` has to be set. If the chunk ``--reference-filter`` will just print the CRC and encryption status of the
is encrypted a ``--keyfile`` has to be provided for decoding. chunk. You can also decode chunks, to do so ``--decode`` has to be set. If the
chunk is encrypted a ``--keyfile`` has to be provided for decoding.
Restore without a running PBS Restore without a running PBS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
It is possible to restore snapshots even without a running PBS, assuming you have It is possible to restore spefiic files of snapshots without a running PBS using
access to the index and chunk files, if encrypted you'll also need the keyfile the `recover` sub-command, provided you have access to the intact index and
it was encrypted with. chunk files. Note that you also need the corresponding key file if the backup
was encrypted.
.. code-block:: console .. code-block:: console
# proxmox-backup-debug recover index drive-scsi0.img.fidx ../../../.chunks # proxmox-backup-debug recover index drive-scsi0.img.fidx /path/to/.chunks
where `../../../.chunks` is the path to the directory that contains contains the In above example the `/path/to/.chunks` argument is the path to the directory
chunks and `drive-scsi0.img.fidx` is the index-file of the file you'd lile to that contains contains the chunks, and `drive-scsi0.img.fidx` is the index-file
restore. Both paths can be absolute or relative. With ``--skip-crc`` it is possible to of the file you'd lile to restore. Both paths can be absolute or relative. With
disable the crc checks of the chunks, this will speed up the process, however should ``--skip-crc`` it is possible to disable the crc checks of the chunks, this will
probably only be used for testing. speed up the process slightly and allows for trying to restore (partially)
corrupt chunks. It's recommended to always try without the skip-CRC option
first.