*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> set_parms (1m)              


 set_parms(1M)                                                 set_parms(1M)

 NAME    [Toc]    [Back]
      set_parms - set system initial identity parameters:  hostname,
      date/time, root password, and networking

 SYNOPSIS    [Toc]    [Back]
      set_parms initial
      set_parms hostname
      set_parms timezone
      set_parms date_time
      set_parms ip_address
      set_parms addl_netwrk

 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

 set_parms(1M)                                                 set_parms(1M)

      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

 set_parms(1M)                                                 set_parms(1M)

                     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
                     Service (NIS).

                     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

 set_parms(1M)                                                 set_parms(1M)

      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

 set_parms(1M)                                                 set_parms(1M)

 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 ]
 Similar pages
Name OS Title
date Linux print or set the system date and time
perlfaq9 IRIX Networking ($Revision: 1.17 $, $Date: 1997/04/24 22:44:29 $)
perlfaq9 OpenBSD Networking ($Revision: 1.6 $, $Date: 2003/12/03 03:02:45 $)
mdSetStartPoint IRIX Define initial MIDI-stamp and UST time values
gettimeofday64 Tru64 Gets and sets date and time and converts time between timeval and timeval64
ftime Tru64 Gets and sets date and time and converts time between timeval and timeval64
TIMEVAL32TO64 Tru64 Gets and sets date and time and converts time between timeval and timeval64
gettimeofday Tru64 Gets and sets date and time and converts time between timeval and timeval64
settimeofday Tru64 Gets and sets date and time and converts time between timeval and timeval64
settimeofday64 Tru64 Gets and sets date and time and converts time between timeval and timeval64
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service