www.nico.schottelius.org/software/ccollect.mdwn

319 lines
14 KiB
Markdown

#### ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync
<P ALIGN="center">
<a href="screenshots/">
![ccollect-0.7.1](screenshots/ccollect-0.7.1-screenshot-20090527.png "Example output of ccollect-0.6")
</a>
<P>ccollect backups data from local and remote hosts to your local harddisk.
Although ccollect creates full backups, it requires very less space on the
backup medium, because ccollect uses hardlinks to create an initial copy of
the last backup. Only the inodes used by the hardlinks and the changed files
need additional space.
ccollect uses [rsync](http://www.samba.org/rsync/) for synchronisation.
Since ccollect-0.2 there is [asciidoc](http://www.methods.co.nz/asciidoc/)
based documentation included in the distribution (see below).
You should also be able to configure ccollect with the help of the example
configuration in conf/.
### Documentation
You can read
* the ccollect handbook as
<a href="doc/ccollect.text">text</a>,
<a href="doc/ccollect.html">HTML</a>,
<a href="doc/ccollect.htm">HTML (docbook)</a>,
* the ccollect manpage as
<a href="doc/man/ccollect.text">text</a>,
<a href="doc/man/ccollect.1">troff</a>
<a href="doc/man/ccollect.html">HTML</a>
<a href="doc/man/ccollect.htm">HTML (docbook)</a>
* or view some <a href="screenshots/">screenshots</a>.
There used to be a German translation of the handbook, but it
is outdated and thus removed.
### Portability
As ccollect is a simple shell script, it should run on
any POSIX compatible OS. It is known or reported to run on:
<ul>
<li>FreeBSD: amd64/i386
<li>Linux: alpha/hppa/ppc/i386
<li>NetBSD: alpha/sparc64/i386/amd64
<li>OpenBSD: amd64
</ul>
Feel free to send an e-mail if you are running ccollect on another
OS or architecture.
### Sample configurations
<ul>
<li><a href="config/ccollect-buche-2006-06-16.tar.bz2">Configuration
for ccollect 0.4 or later from buche.intern.schottelius.org</a>
<li><a href="config/ccollect-eiche-2006-02-05.tar.bz2">Configuration
for ccollect 0.3.3 or earlier from eiche.intern.schottelius.org</a>
</ul>
### Getting ccollect
You can get the latest (development) version via git:
git clone git://git.schottelius.org/cLinux/ccollect.git
A git mirror can be found at
* [github](http://github.com/telmich/ccollect/tree/master)
Alternatively, you can
[look at the current
status in gitweb](http://git.schottelius.org/?p=cLinux/ccollect.git;a=summary).
<!-- ######################################################### -->
<h4>Releases</h4>
<ul>
<li><A HREF="ccollect-0.7.1.tar.bz2">ccollect-0.7.1.tar.bz2</A>
(<A HREF="ccollect-0.7.1">browse source</A>)
(<A HREF="ccollect-0.7.1/doc/changes/0.7.1">Changes</A>)
<li><A HREF="ccollect-0.7.0.tar.bz2">ccollect-0.7.0.tar.bz2</A>
(<A HREF="ccollect-0.7.0">browse source</A>)
(<A HREF="ccollect-0.7.0/doc/CHANGES">Changes</A>)
<!-- ######################################################### -->
<li><A HREF="ccollect-0.6.2.tar.bz2">ccollect-0.6.2.tar.bz2</A>
(<A HREF="ccollect-0.6.2">browse source</A>)
(<A HREF="ccollect-0.6.2/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.6.2/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.6.2/doc/man/ccollect.1">Troff</A>)
(<A HREF="ccollect-0.6.2/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.6.2/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.6.2/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.6.2/doc/ccollect.htm">HTML (docbook)</A>)
<li>German documentation:
(<A HREF="ccollect-0.6.2/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.6.2/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.6.2/doc/ccollect-DE.html">HTML (docbook)</A>)
(<b>EXTREMLY OUT OF DATE</b>)
</ul>
<!-- ######################################################### -->
<li><A HREF="ccollect-0.6.1.tar.bz2">ccollect-0.6.1.tar.bz2</A>
(<A HREF="ccollect-0.6.1">browse source</A>)
(<A HREF="ccollect-0.6.1/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.6.1/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.6.1/doc/man/ccollect.1">Troff</A>)
(<A HREF="ccollect-0.6.1/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.6.1/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.6.1/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.6.1/doc/ccollect.htm">HTML (docbook)</A>)
<li>German documentation:
(<A HREF="ccollect-0.6.1/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.6.1/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.6.1/doc/ccollect-DE.html">HTML (docbook)</A>)
(<b>VERY OUT OF DATE</b>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.6.tar.bz2">ccollect-0.6.tar.bz2</A>
(<A HREF="ccollect-0.6">browse source</A>)
(<A HREF="ccollect-0.6/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.6/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.6/doc/man/ccollect.1">Troff</A>)
(<A HREF="ccollect-0.6/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.6/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.6/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.6/doc/ccollect.htm">HTML (docbook)</A>)
<li>German documentation:
(<A HREF="ccollect-0.6/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.6/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.6/doc/ccollect-DE.html">HTML (docbook)</A>)
(<b>VERY OUT OF DATE</b>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.5.2.tar.bz2">ccollect-0.5.2.tar.bz2</A>
(<A HREF="ccollect-0.5.2">browse source</A>)
(<A HREF="ccollect-0.5.2/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.5.2/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.5.2/doc/man/ccollect.man">Troff</A>)
(<A HREF="ccollect-0.5.2/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.5.2/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.5.2/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.5.2/doc/ccollect.texi">Texinfo</A>)
<li>German documentation:
(<A HREF="ccollect-0.5.2/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.5.2/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.5.2/doc/ccollect-DE.texi">Texinfo</A>)
(<b>OUT OF DATE</b>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.5.1.tar.bz2">ccollect-0.5.1.tar.bz2</A>
(<A HREF="ccollect-0.5.1">browse source</A>)
(<A HREF="ccollect-0.5.1/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.5.1/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.5.1/doc/man/ccollect.man">Troff</A>)
(<A HREF="ccollect-0.5.1/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.5.1/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.5.1/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.5.1/doc/ccollect.texi">Texinfo</A>)
<li>German documentation:
(<A HREF="ccollect-0.5.1/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.5.1/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.5.1/doc/ccollect-DE.texi">Texinfo</A>)
(<b>OUT OF DATE</b>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.5.tar.bz2">ccollect-0.5.tar.bz2</A>
(<A HREF="ccollect-0.5">browse source</A>)
(<A HREF="ccollect-0.5/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.5/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.5/doc/man/ccollect.man">Troff</A>)
(<A HREF="ccollect-0.5/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.5/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.5/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.5/doc/ccollect.texi">Texinfo</A>)
<li>German documentation:
(<A HREF="ccollect-0.5/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.5/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.5/doc/ccollect-DE.texi">Texinfo</A>)
(<b>OUT OF DATE</b>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.4.2.tar.bz2">ccollect-0.4.2.tar.bz2</A>
(<A HREF="ccollect-0.4.2">browse source</A>)
(<A HREF="ccollect-0.4.2/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.4.2/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.4.2/doc/man/ccollect.man">Troff</A>)
(<A HREF="ccollect-0.4.2/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.4.2/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.4.2/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.4.2/doc/ccollect.texi">Texinfo</A>)
<li>German documentation:
(<A HREF="ccollect-0.4.2/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.4.2/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.4.2/doc/ccollect-DE.texi">Texinfo</A>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.4.1.tar.bz2">ccollect-0.4.1.tar.bz2</A>
(<A HREF="ccollect-0.4.1">browse source</A>)
(<A HREF="ccollect-0.4.1/doc/CHANGES">Changes</A>)
<ul>
<li>Manpage:
(<A HREF="ccollect-0.4.1/doc/man/ccollect.text">Text</A>)
(<A HREF="ccollect-0.4.1/doc/man/ccollect.man">Troff</A>)
(<A HREF="ccollect-0.4.1/doc/man/ccollect.html">HTML</A>)
<li>English documentation:
(<A HREF="ccollect-0.4.1/doc/ccollect.text">Text</A>)
(<A HREF="ccollect-0.4.1/doc/ccollect.html">HTML</A>)
(<A HREF="ccollect-0.4.1/doc/ccollect.texi">Texinfo</A>)
<li>German documentation:
(<A HREF="ccollect-0.4.1/doc/ccollect-DE.text">Text</A>)
(<A HREF="ccollect-0.4.1/doc/ccollect-DE.html">HTML</A>)
(<A HREF="ccollect-0.4.1/doc/ccollect-DE.texi">Texinfo</A>)
</ul>
<!-- -------------------------------------------------------- -->
<li><A HREF="ccollect-0.4.tar.bz2">ccollect-0.4.tar.bz2</A>
(<A HREF="ccollect-0.4">browse source</A>)
(<A HREF="ccollect-0.4/doc/CHANGES">Changes</A>)
(<A HREF="ccollect-0.4/doc/ccollect.html">HTML documentation</A>)
(<A HREF="ccollect-0.4/doc/ccollect.text">Text documentation</A>)
<li><A HREF="ccollect-0.3.3.tar.bz2">ccollect-0.3.3.tar.bz2</A>
(<A HREF="ccollect-0.3.3">browse source</A>)
(<A HREF="ccollect-0.3.3/doc/CHANGES">Changes</A>)
(<A HREF="ccollect-0.3.3/doc/ccollect.html">HTML documentation</A>)
(<A HREF="ccollect-0.3.3/doc/ccollect.text">Text documentation</A>)
<li><A HREF="ccollect-0.3.2.tar.bz2">ccollect-0.3.2.tar.bz2</A>
(<A HREF="ccollect-0.3.2">browse source</A>)
(<A HREF="ccollect-0.3.2/doc/CHANGES">Changes</A>)
(<A HREF="ccollect-0.3.2/doc/ccollect.html">HTML documentation</A>)
(<A HREF="ccollect-0.3.2/doc/ccollect.text">Text documentation</A>)
<li><A HREF="ccollect-0.3.1.tar.bz2">ccollect-0.3.1.tar.bz2</A>
(<A HREF="ccollect-0.3.1">browse source</A>)
(<A HREF="ccollect-0.3.1/doc/CHANGES">Changes</A>)
(<A HREF="ccollect-0.3.1/doc/ccollect.html">HTML documentation</A>)
(<A HREF="ccollect-0.3.1/doc/ccollect.text">Text documentation</A>)
<li><A HREF="ccollect-0.3.tar.bz2">ccollect-0.3.tar.bz2</A>
(<A HREF="ccollect-0.3">browse source</A>)
(<A HREF="ccollect-0.3/doc/CHANGES">Changes</A>)
(<A HREF="ccollect-0.3/doc/ccollect.html">HTML documentation</A>)
(<A HREF="ccollect-0.3/doc/ccollect.text">Text documentation</A>)
<li><A HREF="ccollect-0.2.tar.bz2">ccollect-0.2.tar.bz2</A>
(<A HREF="ccollect-0.2">browse source</A>)
(<A HREF="ccollect-0.2/doc/CHANGES">Changes</A>)
(<A HREF="ccollect-0.2/doc/ccollect.html">HTML documentation</A>)
(<A HREF="ccollect-0.2/doc/ccollect.text">Text documentation</A>)
<li><A HREF="ccollect-0.1.tar.bz2">ccollect-0.1.tar.bz2</A>
(<A HREF="ccollect-0.1">browse source</A>)
</ul>
<!-- ######################################################### -->
<h4><A NAME="gentoo">gentoo</A></h4>
<P>ccollect is included into gentoo portage.
Thanks to Ren&eacute; Nussbaumer.
<!-- ######################################################### -->
<h4><A NAME="debian">Debian packages</A></h4>
<P>Marcus Wagner makes ccollect available as Debian packages.
<BR>To get ccollect insert the following line into your /etc/apt/sources.list:
<PRE>
<A HREF="http://deb.notestc.de/clinux/">deb http://deb.notestc.de/ clinux/</A>
</PRE>
<HR>
Daniel Aubry also created a Debian package containing ccollect.
To use his archive, add the following line into your /etc/apt/sources.list:
<PRE>
<A HREF="http://debian.syhosting.ch/software/">deb http://debian.syhosting.ch/ software/</A>
</PRE>
<HR>
<P>
After adding one of the above sources.list entries do
<PRE>apt-get update && apt-get install ccollect</PRE>
<h3><A name="support">Support</a></h3>
<ul>
<li><a name="ml">Mailing list</a>
<ul>
<li>Subscribe: Send an e-mail to
<b>ccollect-subscribe at lists.schottelius.org</b>
<li>Sending: Send e-mails to ccollect [at] lists.schottelius.org
<li>Unsubscribe: Send an e-mail to
<b>ccollect-unsubscribe at lists.schottelius.org</b>
</ul>
<li><a name="irc">IRC</a>
<ul>
<li>Join
<a href="irc://irc.freenode.org/#cLinux">#cLinux on irc.freenode.org</a>
</ul>
</ul>
<h4><A NAME="links">Related websites</A></h4>
<ul>
<li><A HREF="http://0xf00.de/ccollect-config.html">ccollect-config</A>,
a configuration tool written by Frederic Jaeckel
<li><A HREF="http://www.juame.ch/index.php?go=ccollect">German ccollect
documentation</A> by Julian Meier
<li><A HREF="http://muasch.ch/article/show/ccollect-backup-software">German report about
ccollect by Benedikt K&ouml;ppel, which includes a description of reverse ssh tunnels</a>
</ul>
</BODY>
</HTML>