Go to main content

Managing Network Virtualization and Network Resources in Oracle® Solaris 11.3

Exit Print View

Updated: April 2018
 
 

Administering an IPnet Configuration

This section describes how to perform the following tasks for an IPnet after you add an IPnet for an elastic virtual switch:

  • Setting properties for an IPnet

  • Displaying properties associated with an IPnet

  • Removing an IPnet configured for an elastic virtual switch

  • Displaying information about IPnets

Setting Properties for an IPnet

You use the evsadm-setipnetprop command to set properties for an IPnet. The command syntax is:

# evsadm set-ipnetprop [-T tenant-name] -p prop=[value[,...]]\
EVS-switch-name/IPnet-name

The property associated with an IPnet is reset to the default value, if you do not specify any value for the property. For more information about the properties that can be set for an IPnet, see Adding an IPnet to an Elastic Virtual Switch.

Example 60  Setting Properties for an IPnet

This example shows how to set the pool property for the IPnet ora_ipnet.

# evsadm set-ipnetprop -T ABC -p pool=192.0.2.10-192.0.2.15 ORA/ora_ipnet

In this example, ABC is the name of the tenant and ORA is the name of the EVS.

Displaying Properties of an IPnet

You use the evsadm-showipnetprop command to display the properties associated with an IPnet. The command syntax is:

# evsadm show-ipnetprop [-f {fname=value[,...]}[,...]] [[-c] -o field[,...]] \
[-p prop[,...]] [IPnet-name]
–f {fname=value[,...]}[,...]

A comma-separated name-value pair used to filter the output (row selection). If multiple filters are specified, then the displayed output is a result of an AND operation among the filters. If the filter value is multivalued, then the displayed output is a result of an OR operation among the filter values. The supported filters are:

  • tenant – Filter the IPnet list by the tenant name

  • evs – Filter the IPnet list by the elastic virtual switch name

  • ipnet – Filter the IPnet list by the IPnet name

  • host – Filter the IPnet list by the host name


Note -  You can filter IPnets by using their property values. See Example 66, Displaying VPort Properties.
–p prop

Specifies the properties that are associated with an IPnet. For information, see Adding an IPnet to an Elastic Virtual Switch.

–o field[,...]

Specifies a case-insensitive, comma-separated list of output fields to display. You can specify the following fields, which appear as columns in the output:

all

Displays all the output fields.

NAME

Name of the IPnet with the name of the elastic virtual switch with which it is associated in the format EVS-switch-name/IPnet-name.

IPnet

Name of the IPnet.

EVS

Name of the elastic virtual switch.

TENANT

Name of the tenant that owns the elastic virtual switch.

PROPERTY

Name of the IPnet property.

PERM

Permission of the property, which is either rw or r-.

VALUE

The current value of the property. If you have not set a value, it is shown as --. If the value is unknown, it is shown as ?.

DEFAULT

The default value of the property. If the property does not a have default value, it is shown as --.

POSSIBLE

A comma-separated list of possible values for the property. If the possible values are unknown or unbounded, -- is shown.

Example 61  Displaying Properties of an IPnet

This example shows how to display properties for the IPnet ora_ipnet.

# evsadm show-ipnetprop ora_ipnet
NAME              TENANT   PROPERTY  PERM VALUE                      DEFAULT   POSSIBLE
ORA/ora_ipnet     ABC      evs       r-   ORA                        --        --
ORA/ora_ipnet     ABC      subnet    r-   192.0.2.0/27             --        --
ORA/ora_ipnet     ABC      defrouter r-   192.0.2.1                --        --
ORA/ora_ipnet     ABC      pool      rw   192.0.2.10-192.0.2.15, --        --
                                          192.0.2.20-192.0.2.25  
ORA/ora_ipnet     ABC      tenant    r-   ABC                        --        --
Example 62  Displaying the UUID of an IPnet

This example shows how to display the UUID for the IPnet evs1/ipnet1.

# evsadm show-ipnetprop -p uuid -o name,tenant,property,perm,value evs1/ipnet1
NAME         TENANT      PROPERTY  PERM VALUE
evs1/ipnet1  sys-global  uuid      r-   d2698f0c-96ba-11e4-ab94-171c32874415

Removing an IPnet

You use the evsadm remove-ipnet command to remove an IPnet configured for the elastic virtual switch. The command syntax is:

# evsadm remove-ipnet [-T tenant-name] EVS-switch-name/IPnet-name 

This command removes the specified IPnet from the specified elastic virtual switch. You cannot remove an IPnet if any one of the VPorts is in use. A VPort is in use if it has a VNIC connected to it.

Example 63  Removing an IPnet Configured for an Elastic Virtual Switch

This example shows how to remove the IPnet ora_ipnet from the elastic virtual switch ORA.

# evsadm remove-ipnet ORA/ora_ipnet

Displaying IPnets

You use the evsadm show-ipnet command to display information about IPnets managed by the EVS controller or for the specified IPnet. The command syntax is:

# evsadm show-ipnet [-f {fname=value[,...]}[,...]] [[-c] -o field[,...]] [IPnet-name]
–f {fname=value[,...]}[,...]

A comma-separated name-value pair used to filter the output (row selection). If multiple filters are specified, then the displayed output is a result of an AND operation among the filters. If the filter value is multivalued, then the displayed output is a result of an OR operation among the filter values. The supported filters are tenant, evs, ipnet, and host.

–o field[,...]

Specifies a case-insensitive, comma-separated list of output fields to display. You can specify the following fields, which appear as columns in the output:

all

Displays all the output fields.

NAME

Name of the IPnet along with the name of the elastic virtual switch with which it is associated.

IPNET

Name of the IPnet.

EVS

Name of the elastic virtual switch.

TENANT

The name of the tenant that owns the elastic virtual switch.

SUBNET

Represents the subnet (either IPv4 or IPv6) for this IPnet.

START

Start address of the IP address range.

END

End address of the IP address range.

DEFROUTER

The IP address of the default router for the given IPnet.

AVAILRANGE

A comma-separated list of available IP addresses that can be assigned to VPort.

Example 64  Displaying IPnet for an Elastic Virtual Switch

This example displays the IPnet configured for the elastic virtual switch ORA.

# evsadm show-ipnet
NAME          TENANT     SUBNET          DEFROUTER    AVAILRANGE
ORA/ora_ipnet sys-global 192.0.2.0/27 192.0.2.1 192.0.2.3-192.0.2.30