SI_PREPARECLIENT(8) SI_PREPARECLIENT(8)
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 | % ] [ --yes ]
[ --exclude DISK ... ] [ -e DISK ... ] [ --no-uyok ] [ --my-modules ] [
--kernel FILE --modules-dir DIR ] [ --image IMAGENAME ] [ --filesystem
FILESYSTEM ] [ --ssh-key FILE ] [ --authorized-keys FILE ] [ -config
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 dur-
ing 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
--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 spec-
ified 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. Impor-
tant: 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 ini-
trd.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 imag-
ing 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.
-config FILE
Where FILE contains all the settings necessary for the client to
set it's hostname and configure it's networking information
without DHCP. This file is copied to /local.cfg into the UYOK
initrd.img.
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 <<dannf@debian.org>> for the De-
bian GNU/Linux system (but may be used by others).
December 8, 2002 SI_PREPARECLIENT(8)
Generated by dwww version 1.15 on Sat Jun 29 01:42:47 CEST 2024.