Solaris 10 10/08 Installation Guide: Network-Based Installations

`network_interface` Keyword

Use the network_interface keyword to perform the following tasks.

Specify a host name
Specify an IP address
Specify the default router 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 the system interfaces.

Syntax for Nonnetworked Systems

To turn off networking for the 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 on how to use a DHCP server during your installation, see Preconfiguring System Configuration Information With the DHCP Service (Tasks).

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 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 nonnetworked.

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 use either IPv6 or to not use IPv6.

For WAN boot installations, you must set the value of protocol_ipv6=no.

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 not networked.

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.

Note –

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 to configure the system to either use IPv6 or to not use IPv6.

Note –

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

For WAN boot installations, you must set the value of protocol_ipv6=no.

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 curly braces ({}).

Example 2–8 Configuring a Single Interface By Using DHCP With the `network_interface` Keyword

The following example instructs the installation program to use DHCP to configure the eri0 network interface. IPv6 support is not enabled.

network_interface=eri0 {dhcp protocol_ipv6=no}

Example 2–9 Configuring a Single Interface By Specifying Configuration Information With the `network_interface` Keyword

The following example configures the interface eri0 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 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 a network interface. For more information on how to use a DHCP server during your installation, see Preconfiguring System Configuration Information With the DHCP Service (Tasks).

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 to either use IPv6 or to not use IPv6.

Note –
For WAN boot installations, you must set the value of protocol_ipv6=no.

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.

Note –

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 to configure the system to either use IPv6 or to not use IPv6.

Note –

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

For WAN boot installations, you must set the value of protocol_ipv6=no.

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 curly 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 2–10 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.146.88.100
                        netmask=255.255.255.0 
                        protocol_ipv6=no}

network_interface Keyword

Syntax for Nonnetworked Systems

Syntax for Configuring a Single Interface

Example 2–8 Configuring a Single Interface By Using DHCP With the network_interface Keyword

Example 2–9 Configuring a Single Interface By Specifying Configuration Information With the network_interface Keyword

Syntax for Configuring Multiple Interfaces

Example 2–10 Configuring Multiple Interfaces With the network_interface Keyword

`network_interface` Keyword

Example 2–8 Configuring a Single Interface By Using DHCP With the `network_interface` Keyword

Example 2–9 Configuring a Single Interface By Specifying Configuration Information With the `network_interface` Keyword

Example 2–10 Configuring Multiple Interfaces With the `network_interface` Keyword