fai-mirror

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
NOTES
SEE ALSO
FILES
AUTHOR

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 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/debmirror-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.
fai-make-nfsroot
(8), install_packages(8)

FILES

/etc/fai/fai.conf

The FAI configuration file.

/etc/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>