README
Copyright (c) 1999 Michael Merten <mikemerten@yahoo.com>

LICENSE:

    This package is distributed under the terms of version 2 of
    the GNU GPL.  See the LICENSE file included with this package.
    
CHANGES from previous versions:

   Added a verbose option (-v) to show additional output from rsync(1).

   Major change...  I've rewritten apt-move so that you can now mirror
   the source files as well as the binary packages.  (see the PKGTYPE
   setting in /etc/apt-move.conf).  I've also rewritten the license
   notices for most of the files included with the distribution, and
   I've included a copy of Version 2 of the GPL (see the LICENSE file).

   Major change...  I've remove the runmirror script.  Background operation
   for apt-move is now handled using the -b command line switch.  The
   old 'runmirror start' is now handled by 'apt-move -b mirror'.

   The install script is not terribly intelligent.  It checks to see if 
   a file exists with the same name in the target directory, and, if found,
   will ask you if you want to overwrite it.   It does NOT check the file
   to try to figure out if it really is from an old version of apt-move, so
   there exists the possibility of a name collision with another package.
   It's up to you to decide what to do.  If you answer no, the install will
   abort and you can manually fix the problem.

   If you want, you can run ./install with the -f switch, to force overwriting
   of all files necessary to complete the installation. (It's your choice.)

   There is a new 'sync' option which will allow you to easily mirror only
   the packages you actually use.  See the apt-move(8) manpage.

INSTALLING apt-move:

   Since you are reading this file, I'm assuming you've already unpacked the
   tarball, so I won't bore you with the details on how to do that.
   Installation is fairly simple, but please read the rest of this file
   before you get started.

    1. Run the install script with './install'.  It will copy the scripts
       to /usr/local/sbin, the manpages to /usr/local/man/man8, the config
       file to /etc, and will put a script in cron.weekly to rotate the log
       file. If you wish to use different directories, change the
       BINDIR and MANDIR settings in the install script before using it.

       The install script will not overwrite any files.  It interactively
       prompts you with a yes/no answer for each file already on your system.
       To override this and force overwrites, run ./install -f instead.

       If you want to install manually, here's where I put everything:

           /usr/local/sbin/apt-move
           /usr/local/man/man8/apt-move.8
           /etc/apt-move.conf                 << this MUST go here
           apt-move.cron -> /etc/cron.weekly/apt-move
           
    3. Set DELETE=no in /etc/apt-move.conf and run:

          apt-move -t update

       Make sure everything appears to work correctly.  (you can redirect
       the output to a log file if needed, to keep from missing anything
       important, with  'apt-move -bt update')
       
    4. When you're satisfied with the result in step 3, run:
    
          apt-move update

       Once again, make sure everything is ok before proceeding.

    5. You can disconnect from the internet at this point, if desired.

    6. If you don't want apt-move to automatically delete any package
       files, skip this step.  Otherwise, if step 4 worked as expected,
       edit /etc/apt-move.conf and set DELETE=yes then run:

          apt-move -t local

       This should show you exactly what files will be deleted, and
       if you like the results, you can run:

          apt-move local

       to finish up the process.

I can't stress enough the benifits of using the test parameter EVERY TIME
you make configuration changes.  It may result in a lot of extra work, but
thats better than suddenly losing all of you package files!

MIRROR 

    If you plan to use the mirror option to maintain your local mirror,
    you need to create an file in the debian/ directory called .exclude
    (see the SAMPLE.exclude file for an example).  You need to read the
    documentation in the apt-move(8) manpage for additional information.  
    
    After you get your .exclude file set up, test the configuration by
    connecting to the internet and running:

        apt-move -bt mirror

    If the logfile output looks good, you can run it for real using:

        apt-move -b mirror

    During a mirror run, if you need to stop the script (like, for instance,
    your wife needs to use the phone) use:

        apt-move stop

    and the script will abort.  You can take up where you left off by
    running:

        apt-move -b mirror 

    again.  There are two settings in /etc/apt-move.conf that affect
    the -b (background) operation, LOGFILE and MONITOR.  If neither of these
    are set, all output will be discarded.  See apt-move(8) for more
    details.

SYNC

    If you plan to use the sync option you should be aware of a few things
    that work differently than the mirror option.

    The sync option will only download the installed packages that can
    be found in the sections of the mirror you selected with the SECTIONS
    setting in /etc/apt-move.conf.  It does not need an exclude file, but
    if one exists, it will obey it (this is to keep you from needlessly 
    downloading files, then deleting them on a later pass).  See the
    apt-move(8) manpage for more details.

    Test your configuration by connecting to the internet and running:

        apt-move -bt sync

    If the output looks good, you can run it for real using:

        apt-move -b sync

    During a sync run, if you need to stop the script (like, for instance,
    your wife needs to use the phone) use:

        apt-move stop

    and the script will abort.  You can take up where you left off by
    running:

        apt-move -b sync

    again.  There are two settings in /etc/apt-move.conf that affect
    the -b (background) operation, LOGFILE and MONITOR.  If neither of these
    are set, all output will be discarded.  See apt-move(8) for more
    details.

    
