NAME

getimage - pull an image from a golden client

SYNOPSIS

getimage [ OPTION... ] -golden-clientHOSTNAME-imageIMAGENAME

DESCRIPTION

This manual page documents briefly the getimage command.
getimage is a program that pulls an image to the image server. The
source for this image can be either a golden client or an image stored
on another image server

OPTIONS

A summary of options is included below.
-help Show summary of options
-version
Display version and copyright information
-golden-clientHOSTNAME
Hostname or IP address of the "golden" client
-imageIMAGENAME
Where IMAGENAME is the name to assign to the image you are
retrieving. This can be either the name of a new image if you
want to create a new image, or the name of an existing image if
you want to update an image. If you are using the -server
option, the same imagename is used for both the source and
destination.
-ssh-userUSERNAME
Username for ssh connection to the client. Only needed if a
secure connection is required.
-logSTRING
Quoted string for log file format. See the rsyncd.conf(5) man
page for options.
-quiet Don’t ask any questions or print any output (other than errors).
In this mode, no warning will be given if the image already
exists on the server.
-directoryPATH
The full path and directory name where you want this image to be
stored. The directory bearing the image name itself will be
placed inside the directory specified here.
-excludePATH
Don’t pull the contents of PATH from the golden client. PATH
must be absolute (starting with a "/").
To exclude a single file use:
-exclude /DIRECTORYNAME/FILENAME
To exclude a directory and it’s contents use:
-exclude /DIRECTORYNAME/
To exclude the contents of a directory, but pull the directory
itself use:
-exclude "/DIRECTORYNAME/*"
-exclude-fileFILE
Don’t pull the PATHs specified in FILE from the golden client.
See the rsync(1) for details on creating this file.
-update-scriptYES|NO
Update the $image.master script? Defaults to NO if -quiet. If
not specified you will be prompted to confirm an update.
-no-listing
Don’t show each filename as it is copied over during install.
This is useful for times when your console device is slow (e.g.
serial console), and is the bottleneck of your installation.
The following options affect the autoinstall client after
autoinstalling.
-ip-assignmentMETHOD
Where METHOD can be:
· static_dhcp -- A DHCP server will assign the same static
address each time to clients installed with this image. The
DHCP server in this case also assigns the corresponding host
name. It is possible therefore, when using static dhcp, to
change a machine’s hostname and IP address by simply changing
one value in the dhcpd.conf file. Some may find this
desirable. Also see the mkdhcpstatic command.
· dynamic_dhcp -- A DHCP server will assign IP addresses
dynamically to clients installed with this image. In dynamic
dhcp, the IP address of a machine may change, but you want it
to retain the same host name. Therefore the hostname is set
by the machine itself. They may be assigned a different
address each time.
· static -- The IP address the client uses during autoinstall
will be permanently assigned to that client.
· replicant -- Don’t mess with the network settings in this
image. I’m using it as a backup and quick restore mechanism
for a single machine.
-post-installACTION
ACTION can be:
· beep -- Clients will beep incessantly after successful
completion of an autoinstall.
· reboot -- Clients will reboot themselves after successful
completion of an autoinstall.
· shutdown -- Clients will halt themselves after successful
completion of an autoinstall.