SetupExec installs architecture-dependent executables for diskless SunOS client workstations from either a tape or CD-ROM, using either a local drive or a drive on a remote host. It adds a supported SunOS architecture to the NetServer. For example, the SunOS Version 4.1.3 Sun-4 executables are loaded into /export/exec/sun4.sunos.4.1.3, and a Sun-4 client mounts this directory as the client’s /usr file system. Figure 4-8 on page 4-17 provides an illustration of the /export directory structures.
SetupExec updates two database files as follows:
/etc/exports SetupExec updates /etc/exports (see the exportfs(8) man page) to export the executable directories it has installed. Check this file to verify that the directory was exported to the correct groups.
/etc/hosts SetupExec updates /etc/hosts to add any remote CD-ROM host or tape host names and IP addresses not currently in the database.
Things to Remember When Running SetupExec
Before running SetupExec, be aware of the following: ▲ Run SetupExec in multiuser mode, only by the root user.▲ Auspex does not supply the architecture-dependent executables; purchase the executables from your Sun supplier.
▲ Each architecture-dependent executable uses a variable amount of disk space, depending on the release. The /export file system is installed by default on a partition that allows enough space for about two executables. If you need room for more executables, move /export to a larger partition before running SetupExec. If SetupExec runs out of space trying to install the executables, it generates an error message and terminates.
Recommendation: Installing /export on a nonroot disk allows you to replace the root disk if necessary without having to restore /export.
▲ If the CD-ROM containing the client executables is on a remote host, execute the
mount command on the remote host before running SetupExec on the NetServer:
mount -rt hsfs /dev/sr0 /cdrom
if the remote host is a non-Auspex server, or
mount -rt hsfs /dev/acdn /cdrom
if the remote host is an Auspex server, where n is the slot number for the CD-ROM. ▲ When using either a remote tape or a remote CD-ROM, SetupExec accesses the
remote host using rsh. The hosts file (/.rhosts) on the remote machine must include the name of your NetServer and have the correct root permissions.
▲ Run SetupExec before you run SetupClient. If you add a client with SetupClient and the appropriate architecture-dependent executables are not found, SetupClient generates an error message and terminates.
Running SetupExec
The following procedure describes how to start SetupExec and fill out the SetupExec form: 1. Make sure the system is in multiuser mode. Log in as root.
2. Insert the SUNBIN CD or tape into the appropriate drive. If the SUNBIN medium is a CD-ROM and is installed on a remote host, mount the CD-ROM (see “Things to Remember When Running SetupExec” on page 2-21).
3. Execute SetupExec: # SetupExec
4. The command displays the SetupExec form. Sample forms appear in Figure 2-6, Figure 2-7, Figure 2-8, and Figure 2-9.
Table 2-8 explains the fields in the SetupExec form. In some cases, if you select a certain value for a field, an additional field appears on the form. For example, if you select Remote for “Drive location,” you are prompted for the media host and the host’s IP address. The additional fields are indented in the table.
Note: If you specify a remote tape or a remote CD-ROM drive, you must have root permission on the remote host. To obtain root permission, edit the file
/.rhosts on the remote host, and add an entry in this format:
hostname root
where hostname is the name of the Ethernet interface through which you send requests to the remote host. For example, if your local server is named
“Engineering” and “Engineering-e0” is the interface attached to the network to which the remote host is connected, specify “Engineering-e0 root” in .rhosts.
Table 2-7. Sun system architectures
Application architecture
Kernel
architecture Sun system models supported
sun3 sun3 3/50, 3/60, 3/75, 3/110, 3/140, 3/160, 3/260, 3/280
sun3 sun3x 3/80, 3/470, 3/480
sun4 sun4 4/110, 4/260, 4/280, SPARCsystem 330
sun4 sun4m SPARCstation20, SPARCstation10, SPARCstation5, SPARCclassic
sun4 sun4c SPARCstation 1 (4/60), SPARCstation 1+ (4/65), SPARCstation 2 (4/75), SPARCstation SLC (4/20), SPARCstation IPC (4/40), SPARCstation IPX (4/50), SPARCstation ELC (4/25)
Figure 2-6. Sample SetupExec form for a local tape device
Figure 2-8. Sample SetupExec form for a remote tape device
Table 2-8. The SetupExec form fields
Field Description
Architecture type Architecture to install (for example, sun4, aushp). For further explanation of application architecture, see the arch(1) man page orTable 2-7.
SunOS version The SunOS version to install (for example, 4.1.3, 4.1.3_U1, 4.1.4). Path to executables Path name of the directory in which to install the application
executables. When SetupExec is complete, mount this directory as /usr by the diskless SunOS clients of architecture specified by “Architecture type.”
Path to kernel executables Path name of the directory in which to install the kernel-specific executables. When SetupExec is complete, mount the path to executables as /usr/kvm by the diskless SunOS clients of the architecture specified by “Architecture type.”
Path to /usr/share files Path name of the directory in which to install the architecture-
independent executables. When SetupExec is complete, this directory is ready to mount as /usr/share by the diskless SunOS clients of the architecture specified by “Architecture type.”
Distribution medium Type of distribution medium; either tape or CD-ROM.
Drive location Location of the tape or CD-ROM drive. Local for a drive on the server, or Remvhote for a drive on a remote host.
Tape device name or CD- ROM device name
Tape or CD-ROM device name and slot number (for example, acd1 for the Auspex CD-ROM drive in slot 1, or rast9 for the Auspex tape drive in slot 9).
Media host Host name of the machine with the tape or CD-ROM drive. This field appears only if “Drive location” is Remote.
IP Addr IP address of media host. This field appears only if “Drive location” is
Remote.
Mount point of CD-ROM Path name of the directory on the host on which the CD-ROM drive is mounted. This field appears only if distribution medium is CD-ROM. The default mount point is /cdrom. If drive location is Local,
SetupExec automatically executes this mount command:
mount -rt hsfs /dev/MEDIA_NAME /cdrom
If drive location is Remote, execute mount on the remote host as follows before running SetupExec:
mount -rt hsfs /dev/sr0 /cdrom
if the remote host is a non-Auspex machine, or
mount -rt hsfs /dev/acdn /cdrom
5. After you fill in all the fields in the SetupExec form, execute the form by typing Ctrl-F. The system displays messages similar to the following, which shows sun4c
executables being loaded:
SetupExec: reading distribution CD-ROM...
Extracting the SunOS 4.1.3 sun4c "root" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "usr" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Kvm" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Install" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Networking" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "System_V" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Sys" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "SunView_Users" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "SunView_Demo" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Text" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "Demo" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "OpenWindows_Users" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "OpenWindows_Demo" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "OpenWindows_Fonts" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "User_Diag" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "Manual" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "TLI" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "RFS" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "Debugging" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "SunView_Programmers" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "Shlib_Custom" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Graphics" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "uucp" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Games" CD-ROM file. Extracting the SunOS 4.1.3 sun4c "Security" CD-ROM file.
Extracting the SunOS 4.1.3 sun4c "OpenWindows_Programmers" CD-ROM file.
SetupClient
Figure 2-10 is a flowchart describing the procedure for configuring client information on the server using SetupClient.
Figure 2-10. Configure client information on the server using SetupClient
Do you want server to boot diskless clients?
Change /etc/ethers, /etc/hosts, and /bootparams on the NIS master server.
Run SetupExec yet? Run SetupExec.
Is server an NIS slave?
Update NIS database by /var/yp/make on the NIS master server.
Run SetupClient. Yes No Do nothing. No Yes No