mkpni

Purpose

Use the mkpni command to define a preferred network interface (PNI) for an existing host. You can specify an unlimited number of PNIs for a host.

The PNI is the network interface that should be used to transmit data to be backed up or restored. A network can have multiple physical connections between a client and the server performing a backup or restore on behalf of that client. For example, a network can have both Ethernet and Fiber Distributed Data Interface (FDDI) connections between a pair of hosts. PNI enables you to specify, on a client-by-client basis, which of the server's network interfaces should be used.

See Also:

"Preferred Network Interface Commands" for related commands

Prerequisites

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

Syntax

mkpni::=

mkpn•i --interface/-i server-ipname
{ --client/-c client-hostname[,client-hostname]... }
server-hostname

Semantics

--interface/-i server-ipname

Specifies the IP address or the DNS name that the specified clients should use when communicating with the server specified by server-hostname.

--client/-c client-hostname[,client-hostname]...

Specifies one or more clients that should use the server-ipname when communicating with server-hostname. The client-hostname specifies the host name or internet address of the client as seen from the server. The host name must be a host name that you created with the mkhost command.

server-hostname

Specifies the name of the server host.

Example

Example 2-91 defines a preferred network interface that specifies that the client hosts stadv07 and brhost3 should use the IP address 126.1.1.2 when communicating with server brhost2.

Example 2-91 Defining a Preferred Network Interface

ob> mkpni --interface 126.1.1.2 --client stadv07,brhost3 brhost2
ob> lspni
brhost2:
    PNI 1:
        interface:          126.1.1.2
        clients:            stadv07, brhost3