HP-UX Reference (11i v2 04/09) - 1M System Administration Commands N-Z (vol 4)

s
set_parms(1M) set_parms(1M)
NAME
set_parms - set system initial identity parameters: host name, date, time, root password, networking
SYNOPSIS
set_parms initial
set_parms hostname
set_parms timezone
set_parms date_time
set_parms ip_address
set_parms addl_netwrk
DESCRIPTION
The set_parms command is an interactive system setup command that allows you to specify various
"initial identity parameters" when first booting a newly installed operating system (whether preinstalled,
or installed locally from media or an install server), and to revise these parameters later on a running
system. Initial identity parameters are a minimal set of values required to bring a system to an initially
useful state. They include the following:
• system host name
• time zone for the system’s location
• date and time
• root password
• IP address
• netmask, default routing, DNS, and NIS information
In a first-boot situation,
set_parms is invoked automatically by
/sbin/auto_parms.For
set_parms purposes, "first boot" is defined as having no host name set when the system wakes up. This
causes set_parms to step through all of its subareas to help you set all of the initial identity parame-
ters.
After the system has booted and is running,
set_parms may also be called from the command line to
step through all areas (via set_parms initial), similar to how it works at first boot, or to finish set-
ting up a particular subarea (the latter forms above). There are certain limitations to its actions when it’s
run after first boot, as described see below.
Note: The
set_parms command only sets the root (superuser) password during "initial" processing,
and then only if it is not already set. If so, it uses the passwd (1) command, so the effect is immediate.
The
set_parms command has two available user interfaces: Graphical and terminal-based. At first
boot, the graphical interface is used if the system console is a graphics device, otherwise a terminal inter-
face is used. If set_parms is invoked later on a running system, the graphical interface is used if and
only if the DISPLAY parameter is set in the user’s environment and an X server can be contacted at the
host referenced in the DISPLAY variable. If run under CDE, set_parms should automatically select
the graphical interface.
The
set_parms command is also DHCP-aware. If you attempt to change DHCP-supplied data such as
the host name or IP address, set_parms issues a warning. If you continue with the changes,
set_parms relinquishes the DHCP lease. On first boot, set_parms asks if you would like like to try
getting setup data from a DHCP server.
However invoked, the
set_parms command often knows and provides default values for many of the
initial identity parameters, based on values specified to Ignite-UX in a previous or recent installation of
the system or found in system configuration files.
The
set_parms command can be run only by the user with appropriate privilege.
Operands
Each subarea of
set_parms is described below. In a first-boot situation, all of the subareas are run
sequentially. Special first-boot behavior is noted below if applicable, along with any special cases when
invoking set_parms on a running system. When calling a subarea directly, only a unique portion of the
subarea name is required to be given; for example, set_parms h.
initial
Step through all the following operands.
hostname
Set the system host name: Validates a user-supplied host name according to host-naming conven-
tions and sets various system initialization variables to operate with that host name. Particularly,
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 1M−−757