DI-NETBOOT-ASSISTANT(1)

NAME
di-netboot-assistant - Debian-Installer netboot assistant

SYNOPSIS
di-netboot-assistant [-h] [--version] [--verbose] [--offline] {[install image...] | [uninstall image...] | [uncache image...] | [purge image...] | [fw-toggle image...] | [rebuild-grub] | [rebuild-menu] } [--arch=arch] [--di-args=ARGS] [--target-args=ARGS] [--alias=alias]

DESCRIPTION

di-netboot-assistant is a simple tool to download and extract latest debian installer netboot images.

Unless the -h, --help, -V, or --version option is given, one of the commands below must be present.

install
    install is followed by a repository name desired for installation. The repository name has to be one of those declared in /etc/di-netboot-assistant/di-sources.list. The image will be installed/extracted in the default location (declared in /etc/di-netboot-assistant/di-netboot-assistant.conf).

uninstall
    uninstall is followed by the name of the repository to be uninstalled (or the repository's alias if you used --alias=). The netboot files related to that distribution will be removed from the TFTP server.

uncache
    uncache will clean the cached files for the given netboot image. You must specify a repository name (not an --alias= name).

purge
    purge is followed by a repository name desired for installation. purge is identical to running uninstall then uncache for a given repository.

rebuild-grub
    rebuild-grub will rebuild the grub EFI netboot image. The configuration itself is set up by rebuild-menu. This command takes no argument.

rebuild-menu
    rebuild-menu will rebuild the top level menu. It's only useful if you have modified di-netboot-assistant.conf and you are using some client images that have top level menu (like i386, amd64 and ia64). This command takes no argument.

fw-toggle
    fw-toggle is followed by a repository name and adds respectively removes non-free firmware. The non-free firmware will be downloaded if not available from cache.

OPTIONS

-h, --help Print this message and exit

-v, --version
    Print script version and exit

--alias=alias
    Specify the alias name under which this repository will be saved. Alias names can only contain alphanumeric, "_" and "-" characters. This is especially useful for daily images. By default, the alias name is the same as the repository name.

--arch=arch
    Specify the architecture you want to install or purge. The architecture you can use for the install action must be declared in /etc/di-netboot-assistant/di-sources.list. The architecture you can use for purge action in one of those you previously installed ! The usable architectures can be listed by leaving --arch= empty. The default architecture is the current one (as reported by dpkg --print-architecture).

--verbose
    Verbose messages

--di-args="ARGS"
    Debian-Installer boot arguments. The specified arguments will be *appended* to the one provided in the downloaded image, before the "--". (You can also define DI_ARGS= in di-netboot-assistant.conf).

--ignore-sig
    Ignore failing image signature checks. Useful when run non-interactively in scripts and images are known to be not signed.

--target-args="ARGS"
    Boot arguments for the target (installed) system. The specified arguments will be *appended* to the one provided in the downloaded image, at the very end of the line. (You can also define TARGET_ARGS= in di-netboot-assistant.conf).

--offline
    Don't download the files (use the files cached previously).

EXAMPLES
To install a netboot image for the stable repository, for the default architecture.
    di-netboot-assistant install stable
To list the installed netboot image that can removed.
    di-netboot-assistant purge
To remove a netboot image for the stable repository, for the default architecture.
    di-netboot-assistant purge stable

EXIT CODE

0   Successful program execution.

1   An error occurred. (Note that purge doesn't fail if the specified repository doesn't exists).

FILES

/etc/di-netboot-assistant/di-netboot-assistant.conf
    The default system-wide configuration file. The file syntax must be bash(1) compatible.

~/.di-netboot-assistant/di-netboot-assistant.conf
    User's own configuration file. The file syntax must be bash(1) compatible. (See file peruser.di-netboot-assistant.conf, in /usr/share/doc/di-netboot-assistant/examples/).

/etc/di-netboot-assistant/di-sources.list
    This file contains the list of downloadable netboot images.

/etc/di-netboot-assistant/pxelinux.HEAD
    The content of this file is prepended to the generated PXElinux config file (i.e boot menu). PXElinux bootloader is used on BIOS based i386 and amd64 systems.

/var/lib/di-netboot-assistant/
    The folder where hints about installed netboot images are stored. Do not edit those files, re-use install to modify the settings of installed image.

/var/cache/di-netboot-assistant/
    The folder where downloaded files are stored (cached) before "installing" them. Use the action uncache to remove cached files.

SECURITY
Do not use sudo to grant execution right to di-netboot-assistant (see the README file).

PROXY
di-netboot-assistant uses wget or curl to actually download the files. You can set the environnement variables accordingly.

AUTHOR
di-netboot-assistant was written by Frank Lin PIAT <fpiat@klabs.be>.