sysidcfg(4)                                                        File Formats                                                        sysidcfg(4)

NAME

       sysidcfg - system identification configuration file

DESCRIPTION

       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 systems (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. However, if you want to preconfigure a different root password for each of those systems, then each system would need
       its own sysidcfg file.

   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  differ-
       ent 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 will be
            used. The network_interface keyword 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:

       name_service=NIS,NIS+,LDAP,DNS,NONE

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

       domain_name=domain_name
       name_server=hostname(ip_address)

       The following is an example NIS entry:

       name_service=NIS
       {domain_name=west.arp.com name_server=timber(172.16.2.1)}

       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:

       name_service=DNS
       {domain_name=west.arp.com
       name_server=10.0.1.10,10.0.1.20
       search=arp.com,east.arp.com}

       For LDAP, the syntax is:

       domain_name=domain_name;
       profile=profile_name;
       profile_server=ip_address;
       proxy_dn="proxy_bind_dn";
       proxy_password=password

       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:

       name_service=LDAP
       {domain_name=west.arp.com
       profile=default
       profile_server=172.16.2.1
       proxy_dn="cn=proxyagent,ou=profile,dc=west,dc=arp,dc=com"
       proxy_password=password}

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

   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:

       hostname=hostname

       For example,

       network_interface=NONE {hostname=feron}

       For the PRIMARY and value keywords, the options are:

       primary (used only with multiple network_inteface lines)
       dhcp
       hostname=hostname
       ip_address=ip_address
       netmask=netmask
       protocol_ipv6=yes | no
       default_router=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=PRIMARY {dhcp protocol_ipv6=yes}

       If you are not using DHCP, you may 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
            ip_address=172.16.2.7
            netmask=255.255.255.0
            protocol_ipv6=no
            default_route=172.16.2.1}

    Multiple Network Interfaces
       If you have multiple network interfaces on your system, you may configure them all in the sysidcfg file by defining multiple network_inter-
       face 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
            hostname=feron
            ip_address=172.16.2.7
            netmask=255.255.255.0
            protocol_ipv6=no
            default_route=172.16.2.1}

       network_interface=eri1 {hostname=feron-b
            ip_address=172.16.3.8
            netmask=255.255.255.0
            protocol_ipv6=no
            default_route=172.16.3.1}

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

       root_password=encrypted_password

   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
       admin_server=krbadmin.Yoursite.COM
       kdc=kdc1.Yoursite.COM, kdc2.Yoursite.COM}

       You can list a maximum of three key distribution centers (KDCs) for a security_policy keyword. 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:

       system_locale=locale

       where locale is /usr/lib/locale.

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

       terminal=terminal_type

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

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

       timezone=timezone

       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:

       timeserver=localhost
       timeserver=hostname
       timeserver=ip_address

       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.

   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:

           monitor=monitor_type

       Keyboard language, keyboard layout

           The keyboard--language keyword is keyboard. The syntax is:

           keyboard=keyboard_language {layout=value}

       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
           irq=value}

EXAMPLES

       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  net-
       mask  of these systems have been preconfigured by editing the name service.  Because all the system configuration information has been pre-
       configured, an automated installation can be created by using a custom JumpStart profile.

       system_locale=en_US
       timezone=US/Central
       timeserver=localhost
       terminal=sun-cmd
       name_service=NIS {domain_name=marquee.central.example.com
                         name_server=connor(172.16.112.3)}
       root_password=m4QPOWNY
       system_locale=C
       security_policy=kerberos
           {default_realm=Yoursite.COM
            admin_server=krbadmin.Yoursite.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 kdmconfig -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.

       keyboard=ATKBD {layout=US-English}
       display=ati {size=15-inch}
       pointer=MS-S
       timezone=US/Central
       timeserver=connor
       terminal=AT386
       name_service=NIS {domain_name=marquee.central.example.com
                         name_server=connor(172.16.112.3)}
       root_password=URFUni9
       security_policy=none

SEE ALSO

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

       Solaris 10 Installation Guide: Basic Installations

SunOS 5.10                                                          12 Nov 2003                                                        sysidcfg(4)