rmpni

Purpose

Use the rmpni command to remove preferred network interface (PNI) definitions.

See Also:

"Preferred Network Interface Commands" for related commands

Prerequisites

You must have the modify administrative domain's configuration right to use the rmpni command.

Syntax

Syntax 1

Use the following syntax to remove all preferred network interfaces defined for a server.

rmpni::=

rmpn•i server-hostname ...

Syntax 2

Use the following syntax to remove a client host from all preferred network interface definitions.

rmpni::=

rmpn•i [ --client/-c client-hostname[,client-hostname]... ]...

Syntax 3

Use the following syntax to remove all preferred network interfaces that use a specific interface on a server.

rmpni::=

rmpn•i [ --interface/-i server-ipname[,server-ipname]... ]...

Syntax 4

Use the following syntax to remove a client host from the preferred network interface defined for the specified server.

rmpni::=

rmpn•i [ --client/-c client-hostname[,client-hostname]... ]...
server-hostname ...

Semantics

-client/c client-hostname[,client-hostname]...: Specifies one or more client hosts from which you want to remove preferred network interfaces.
--interface/-i server-ipname[,server-ipname]...: Specifies the IP address or the DNS name of the interface to be removed.
server-hostname ...: Specifies the name of the server machine.

Examples

Example 2-134 uses the syntax shown in Syntax 1 to remove all network interfaces for host brhost3.

Example 2-134 Removing All PNI Definitions for a Host

ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            stadv07, brhost4, dlsun1976
brhost3:
    PNI 1:
        interface:          126.1.1.3
        clients:            stadv07, brhost4, dlsun1976
ob> rmpni brhost3
ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            stadv07, brhost3, dlsun1976

Example 2-135 uses the syntax shown in Syntax 2 to remove the client hosts dlsun1976 and stadv07 from all network interfaces definitions.

Example 2-135 Removing a Client from All PNI Definitions

ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            stadv07, brhost4, dlsun1976
brhost3:
    PNI 1:
        interface:          126.1.1.3
        clients:            stadv07, brhost4, dlsun1976
ob> rmpni --client dlsun1976,stadv07
ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            brhost4
brhost3:
    PNI 1:
        interface:          126.1.1.3
        clients:            brhost4

Example 2-136 uses the syntax shown in Syntax 3 to remove all preferred network interfaces that use interface 126.1.1.2 on a server.

Example 2-136 Removing All PNI Definitions That Use a Specified Interface

ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            stadv07, brhost4, dlsun1976
brhost3:
    PNI 1:
        interface:          126.1.1.3
        clients:            stadv07, brhost4, dlsun1976
ob> rmpni --interface 126.1.1.2
ob> lspni
brhost3:
    PNI 1:
        interface:          126.1.1.3
        clients:            stadv07, brhost4, dlsun1976

Example 2-137 uses the syntax shown in Syntax 4 to remove the clients stadv07 and dlsun1976 from the PNI definition for server brhost2.

Example 2-137 Removing Clients from a PNI Definition

ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            stadv07, brhost4, dlsun1976
ob> rmpni --client stadv07,dlsun1976 brhost2
ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            brhost4