si_addclients [-help] [-version] [-hosts HOST_LIST] [-ip-range IP_LIST] [-domainname DOMAINNAME] [-script SCRIPT] [-interactive YES|NO]
This manual page documents briefly the si_addclients command.
si_addclients is a tool for mapping clients to a SystemImager image. There are three sections to the si_addclients utility:
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, "node1-node10,node20" as your hostname range, 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 |
| node20.bogus.net |
Section 2 is where you specify the image you want to assign to the hosts defined in section 1.
Section 3 gives you the option of automatically generating (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 section for that host again (but doing so is harmless).
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.
-helpShow summary of options
-versionDisplay version and copyright information.
-hosts HOST_LISTList of target nodes. List can be separated by comma, spaces or new line and can include ranges.
Example: node001-node099,node101.
-domainname DOMAINNAMEIf this option is used, DOMAINNAME will be appended to the client host name(s).
-ip-range IP_LISTThe range of IP addresses to assign to your autoinstall clients. There must be one IP per hostname.
Example: 192.168.1.1-192.168.1.99,192.168.1.101.
-domainname DOMAINNAMEIf this option is used, DOMAINNAME will be appended to the client host name(s).
-interactive YES|NOThis program will go interactive by default if domainname, host, host-range, and script are all specified.
If you specify YES here, then it will go interactive, even if all of these values are specified.
If you specify NO here, then it will not go interactive, even if it is missing some of the required values.
-script IMAGEMaster autoinstall script name (typically the imagename). Don't include the path or the .master extension.
si_getimage(8), si_mkdhcpserver(8), si_mkdhcpstatic(8)
More details can be found in the SystemImager manual.
This manual page was compiled by dann <<dannf@dannf.org>> for
the Debian GNU/Linux system (but may be used by others).