HP-UX Reference (11i v2 07/12) - 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 "ini-
tial 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 parameters.
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 setting 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 interface 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 refer-
enced 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 ini-
tial 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 conventions
and sets various system initialization variables to operate with that host name. Particularly,
HP-UX 11i Version 2: December 2007 Update − 1 − Hewlett-Packard Company 321