Index  |  Top  -  Up Data ONTAP 8.3

network interface modify

Modify a logical interface

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The network interface modify command modifies attributes of a logical interface (LIF).
Note:

Parameters

-vserver <vserver> - Vserver Name

Use this parameter to specify the Vserver on which the LIF to be modified is located.

-lif <lif-name> - Logical Interface Name

Use this parameter to specify the name of the LIF that is to be modified

[-home-node <nodename>] - Home Node

Use this parameter to modify the LIF's home node. The home node is the node to which the LIF returns when the network interface revert command is run on that LIF.

[-home-port {<netport>|<ifgrp>}] - Home Port

Use this parameter to modify the LIF's home port. The home port is the port or interface group to which the LIF returns when the network interface revert command is run on that LIF.
Note:

[-address <IP Address>] - Network Address

Use this parameter to modify the LIF's IP address.
Note:

{  [-netmask <IP Address>] - Netmask

Use this parameter to modify the LIF's netmask.

|  [-netmask-length <integer>] - Bits in the Netmask

Use this parameter to modify the length (in bits) of the LIF's netmask.

{  [-auto {true|false}] - IPv4 Link Local

Use this parameter to modify the LIF's IPv4 Link Local IP address.

|  [-subnet-name <subnet name>]  } - Subnet Name

Use this parameter to allocate the interface address from a subnet. Modifying this parameter will cause a new IP address to be allocated and assigned to the interface.

[-status-admin {up|down}] - Administrative Status

Use this parameter to modify the administrative status of the LIF. The administrative status can differ from the operational status. For example, if you specify the status as up but a network problem prevents the interface from functioning, the operational status remains as down.

[-failover-policy {system-defined|local-only|sfo-partner-only|ipspace-wide|disabled|broadcast-domain-wide}] - Failover Policy

Use this parameter to modify the failover policy for the LIF.
Note:
Note:

[-firewall-policy <policy>] - Firewall Policy

Use this parameter to set the firewall policy for the LIF. A LIF can use a default firewall policy that corresponds to its role (management, cluster, or data) or a custom firewall policy created by an administrator. When using a custom policy, the interface will fallback on its role's default policy for unspecified services. View existing firewall policies with the "system services firewall policy show" command. Modify existing firewall policies with the "system services firewall policy modify" command.

[-auto-revert {true|false}] - Auto Revert

Use this parameter to modify whether a data LIF is reverted automatically to its home node under certain circumstances. These circumstances would include startup, when the status of the management database changes to either master or secondary, and when the network connection is made. The default setting is false. If you set the value of this parameter to true, the load balancing migration capability of the data LIF is disabled (the -allow-lb-migrate parameter is set to false).
Note:

[-dns-zone {zone-name|none}] - Fully Qualified DNS Zone Name

Use this parameter to modify the unique, fully qualified domain name of the DNS zone to which this data LIF belongs. You can associate a data LIF with a single DNS zone. All data LIFs included in a zone must be on the same Vserver. If you do not specify a value for this parameter, the data LIF is created with the value none.

[-listen-for-dns-query {true|false}] - DNS Query Listen Enable

Use this parameter to specify if the LIF has to listen for DNS queries. The default value for this parameter is true.

[-allow-lb-migrate {true|false}] - Load Balancing Migrate Allowed (privilege: advanced)

Use this parameter to modify whether or not load balancing migration is enabled for this data LIF. The default value of this parameter is false. If you set the value of this parameter to true, the automatic revert capability of the data LIF is disabled (the -auto-revert parameter is set to false). Also, data LIFs that migrate as a result of load balancing adhere to network interface failover rules.
Note:

[-lb-weight {load|0..100}] - Load Balanced Weight (privilege: advanced)

Use this parameter to modify the load balancing weight of the data LIF. A valid load balancing weight is any integer between 1 and 100. If you specify the same load balancing weight for all data LIFs in a DNS zone, client requests are uniformly distributed, similar to round-robin DNS. A data LIF with a low load balancing weight is made available for client requests less frequently than one that has a high load balancing weight.

[-failover-group <failover-group>] - Failover Group Name

Use this parameter to modify the name of the failover group to associate with the network interface. Create failover groups using the network interface failover create command. A "clusterwide" failover group exists by default and includes all of the ports available in the cluster for LIF failover. Furthermore, the failover group of the cluster management LIF, which you specify when you create a cluster (see the cluster create command), is automatically set to "clusterwide".
Note:

[-comment <text>] - Comment

Use this parameter to modify the comment associated with the LIF.

[-force-subnet-association [true]] - Force the LIF's Subnet Association

This command will fail if the IP address falls within the address range of a named subnet. Set this to true to acquire the address from the named subnet and assign the subnet to the LIF.

Examples

The following example modifies a LIF named datalif1 on a logical server named vs0. The LIF's netmask is modified to 255.255.255.128.
cluster1::> network interface modify -vserver vs0 -lif datalif1 -netmask 255.255.255.128

See Also

network interface revert   system services firewall policy show   system services firewall policy modify   network interface failover create   cluster create   lun portset show   lun portset remove  
Index  |  Top  -  Up Data ONTAP 8.3

Copyright © 1994-2015 NetApp, Inc. Legal Information