Unix/Linux Go Back    

OpenSolaris 2009.06 - man page for sysidcfg (opensolaris section 4)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

sysidcfg(4)				   File Formats 			      sysidcfg(4)

       sysidcfg - system identification configuration file

       When a diskless client boots for the first time or a system installs over the network, the
       booting software tries to obtain configuration information about the system, such  as  the
       system's  root  password  or  name service, from, first, a sysidcfg file and then the name
       service databases. If the booting software cannot find the  information,  it  prompts  the
       user  for  it. Like the name service databases, the sysidcfg file can be used to avoid the
       user prompts and provide a totally hands-off booting process.

       The sysidcfg file preconfigures information through a set of keywords. You can specify one
       or  more of the keywords to preconfigure as much information as you want. Each set of sys-
       tems (one or more) that has unique configuration information must have  its  own  sysidcfg
       file.  For  example,  you can use the same sysidcfg file to preconfigure the time zone for
       multiple systems if you want all the systems to have the same time zone	configured.  How-
       ever,  if  you  want  to preconfigure a different root password for each of those systems,
       then each system would need its own sysidcfg file.

       If a syntax error (such as an invalid keyword) is detected when reading the sysidcfg file,
       an  error message that notes the position in the file where the error was found is sent to
       the console. Under such a condition, the file is not used.

   Where To Put the sysidcfg File
       The sysidcfg file can reside on a shared NFS network directory or the root directory on	a
       UFS  or	PCFS  diskette	in the system's diskette drive. If you put the sysidcfg file on a
       shared NFS network directory, you have to use the -p option of the  add_install_client(1M)
       command (see install_scripts(1M)) to specify where the system being installed can find the
       sysidcfg file. If you put the sysidcfg file on a diskette,  you	need  to  make	sure  the
       diskette  is  in  the  system's	diskette drive when the system boots (on x86 systems, the
       sysidcfg file should reside on the Solaris Device Configuration Assistant diskette).

       Only one sysidcfg file can reside in a directory or diskette. If  you  are  creating  more
       than one sysidcfg file, they must reside in different directories or diskettes.

   Keyword Syntax Rules
       The following rules apply to the keywords in a sysidcfg file:

	   o	  Keywords can be in any order

	   o	  Keywords are not case-sensitive

	   o	  Keyword values can be optionally enclosed in single (') or double (") quotes

	   o	  Only	the first instance of a keyword is valid; if you specify the same keyword
		  more than once, the first keyword specified is used. The network_interface key-
		  word is exempt from this rule.

   Keywords - All Platforms
       The following keywords apply to both SPARC and x86 platforms.

   Name Service, Domain Name, Name Server
       Naming-related keywords are as follows:


       For the NIS and NIS+ keywords, the options are:


       The following is an example NIS entry:

	 {domain_name=west.arp.com name_server=timber(}

       For  NIS+,  the	example  is identical to the one above, except for the replacement of the
       keyword NIS by NIS+.

       For DNS, the syntax is:

	 domain_name=domain_name; name_server=ip_address, ... ;
	 search=domain_name, ...

       You can have a maximum of three IP addresses and six domain names. The total length  of	a
       search entry cannot exceed 250 characters. The following is an example DNS entry:


       For LDAP, the syntax is:


       The proxy_dn and proxy_password keywords are optional. If proxy_dn is used, the value must
       be enclosed in double quotes.

       The following is an example LDAP entry:


       Choose only  one  value	for  name_service.  Include  either,  both,  or  neither  of  the
       domain_name  and  name_server keywords, as needed. If no keywords are used, omit the curly

   NFS version 4 Default Domain Name
       There is only one keyword for specifying the NFSv4 default domain name:

	 nfs4_domain=dynamic, value

       where value must be a fully qualified domain name, as per RFC1033 and RFC1035  recommenda-
       tions.  The  reserved  value  dynamic suppresses the front-end installation prompt. At the
       same time, use of dynamic enables the NFSv4 domain to be derived dynamically, at run time,
       based on naming service configuration.

       For example:


       ...hard	codes  the  value used by the nfsmapid(1M) daemon to be example.com. In contrast,
       the following example shows how to set the nfs4_domain variable to  the	reserved  keyword


       The  preceding  example enables the nfsmapid(1M) daemon to derive the domain from the sys-
       tem's configured naming services, as prescribed in the System Administration  Guide:  Net-
       work Services.

   Network Interface, Hostname, IP address, Netmask, DHCP, Default Route
       Network-related keywords are as follows:

	 network_interface=NONE, PRIMARY, value

       where value is a name of a network interface, for example, eri0 or hme0.

       For the NONE keyword, the options are:


       For example,

	 network_interface=NONE {hostname=feron}

       For the PRIMARY and value keywords, the options are:

	 primary (used only with multiple network_interface lines)
	 protocol_ipv6=yes | no
	 default_route=ip_address (IPv4 address only)

       If  you are using the dhcp option, the only other option you can specify is protocol_ipv6.
       For example:

	 network_interface=PRIMARY {dhcp protocol_ipv6=yes}

       If you are not using DHCP, you can specify  any	combination  of  the  other  keywords  as
       needed. If you do not use any of the keywords, omit the curly braces.

	 network_interface=eri0 {hostname=feron

   Multiple Network Interfaces
       If  you have multiple network interfaces on your system, you can configure them all in the
       sysidcfg file by defining multiple network_interface keywords.  If  you	specify  multiple
       network_interface  keywords,  you  cannot use NONE or PRIMARY for values. You must specify
       interface names for all of the values. To specify the primary interface, use  the  primary
       option value.

       For example,

	 network_interface=eri0 {primary

	 network_interface=eri1 {hostname=feron-b

   Root Password
       The   root   password  keyword  is  root_password.  Possible  values  are  encrypted  from
       /etc/shadow. Syntax is:


   Security Policy
       The security--related keyword is security_policy. It has the following syntax:

	 security_policy=kerberos, NONE

       The kerberos keyword has the following options:

	 {default_realm=FQDN admin_server=FQDN kdc=FQDN1, FQDN2, FQDN3}

       where FQDN is a fully qualified domain name. An example of the security_policy keyword  is
       as follows:

	 security_policy=kerberos {default_realm=Yoursite.COM
	 kdc=kdc1.Yoursite.COM, kdc2.Yoursite.COM}

       You can list a maximum of three key distribution centers (KDCs) for a security_policy key-
       word. At least one is required.

   Language in Which to Display the Install Program
       The system-location keyword is system_locale. It has the following syntax:


       where locale is /usr/lib/locale.

   Terminal Type
       The terminal keyword is terminal. It has the following syntax:


       where terminal_type is a value from /usr/share/lib/terminfo/*.

   Timezone Information
       The timezone keyword is timezone. It has the following syntax:


       where timezone is a value from /usr/share/lib/zoneinfo/*or, where timezone is  an  offset-
       from-GMT  style	quoted timezone. Refer to environ(5) for information on quoted timezones.
       An example of a quoted timezone is: timezone="<GMT+8>+8".

   Date and Time
       The time server keyword is timeserver. It has the following syntax:


       If you specify localhost as the time server, the system's time is assumed to  be  correct.
       If  you	specify  the  hostname or ip_address, if you are not running a name service, of a
       system, that system's time is used to set the time.

   Keyboard Layout
       The keyboard keyword is keyboard. It has the following syntax:


       The   valid   keyboard_layout   strings	 are   defined	 in   the   /usr/share/lib/keyta-
       bles/type_6/kbd_layouts file.

   x86 Platform Keywords
       The  following keywords apply only to x86 platforms. For all these keywords, use kdmconfig
       -d to create or append to the sysidcfg file. See kdmconfig(1M).

       Monitor type

	   The monitor--related keyword is monitor. The syntax is:


       Graphics card, color depth, display resolution, screen size

	   The display-related keywords are display, size, depth, and resolution. The syntax is:

	     display=graphics_card {size=screen_size
	     depth=color_depth resolution=screen_resolution}

       Pointing device, number of buttons, IRQ level

	   The mouse-related keywords are pointer, nbuttons, and irq.

	     pointer=pointing_device {nbuttons=number_buttons

       Example 1 Sample sysidcfg files

       The following example is a sysidcfg file for a group of SPARC systems to install over  the
       network.  The  host names, IP addresses, and netmask of these systems have been preconfig-
       ured by editing the name service. Because all the  system  configuration  information  has
       been  preconfigured, an automated installation can be achieved by using this sysidcfg file
       in conjunction with a custom JumpStart profile.

	 name_service=NIS {domain_name=marquee.central.example.com
	      kdc=kdc1.Yoursite.COM, kdc2.Yoursite.COM}

       The following example is a sysidcfg file created for a group of	x86  systems  to  install
       over  the  network  that all have the same keyboard, graphics cards, and pointing devices.
       The device information (keyboard, display, and pointer) was captured from running  kdmcon-
       fig  -d.  See  kdmconfig(1M). In this example, users would see only the prompt to select a
       language, system_locale, for displaying the rest of the Solaris installation program.

	 display=ati {size=15-inch}
	 name_service=NIS {domain_name=marquee.central.example.com

       install_scripts(1M), kdmconfig(1M), nfsmapid(1M), sysidtool(1M), environ(5)

       Solaris Express Installation Guide: Basic Installations

SunOS 5.11				   12 May 2008				      sysidcfg(4)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 07:01 AM.