si_addclients(8)

NAME

si_addclients - assign clients to an image

SYNOPSIS

si_addclients [ -help ] [ -version ] [ -host HOSTNAME ]  [
-domainname DOMAINNAME ] [ -host-range X-Y ] [ -script SCRIPT ] [
-ip-range IP-IP ] [ -interactive YES|NO ]

DESCRIPTION

This manual page documents briefly the si_addclients com

mand.

si_addclients is a tool for mapping clients to a SystemIm

ager image. There are three sections to the si_addclients utili

ty:

1. The first section is where you define what a hostname

in your cluster looks like, and define a range of hostnames that

you will associate with an image in the next section. (You

should already have created the image for these clients to use by

this point). Hostnames are of the form prefixnumber.domainname

For example, if you specify "bogus.net" as your domainname,

"node" as your base hostname, a starting number of 1 and an end

ing number of 10, you will have defined the following hosts:

node1.bogus.net

node2.bogus.net

node3.bogus.net

node4.bogus.net

node5.bogus.net

node6.bogus.net

node7.bogus.net

node8.bogus.net

node9.bogus.net

node10.bogus.net

Note: Currently, si_addclients does not support host

names with leading zeros (e.g. node09.bogus.net, instead of

node9.bogus.net), but this will likely be added in a future re

lease. One reason for making the no-padded-zeros method the de

fault behavior is flexible cluster expansion. For example, if

you had initially chosen node01 - node80 as your cluster range,

and later decide to add 25 more nodes to your cluster, you will

have to renumber all of your nodes to add another leading zero

(i.e. node001 - node105).

2. Section 2 is where you specify the image you want to

assign to the hosts defined in section 1.

3. Section 3 gives you the option of automatically gener

ating (or just updating) entries in your hosts files. During an

autoinstallation, a client will request a hosts file in order to

determine its hostname from its IP address. An autoinstall

client will attempt other methods for determining it's hostname,

including DNS, so this is not always necessary. Once an entry

for a host has been added, there is no need to complete this sec

tion for that host again (but doing so is harmless).

OPTIONS

A summary of options is included below. By default, if an

insufficient set of options is specified, si_addclients will fall

back to an interactive mode. See -interactive below if you wish

to alter this behavior.

-help Show summary of options

-version
Display version and copyright information.

-host HOSTBase host name of the client(s) to be autoin

stalled. Will be combined with "-host-range" to derive actual

host names.

-domainname DOMAINNAME
If this option is used, DOMAINNAME will be appended

to the client host name(s).

-host-range X-Y
Number range used to create a series of host names

based on the -client option. For example, "-client www -range

1-3" will cause si_addclients to use www1, www2, and www3 as host

names. If leading zeros are used, then host names will be padded

with zeros. For example, "-client www -range 01-03" produces

host names www01, www02, and www03. Padding hostnames with zeros

is not recommended.

-ip-range IP0-IP1The range of IP addresses to assign to your autoin

stall clients. Where IP0 is the first IP address in the range

and IP1 is the last ip address in the range.

-interactive YES|NOThis program will go interactive by default if do

mainname, host, host-range, and script are all specified.

If you specify YES here, then it will go interac

tive, even if all of these values are specified.

If you specify NO here, then it will not go inter

active, even if it is missing some of the required values.

-script IMAGEMaster autoinstall script name (typically the ima

gename). Don't include the path or the .master extension.

SEE ALSO

si_getimage(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_ADDCLIENTS(8)