si_updateclient(8)

NAME

si_updateclient - update the image running on the local

client machine to match that of an image on an image server

SYNOPSIS

si_updateclient  [ -help ] [ -version ] [ -server HOSTNAME
] [ -image IMAGENAME ] [ -override OVERRIDE ...  ]  [  -directory
DIRECTORY  ] [ -no-bootloader ] [ -autoinstall ] [ -flavor FLAVOR
] [ -configure-from DEVICE ] [ -ssh-user USERNAME ] [ -reboot ] [
-dry-run ] [ -log "STRING" ]

DESCRIPTION

This manual page documents briefly the si_updateclient

command.

si_updateclient is a program that brings the local

client's image up to date with an image on a image server.

OPTIONS

A summary of options is included below.

-help Show summary of options

-version

Display version and copyright information

-server HOSTNAME

Hostname or IP address of the imageserver. Re

places deprecated -imageserver option.

-image IMAGENAME

Image from which the client should be updated

-override OVERRIDE

Override module(s) from which to copy additional

files. Override directories are useful when you have multiple

types of clients that share a subset of files. The image can

contain this subset, and you can have an override module for each

client type which contains the additional files required for that

client type. If the same file exists in an override module and

the image, the files in the override module will overwrite those

in the image.

You can specify multiple override modules. They

will be copied over in the same order the are specified on the

command line.

-directory DIRECTORY

Absolute path of the directory to be updated (de

faults to "/")

-nobootloader

Don't run the bootloader (lilo, elilo, grub, etc)

after update completes. (si_updateclient always runs the boot

loader unless specified).

-autoinstall

Autoinstall this client the next time it reboots.

This option must be used if you want your partition scheme to be

updated to match the partition scheme of the image you are updat

ing too. This is required if the partition scheme of the image

you are updating from differs from the partition scheme of the

image you are currently running, as your system may be left un

bootable otherwise. This option conflicts with -nolilo.

Updates that use this option cannot take advantage

of rsync's efficient updating mechanism. This process also re

quires two reboots. This makes -autoinstall updates more consum

ing.

-flavor FLAVOR

The boot flavor to be used for doing an autoinstall

(assumes -autoinstall).

-configure-from DEVICE

Only used with -autoinstall. Stores the network

configuration for DEVICE in the /local.cfg file so that the same

settings will be used during the autoinstall process.

-ssh-user USERNAME

Username for ssh connection from the client. Only

needed if a secure connection is required.

-listing

List available images on imageserver. This option

is now deprecated in favor of si_lsimage.

-reboot

Reboot client after update completes

-dry-run

Don't actually modify anything, just show what

would be done.

-log STRING

Quoted string for log file format. See the

rsyncd.conf(5) man page for options.

SEE ALSO

si_pushupdate(8), si_lsimage(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_UPDATECLIENT(8)