sysidcfg File Keywords

The following table lists the keywords that you can use to configure system information in the sysidcfg file.

The following sections describe the keywords that you can use in the sysidcfg file.

network_interface Keyword

Use the network_interface keyword to perform the following tasks:

• Specify a host name.

• Specify an IP address.

• Specify a netmask value.

• Use DHCP to configure the network interface.

• Enable IPv6 on the network interface.

The following sections describe how to use the network_interface keyword to configure system interfaces.

Syntax for Nonnetworked Systems

To turn off networking for a system, set the network_interface value to none. For example:

network_interface=none

Syntax for Configuring a Single Interface

You can use the network_interface keyword to configure a single interface in the following ways.

• With DHCP – You can use a DHCP server on your network to configure the network interface. For more information about how to use a DHCP server during your installation, see Preconfiguring System Configuration Information With the DHCP Service (Task Map).

  To use the DHCP server to configure a single interface on the system, use the following syntax for the network_interface keyword:

  network_interface=PRIMARY or value {dhcp protocol_ipv6=yes-or-no}

  PRIMARY

  Instructs the installation program to configure the first up, non-loopback interface that is found on the system. The order is the same order that is displayed with the ifconfig command. If no interfaces are up, then the first non-loopback interface is used. If no non-loopback interfaces are found, then the system is nonnetworked.

  ---

  Note –

  Do not use the PRIMARY keyword value if you want to configure multiple interfaces.

  ---

  value

  Instructs the installation program to configure a specific interface, such as hme0 or eri1.

  protocol_ipv6=yes-or-no

  Instructs the installation program to configure the system to either use IPv6 or to not use IPv6.

• Without DHCP – If you do not want to use DHCP to configure the network interface, you can specify the configuration information in the sysidcfg file. To instruct the installation program to configure a single interface on the system without using DHCP, use the following syntax:

  network_interface=PRIMARY or value {hostname=host-name default_route=ip-address ip_address=ip-address netmask=netmask protocol_ipv6=yes-or-no}

  PRIMARY

  Instructs the installation program to configure the first up, non-loopback interface that is found on the system. The order is the same as the order that is displayed with the ifconfig command. If no interfaces are up, then the first non-loopback interface is used. If no non-loopback interfaces are found, then the system is notnetworked.

  ---

  Note –

  Do not use the PRIMARY keyword value if you want to configure multiple interfaces.

  ---

  value

  Instructs the installation program to configure a specific interface, such as hme0 or eri1.

  hostname=host-name

  (Optional) Specifies the host name of the system.

  default_route=ip-address or NONE

  (Optional) Specifies the IP address of the default router. If you want the installation program to detect the router by using the ICMP router discovery protocol, omit this keyword.

  If the installation program cannot detect the router, you are prompted for the router information during the installation.

  ip_address=ip-address

  (Optional) Specifies the IP address of the system.

  netmask=netmask

  (Optional) Specifies the netmask value for the system.

  protocol_ipv6=yes-or-no

  (Optional) Instructs the installation program either to configure the system to either use IPv6 or to not use IPv6.

  To perform an unattended custom JumpStart installation, you must specify a value for the protocol_ipv6 keyword.

  ---

  Note –

  Include any combination or none of the hostname, ip_address, and netmask keywords, as needed. If you do not use any of these keywords, omit the braces ({}).

  ---

Example 1–1 Configuring a Single Interface by Using DHCP With the network_interface Keyword

The following example shows how to instruct the installation program to DHCP to configure the eri0 network interface. IPv6 support is not enabled.

network_interface=eri0 {dhcp protocol_ipv6=no}

Example 1–2 Configuring a Single Interface by Specifying Configuration Information With the network_interface Keyword

The following example shows how to configure the eri0 interface with the following settings:

• The host name is set to host1.

• The IP address is set to 172.31.88.100.

• The netmask is set to 255.255.255.0.

• IPv6 support is not enabled on the interface.

network_interface=eri0 {hostname=host1 ip_address=172.31.88.100
                        netmask=255.255.255.0 protocol_ipv6=no}

Syntax for Configuring Multiple Interfaces

You can configure multiple network interfaces in your sysidcfg file. For each interface that you want to configure, include a network_interface keyword entry in the sysidcfg file.

You can use the network_interface keyword to configure multiple interfaces in the following ways:

• With DHCP – You can use a DHCP server on your network to configure the network interface. For more information about how to use a DHCP server during your installation, see Preconfiguring System Configuration Information With the DHCP Service (Task Map).

  To use the DHCP server to configure a network interface on the system, use the following syntax for the network_interface keyword.

  network_interface=value {PRIMARY dhcp protocol_ipv6=yes-or-no}

  value

  Instructs the installation program to configure a specific interface, such as hme0 or eri1.

  PRIMARY

  (Optional) Specifies value as the primary interface.

  protocol_ipv6=yes-or-no

  Instructs the installation program to configure the system either to use IPv6 or to not use IPv6.

• Without DHCP – If you do not want to use DHCP to configure the network interface, you can specify the configuration information in the sysidcfg file. To instruct the installation program to configure multiple interfaces without using DHCP, use the following syntax.

  network_interface=value {PRIMARY hostname=host-name default_route=ip-address or NONE ip_address=ip-address netmask=netmask protocol_ipv6=yes-or-no}

  value

  Instructs the installation program to configure a specific interface, such as hme0 or eri1.

  PRIMARY

  (Optional) Specifies value as the primary interface.

  hostname=host-name

  (Optional) Specifies the host name of the system.

  default_route=ip-address or NONE

  (Optional) Specifies the IP address of the default router. If you want the installation program to detect the router by using the ICMP router discovery protocol, omit this keyword.

  If you configure multiple interfaces in the sysidcfg file, set default_route=NONE for each secondary interface that does not use a static default route.

  If the installation program cannot detect the router, you are prompted for the router information during installation.

  ip_address=ip-address

  (Optional) Specifies the IP address of the system.

  netmask=netmask

  (Optional) Specifies the netmask value for the system.

  protocol_ipv6=yes-or-no

  (Optional) Instructs the installation program to configure the system either to use IPv6 or to not use IPv6.

  To perform an unattended custom JumpStart installation, you must specify a value for the protocol_ipv6 keyword.

  ---

  Note –

  Include any combination or none of the hostname, ip_address, and netmask keywords, as needed. If you do not use any of these keywords, omit the braces ({}).

  ---

In the same sysidcfg file, you can use DHCP to configure certain interfaces, while also specifying the configuration information for other interfaces in the sysidcfg file.

Example 1–3 Configuring Multiple Interfaces With the network_interface Keyword

In the following example, the network interfaces eri0 and eri1 are configured in the following way:

• eri0 is configured by using the DHCP server. IPv6 support is not enabled on eri0.

• eri1 is the primary network interface. The host name is set to host1, and the IP address is set to 172.31.88.100. The netmask is set to 255.255.255.0. IPv6 support is not enabled on eri1.

network_interface=eri0 {dhcp protocol_ipv6=no}
network_interface=eri1 {primary hostname=host1 
                        ip_address=172.31.88.100
                        netmask=255.255.255.0 
                        protocol_ipv6=no}

root_password Keyword

You can specify the root (superuser) password to the system in the sysidcfg file. To specify the root (superuser) password, use the root_password keyword with the following syntax:

root_password=encrypted-password

encrypted-password is the encrypted password as it appears in the /etc/shadow file.

security_policy Keyword

You can use the security_policy keyword in your sysidcfg file to configure your system to use the Kerberos network authentication protocol. If you want to configure the system to use Kerberos, use the following syntax:

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

FQDN specifies the fully qualified domain name of the Kerberos default realm, the administration server, and key distribution center (KDC). You must specify at least one, but no more than three, key distribution centers.

If you do not want to set the security policy for the system, set security_policy=NONE.

For more information about the Kerberos network authentication protocol, see Part VI, Kerberos Service, in System Administration Guide: Security Services.

Example 1–4 Configuring the System to Use Kerberos With the security_policy Keyword

The following example configures the system to use Kerberos with the following information:

• The Kerberos default realm is example.COM.

• The Kerberos administration server is krbadmin.example.COM.

• The two key distribution centers are kdc1.example.COM and kdc2.example.COM.

security_policy=kerberos 
                {default_realm=example.COM 
                 admin_server=krbadmin.example.COM 
                 kdc=kdc1.example.COM, 
                 kdc2.example.COM}

system_locale Keyword

You can use the system_locale keyword to specify the language in which to display the installation program and desktop. Use the following syntax to specify a locale:

system_locale=locale

locale specifies the language that you want the system to use to display the installation panels and screens. For a list of valid locale values, see the /usr/lib/locale directory or the International Language Environments Guide.

terminal Keyword

You can use the terminal keyword to specify the terminal type for the system. Use the following syntax to specify the terminal type:

terminal=terminal_type

terminal_type specifies the terminal type for the system. For a list of valid terminal types, see the subdirectories in the /usr/share/lib/terminfo directory.

timezone Keyword

You can set the time zone for the system with the timezone keyword. Use the following syntax:

timezone=timezone

The timezone keyword specifies the time zone value for the system. The directories and files in the /usr/share/lib/zoneinfo directory provide the valid time zone values. The timezone value is the name of the path relative to the /usr/share/lib/zoneinfo directory. You can also specify any valid Olson time zone.

Example 1–5 Configuring the System Time Zone With the timezone Keyword

In the following example, the system time zone is set to mountain standard time in the United States.

timezone=US/Mountain

The installation program configures the system to use the time zone information in /usr/share/lib/zoneinfo/US/Mountain.

timeserver Keyword

You can use the timeserver keyword to specify the system that sets the date and time on the system you want to install.

Do not set timeserver=host-name or ip-address if you are running a name service.

Choose one of the following methods to set the timeserver keyword:

• To configure the system to serve as its own time server, set timeserver=localhost. If you specify localhost as the time server, the system's time is assumed to be correct.

• To specify another system as the time server, specify either the host name or the IP address of the time server with the timeserver keyword. Use the following syntax:

  timeserver=host-name or ip-address

  where host-name is the host name of the time server system, and ip-address specifies the IP address of the time server.

monitor Keyword

You can configure monitor information with the monitor keyword. Use the following syntax with the monitor keyword:

monitor=monitor-type

To set the value for the monitor keyword, run the kdmconfig -d command on the system that you want to install. Copy the line of output that includes the monitor keyword, and include this line in the sysidcfg file.

keyboard Keyword

You can configure the keyboard language and layout information with the keyboard keyword. Use the following syntax with the keyboard keyword:

keyboard=keyboard-language {layout=value}

To set the value for the keyboard keyword, run the kdmconfig -d command on the system you want to install. Copy the line of output that includes the keyboard keyword, and include this line in the sysidcfg file.

display Keyword

You can configure the following information with the display keyword:

• Graphics card

• Screen size

• Color depth

• Display resolution

Use the following syntax with the display keyword:

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

To set the appropriate values for the display keyword, run the kdmconfig -d command on the system you want to install. Copy the line of output that includes the display keyword, and include this line in the sysidcfg file.

pointer Keyword

You can configure the following mouse information with the pointer keyword:

• Pointing device

• Number of buttons

• IRQ level

Use the following syntax with the pointer keyword:

pointer=pointing-device {nbuttons=number-buttons irq=value}

To set the value for the pointer keyword, run the kdmconfig -d command on the system that you want to install. Copy the line of output that includes the pointer keyword, and include this line in the sysidcfg file.

For more information about all of these keywords, see the kdmconfig(1M) man page.