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)

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

IPMP Administration Task Maps

IPMP Group Creation and Configuration (Task Map)

IPMP Group Maintenance (Task Map)

Probe-Based Failure Detection Configuration (Task Map)

IPMP Group Monitoring (Task Map)

Configuring IPMP Groups

How to Plan an IPMP Group

How to Configure an IPMP Group by Using DHCP

How to Manually Configure an Active-Active IPMP Group

How to Manually Configure an Active-Standby IPMP Group

Maintaining IPMP Groups

How to Add an Interface to an IPMP Group

How to Remove an Interface From an IPMP Group

How to Add or Remove IP Addresses

How to Move an Interface From One IPMP Group to Another Group

How to Delete an IPMP Group

Configuring for Probe-Based Failure Detection

How to Manually Specify Target Systems for Probe-Based Failure Detection

How to Configure the Behavior of the IPMP Daemon

Recovering an IPMP Configuration With Dynamic Reconfiguration

How to Replace a Physical Card That Has Failed

About Missing Interfaces at System Boot

Monitoring IPMP Information

How to Obtain IPMP Group Information

How to Obtain IPMP Data Address Information

How to Obtain Information About Underlying IP Interfaces of a Group

How to Obtain IPMP Probe Target Information

How to Observe IPMP Probes

How to Customize the Output of the ipmpstat Command in a Script

How to Generate Machine Parseable Output of the ipmpstat Command

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

Monitoring IPMP Information

The following procedures use the ipmpstat command, enabling you to monitor different aspects of IPMP groups on the system. You can observe the status of the IPMP group as a whole or its underlying IP interfaces. You can also verify the configuration of data and test addresses for the group. Information about failure detection is also obtained by using the ipmpstat command. For more details about the ipmpstat command and its options, see the ipmpstat(1M) man page.

By default, host names are displayed on the output instead of the numeric IP addresses, provided that the host names exist. To list the numeric IP addresses in the output, use the -n option together with other options to display specific IPMP group information.


Note - In the following procedures, use of the ipmpstat command does not require system administrator privileges, unless stated otherwise.


How to Obtain IPMP Group Information

Use this procedure to list the status of the various IPMP groups on the system, including the status of their underlying interfaces. If probe-based failure detection is enabled for a specific group, the command also includes the failure detection time for that group.

How to Obtain IPMP Data Address Information

Use this procedure to display data addresses and the group to which each address belongs. The displayed information also includes which address is available for use, depending on whether the address has been toggled by the ifconfig [up/down] command. You can also determine on which inbound or outbound interface an address can be used.

How to Obtain Information About Underlying IP Interfaces of a Group

Use this procedure to display information about an IPMP group's underlying IP interfaces. For a description of the corresponding relationship between the NIC, datalink, and IP interface, see Oracle Solaris Implementation of the Networking Stack.

How to Obtain IPMP Probe Target Information

Use this procedure to monitor the probe targets that are associated with each IP interface in an IPMP group.

How to Observe IPMP Probes

Use this procedure to observe ongoing probes. When you issue the command to observe probes, information about probe activity on the system is continuously displayed until you terminate the command with Ctrl-C. You must have Primary Administrator privileges to run this command.

  1. Become an administrator.

    For more information, see How to Obtain Administrative Rights in System Administration Guide: Security Services.

  2. Display the information about ongoing probes.
    # ipmpstat -pn
    TIME    INTERFACE   PROBE   TARGET        NETRTT   RTT      RTTAVG     RTTDEV
    0.11s   subitops0   589     192.168.85.1  0.51ms   0.76ms   0.76ms     --
    0.17s   hme1        612     192.1.2.1     --       --       --         --
    0.25s   fops0       602     128.0.0.1     0.61ms   1.10ms   1.10ms     --
    0.26s   fops1       602     128.0.0.2     --       --       --         --
    0.25s   fops2       601     128.0.0.1     0.62ms   1.20ms   1.00ms     --
    0.26s   fops3       603     128.0.0.1     0.79ms   1.11ms   1.10ms     --
    1.66s   hme1        613     192.1.2.1     --       --       --         --
    1.70s   subitops0   603     192.168.85.3  0.63ms   1.10ms   1.10ms     --
    ^C
    TIME

    Specifies the time a probe was sent relative to when the ipmpstat command was issued. If a probe was initiated prior to ipmpstat being started, then the time is displayed with a negative value, relative to when the command was issued.

    PROBE

    Specifies the identifier that represents the probe.

    INTERFACE

    Specifies the interface on which the probe is sent.

    TARGET

    Specifies the hostname or, if the -n option is used in conjunction with -p, the target address to which the probe is sent.

    NETRTT

    Specifies the total network round-trip time of the probe and is measured in milliseconds. NETRTT covers the time between the moment when the IP module sends the probe and the moment the IP module receives the ack packets from the target. If the in.mpathd daemon has determined that the probe is lost, then the field will be empty.

    RTT

    Specifies the total round-trip time for the probe and is measured in milliseconds. RTT covers the time between the moment the daemon executes the code to send the probe and the moment the daemon completes processing the ack packets from the target. If the in.mpathd daemon has determined that the probe is lost, then the field will be empty. Spikes that occur in the RTT which are not present in the NETRTT might indicate that the local system is overloaded.

    RTTAVG

    Specifies the probe's average round-trip time over the interface between local system and target. The average round-trip time helps identify slow targets. If data is insufficient to calculate the average, this field will be empty.

    RTTDEV

    Specifies the standard deviation for the round-trip time to the target over the interface. The standard deviation helps identify jittery targets whose ack packets are being sent erratically. For jittery targets, the in.mpathd daemon is forced to increase the failure detection time. Consequently, the daemon would take a longer time before it can detect such a target's outage. If data is insufficient to calculate the standard deviation, this field will be empty.

How to Customize the Output of the ipmpstat Command in a Script

When you use the ipmpstat, by default, the most meaningful fields that fit in 80 columns are displayed. In the output, all the fields that are specific to the option that you use with the ipmpstat command are displayed, except in the case of the ipmpstat -p syntax. If you want to specify the fields to be displayed, then you use the -o option in conjunction with other options that determine the output mode of the command. This option is particularly useful when you issue the command from a script or by using a command alias

How to Generate Machine Parseable Output of the ipmpstat Command

You can generate machine parseable information by using the ipmpstat -P syntax. The -P option is intended to be used particularly in scripts. Machine-parseable output differs from the normal output in the following ways:

To correctly use the ipmpstat -P syntax, observe the following rules:

Ignoring either one of these rules will cause ipmpstat -P to fail.

Example 14-8 Using ipmpstat -P in a Script

This sample script displays the failure detection time of a particular IPMP group.

getfdt() {
         ipmpstat -gP -o group,fdt | while IFS=: read group fdt; do
             [[ "$group" = "$1" ]] && { echo "$fdt"; return; }
         done
     }