instl_adm(1M)

NAME

instl_adm − Maintain the network install message and default parameters.

SYNOPSIS

Call to change the install message and/or default parameters.

instl_adm −S Series(700|300/400) [−f message-file] [−h default-host-IP] [−s default-server-IP] [−p default-netdist-port] [−g default-gateway-IP] [−m default-netmask]

Call to display the current message and default parameters.

instl_adm −S Series(700|300/400) −d

DESCRIPTION

instl_adm can be used on a network install boot server to set or replace the current message and default network parameters. The message and default parameters are used when a client connects to the install boot server and attempts to install HP-UX.

During an HP-UX installation via network, the contents of message-file will be displayed immediately before the user conducting the network install is asked questions pertaining to the network he/she is connected to. The network related questions that follow the message can also be assigned default values by running instl_adm on the install boot server prior to attempting a network install of HP-UX.

Specifying any of the options to set the default network values, (−h −s −p −g −m), will cause all the default values to be updated. This means that it is not possible to change just one of those values without effecting the others. If a particular default value was set with a previous invocation of instl_adm and that same option is not specified on the next invocation, that value will be deleted. Therefore if you wish to change any default value, you must specify all defaults desired.

Options

−S Series Can be one of 700, 300, or 400 (300 and 400 have identical effects). Specifies which machine series that the operations should apply to. This argument is necessary because an install server can serve install requests to Series 700, 300, and 400 clients. Series is not related to the series of the install server on which instl_adm is executed.

−f message-file
The contents of message-file will become the message displayed to a user doing an install just before the user is asked questions pertaining to the network he/she is installing on. If this option is omitted, the current message (if any) is kept. If a message-file is given with no other options (other than −S), the current network defaults are kept, and just the message is updated. To remove a message completely, simply use an empty file as the message-file. The maximum size of a message is 1024 bytes, but it is also important to limit the message to less than 24 lines for appearance.

−h default-host-IP
This option should be used only if a specific internet address has been reserved for install purposes. Setting this value will cause default-host-IP to be supplied to the install user as a default internet host address for his/her machine during a network install. This should be a temporary internet address that is to be used only during installs. Once the install client has been installed, it must have it’s own uniq internet address. Supplying this default is not recommended if more than one install will be done at the same time, since there cannot be more than one active host sharing the same internet address. default-host-IP cannot be a hostname, it must be a legal internet address in dot notation (eg. ’15.2.56.1’). (See hosts(4)).

−s default-server-IP
This specifies the default internet address of a server running netdistd which should be use to supply the software during a network install. default-sever-IP cannot be a hostname, it must be a legal internet address in dot notation (eg. ’15.2.56.1’). (See hosts(4)).

−p default-netdist-port
This specifies the default netdistd port number that the install client must use to connect to the netdistd server, (See netdistd(1M)).

−g default-gateway-IP
If a gateway is needed for the install client to reach the netdistd server, then this option can be used to supply a default internet address for that gateway, (See route(1M)). If a gateway will not be needed, the keyword none can be used as the default to indicate this fact. default-gateway-IP cannot be a hostname, it must be a legal internet address in dot notation (eg ’15.2.56.1’), or the word none. (See hosts(4)).

−m default-netmask
If your network uses sub-networks, then it may be necessary for the install client to use a netmask in order to connect to the netdistd server. This netmask is the same as that supplied to the ifconfig(1M) command, (See ifconfig(1M)). This option can be used to supply a default netmask value to the install client. default-netmask can be supplied in either dot-notation or as a hexadecimal number with a leading 0x (eg. 255.255.248.0 or 0xfffff80). If sub-networks are not used, and the default netmask that ifconfig(1M) provides is sufficient, then the keyword none can be used to indicate this fact.

−d This option can be used only with the −S flag. This option will read and display the current message and defaults.

EXAMPLES

For example, the following command can be used to read the current message and defaults used for serving Series 700 clients.

instl_adm -S700 -d

The next command would change the message (to what is in new-message while leaving the current network defaults in place.

instl_adm -S700 -f new-message

The next command would replace all the default network values with those given on the command line, while leaving the current message in place.

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

FILES

/usr/lib/uxinstkern.700 Kernel and filesystem used by series 700 install clients. The message and defaults for series 700 are wrapped inside this file.

/usr/lib/uxinstfs.300 Filesystem used by series 300 and 400 install clients. The message and defaults for series 300 and 400 are wrapped inside this file.

Museum

Related Articles