si_getimage(8)

NAME

si_getimage - pull an image from a golden client

SYNOPSIS

si_getimage [ OPTION ... ] -golden-client HOSTNAME  -image
IMAGENAME

DESCRIPTION

This manual page documents briefly the si_getimage com

mand.

si_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-client HOSTNAME

Hostname or IP address of the "golden" client

-image IMAGENAME

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 im

age if you want to update an image. If you are using the -server

option, the same imagename is used for both the source and desti

nation.

-ssh-user USERNAME

Username for ssh connection to the client. Only

needed if a secure connection is required.

-log STRING

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 im

age already exists on the server.

-directory PATH

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.

-exclude PATH

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-file FILE

Don't pull the PATHs specified in FILE from the

golden client. See the rsync(1) for details on creating this

file.

-update-script YES|NO

Update the $image.master script? Defaults to NO if

-quiet. If not specified you will be prompted to confirm an up

date.

-no-listing

Don't show each filename as it is copied over dur

ing install. This is useful for times when your console device

is slow (e.g. serial console), and is the bottleneck of your in

stallation.

The following options affect the autoinstall client after

autoinstalling.

-ip-assignment METHOD

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. Al

so see the si_mkdhcpstatic command.

· dynamic_dhcp -- A DHCP server will assign IP ad

dresses dynamically to clients installed with this image. In dy

namic 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 mecha

nism for a single machine.

-post-install ACTION

ACTION can be:

· beep -- Clients will beep incessantly after suc

cessful 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.

SEE ALSO

si_addclients(8), si_mkdhcpserver(8), si_mkdhcpstatic(8),

More details can be found in the SystemImager manual.

AUTHOR

This manual page was compiled by dann <<dannf@debian.org>>

for the Debian GNU/Linux system (but may be used by others).

06 March 2007

SI_GETIMAGE(8)