instl_adm(1M)

NAME

instl_adm − maintain network install message and default parameters

SYNOPSIS

/etc/instl_adm [-S series] [-F filesystem-kernel] [-f message-file] [-h default-host-IP] [-s default-server-IP] [-p default-netdist-port] [-g default-gateway-IP] [-m default-netmask]
/etc/instl_adm -d [-S series] [-F filesystem-kernel]

DESCRIPTION

instl_adm is executed on a network install boot server system to set or modify the current message and default network parameters used when a client connects to the server to install the HP-UX operating system.

During an HP-UX system installation over a network, the contents of message-file are displayed immediately before the user is asked questions about the network to which he or she is connected. The questions that follow the message can also be assigned default answers using instl_adm.

Options

instl_adm recognizes the following options:

−S series Specifies what series client system the changes apply to. series can be any one of 300, 400, or 700. (300 and 400 are synonymous.) The series value specified is independent of the series of server system on which instl_adm is executed.

−F filesystem-kernel
The informative message and configurable network defaults are stored in filesystem-kernel. If the filesystem-kernel is not located in the standard place based on the series type (see FILES below), use the −F option to specify the file path, in which case the −S option is not required.

Either the −S or the −F option must be specified.

−f message-file instl_adm stores the contents of message-file for use as the opening message displayed to users doing a network 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 message-file. Maximum message size is 1024 bytes. To fit on a standard terminal screen, the message should contain not more than 24 lines.

−h default-host-IP
Specifies the default Internet host address to be supplied to the install user for his or her system during a network install. Use this option only if a specific 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 have 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.

default-host-IP cannot be a hostname. It must be a legal Internet address in dot notation such as 15.2.56.1 (see hosts(4)).

−s default-server-IP
Specifies the default Internet address of a server running netdistd from which software should be loaded during a network install. As with default-host-IP, default-server-IP cannot be a hostname.

−p default-netdist-port
Specifies the default port number that the install client should use to connect to the server running netdistd (see netdistd(1M)).

−g default-gateway-IP
Specifies the default Internet address for the gateway system through which the client system can reach the netdist server system (see route(1M)). If a gateway is not required, use the keyword none for the value of default-gateway-IP. As with default-host-IP, default-gateway-IP cannot be a hostname.

−m default-netmask
Specifies the default netmask for the client system to use to reach the netdist server system. This is necessary if your network uses sub-networks. The netmask is the same as that supplied to the ifconfig command (see ifconfig(1M)). default-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). If sub-networks are not used and the default netmask provided by ifconfig is sufficient, use the keyword none for the value of default-netmask.

WARNING: Specifying any of the options −h, −s, −p, −g, or −m each of which sets a default network value causes all of the default values to be updated. It is not possible to change one of the values without affecting the others. If any of the options −h, −s, −p, −g, or −m is specified and any other is not, the default value controlled by the latter is deleted.

−d Display current message and default network values.

EXAMPLES

Display the current message and defaults used for serving Series 700 clients:

instl_adm -d -S700

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

instl_adm -S700 -f new-message

Replace all the default network values with those given on the command line, except delete the default-host-IP value, while leaving the current message in place:

instl_adm -S700 -s15.2.40.18 -p2106 -g none -m255.255.248.0

FILES

/usr/lib/uxinstfs.300
Kernel and file system used by Series 300/400 install clients. The message and defaults for Series 300/400 are kept in this file.

/usr/lib/uxinstkern.700
Kernel and file system used by Series 700 install clients. The message and defaults for Series 700 are kept in this file.

Museum

Related Articles