Metadata-Version: 1.1
Name: darfortie
Version: 1.0.2
Summary: A utility that extends and simplifies using dar (Disk ARchive) for doing routine incremental backups.
Home-page: https://github.com/kagalle/darfortie
Author: Kenneth Galle
Author-email: ken.galle@rainshowers.org
License: UNKNOWN
Description: darfortie
        =========
        
        Darfortie is a front-end for the dar (Disk ARchive) utility
        (http://dar.linux.free.fr/). It adds functionality to the dar utility
        and makes it simpler to use for creating incremental backups. It is
        meant to facilitate a more convienent backup strategy, typically one run
        periodically by a cron task.
        
        The utility can be run repeatedly with the same parameters, and each run
        will generate a new incremental archive based on the last one created.
        It will search the directory where the current archive is being created
        for past reference archives, or a directory can be specified to search
        in (-I).
        
        The first backup is created without the incremental option (-i).
        
        Further incremental backups are created using the -i option and the
        **same** (base) name. Darfortie adds the date/time to the final name to
        make it unique. It relies on this naming convention to find the most
        recent reference backup it should use.
        
        --------------
        
        It is suggested that for the base name you adopt a convention such as::
        
            machine_daily
        
        where “`machine`” is the machine name being backed up, and “`daily`”
        is for daily incremental backups. The end result would result in names
        like::
        
          machine_daily_20160228T0352UTC.1.dar
          machine_daily_20160228T0403UTC_based_on_20160228T0352UTC.1.dar
        
        --------------
        
        A configuration file can be passed through to dar by using the -c
        switch. If not specified, dar will search for and use any dar
        configuration file it normally would (ie. /etc/darrc, ~/.darrc). See the
        dar man page for details on its structure (“CONDITIONAL SYNTAX”).
        
        It also allows you to pass thru dar prune paths.
        
        --------------
        
        Install darfortie by running:
        
        1.  Installing Python (either v2 or v3) if not already installed.
        
        2.  Download a configuration file to use with the -c option at https://github.com/kagalle/darfortie/blob/master/darfortie.conf.
        
        3.  Run ``pip install -i https://pypi.python.org/pypi darfortie``
        
        If this is done as a normal user, then the install puts the package in
        
            /home/ken/.local/lib/python2.7/site-packages/darfortie
        
        and creates an execuatable such that the application can be run by:
        
            $ ./local/bin/darfortie
        
        If installed as `root`, then the install is done into
        
            /usr/local/lib/python2.7/dist-packages/darfortie
        
        and the executable is created as:
        
            /usr/local/bin/darfortie
        
        which is normally on the system PATH.
        
        --------------
        
        For a complete list of options, run::
        
            python darfortie --help
        
        --------------
        
        This is BETA software. Use at your own risk. Please:
        
        #. Test for suitability before using for “real” data.
        #. During testing, use “dar -d …” to compare the created backup against
           the filesystem.
        #. For testing, do a complete restore to a separate filesystem and
           compare results.
        
        --------------
        
        There is an older bash-based version in the “bash\_version” directory,
        kept ONLY for historical reasons.
        
        --------------
        
        There is currently no restore option - use the dar utility directly to
        do restores.
        
Keywords: dar incremental backup
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Archiving :: Backup
