SI_PREPARECLIENT

Name

si_prepareclient -- prepare a golden client's image for retrieval

Synopsis

si_prepareclient {--server HOSTNAME} [--version] [-h] [--help] [-n] [--no-rsyncd] [-q] [--quiet] [-r] [--unit MB | %] [--rpm-install] [--yes] [--exclude DISK...] [-e DISK...] [--no-uyok] [--my-modules] [--kernel FILE --modules-dir DIR] [--image IMAGENAME] [--filesystem FILESYSTEM] [--ssh-key FILE] [--authorized-keys FILE]

DESCRIPTION

This manual page documents briefly the si_prepareclient command.

si_prepareclient is a program that prepares a golden client's image for extracting by an image server.

OPTIONS

A summary of options is included below. Only one option is taken.

--version

Display version and copyright information

-h, --help

Show summary of options

-n, --no-rsyncd

Do not start the rsync daemon

-q, --quiet

Run silently. Return an exit status of 0 for success or a non-zero exit status for failure

--server HOSTNAME

Hostname or IP address of the image server

--exclude DISK, -e DISK

Do not gather partition information for DISK(s). The result of using this option, is that DISK(s) will not be partitioned during the auto-install process. You may prefix DISK with "/dev/", but it is not necessary, and a base directory of /dev/ will be assumed. Example: -e /dev/sdb -e sdc -e /dev/ida/c0d0 -e ida/c0d1

-r, --rpm-install

This is only used when building an RPM

--unit MB | %

Use the specified unit of measurement to save disk informations. If MB is specified the size of the partitions will be reported in absolute values, otherwise with '%' all the values will be reported in percentage relative to the total disk size. Default is MB.

--yes

Answer yes to all yes/no questions

--no-uyok

Don't create a UYOK (Use Your Own Kernel) boot package. This option is advantageous if you know you don't need a UYOK kernel, and you want this command to complete faster.

--kernel FILE

Do not detect the kernel to use with UYOK, but instead use the file specified by the argument FILE. Use this parameter only with --modules_dir and only if you use UYOK feature.

--modules-dir DIR

Get kernel modules to use with UYOK from the DIR repository. Use this parameter only with --kernel and only if you use UYOK feature.

--image IMAGENAME

Get kernel and kernel modules automatically from the image specified by IMAGENAME to use with UYOK (if executed on image server). Use this parameter only if you use UYOK feature.

--filesystem FILESYSTEM

Force the use of FILESYSTEM to create the initial ramdisk. Use the filesystem name as specified in /proc/filesystems. Important: the filesystem must be statically compiled in the kernel used to install the clients.

--ssh-key FILE

Where FILE is the SSH2 id_dsa or id_rsa private key of the user account that the autoinstall client will use to connect to the imageserver.

Can be used when installing with the client-driven SSH transport (where clients download the image from the image server using rsync over a SSH tunnel).

WARNING: since the private key will be included into the initrd.img it is strongly recommended to not use it to install via network PXE over insecure networks, otherwise the initrd.img will be distributed clear (unencrypted).

--authorized-keys FILE

Specifies the file that contains the public keys that can be used for user authentication from the image server to the imaging clients.

Can be used when installing with SSH transport (and the master pushes the image to the clients), or with the installation boot parameter SSHD=y, to execute commands (or open a remote shell) on the imaging clients.

SEE ALSO

si_updateclient(8)

si_mkbootpackage(8)

More details can be found in the SystemImager manual.

AUTHOR

This manual page was compiled by dann <> for the Debian GNU/Linux system (but may be used by others).