JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Administration: Network Interfaces and Network Virtualization     Oracle Solaris 11 Express 11/10
search filter icon
search icon

Document Information

Preface

Part I Network Auto-Magic

1.  Introduction to NWAM

2.  NWAM Configuration and Administration (Overview)

Overview of NWAM Configuration

What Are Network Profiles?

Description of an NCP

Description of an NCU

Description of the Automatic and User NCPs

Description of a Location Profile

Description of an ENM

About Known WLANs

NWAM Configuration Data

NCU Property Values

Property Values of System-Defined Locations

How NWAM Profiles Are Activated

NCP Activation Policy

Example of an NCP Policy

NCU Activation Properties

Location Activation Selection Criteria

Using the nwamcfg Command to Configure Profiles

nwamcfg Interactive Mode

nwamcfg Command-Line Mode

nwamcfg Command-File Mode

nwamcfg Supported Subcommands

Using the nwamadm Command to Administer Profiles

Overview of the NWAM Daemons

Description of the NWAM Policy Engine Daemon (nwamd)

Description of the NWAM Repository Daemon (netcfgd)

SMF Network Services and the NWAM Process

Refresh and Restart Behavior of the NWAM Service

Overview of NWAM Security

Authorizations and Profiles That Are Related to NWAM

Authorizations That Are Required to Use the NWAM User Interfaces

3.  NWAM Profile Configuration (Tasks)

4.  NWAM Profile Administration (Tasks)

5.  About the NWAM Graphical User Interface

Part II Administering Single Interfaces

6.  Overview of the Networking Stack

7.  Datalink Configuration and Administration

8.  Configuring an IP Interface

9.  Configuring Wireless Interface Communications on Oracle Solaris

Part III Administering Interface Groups

10.  Administering Bridges

11.  Administering Link Aggregations

12.  Administering VLANs

13.  Introducing IPMP

14.  Administering IPMP

Part IV  Network Virtualization and Resource Management

15.  Introducing Network Virtualization and Resource Control (Overview)

16.  Planning for Network Virtualization and Resource Control

17.  Configuring Virtual Networks (Tasks)

18.  Using Link Protection in Virtualized Environments

19.  Managing Network Resources

20.  Monitoring Network Traffic and Resource Usage

Glossary

Index

NWAM Configuration Data

There are effectively two configuration repositories on the system: the NWAM profile repository, which is stored in the /etc/nwam directory, and the legacy configuration repository, which is made up of /etc/hostname,intf, and /etc/dladm.conf files, as well as various other configuration files that are associated with network services.

When NWAM is enabled, the process works primarily from its own repository. The legacy link and interface configuration that is stored in the /etc/hostname.intf and the /etc/dladm.conf files is ignored. NWAM configures links and interfaces directly, based on the NCP data.

Location profile data is read from the NWAM repository. However, in many cases NWAM applies a particular location by copying configuration data into the expected legacy location. For example, if you provide a custom nsswitch.conf file as part of a location, when applying that Location profile, NWAM copies the user-provided file to the /etc/nsswitch.conf file where the name service subsystem within Oracle Solaris expects that configuration data to be located.

Because NWAM overwrites legacy configuration data in the process of applying Location profiles, upon startup, any configuration that might be overwritten is saved. NWAM then restores that configuration upon shutdown. Although it is not a location that can be applied as part of the NWAM operation, this process is referred to as the Legacy location.

Property values for the following system-defined and user-defined network profiles are stored in the NWAM repository:

Configuration data for each NCP is stored persistently as a file in the /etc/nwam directory, using the format, ncp-name. There is one file per NCP, with the entries representing each NCU. For example, the file for the Automatic NCP is named ncp-Automatic.conf. All NCP files are stored in the /etc/nwam directory.

Location properties are stored in the /etc/nwam/loc.conf file.

ENM properties are stored in the /etc/nwam/enm.conf file. Known WLANs are stored in the /etc/nwam/known-wlan.conf file. This file format is similar to the file format of the /etc/dladm/datalink.conf file.


Note - Although it is possible to modify network profiles by directly editing the files in the NWAM repository, the appropriate way to modify a profile is to use the nwamcfg command or the NWAM GUI configuration panels. See Setting and Changing Property Values of a Profile.


NCU Property Values

NCUs, the individual configuration objects of an NCP, represent individual links and interfaces on a system. General properties for both NCU types (link and interface), as well properties that are specific to each NCU type, are stored in the NWAM profile repository. The type, class, and parent properties are set when the NCU is created and cannot be changed later. Also, you cannot directly change an enabled property. The property is changed indirectly by enabling or disabling an NCU by using the nwamadm command.

The Automatic NCP consists of one link NCU for each physical link that is discovered in the system and one interface NCU that is plumbed on each link. The Automatic NCP changes dynamically upon insertion of additional physical links. As new links are inserted, a link NCU and corresponding interface NCU are created for each new link. The following tables define the values that are assigned to each NCU that makes up the Automatic NCP.


Note - The properties in this table are listed in the order in which they appear when viewing the NCU properties of the Automatic NCP. Certain values apply to each NCU type.


Table 2-1 Link NCU Properties for an Automatic NCP

Property
Link NCU Value
type
link
class
phys
parent
Automatic
enabled
true
activation-mode
prioritized
priority-group
0 (for 802.3 links) or 1 (for 802.11 links)
priority-group-mode
shared
mac-address
Hardware-assigned
autopush
N/A
MTU
1500

Table 2-2 Interface NCU Properties for an Automatic NCP

Property
Interface NCU Value
type
IP
class
IP
parent
Automatic
enabled
true
ip-version
ipv4, ipv6
ipv4-addrsrc
dhcp
ipv4-static-addr
N/A
ipv6-addrsrc
dhcp, autoconf
ipv6-static-addr
N/A

Property Values of System-Defined Locations

The following table provides the default property values for the Automatic location, which is a system-defined profile. You can modify these values, with the exception of the activation-mode and the enabled properties. The system always activates the Automatic location when at least one interface is active and no other Location profile supersedes it.

Table 2-3 Properties of System-Defined Locations

Property
Value
name
Automatic
activation-mode
system
enabled
System modified, as required
conditions
N/A
default-domain
N/A
nameservices
dns
nameservices-config-file
/etc/nsswitch.dns
dns-nameservice-configsrc
dhcp
dns-nameservice-domain
N/A
dns-nameservice-servers
N/A
dns-nameservice-search
N/A
nis-nameservice-configsrc
N/A
nis-nameservice-servers
N/A
ldap-nameservice-configsrc
N/A
ldap-nameservice-servers
N/A
nfsv4–domain
N/A
ipfilter-config-file
N/A
ipfilter-v6–config-file
N/A
ipnat-config-file
N/A
ippool-config-file
N/A
ike-config-file
N/A
ipsecpolicy-config-fiile
N/A

The following table provides the predefined properties for the NoNet location. Note that you can modify these values, with the exception of the activation-mode and the enabled properties. The system always enables the NoNetlocation when there are no interfaces enabled.

Table 2-4 Properties of the NoNet Location

Property
Value
name
NoNet
activation-mode
system
enabled
System modified, as required
conditions
N/A
default-domain
N/A
nameservices
files
nameservices-config-file
/etc/nsswitch.files
dns-nameservice-configsrc
N/A
dns-nameservice-domain
N/A
dns-nameservice-servers
N/A
dns-nameservice-search
N/A
nis-nameservice-configsrc
N/A
nis-nameservice-servers
N/A
ldap-nameservice-configsrc
N/A
ldap-nameservice-servers
N/A
nfsv4–domain
N/A
ipfilter-config-file
/etc/nwam/loc/NoNet/ipf.conf, which consists of IP Filter rules that block all non-loopback traffic, with the exception of a minimum amount of network traffic that is required by NWAM to perform network configuration, such as DHCP address assignment.
ipfilter-v6–config-file
/etc/nwam/loc/NoNet/ipf6.conf, which consists of IP Filter rules, as described for the ipfilter-config-file.
ipnat-config-file
N/A
ippool-config-file
N/A
ike-config-file
N/A
ipsecpolicy-config-fiile
N/A

For more information about location properties, including the properties that make up user-defined locations, see the nwamcfg(1M) man page.