instl_adm(1M)

NAME

instl_adm − maintain network install configuration and default parameters

SYNOPSIS

instl_adm [-d] [-F filesystem|LIF-vol] [-h hostname] [-s SD-server[:depot-dir]] [-g gateway] [-m netmask] [-t install-tftp-server] [-a msg-file|-]

instl_adm [-d] [-c] [-f config-file] [-F filesystem|LIF-vol]

instl_adm -T [-f config-file]

instl_adm [-b] [-F filesystem|LIF-vol]

DESCRIPTION

instl_adm is used on a network install boot server to set, modify, or display the default parameters used when a client connects to the server to install the HP-UX operating system. instl_adm can be used to specify the network parameters using the -h -s -g -m -t options. An informative message can be given to install users by using the -a option. More complex configuration parameters can be stored in a config-file and applied or tested by using the -f and -T options. (See instl_adm(4) for details on the syntax of config-file).

Options

instl_adm recognizes the following options:

−d Display the current configuration. The format of this information is described in the instl_adm(4) man page.

The standard-output resulting from the -d option can be stored in a file, edited, and re-applied using the -f option.

−F filesystem|LIF-vol
Specifies that instl_adm should modify/display the configuration as stored in filesystem or LIF-vol. See FILES below for the default file system file that instl_adm operates on. If filesystem or LIF-vol is a file system image, instl_adm will save the configuration in the first 8KB of that image. If the file is a LIF volume (like a bootable tape image), and the -c option is not given, then instl_adm will operate on the first 8KB of the LIF file named INSTALLFS. If the file is a LIF file and the -c option is given, then the LIF file named CONFIG will be operated on in totality.

−h hostname Specifies the default hostname to be supplied to the install user for his or her system during a network install. The IP address of the hostname given is determined and stored along with the hostname. If hostname is given as an IP address, then the hostname is looked up and stored as the default. Use this option only if a specific hostname and Internet address is reserved for install purposes. This should be a temporary Internet address used only during installs. Once the install client has its system installed, it must be assigned its own unique Internet address.

Supplying this default is not recommended if multiple installs are to be done simultaneously because only one active host can occupy a given Internet address at any given time.

−s SD-server[:depot-dir]
Specifies the default Software Distributor server and depot directory that is to be used during the install as the source for the swinstall(1M) command. The SD-server must have the HP-UX operating system loaded into depot-dir using the swcopy(1M) command prior to attempting an installation.

If either the SD-server or depot-dir element of the source is omitted, then the previously set element (if any) will be retained.

−g gateway Specifies the default Internet address for the gateway system through which the client system can reach the install-tftp-server and the SD-server system (see route(1M)).

If no default gateway is given, then the default will be the same as the client host’s IP address, in which case wild-card routing will be performed (on networks that support it).

−m netmask Specifies the default netmask for the client system to use in reaching the install and SD server systems. This is necessary if your network uses sub-networks. The netmask is the same as that supplied to the ifconfig command (see ifconfig(1M)). netmask can be supplied either in dot-notation (for example, 255.255.248.0) or as a hexadecimal number with a leading 0x (such as, 0xfffff80).

−t install-tftp-server
Specifies the default system to be used as the install server. The install-tftp-server is normally the same as system that is being used as the boot-server (which is normally the same as the system on which instl_adm is run). install-tftp-server is a system that has the HPUX-Install.FILE-SERV-HPPA fileset loaded and that is configured with tftp(1) access to the files listed under FILES .

−a msg-file|- instl_adm stores the contents of msg-file for use as the opening message displayed to users doing an install. If this option is omitted, the current message (if any) is kept. To remove the message completely, simply use an empty file such as /dev/null as the msg-file. If the − character is given for msg-file, then instl_adm will prompt the user to enter the message on the command line. Once the message is entered, Ctrl-D (end-of-file) should be typed to end the message.

If the message given contains any double-quote characters (") then they must be preceded by the back-slash (\) character. (i.e. \"hello\"). A message with non-escaped double-quote characters will cause syntax errors.

−c Causes instl_adm to operate on the LIF file named CONFIG instead of the first 8KB of the file named INSTALLFS. This option is only valid when the -F option is used to instruct instl_adm to operate on an install tape image. The install tape image is a logical interchange format file (See lif(4)).

The CONFIG file is where the standard configuration as shipped by Hewlett-Packard is kept. This file defines the default file system and software configuration that is selectable during an install. See FILES below for the location of this file on a network install server.

Hewlett-Packard does not support modifications of the standard configuration file.

−T Test for proper syntax of standard configuration files, or of the configuration file given with the -f option. See FILES below for the location of the standard configuration files.

−b Blanks (or clears) any previous configuration values set.

EXAMPLES

Display the current message and defaults:

instl_adm -d

Change the message to the contents of file new-message while leaving the current network defaults in place:

instl_adm -a new-message

Install new default parameters for the SD server and depot directory as well as a default gateway and netmask. The −d option will cause the information to be displayed after installation:

instl_adm -d -s jupiter:/depot -g 15.1.48.1 -m255.255.248.0

Extract the current default configuration, edit it, and then reinstall the new configuration:

instl_adm -d > /tmp/cfg
vi /tmp/cfg
instl_adm -f /tmp/cfg

Make a customized cold-install tape that gives a message to the user. This uses dd to extract the tape data, instl_adm to modify it, and then dd to write a new tape.

mt -t /dev/rmt/0m rew
dd if=/dev/rmt/0m of=/tmp/tape.image bs=2k
instl_adm -F /tmp/tape.image -a msg-file
mt -t /dev/rmt/0m rew
dd if=/tmp/tape.image of=/dev/rmt/0m bs=2k

FILES

/usr/lib/sw/hpux.install/700INSTALLFS
File system used by Series 700 install clients. Configuration information available at client boot-time is stored in the first 8KB of this file. This is the default file instl_adm modifies.

/usr/lib/sw/hpux.install/700INSTALL
The kernel booted by Series 700 install clients.

/usr/lib/sw/hpux.install/config.local
Holds the configuration that resulted from the installation of the server itself. This configuration is provided to clients as a way of matching that of the server. The information in this file will become out of date with respect to the server as software is added/deleted and as new file systems are created. This file may be customized to provide an easy way to pick a system configuration for your specific application. (see instl_adm(4)).

/usr/lib/sw/hpux.install/config
Holds the default configuration information provided by Hewlett-Packard. Modification of this file is not recommended or supported. Any modifications will be lost if the HPUX-Install product is re-loaded. Customizations should be restricted to the config.local file.

Museum

Related Articles