Troubleshooting Network Administration Issues in Oracle® Solaris 11.2

Exit Print View

Updated: July 2014
 
 

Troubleshooting Profile Configuration Issues by Using the netadm Command

Use the netadm list command with the appropriate options and arguments to display information about the profiles on a system and troubleshoot profile-based network configuration. For complete details see the netadm (1M) man page.

When used with no additional options, the netadm list command displays all of the profiles that are on a system and their current state:

%  netadm list
TYPE         PROFILE        STATE
ncp          DefaultFixed   disabled
ncp          Automatic      online
ncu:phys     net0           online
ncu:ip       net0           online
loc          Automatic      online
loc          NoNet          offline
loc          DefaultFixed   offline

To display information about a particular profile, specify the profile's name, as shown in the following example where the Automatic profile is specified:

% netadm list Automatic
TYPE         PROFILE        STATE
ncp          Automatic      online
ncu:ip       net1           offline
ncu:phys     net1           offline
ncu:ip       net0           online
ncu:phys     net0           online
loc          Automatic      online

To display information about all of the profiles on the system that are of a certain type, use the netadm list command with the –p option. For example, you would display all of the Location profiles on a system as follows:

% netadm list -p loc
TYPE         PROFILE        STATE
loc          NoNet          offline
loc          Automatic      online
loc          DefaultFixed   offline

In the following example, the netadm list command is used with the –c option to display configuration details for the currently active profile.

% netadm list -c ip
TYPE         PROFILE         STATE
ncu:ip       net0            online

The netadm list –x command is useful for determining why a network interface might not be configured correctly. Use this command to display the various profiles on a system, their current state, and the reason for being in that state.

For example, if a cable is unplugged, use the netadm list –x command to determine if the link state is offline and why, for example, “link is down.” Similarly, for duplicate address detection, the output of the netadm list –x command shows that the physical link is online (up), but the IP interface is in a maintenance state. In this instance, the reason that is given is “Duplicate address detected.”.

The following example shows the type of information that you can obtain by using the netadm list –x command:

% netadm list -x
TYPE        PROFILE        STATE          AUXILIARY STATE
ncp         DefaultFixed   online         active
ncp         Automatic      disabled       disabled by administrator
loc         NoNet          offline        conditions for activation are unmet
loc         DefaultFixed   online         active
loc         Automatic      offline        conditions for activation are unmet

After determining the reason a link or an interface is offline, you can then proceed to correct the problem. In the case of a duplicate IP address, you must modify the static IP address that is assigned to the specified interface by using the netcfg command. For instructions, see Setting Property Values for Profiles in Configuring and Administering Network Components in Oracle Solaris 11.2 . After you commit the changes, run the netadm list –x command again to check that the interface is configured correctly and its state is showing as online.

Another example of why an interface might not be configured correctly is if no known wireless local area networks (WLANs) are available. In this case, the WiFi link's state would be displayed as "offline" and the reason would be indicated as "need WiFi network selection". Alternatively, if a WiFi selection was initially made, but a key is required, the reason would be indicated as "need WiFi key".