wok-stable rev 1357
Add: BoxBackup automatic on-line backup system
| author | Dominique Corbex <domcox@users.sourceforge.net> |
|---|---|
| date | Tue Sep 09 22:18:22 2008 +0200 (2008-09-09) |
| parents | d5be027602dd |
| children | 30037287225e |
| files | boxbackup-client/description.txt boxbackup-client/receipt boxbackup-client/stuff/bbackupd boxbackup-server/description.txt boxbackup-server/receipt boxbackup-server/stuff/bbstored |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/boxbackup-client/description.txt Tue Sep 09 22:18:22 2008 +0200 1.3 @@ -0,0 +1,22 @@ 1.4 +BoxBackup Client (bbackupd) 1.5 + 1.6 +BoxBackup is designed to be easy to set up and run, and cheap to use. 1.7 +Once set up, there should be no need for user or administrative 1.8 +intervention, apart from usual system maintenance. 1.9 + 1.10 +bbackupd is configured with a list of directories to back up. It has a 1.11 +lazy approach to backing up data. Every so often, the directories are 1.12 +scanned, and new data is uploaded to the server. 1.13 + 1.14 +The daemon is always running, although sleeping most of the time. In 1.15 +lazy mode, it is completely self contained - scripts running under cron 1.16 +jobs are not used. 1.17 + 1.18 +If an old version of the file is present on the server, a modified 1.19 +version of the rsync algorithm is used to upload only the changed 1.20 +portions of the file. 1.21 + 1.22 +After a new version is uploaded, the old version is still available 1.23 +(subject to disc space on the server). Similarly, a deleted file is 1.24 +still available. The only limit to their availability is space allocated 1.25 +to this account on the server.
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 2.2 +++ b/boxbackup-client/receipt Tue Sep 09 22:18:22 2008 +0200 2.3 @@ -0,0 +1,80 @@ 2.4 +# SliTaz package receipt. 2.5 + 2.6 +PACKAGE="boxbackup-client" 2.7 +VERSION="0.10" 2.8 +CATEGORY="network" 2.9 +SHORT_DESC="Client for the BoxBackup on-line backup system" 2.10 +MAINTAINER="domcox@users.sourceforge.net" 2.11 +DEPENDS="db libedit openssl perl zlib" 2.12 +SOURCE="boxbackup" 2.13 +WANTED="boxbackup-server" 2.14 +WEB_SITE="http://www.boxbackup.org/" 2.15 + 2.16 +# Configuration variables 2.17 +CONF_DIR="/etc/box" 2.18 +DATA_DIR="/var/lib/bbackupd" 2.19 +RUN_DMON=0 2.20 + 2.21 +# Rules to gen a SliTaz package suitable for Tazpkg 2.22 +genpkg_rules() 2.23 +{ 2.24 + _pkg=$WOK/$WANTED/${SOURCE}-$VERSION/parcels/boxbackup-${VERSION}-backup-client-linux-gnu 2.25 + mkdir -p $fs/usr/bin 2.26 + cp -a $_pkg/bb* $fs/usr/bin 2.27 + mkdir -p $fs/etc/init.d 2.28 + cp -a stuff/bbackupd $fs/etc/init.d 2.29 +} 2.30 + 2.31 +# Pre and post install commands for Tazpkg 2.32 + 2.33 +pre_install() 2.34 +{ 2.35 + # Stop daemon 2.36 + if [ -e /var/run/bbackupd.pid ]; then 2.37 + /etc/init.d/bbackupd stop 2.38 + RUN_DMON=1 2.39 + fi 2.40 +} 2.41 + 2.42 +post_install() 2.43 +{ 2.44 + # Creating conf dir 2.45 + if [ ! -e $CONF_DIR ]; then 2.46 + mkdir -p $CONF_DIR && chmod 755 $CONF_DIR 2.47 + fi 2.48 + if [ ! -e $DATA_DIR ]; then 2.49 + mkdir -p $DATA_DIR && chmod 700 $DATA_DIR 2.50 + fi 2.51 + # Start daemon (if stopped by install) 2.52 + if [ $RUN_DMON -eq 1 ]; then 2.53 + /etc/init.d/bbackupd start 2.54 + fi 2.55 +} 2.56 + 2.57 +# Pre and post remove commands for Tazpkg 2.58 + 2.59 +pre_remove() 2.60 +{ 2.61 + # Stop daemon 2.62 + if [ -e /var/run/bbackupd.pid ]; then 2.63 + /etc/init.d/bbackupd stop 2.64 + fi 2.65 +} 2.66 + 2.67 +post_remove() 2.68 +{ 2.69 + # Delete DATA directory 2.70 + rm -rf $DATA_DIR 2.71 + 2.72 + # Delete Client config files 2.73 + rm -rf $CONF_DIR/bbackupd* 2.74 + 2.75 + # Delete CONF dir (if empty) 2.76 + if [ `ls $CONF_DIR | wc -l` -eq 0 ]; then 2.77 + echo -n "Removing $CONF_DIR..." 2.78 + rm -rf $CONF_DIR 2.79 + status 2.80 + fi 2.81 + # Delete PID, sock files 2.82 + rm -f /var/run/bbackupd.* 2.83 +} 2.84 \ No newline at end of file
3.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 3.2 +++ b/boxbackup-client/stuff/bbackupd Tue Sep 09 22:18:22 2008 +0200 3.3 @@ -0,0 +1,55 @@ 3.4 +#!/bin/sh 3.5 +# /etc/init.d/bbackupd: Start, stop and restart bbackupd deamon on SliTaz, at boot 3.6 +# time or with the command line. 3.7 +# 3.8 +# To start daemon at boot time, just put the right name in the $RUN_DAEMONS 3.9 +# variable of /etc/rcS.conf and configure options with /etc/daemons.conf. 3.10 +# 3.11 +. /etc/init.d/rc.functions 3.12 +. /etc/daemons.conf 3.13 + 3.14 +NAME=BBackupd 3.15 +DESC="BoxBackup deamon" 3.16 +DAEMON=/usr/bin/bbackupd 3.17 +OPTIONS=$BBSTORED_OPTIONS 3.18 +PIDFILE=/var/run/bbackupd.pid 3.19 + 3.20 +case "$1" in 3.21 + start) 3.22 + if [ -f $PIDFILE ] ; then 3.23 + echo "$NAME already running." 3.24 + exit 1 3.25 + fi 3.26 + echo -n "Starting $DESC: $NAME... " 3.27 + $DAEMON $OPTIONS > /dev/null 3.28 + status 3.29 + ;; 3.30 + stop) 3.31 + if [ ! -f $PIDFILE ] ; then 3.32 + echo "$NAME is not running." 3.33 + exit 1 3.34 + fi 3.35 + echo -n "Stopping $DESC: $NAME... " 3.36 + kill `cat $PIDFILE` 3.37 + status 3.38 + ;; 3.39 + restart) 3.40 + if [ ! -f $PIDFILE ] ; then 3.41 + echo "$NAME is not running." 3.42 + exit 1 3.43 + fi 3.44 + echo -n "Restarting $DESC: $NAME... " 3.45 + kill `cat $PIDFILE` 3.46 + sleep 2 3.47 + $DAEMON $OPTIONS > /dev/null 3.48 + status 3.49 + ;; 3.50 + *) 3.51 + echo "" 3.52 + echo -e "\033[1mUsage:\033[0m /etc/init.d/`basename $0` [start|stop|restart]" 3.53 + echo "" 3.54 + exit 1 3.55 + ;; 3.56 +esac 3.57 + 3.58 +exit 0
4.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 4.2 +++ b/boxbackup-server/description.txt Tue Sep 09 22:18:22 2008 +0200 4.3 @@ -0,0 +1,37 @@ 4.4 +Server for the BoxBackup on-line backup system. 4.5 + 4.6 +Box Backup is an open source, completely automatic, on-line backup system. 4.7 +It has the following key features: 4.8 + 4.9 + * All backed up data is stored on the server in files on a filesystem - 4.10 + no tape, archive or other special devices are required. 4.11 + 4.12 + * The server is trusted only to make files available when they are 4.13 + required - all data is encrypted and can be decoded only by the 4.14 + original client. This makes it ideal for backing up over an untrusted 4.15 + network (such as the Internet), or where the server is in an 4.16 + uncontrolled environment. 4.17 + 4.18 + * A backup daemon runs on systems to be backed up, and copies encrypted 4.19 + data to the server when it notices changes - so backups are continuous 4.20 + and up-to-date (although traditional snapshot backups are possible too). 4.21 + 4.22 + * Only changes within files are sent to the server, just like rsync, 4.23 + minimising the bandwidth used between clients and server. This makes it 4.24 + particularly suitable for backing up between distant locations, or over 4.25 + the Internet. 4.26 + 4.27 + * It behaves like tape - old file versions and deleted files are available. 4.28 + 4.29 + * Old versions of files on the server are stored as changes from the 4.30 + current version, minimising the storage space required on the server. 4.31 + Files are the server are also compressed to minimise their size. 4.32 + 4.33 + * Choice of backup behaviour - it can be optimised for document or server 4.34 + backup. 4.35 + 4.36 + * It is designed to be easy and cheap to run a server. It has a portable 4.37 + implementation, and optional RAID implemented in userland for reliability 4.38 + without complex server setup or expensive hardware. 4.39 + 4.40 +Box Backup is distributed under a BSD license.
5.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 5.2 +++ b/boxbackup-server/receipt Tue Sep 09 22:18:22 2008 +0200 5.3 @@ -0,0 +1,180 @@ 5.4 +# SliTaz package receipt. 5.5 + 5.6 +PACKAGE="boxbackup-server" 5.7 +VERSION="0.10" 5.8 +CATEGORY="network" 5.9 +SHORT_DESC="Server for the BoxBackup on-line backup system" 5.10 +MAINTAINER="domcox@users.sourceforge.net" 5.11 +DEPENDS="db libedit openssl perl zlib" 5.12 +BUILD_DEPENDS="db-dev libedit-dev openssl-dev zlib-dev" 5.13 +SOURCE="boxbackup" 5.14 +TARBALL="$SOURCE-$VERSION.tgz" 5.15 +WEB_SITE="http://www.boxbackup.org/" 5.16 +WGET_URL="$SF_MIRROR/$SOURCE/$TARBALL" 5.17 + 5.18 +# Configuration variables 5.19 +HOSTNAME=`ifconfig | awk -F ":" '/cast/ {print substr($2,0, index($2," ")-1) }'` 5.20 +CONF_DIR="/etc/box" 5.21 +DATA_DIR="/var/lib/bbstored" 5.22 +CA_DIR="${CONF_DIR}/ca" 5.23 +BBUSER="bbstored" 5.24 + 5.25 +# Rules to configure and make the package. 5.26 +compile_rules() 5.27 +{ 5.28 + cd $src 5.29 + ./configure --prefix=/usr $CONFIGURE_ARGS 5.30 + make 5.31 +} 5.32 + 5.33 +# Rules to gen a SliTaz package suitable for Tazpkg. 5.34 +genpkg_rules() 5.35 +{ 5.36 + _pkg=$WOK/$PACKAGE/${SOURCE}-${VERSION}/parcels/boxbackup-${VERSION}-backup-server-linux-gnu 5.37 + mkdir -p $fs/usr/bin 5.38 + cp -a $_pkg/bb* $fs/usr/bin 5.39 + cp -a $_pkg/ra* $fs/usr/bin 5.40 + mkdir -p $fs/etc/init.d 5.41 + cp -a stuff/bbstored $fs/etc/init.d 5.42 +} 5.43 + 5.44 + 5.45 +# Pre and post install commands for Tazpkg. 5.46 + 5.47 +pre_install() 5.48 +{ 5.49 + # Stop daemon 5.50 + if [ -e /var/run/bbstored.pid ]; then 5.51 + /etc/init.d/bbstored stop 5.52 + fi 5.53 +} 5.54 + 5.55 +post_install() 5.56 +{ 5.57 + # adduser BBUSER if needed 5.58 + if ! grep -q $BBUSER $1/etc/passwd; then 5.59 + echo -n "Adding user '$BBUSER'..." 5.60 + echo $BBUSER':x:505:505:BoxBackup Network Backup:/dev/null:/bin/false' >> $1/etc/passwd 5.61 + echo $BBUSER':!:14013:0:99999:7:::' >> $1/etc/shadow 5.62 + echo $BBUSER':x:505:' >> $1/etc/group 5.63 + echo $BBUSER':!::' >> $1/etc/gshadow 5.64 + status 5.65 + fi 5.66 + 5.67 + # Create config is needed 5.68 + if [ ! -e $CONF_DIR ]; then 5.69 + mkdir -p $CONF_DIR && chown $BBUSER $CONF_DIR && chmod 700 $CONF_DIR 5.70 + fi 5.71 + 5.72 + if [ ! -e $DATA_DIR/backup ]; then 5.73 + # Creating backup dir 5.74 + echo -n "Creating backup directory..." 5.75 + mkdir -p $DATA_DIR/backup && chown -R $BBUSER $DATA_DIR && chmod -R 700 $DATA_DIR 5.76 + status 5.77 + fi 5.78 + 5.79 + if [ ! -e $CONF_DIR/raidfile.conf ]; then 5.80 + # RAID Setup 5.81 + echo -n "Disabling deprecated userland RAID..." 5.82 + /usr/bin/raidfile-config $CONF_DIR 2048 $DATA_DIR 2>1 > /dev/null 5.83 + status 5.84 + chown -R $BBUSER $CONF_DIR/raidfile.conf && chmod 700 -R $CONF_DIR/raidfile.conf 5.85 + fi 5.86 + 5.87 + if [ ! -e $CONF_DIR/bbstored.conf ]; then 5.88 + # Setting hostname 5.89 + echo -n "Setting hostname... " 5.90 + if [ `hostname -f 2>1 > /dev/null;echo $?` -eq 0 ]; then 5.91 + HOSTNAME=`hostname -f` 5.92 + fi 5.93 + if [ -z $HOSTNAME ]; then 5.94 + HOSTNAME="127.0.0.1" 5.95 + fi 5.96 + echo $HOSTNAME 5.97 + 5.98 + # Setting up the CA environment 5.99 + echo -n "Creating certificates..." 5.100 + /usr/bin/bbstored-certs $CA_DIR init 2>1 > /dev/null 5.101 + status 5.102 + 5.103 + # Generate server certificate request 5.104 + echo -n "Generate server certificate request..." 5.105 + bbstored-config $CONF_DIR $HOSTNAME $BBUSER 2>1 > /dev/null 5.106 + status 5.107 + 5.108 + # Sign the server certificate 5.109 + echo -n "Sign the server certificate..." 5.110 + openssl x509 -req -sha1 -extensions usr_crt \ 5.111 + -in $CONF_DIR/$BBUSER/${HOSTNAME}-csr.pem \ 5.112 + -CA $CA_DIR/roots/serverCA.pem \ 5.113 + -CAkey $CA_DIR/keys/serverRootKey.pem \ 5.114 + -out $CA_DIR/servers/${HOSTNAME}-cert.pem \ 5.115 + -days 5000 2>1 > /dev/null 5.116 + status 5.117 + 5.118 + # Preparing the server certificates 5.119 + echo -n "Installing server certificate..." 5.120 + cp -a $CA_DIR/servers/${HOSTNAME}-cert.pem $CONF_DIR/$BBUSER 5.121 + status 5.122 + echo -n "Installing client certificate..." 5.123 + cp -a $CA_DIR/roots/clientCA.pem $CONF_DIR/$BBUSER 5.124 + status 5.125 + 5.126 + # Securing $CONF_DIR 5.127 + chown -R $BBUSER $CONF_DIR/bbstored* && chmod 700 -R $CONF_DIR/bbstored* 5.128 + fi 5.129 + 5.130 + if [ -e $CA_DIR ]; then 5.131 + # Warning 5.132 + echo 5.133 + echo "IMPORTANT NOTE:" 5.134 + echo "--------------" 5.135 + echo "The certificate authority directory $CA_DIR is intended to be" 5.136 + echo "moved to another system. It should not be kept on the backup server" 5.137 + echo "to limit the impact of a server compromise." 5.138 + fi 5.139 +} 5.140 + 5.141 +# Pre and post remove commands for Tazpkg 5.142 + 5.143 +pre_remove() 5.144 +{ 5.145 + /etc/init.d/bbstored stop 5.146 +} 5.147 + 5.148 +post_remove() 5.149 +{ 5.150 + if grep -q $BBUSER $1/etc/passwd; then 5.151 + echo -n "Removing $BBUSER user..." 5.152 + deluser bbstored 5.153 + status 5.154 + fi 5.155 + # Delete data 5.156 + if [ -e $DATA_DIR ]; then 5.157 + echo -n "Removing all backup data..." 5.158 + rm -r $DATA_DIR 5.159 + status 5.160 + fi 5.161 + # Delete bbstored conf files 5.162 + if [ -e $CONF_DIR/bbstored.conf ]; then 5.163 + echo -n "Removing config files..." 5.164 + rm -rf $CONF_DIR/bbstored 5.165 + rm -f $CONF_DIR/raidfile.conf 5.166 + rm -f $CONF_DIR/bbstored.conf 5.167 + status 5.168 + fi 5.169 + # Delete certificates 5.170 + if [ -e $CA_DIR ]; then 5.171 + echo -n "Removing certificates..." 5.172 + rm -r $CA_DIR 5.173 + status 5.174 + fi 5.175 + # Delete $CONF_DIR (if empty) 5.176 + if [ `ls $CONF_DIR | wc -l` -eq 0 ]; then 5.177 + echo -n "Removing $CONF_DIR..." 5.178 + rm -r $CONF_DIR 5.179 + status 5.180 + fi 5.181 + # Delete PID, sock files 5.182 + rm -f /var/run/bbstored.* 5.183 +} 5.184 \ No newline at end of file
6.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 6.2 +++ b/boxbackup-server/stuff/bbstored Tue Sep 09 22:18:22 2008 +0200 6.3 @@ -0,0 +1,55 @@ 6.4 +#!/bin/sh 6.5 +# /etc/init.d/bbstored: Start, stop and restart bbstored deamon on SliTaz, at boot 6.6 +# time or with the command line. 6.7 +# 6.8 +# To start daemon at boot time, just put the right name in the $RUN_DAEMONS 6.9 +# variable of /etc/rcS.conf and configure options with /etc/daemons.conf. 6.10 +# 6.11 +. /etc/init.d/rc.functions 6.12 +. /etc/daemons.conf 6.13 + 6.14 +NAME=BBstored 6.15 +DESC="BoxBackup server deamon" 6.16 +DAEMON=/usr/bin/bbstored 6.17 +OPTIONS=$BBSTORED_OPTIONS 6.18 +PIDFILE=/var/run/bbstored.pid 6.19 + 6.20 +case "$1" in 6.21 + start) 6.22 + if [ -f $PIDFILE ] ; then 6.23 + echo "$NAME already running." 6.24 + exit 1 6.25 + fi 6.26 + echo -n "Starting $DESC: $NAME... " 6.27 + $DAEMON $OPTIONS > /dev/null 6.28 + status 6.29 + ;; 6.30 + stop) 6.31 + if [ ! -f $PIDFILE ] ; then 6.32 + echo "$NAME is not running." 6.33 + exit 1 6.34 + fi 6.35 + echo -n "Stopping $DESC: $NAME... " 6.36 + kill `cat $PIDFILE` 6.37 + status 6.38 + ;; 6.39 + restart) 6.40 + if [ ! -f $PIDFILE ] ; then 6.41 + echo "$NAME is not running." 6.42 + exit 1 6.43 + fi 6.44 + echo -n "Restarting $DESC: $NAME... " 6.45 + kill `cat $PIDFILE` 6.46 + sleep 2 6.47 + $DAEMON $OPTIONS > /dev/null 6.48 + status 6.49 + ;; 6.50 + *) 6.51 + echo "" 6.52 + echo -e "\033[1mUsage:\033[0m /etc/init.d/`basename $0` [start|stop|restart]" 6.53 + echo "" 6.54 + exit 1 6.55 + ;; 6.56 +esac 6.57 + 6.58 +exit 0