sysinfo.4 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

sysinfo(4) sysinfo(4)

(Itanium(R)-based System Only)

NAME

sysinfo - ﬁle for setting system information parameters, used with drd rehost

SYNOPSIS

/EFI/HPUX/SYSINFO.TXT

DESCRIPTION

When present, the SYSINFO.TXT ﬁle is used during the boot of an Itanium-based system to set system

hostname, IP address, timezone, DNS domain, and other system and networking parameters. Support for

the SYSINFO.TXT ﬁle is not provided for PA-RISC systems.

The ﬁle must be located in the EFI/HPUX directory of the EFI (Extensible Firmware Interface) partition

of a boot disk. The ﬁle is copied to the EFI partition using the

drd rehost command.

Processing of the

SYSINFO.TXT ﬁle by /sbin/auto_parms

, delivered by the

SystemAdmin.FIRST-BOOT

ﬁleset, during the

rc step of the boot of HP-UX 11i v3 was introduced for

11iv3 (11.31) by PHCO_36525.

When the

SYSINFO.TXT ﬁle is not present, the usual determination for displaying the

FIRST-BOOT

interactive interface is made. See auto_parms (1M) and set_parms (1M).

If a required parameter in the

SYSINFO.TXT

ﬁle is missing or incorrect, or if the parameter

SYSINFO_INTERACTIVE

in the ﬁle is set to ALWAYS, the FIRST-BOOT interactive interface is

displayed.

Messages generated when the

SYSINFO.TXT ﬁle is processed are recorded in

/etc/auto_parms.log

After processing, the

SYSINFO_PROCESSED

ﬁeld is set to TRUE in the ﬁle. This prevents the

SYSINFO.TXT ﬁle from being processed on subsequent boots of the same disk.

SYSINFO.TXT File Syntax

The ﬁle supports full-line comments, indicated by a

# in column 1.

Parameters may be entered in any order in the ﬁle. If a parameter is listed multiple times, the last

occurrence is used.

Each parameter must have the form:

PARAMETER_NAME=PARAMETER_VALUE

Some parameters are set once for the entire system. Array parameters (those ending in [n] for a non-

negative integer n) are set for their corresponding network interfaces.

In general, the parameters set for the entire system are not required and default to the value already

present on the system.

The exception is SYSINFO_HOSTNAME

, which must be speciﬁed unless SYSINFO_INTERACTIVE is set

ALWAYS. (See below for acceptable values of SYSINFO_HOSTNAME

In contrast, the network interface parameters for the target system must be speciﬁed. Pre-existing net-

work interface information on the system will be removed. For example,

/etc/rc.config.d/netconf is returned to its newconfig status before processing the parameters

in SYSINFO.TXT.

Parameters Set for the Entire System

SYSINFO_DNS_DOMAIN

Default The Domain Name System domain setting on the system is not changed.

Status Optional

Value The name of the Domain Name System domain.

SYSINFO_DNS_SERVER

Default The Domain Name System setting on the system is not changed.

Status Optional

Value The Domain Name System server, speciﬁed as an IP address in decimal-dot notation (e.g.

192.1.2.3).

SYSINFO_HOSTNAME

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
sysinfo(4) sysinfo(4) (Itanium(R)-based System Only) NAME sysinfo - file for setting system information parameters, used with drd rehost SYNOPSIS /EFI/HPUX/SYSINFO.TXT DESCRIPTION When present, the SYSINFO.TXT file is used during the boot of an Itanium-based system to set system hostname, IP address, timezone, DNS domain, and other system and networking parameters. Support for the SYSINFO.TXT file is not provided for PA-RISC systems.
PAGE 2
sysinfo(4) sysinfo(4) (Itanium(R)-based System Only) Default The SYSINFO_HOSTNAME parameter has no default. SYSINFO_INTERACTIVE is not set to ALWAYS. Status The SYSINFO_HOSTNAME parameter is required. Value The value of the hostname * * * * It must be specified when must consist of the characters: [a-z] [A-Z] [0-9] [-,_] must not begin with a digit, however each dot (.
PAGE 3
sysinfo(4) sysinfo(4) (Itanium(R)-based System Only) Status of Network Interface Parameters If no network interface is included in SYSINFO.TXT, the FIRST-BOOT interactive interface will be displayed. The minimum index is 0 and the maximum index is 1023. An index need not align with the expected instance number of the network interface. For example, index 1 can be used to specify an interface which may, upon boot, appear as lan2.
PAGE 4
sysinfo(4) sysinfo(4) (Itanium(R)-based System Only) Status The SYSINFO_LAN_HW_PATH must be specified for any interface for which SYSINFO_MAC_ADDRESS is not supplied. If both parameters are set for a given index, SYSINFO_MAC_ADDRESS takes precedence over SYSINFO_LAN_HW_PATH. Value A hardware path, specified by non-negative integers separated by forward slashes (/). SYSINFO_IP_ADDRESS[n] Default Status None.
PAGE 5
sysinfo(4) sysinfo(4) (Itanium(R)-based System Only) To supply a file that will NOT use DHCP to configure a system with the single network interface with MAC address 0x0017A451E718, specify SYSINFO_HOSTNAME as well as the required and optional static values for the network interface: SYSINFO_HOSTNAME=myhost SYSINFO_DHCP_ENABLE[0]=0 SYSINFO_MAC_ADDRESS[0]=0x0017A451E718 SYSINFO_IP_ADDRESS[0]=192.2.3.4 SYSINFO_SUBNET_MASK[0]=255.255.255.0 SYSINFO_ROUTE_GATEWAY=192.2.3.
PAGE 6
(Notes) A (Notes) sA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010