mirror of https://github.com/borgbackup/borg.git
Merge pull request #31 from ThomasWaldmann/master
faq updates, website update automation
This commit is contained in:
commit
10a27da556
13
CHANGES
13
CHANGES
|
@ -19,7 +19,7 @@ Version <TBD>
|
||||||
- less memory usage: add global option --no-cache-files
|
- less memory usage: add global option --no-cache-files
|
||||||
- fix traceback when trying to do unsupported passphrase change, fixes attic #189
|
- fix traceback when trying to do unsupported passphrase change, fixes attic #189
|
||||||
- datetime does not like the year 10.000, fixes attic #139
|
- datetime does not like the year 10.000, fixes attic #139
|
||||||
- docs improvements, fixes, updates
|
- docs and faq improvements, fixes, updates
|
||||||
- cleanup crypto.pyx, make it easier to adapt to other modes
|
- cleanup crypto.pyx, make it easier to adapt to other modes
|
||||||
- extract: if --stdout is given, write all extracted binary data to stdout
|
- extract: if --stdout is given, write all extracted binary data to stdout
|
||||||
- create: if "-" is given as path, read binary from stdin
|
- create: if "-" is given as path, read binary from stdin
|
||||||
|
@ -40,9 +40,16 @@ Version <TBD>
|
||||||
- implement rename repo::oldname newname
|
- implement rename repo::oldname newname
|
||||||
- implement create --progress
|
- implement create --progress
|
||||||
- source: refactor indicator (status) and item processing
|
- source: refactor indicator (status) and item processing
|
||||||
- implement delete <repository> (also deletes local cache)
|
- implement delete repo (also deletes local cache)
|
||||||
- better create -v output
|
- better create -v output
|
||||||
- upgraded versioneer, fixes attic #257
|
- upgraded versioneer, PEP440 compliance, fixes attic #257
|
||||||
|
- source: use py.test for better testing, flake8 for code style checks
|
||||||
|
- source: fix tox >=2.0 compatibility
|
||||||
|
- toplevel error handler: show tracebacks for better error analysis
|
||||||
|
- sigusr1 / sigint handler to print current file infos - attic PR #286
|
||||||
|
- pypi package: add python version classifiers, add FreeBSD to platforms
|
||||||
|
- fix Repository._active_txn state when lock upgrade fails
|
||||||
|
- RPCError: include the exception args we get from remote
|
||||||
|
|
||||||
|
|
||||||
Attic Changelog
|
Attic Changelog
|
||||||
|
|
|
@ -138,5 +138,13 @@ gh-pages: html
|
||||||
(cd $$GH_PAGES_CLONE && git add -A && git commit -m 'Updated gh-pages' && git push) && \
|
(cd $$GH_PAGES_CLONE && git add -A && git commit -m 'Updated gh-pages' && git push) && \
|
||||||
rm -rf $$GH_PAGES_CLONE
|
rm -rf $$GH_PAGES_CLONE
|
||||||
|
|
||||||
|
gh-io: html
|
||||||
|
GH_IO_CLONE="`mktemp -d`" && \
|
||||||
|
git clone git@github.com:borgbackup/borgbackup.github.io.git $$GH_IO_CLONE && \
|
||||||
|
(cd $$GH_IO_CLONE && git rm -r *) && \
|
||||||
|
cp -r _build/html/* $$GH_IO_CLONE && \
|
||||||
|
(cd $$GH_IO_CLONE && git add -A && git commit -m 'Updated borgbackup.github.io' && git push) && \
|
||||||
|
rm -rf $$GH_IO_CLONE
|
||||||
|
|
||||||
inotify: html
|
inotify: html
|
||||||
while inotifywait -r . --exclude usage.rst --exclude '_build/*' ; do make html ; done
|
while inotifywait -r . --exclude usage.rst --exclude '_build/*' ; do make html ; done
|
||||||
|
|
45
docs/faq.rst
45
docs/faq.rst
|
@ -16,16 +16,16 @@ Can I backup VM disk images?
|
||||||
Also, we have optional simple sparse file support for extract.
|
Also, we have optional simple sparse file support for extract.
|
||||||
|
|
||||||
Can I backup from multiple servers into a single repository?
|
Can I backup from multiple servers into a single repository?
|
||||||
Yes, but in order for the deduplication used by Borg to work, it
|
Yes, but in order for the deduplication used by |project_name| to work, it
|
||||||
needs to keep a local cache containing checksums of all file
|
needs to keep a local cache containing checksums of all file
|
||||||
chunks already stored in the repository. This cache is stored in
|
chunks already stored in the repository. This cache is stored in
|
||||||
``~/.cache/borg/``. If Borg detects that a repository has been
|
``~/.cache/borg/``. If |project_name| detects that a repository has been
|
||||||
modified since the local cache was updated it will need to rebuild
|
modified since the local cache was updated it will need to rebuild
|
||||||
the cache. This rebuild can be quite time consuming.
|
the cache. This rebuild can be quite time consuming.
|
||||||
|
|
||||||
So, yes it's possible. But it will be most efficient if a single
|
So, yes it's possible. But it will be most efficient if a single
|
||||||
repository is only modified from one place. Also keep in mind that
|
repository is only modified from one place. Also keep in mind that
|
||||||
Borg will keep an exclusive lock on the repository while creating
|
|project_name| will keep an exclusive lock on the repository while creating
|
||||||
or deleting archives, which may make *simultaneous* backups fail.
|
or deleting archives, which may make *simultaneous* backups fail.
|
||||||
|
|
||||||
Which file types, attributes, etc. are preserved?
|
Which file types, attributes, etc. are preserved?
|
||||||
|
@ -62,8 +62,18 @@ How can I specify the encryption passphrase programmatically?
|
||||||
key file based encryption with a blank passphrase. See
|
key file based encryption with a blank passphrase. See
|
||||||
:ref:`encrypted_repos` for more details.
|
:ref:`encrypted_repos` for more details.
|
||||||
|
|
||||||
When backing up to remote servers, is data encrypted before leaving the local machine, or do I have to trust that the remote server isn't malicious?
|
When backing up to remote encrypted repos, is encryption done locally?
|
||||||
Yes, everything is encrypted before leaving the local machine.
|
Yes, file and directory metadata and data is locally encrypted, before
|
||||||
|
leaving the local machine. We do not mean the transport layer encryption
|
||||||
|
by that, but the data/metadata itself. Transport layer encryption (e.g.
|
||||||
|
when ssh is used as a transport) applies additionally.
|
||||||
|
|
||||||
|
When backing up to remote servers, do I have to trust the remote server?
|
||||||
|
Yes and No.
|
||||||
|
No, as far as data confidentiality is concerned - all your files/dirs data
|
||||||
|
and metadata are stored in their encrypted form into the repository.
|
||||||
|
Yes, as an attacker with access to the remote server could delete (or
|
||||||
|
otherwise make unavailable) all your backups.
|
||||||
|
|
||||||
If a backup stops mid-way, does the already-backed-up data stay there? I.e. does |project_name| resume backups?
|
If a backup stops mid-way, does the already-backed-up data stay there? I.e. does |project_name| resume backups?
|
||||||
Yes, during a backup a special checkpoint archive named ``<archive-name>.checkpoint`` is saved every 5 minutes
|
Yes, during a backup a special checkpoint archive named ``<archive-name>.checkpoint`` is saved every 5 minutes
|
||||||
|
@ -75,25 +85,34 @@ If it crashes with a UnicodeError, what can I do?
|
||||||
|
|
||||||
export LANG=en_US.UTF-8 # or similar, important is correct charset
|
export LANG=en_US.UTF-8 # or similar, important is correct charset
|
||||||
|
|
||||||
|
If I want to run |project_name| on a ARM CPU older than ARM v6?
|
||||||
|
You need to enable the alignment trap handler to fixup misaligned accesses::
|
||||||
|
|
||||||
|
echo "2" > /proc/cpu/alignment
|
||||||
|
|
||||||
Why was Borg forked from Attic?
|
Why was Borg forked from Attic?
|
||||||
Borg was created in may 2015 in response to the difficulty of
|
Borg was created in May 2015 in response to the difficulty of
|
||||||
getting new merge requests and larger changes incorporated into
|
getting new code or larger changes incorporated into Attic and
|
||||||
attic. more details can be found in the fairly long discussion
|
establishing a bigger developer community / more open development.
|
||||||
in attic issue queue (found in `ticket 217
|
|
||||||
<https://github.com/jborg/attic/issues/217>`_) that led to the fork.
|
More details can be found in `ticket 217
|
||||||
|
<https://github.com/jborg/attic/issues/217>`_ that led to the fork.
|
||||||
|
|
||||||
Borg intends to be:
|
Borg intends to be:
|
||||||
|
|
||||||
* simple:
|
* simple:
|
||||||
|
|
||||||
* as simple as possible, but no simpler
|
* as simple as possible, but no simpler
|
||||||
* do the right thing by default, but offer options
|
* do the right thing by default, but offer options
|
||||||
* open:
|
* open:
|
||||||
|
|
||||||
* welcome feature requests
|
* welcome feature requests
|
||||||
* accept pull requests of good quality and coding style
|
* accept pull requests of good quality and coding style
|
||||||
* give feedback on PRs that can't be accepted "as is"
|
* give feedback on PRs that can't be accepted "as is"
|
||||||
* discuss openly, don't work in the dark
|
* discuss openly, don't work in the dark
|
||||||
* changing:
|
* changing:
|
||||||
|
|
||||||
|
* Borg is not compatible with Attic
|
||||||
* do not break compatibility accidentally, without a good reason
|
* do not break compatibility accidentally, without a good reason
|
||||||
or without warning
|
or without warning. allow compatibility breaking for other cases.
|
||||||
* Borg is not backwards-compatible with attic
|
* if major version number changes, it may have incompatible changes
|
||||||
* major versions may not be compatible with older releases
|
|
||||||
|
|
Loading…
Reference in New Issue