NAME [Toc] [Back]
set_parms - set system initial identity parameters: hostname,
date/time, root password, and networking
SYNOPSIS [Toc] [Back]
DESCRIPTION [Toc] [Back]
The set_parms command is an interactive system set-up 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 hostname
+ timezone 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 hostname set when the system wakes up. This causes
set_parms to step through all of its sub-areas 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 sub-area (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(1M) 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
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: Sep 2004
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 hostname 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 set-up 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
Options [Toc] [Back]
Each sub-area of set_parms is described below. In a first-boot
situation all of the sub-areas are run sequentially. Special firstboot
behavior is noted below if applicable, along with any special
cases when invoking set_parms on a running system. When calling a
sub-area directly, only a unique portion of the sub-area name is
required to be given; for example, set_parms h.
hostname Set the system hostname: Validates a user-supplied
hostname according to host-naming conventions and sets
various system initialization variables to operate with
that hostname. Particularly, set_parms edits
/etc/hosts to associate the new hostname with the
current IP address of the system, if that can be
determined. Note: It does not notify DNS (Domain Name
Servers), etc. This higher level of configuration is
handled later by broader configuration tools.
First-boot: Also allows the user to specify a DHCP
server from which to get hostname and networking
parameters, then confirms the information.
WARNING: When changing the hostname, set_parms does not
know about optionally-installed software. If any such
software remembers the previous hostname, it might not
work properly after the hostname is changed.
A mechanism is provided that helps generalize the
hostname-changing function. The set_parms command
calls, in ls(1) sorted order, any executable commands
found in the directory /sbin/ch_hostname.d. This
occurs for both first-boot and non-first-boot calls.
HP may in the future supply special commands in this
location. The system administrator may also supply
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: Sep 2004
custom commands (programs or scripts) for site
installations using, for example, Ignite-UX.
The system must be rebooted for any change to take full
timezone Select a timezone based on your country of location.
Also allows you to set a user-supplied timezone. The
system must be rebooted for any change to take effect.
date_time Set the system date and time interactively: This is
similar to calling date(1) as a privileged user, but
without having to format a time specification string.
The change takes effect immediately.
ip_address Set or change the primary IP address for the system:
This function edits the /etc/hosts file to associate
the new IP address with the current hostname. Note:
It does not notify DNS (Domain Name Servers), etc.
This higher level of configuration is handled later by
broader configuration tools.
First-boot: Also lets you pick the LAN interface
(network interface card, or NIC) to set up for this and
subsequent networking functions.
Non-first-boot: In multiple-LAN systems, set_parms
assumes the IP address to change is the one for the
lowest-numbered IP address / LAN Interface Card dataset
in the /etc/rc.config.d/netconf file.
The system must be rebooted for any change to take
addl_netwrk Set the subnet mask (which defines the network and
local subnet portions of a network address), set the
default routing gateway, and define access to the
Domain Name System (DNS) and Network Information
First-boot: These changes take effect immediately,
without a reboot, because set_parms starts networking
after setting the parameters.
Non-first-boot: A reboot is required for all of these
changes to take effect.
set_parms and Ignite-UX / Cold Install
After "cold-installing" HP-UX from tape, CD-ROM, or DVD, or using
Ignite-UX to install HP-UX from any source including an install
server, the file /tmp/install.vars is normally left on the system.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: Sep 2004
This file is used to communicate to set_parms and other tools the
hostname, networking, and other information that was used during the
installation, to make it easier to use any of these values as final
system parameters. In particular, set_parms uses as defaults the
shell-style variables in this file that begin with INST_. For
example, INST_LAN_DEV indicates which LAN interface was used during a
network cold install. This is the LAN interface that set_parms
In general, set_parms first looks in /tmp/install.vars for default
information, then in the system configuration files in the
/etc/rc.config.d directory. If any parameter is defined in both
locations, the latter takes precedence.
If Ignite-UX is installed on your system, see the manual entries for
ignite(5) and instl_adm(4). In particular, read instl_adm(4) for
descriptions of the is_net_info_temporary, run_setparms, and final
Native Language Support (NLS) [Toc] [Back]
The set_parms command supports all of the standard HP-supplied
languages. In first-boot situations, the language set_parms uses is
dictated by either geocustoms(1M) or the LANG parameter as set in
/etc/rc.config.d/LANG. The geocustoms command, if called by
set_parms, allows you to pick both a "system set-up" language (the
language of the system administrator setting up the system, for use by
the user interface), and a "system default" language (the language of
the end user).
The set_parms command uses the "system set-up" language as picked
within geocustoms, unless the system default language is set to an
Asian language. In this case, it uses the Asian language (from the
file /etc/rc.config.d/LANG), since geocustoms itself does not provide
an Asian language user interface.
Interaction with auto_parms and geocustoms [Toc] [Back]
During the boot-up sequence, /sbin/rc always invokes auto_parms, which
in turn detects the first-boot situation and the need to run
geocustoms (note, these are independent conditions). It calls
set_parms if either or both of these conditions are true. The
set_parms command first sets up an X-windows environment if the system
console is on a graphics display, then calls geocustoms if necessary.
If geocustoms is called, after it finishes, and always in a first-boot
situation, set_parms starts its interface and, based on user input,
might call back into auto_parms to obtain and set up the management of
a DHCP lease. After set_parms completes this and other system set-up
tasks, control passes back to /sbin/rc, which completes the boot-up
sequence using the newly-created system initial identity parameters.
EXAMPLES [Toc] [Back]
See /sbin/rc for invocation context in the first boot case.
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: Sep 2004
FILES [Toc] [Back]
The command itself.
Common subroutines used by set_parms and the sub-area commands.
Directory holding all of sub-area commands called by set_parms,
which runs them in sorted order.
Directory containing any hostname-change commands defined by the
user. These are standalone commands run, in sorted order, by
set_parms when setting or changing the hostname.
File left by Ignite-UX / Cold Install that contains networking
and other system information used during the installation.
System configuration files modified by set_parms.
AUTHOR [Toc] [Back]
The set_parms command was developed by HP.
SEE ALSO [Toc] [Back]
auto_parms(1M), geocustoms(1M), dhcpdb2conf(1M), instl_adm(4),
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: Sep 2004 [ Back ]