NAME

       fai-mirror - create and manage a partial mirror for FAI

SYNOPSIS

       fai-mirror [OPTION]...  DIRECTORY

DESCRIPTION

       This  command  creates  a  partial mirror of Debian packages. It can be used to create the fai CD or as a
       local mirror when you can't download the whole Debian mirror. By default  the  mirror  will  contain  all
       packages of all classes used in the configuration space (/srv/fai/config/package_config).

OPTIONS

       -a ARCH
              Download packages from architecture ARCH. If not specified, use native architecture of host.

       -B     Do  not  add  packages  included  in base.tgz and packages defined in make-fai-nfsroot.conf to the
              mirror. By default all these packages are included in the mirror.

       -C CFDIR
              Use CFDIR as the configuration directory. Default is /etc/fai. You can also  set  the  environment
              variable FAI_ETC_DIR.

       -c CLASS[,CLASS]
              Use only this list of classes for building the mirror. Can't be used in conjunction with -x.

       -h     Show simple help and version.

       -m MAX Set the number of packages to NUM. This overwrites the variable MAXPACKAGES.

       -x CLASS[,CLASS]
              Exclude these classes. Do not add the packages of these classes to the mirror.

       -p     Preserve existing sources.list. NOT YET IMPLEMENTED.

       -v     Create verbose output.

EXAMPLES

          # fai-mirror -v /files/scratch/mirror

       Creates a partial mirror in the directory /files/scratch/mirror using all classes.

          # fai-mirror -v -cDEFAULT,DEMO /debmirror

       Creates a partial mirror containing all packages used in the classes DEFAULT and DEMO.

          # fai-mirror -v -cDEFAULT,AMD64 /srv/debmirrir-amd64

       Will create a mirror including packages for amd64 architecture defined for classes DEFAULT and AMD64. You
       can also run this on a non amd64 host.

NOTES

       You only need root permissions if you access the official Debian mirror via NFS. By default, the variable
       MAXPACKAGES  is  set  to  1,  so  conflicting packages can also be added to the mirror. Setting this to a
       higher number (e.g. 99999) reduces the time for creating the mirror, but some packages may be missing.

SEE ALSO

       This program is part of FAI (Fully Automatic Installation).  The FAI homepage is http://fai-project.org.

       make-fai-nfsroot(8), install_packages(8)

FILES

       /etc/fai/fai.conf
              The FAI configuration file.

       /etc/fai/make-fai-nfsroot.conf
              The FAI configuration file for the nfsroot.
       /etc/fai/apt/sources.list
              Package resource definition for FAI.
       /srv/fai/config/package_config/
              The FAI package configuration directory. This directory is defined by the variable FAI_CONFIGDIR.
       $NFSROOT/var/tmp/base-pkgs.lis
              The list of packages included in base.tgz inside the nfsroot.
       $NFSROOT/var/tmp/packages.nfsroot
              Additional packages that were added to the nfsroot by the configuration file /etc/fai/NFSROOT.

AUTHOR

       Thomas Lange <lange@informatik.uni-koeln.de>

FAI 4.0                                           28 July 2010                                     fai-mirror(1)