SetupClient adds or removes one or multiple diskless SunOS clients. If the NetServer is running NIS, SetupClient updates the NIS host’s /etc/hosts, /etc/ethers, and /etc/bootparams databases.
If the NetServer is an NIS master, SetupClient updates the local NIS database; however, it does not propagate the local update to other NIS servers. If the NetServer runs NIS but is not an NIS master, SetupClient issues a warning to indicate that the database is out of date.
Note: Do not run this command unless you have already run SetupExec to install the architecture-dependent executables for the diskless SunOS client machine. The executable directory for the client’s application architecture must be present on the NetServer. If this directory is absent, SetupClient generates an error.
SetupClient updates the /etc/exports file to allow root access to each client’s root file system. It exports the client’s swap and dump partitions only to the client.
When executed, SetupClient performs the following steps:
▲ Adds an entry for the client to /etc/ethers, /etc/hosts, /etc/bootparams, and /etc/exports. ▲ Builds a root directory to be mounted by the client machine.
▲ Builds a swap file to be used as swap space by the client machine.
▲ Uses make and push on the NIS maps (/etc/ethers, /etc/bootparams, and /etc/exports) if the server is an NIS master.
▲ Runs the exportfs program.
▲ Creates a link to the primary boot program in /tftpboot.
Note: Analyze the client root and swap needs of your environment before deciding how to partition the disks on your server. Refer to “Example of File System Distribution” on page 4-11 for more information on setting up partitions for clients’ root and swap directories.
Running SetupClient
1. Determine the IP address and Ethernet address of the client.
One way to determine the client’s Ethernet address is to power on the client and watch it display the power-on messages. For convenience in organizing this information, copy and use the configuration worksheets in Appendix D.
2. If your network uses NIS, and if the NetServer on which you run SetupClient is not the NIS master, follow these steps:
a. Change the NIS text maps of these files on the NIS master:
ethers hosts bootparams
b. Enter the following commands on the NIS master:
# cd /var/yp; make
3. Log in as root on the NetServer to be configured. The system must be in multiuser mode for this procedure.
4. Execute SetupClient: # SetupClient
Figure 2-11 illustrates the SetupClient form. Table 2-9 describes the fields in the
SetupClient form.
5. Fill in all fields of the SetupClient form, and execute it by typing Ctrl-F. The following messages appear:
updated ethers pushed ethers updated hosts pushed hosts
Creating root for client “CLIENTNAME”
Creating swap for client “CLIENTNAME”
Updating /etc/exports to export “CLIENTNAME” info. Updating /etc/bootparams...
updated bootparams
Table 2-9. The SetupClient form fields
Field Description
Setup Client Option Indicates whether to add or remove a client. Client hostname Host name of the client machine.
Architecture type Client’s architecture (for instance, sun4c, sun4, sun3x, or sun3). SeeTable 2-7.
SunOS version The SunOS version running on the client (for example, 4.1.3 or 4.1.4). Internet address Internet address of the client.
Ethernet address Ethernet address of the client.
Type of NIS service Type of NIS service to provide to the client, if any. It can be either
client or none. A diskless SunOS client cannot be an NIS master.
Domain name NIS Domain Name. This field appears only if the client is running NIS service.
Swap size Number of bytes reserved for the client’s swap file. SetupClient creates SWAP_PATH/CLIENTNAME with this size. You can append one of K or k to indicate kilobytes, or M or m to indicate megabytes. (For example, 16M or 16000K.)
FileServer partition Path name of the export partition in which various client directories and files reside.
Path to Client’s root Path name of the client root directory. This is the directory the client mounts as /. You must enter the client’s host name by itself.
Path to Client’s swap file Path name of this client’s swap file. You must enter the client’s host name by itself.
Path to executables Path name of the directory in which the architecture-dependent executables reside. This is the directory that the client mounts as /usr. Path to kernel executables Path name of the directory in which the kernel-specific executables
reside. This is the directory that the client mounts as /usr/kvm. Path to /usr/share files Path name of the directory in which the architecture-independent
operating system files reside. This is the directory that the client mounts as /usr/share.
Path to /home Path name of the directory in which various home directories reside. It is the path name of the directory that the client mounts as /home. This field is optional; if omitted, no /home mount point is created in the client’s /etc/fstab.