diff --git a/software/ccollect/documentation/ccollect.htm b/software/ccollect/documentation/ccollect.htm index 3551246e..86092774 100644 --- a/software/ccollect/documentation/ccollect.htm +++ b/software/ccollect/documentation/ccollect.htm @@ -1,4 +1,4 @@ -ccollect - Installing, Configuring and Using

ccollect - Installing, Configuring and Using

Nico Schottelius

Revision History
Revision 2.0for ccollect 2.0, Initial Version from 2006-01-13NS

Table of Contents

Introduction
Supported and tested operating systems and architectures
Why you COULD only backup from remote hosts, not to them
Incompatibilities and changes
Quick start
Requirements
Installing ccollect
Using ccollect
Installing
Configuring
Runtime options
General configuration
Source configuration
Hints
Smart logging
Using a different ssh port
Using source names or interval in pre_/post_exec scripts
Using rsync protocol without ssh
Not excluding top-level directories
Re-using already created rsync-backups
Using pre_/post_exec
Using source specific interval definitions
Comparing backups
Testing for host reachabilty
Easy check for errors
F.A.Q.
What happens if one backup is broken or empty?
When backing up from localhost the destination is also included. Is this a bug?
Why does ccollect say "Permission denied" with my pre-/postexec script?
Why does the backup job fail when part of the source is a link?
How can I prevent missing the right time to enter my password?
Backup fails, if autofs is running, but sources not reachable
Examples
A backup host configuration from scratch
Using hard-links requires less disk space
A collection of backups on the backup server
Processes running when doing ccollect -j

(pseudo) incremental backup +ccollect - Installing, Configuring and Using

ccollect - Installing, Configuring and Using

Nico Schottelius

Revision History
Revision 2.1for ccollect 2.1, Initial Version from 2006-01-13NS

Table of Contents

Introduction
Supported and tested operating systems and architectures
Why you COULD only backup from remote hosts, not to them
Incompatibilities and changes
Quick start
Requirements
Installing ccollect
Using ccollect
Installing
Configuring
Runtime options
General configuration
Source configuration
Hints
Smart logging
Using a different ssh port
Using source names or interval in pre_/post_exec scripts
Using rsync protocol without ssh
Not excluding top-level directories
Re-using already created rsync-backups
Using pre_/post_exec
Using source specific interval definitions
Comparing backups
Testing for host reachabilty
Easy check for errors
F.A.Q.
What happens if one backup is broken or empty?
When backing up from localhost the destination is also included. Is this a bug?
Why does ccollect say "Permission denied" with my pre-/postexec script?
Why does the backup job fail when part of the source is a link?
How can I prevent missing the right time to enter my password?
Backup fails, if autofs is running, but sources not reachable
Examples
A backup host configuration from scratch
Using hard-links requires less disk space
A collection of backups on the backup server
Processes running when doing ccollect -j

(pseudo) incremental backup with different exclude lists using hardlinks and rsync

Introduction

ccollect is a backup utility written in the sh-scripting language. It does not depend on a specific shell, only /bin/sh needs to be diff --git a/software/ccollect/documentation/ccollect.html b/software/ccollect/documentation/ccollect.html index b1858848..6e7de1e5 100644 --- a/software/ccollect/documentation/ccollect.html +++ b/software/ccollect/documentation/ccollect.html @@ -736,8 +736,8 @@ asciidoc.install();

ccollect - Installing, Configuring and Using

Nico Schottelius
<nico-ccollect__@__schottelius.org>
-version 2.0, -for ccollect 2.0, Initial Version from 2006-01-13 +version 2.1, +for ccollect 2.1, Initial Version from 2006-01-13
@@ -2205,8 +2205,8 @@ rsync -av -H --delete /mnt/archiv/ "$DDIR/archiv/"
diff --git a/software/ccollect/documentation/ccollect.text b/software/ccollect/documentation/ccollect.text index b1c7dba2..74fcab67 100644 --- a/software/ccollect/documentation/ccollect.text +++ b/software/ccollect/documentation/ccollect.text @@ -1,7 +1,7 @@ ccollect - Installing, Configuring and Using ============================================ Nico Schottelius -2.0, for ccollect 2.0, Initial Version from 2006-01-13 +2.1, for ccollect 2.1, Initial Version from 2006-01-13 :Author Initials: NS diff --git a/software/ccollect/documentation/man/ccollect.1 b/software/ccollect/documentation/man/ccollect.1 index 259a6a64..1aae7651 100644 --- a/software/ccollect/documentation/man/ccollect.1 +++ b/software/ccollect/documentation/man/ccollect.1 @@ -2,12 +2,12 @@ .\" Title: ccollect .\" Author: Nico Schottelius .\" Generator: DocBook XSL Stylesheets v1.76.1 -.\" Date: 09/26/2016 +.\" Date: 03/22/2017 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "CCOLLECT" "1" "09/26/2016" "\ \&" "\ \&" +.TH "CCOLLECT" "1" "03/22/2017" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -44,6 +44,11 @@ For more information refer to the manual titled "ccollect \- Installing, Configu Backup all sources specified in /etc/ccollect/sources .RE .PP +\-e, \-\-errors +.RS 4 +Log only errors +.RE +.PP \-h, \-\-help .RS 4 Show the help screen @@ -54,19 +59,139 @@ Show the help screen Specifies the number of jobs to run simultaneously\&. If max is not specified then parallelise all jobs\&. .RE .PP +\-l FILE, \-\-logfile FILE +.RS 4 +Log to specified file +.RE +.PP \-p, \-\-parallel .RS 4 Parallelise backup processes (deprecated from 2\&.0) .RE .PP +\-s, \-\-syslog +.RS 4 +Log to syslog with tag ccollect +.RE +.PP +\-V, \-\-version +.RS 4 +Show version and exit +.RE +.PP \-v, \-\-verbose .RS 4 Be very verbose (uses set \-x) .RE +.SH "LOGGING MECHANISM" +.sp +ccollect logging depends on running in non\-interactive/interactive mode and on specified optins\&. The mechanism behaves as the following: .PP -\-V, \-\-version +non\-interactive mode .RS 4 -Show version and exit +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +standard output goes to syslog +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +optional: specify logging into file +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +log all output by default +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +optional: log only errors +.RE +.RE +.PP +interactive mode +.RS 4 +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +standard output goes to stdout +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +log only errors +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +optional: log into syslog or file +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +log all output by default +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +optional: log only errors +.RE +.RE .RE .SH "SEE ALSO" .sp diff --git a/software/ccollect/documentation/man/ccollect.htm b/software/ccollect/documentation/man/ccollect.htm index 00a607d4..f460e445 100644 --- a/software/ccollect/documentation/man/ccollect.htm +++ b/software/ccollect/documentation/man/ccollect.htm @@ -1,4 +1,4 @@ -ccollect(1)

ccollect(1)

Table of Contents

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
AUTHOR
RESOURCES
COPYING

NAME

ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync

SYNOPSIS

ccollect.sh [args] <interval name> <sources to backup>

DESCRIPTION

ccollect is a backup utility written in the sh-scripting language. +ccollect(1)

ccollect(1)

Table of Contents

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
LOGGING MECHANISM
SEE ALSO
AUTHOR
RESOURCES
COPYING

NAME

ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync

SYNOPSIS

ccollect.sh [args] <interval name> <sources to backup>

DESCRIPTION

ccollect is a backup utility written in the sh-scripting language. It does not depend on a specific shell, only /bin/sh needs to be bourne shell compatibel (like dash, ksh, zsh, bash, …).

For more information refer to the manual titled "ccollect - Installing, Configuring and Using" (available as text (asciidoc), @@ -7,6 +7,10 @@ texinfo or html).

+-e, --errors +
+ Log only errors +
-h, --help
Show the help screen @@ -16,17 +20,48 @@ texinfo or html).

+-l FILE, --logfile FILE +
+ Log to specified file +
-p, --parallel
Parallelise backup processes (deprecated from 2.0)
--v, --verbose +-s, --syslog
- Be very verbose (uses set -x) + Log to syslog with tag ccollect
-V, --version
Show version and exit -

SEE ALSO

ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1) +

+-v, --verbose +
+ Be very verbose (uses set -x) +

LOGGING MECHANISM

ccollect logging depends on running in non-interactive/interactive mode +and on specified optins. The mechanism behaves as the following:

+non-interactive mode +
  • +standard output goes to syslog +
  • +optional: specify logging into file +
  • +log all output by default +
  • +optional: log only errors +
+interactive mode +
  • +standard output goes to stdout +
  • +log only errors +

  • +optional: log into syslog or file +

    • +log all output by default +
    • +optional: log only errors +

SEE ALSO

ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1) ccollect_delete_source(1), ccollect_list_intervals(1)

AUTHOR

Nico Schottelius <nico-ccollect--@--schottelius.org>

RESOURCES

Main web site: http://www.nico.schottelius.org/software/ccollect/

COPYING

Copyright (C) 2006-2008 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3).

diff --git a/software/ccollect/documentation/man/ccollect.html b/software/ccollect/documentation/man/ccollect.html index 79de6741..8287d170 100644 --- a/software/ccollect/documentation/man/ccollect.html +++ b/software/ccollect/documentation/man/ccollect.html @@ -774,6 +774,14 @@ texinfo or html).

+-e, --errors +
+
+

+ Log only errors +

+
+
-h, --help
@@ -791,6 +799,14 @@ texinfo or html).

+-l FILE, --logfile FILE +
+
+

+ Log to specified file +

+
+
-p, --parallel
@@ -799,11 +815,11 @@ texinfo or html).

--v, --verbose +-s, --syslog

- Be very verbose (uses set -x) + Log to syslog with tag ccollect

@@ -814,30 +830,108 @@ texinfo or html).

Show version and exit

+
+-v, --verbose +
+
+

+ Be very verbose (uses set -x) +

+
-

5. SEE ALSO

+

5. LOGGING MECHANISM

+
+

ccollect logging depends on running in non-interactive/interactive mode +and on specified optins. The mechanism behaves as the following:

+
+
+non-interactive mode +
+
+
    +
  • +

    +standard output goes to syslog +

    +
    • +
  • +

    +optional: specify logging into file +

    +
    • +
  • +

    +log all output by default +

    +
    • +
  • +

    +optional: log only errors +

    +
    • +
+
+
+interactive mode +
+
+
    +
  • +

    +standard output goes to stdout +

    +
    • +
  • +

    +log only errors +

    +
    • +
  • +

    +optional: log into syslog or file +

    +
      +
    • +

      +log all output by default +

      +
      • +
    • +

      +optional: log only errors +

      +
      • +
    +
    • +
+
+
+
+
+
+

6. SEE ALSO

ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1) ccollect_delete_source(1), ccollect_list_intervals(1)

-

6. AUTHOR

+

7. AUTHOR

Nico Schottelius <nico-ccollect--@--schottelius.org>

-

7. RESOURCES

+

8. RESOURCES

Main web site: http://www.nico.schottelius.org/software/ccollect/

-

8. COPYING

+

9. COPYING

Copyright (C) 2006-2008 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3).

@@ -847,7 +941,7 @@ granted under the terms of the GNU General Public License Version 3 (GPLv3).

diff --git a/software/ccollect/documentation/man/ccollect.text b/software/ccollect/documentation/man/ccollect.text index 84c1e37a..67f8f473 100644 --- a/software/ccollect/documentation/man/ccollect.text +++ b/software/ccollect/documentation/man/ccollect.text @@ -26,20 +26,54 @@ texinfo or html). OPTIONS ------- +-a, --all:: + Backup all sources specified in /etc/ccollect/sources + +-e, --errors:: + Log only errors + -h, --help:: Show the help screen --p, --parallel:: - Parallelise backup processes +-j [max], --jobs [max]:: + Specifies the number of jobs to run simultaneously. + If max is not specified then parallelise all jobs. --a, --all:: - Backup all sources specified in /etc/ccollect/sources +-l FILE, --logfile FILE:: + Log to specified file + +-p, --parallel:: + Parallelise backup processes (deprecated from 2.0) + +-s, --syslog:: + Log to syslog with tag ccollect + +-V, --version:: + Show version and exit -v, --verbose:: Be very verbose (uses set -x) --V, --version:: - Show version and exit + +LOGGING MECHANISM +----------------- +ccollect logging depends on running in non-interactive/interactive mode +and on specified optins. The mechanism behaves as the following: + +non-interactive mode:: + + * standard output goes to syslog + * optional: specify logging into file + * log all output by default + * optional: log only errors + +interactive mode:: + + * standard output goes to stdout + * log only errors + * optional: log into syslog or file + - log all output by default + - optional: log only errors SEE ALSO diff --git a/software/ccollect/download.mdwn b/software/ccollect/download.mdwn index d330a65d..bb0fa0d0 100644 --- a/software/ccollect/download.mdwn +++ b/software/ccollect/download.mdwn @@ -5,6 +5,7 @@ You can get the latest (development) version via git: git clone https://github.com/telmich/ccollect.git ## Releases + * ccollect-2.1.tar.bz2 * ccollect-2.0.tar.bz2 * [[ccollect-0.8.tar.bz2]] ([[RPM|ccollect-0.8-0.noarch.rpm]]) * ccollect-0.7.1.tar.bz2 diff --git a/software/ccollect/download/ccollect-2.1.tar.bz2 b/software/ccollect/download/ccollect-2.1.tar.bz2 new file mode 100644 index 00000000..03981d64 Binary files /dev/null and b/software/ccollect/download/ccollect-2.1.tar.bz2 differ