esxcfg-vswif

Section: Maintenance Commands (8)
Index Return to Main Contents

BSD mandoc
VMware ESX 4.0  

NAME

esxcfg-vswif - VMware ESX Service Console NIC configuration Tool  

SYNOPSIS

esxcfg-vswif OPTIONS [VSWIF]  

DESCRIPTION

esxcfg-vswif provides an interface to configure Service Console NIC. if no arguments are given, esxcfg-vswif displays the help message. VSWIF is the name of the interface. This should begin with 'vswif' followed by a unit number, for example 'vswif0' for the first Service Console interface.  

OPTIONS

-a -add
Add a Service Console NIC to the system. This requires IP parameters and portgroup name. The newly added Service Console NIC is enabled upon successful completion of the command.
-d -del
Delete the Service Console NIC. WARNING: This may result in a loss of network connectivity to the Service Console.
-l -list
List Service Console NICs in the system. The list contains network information, portgroup, and current state for each of the Service Console NIC in the system.
-e -enable
Enable the Service Console NIC on the system, if disabled.
-s -disable
Disable the Service Console NIC on the system, if enabled. WARNING: This may result in a loss of network connectivity to the Service Console.
-p -portgroup
Set the portgroup name of the Service Console NIC. This option has to be used while adding a new Service Console NIC to the system or to change the portgroup of an existing Service Console NIC.
-V -dvs-name
Set DVPort's DVSwitch name of the Service Console NIC. Setting dvs-name requiers --dv-port-id to be specified. This option has to be used while adding a new Service Console NIC to the system or to change the DVPort information of an existing Service Console NIC.
-P -dv-port-id
Set DVPort's DVPort ID of the Service Console NIC. Setting dv-port-id requiers --dvs-name to be specified. This option has to be used while adding a new Service Console NIC to the system or to change the DVPort information of an existing Service Console NIC.
-i -ip ipv4address/DHCP/ipv6address/DHCPV6/AUTOCONF
The IP address(X.X.X.X) to be used for the Service Console NIC. Setting an IPv4 address requires that the --netmask option be given in same command. If you want to use DHCP for address, pass in DHCP as the value. This does not require --netmask or --broadcast option to be specified. Use IPv6 address in the form X:X:X::X/X to set IPv6 address. Use DHCPV6 to set IPv6 DHCP address. Use AUTOCONF to set IPv6 router advertised address.
-U -unset-ip V4/DHCP/ipv6address/DHCPV6/AUTOCONF
The IP address to be removed from the Service Console NIC. Use V4 to remove IPv4 address. Use IPv6 address in the form X:X:X::X/X to remove IPv6 address. Use DHCPV6 to remove IPv6 DHCP address. Use AUTOCONF to remove IPv6 router advertised flag from kernel, it won't remove the router advertised address.
-n -netmask netmask
The IP netmask(X.X.X.X) to be used for the Service Console NIC. Setting an IP netmask requires that the --ip option be given in same command.
-b -broadcast broadcast
The broadcast address(X.X.X.X) to be used for the Service Console NIC. Setting broadcast requires that the --ip option in the same command. This option is not required if netmask and IP address are set.
-c -check
Check to see if the specified Service Console NIC exists. Program outputs a 1 if the given Service Console NIC exists and is enabled. It is 0 otherwise.
-D -disable-all
Disable all Service Console NICs on the system that are currently enabled. WARNING: This may result in a loss of network connectivity to the Service Console.
-E -enable-all
Enable all Service Console NICs on the system that are currently disabled.
-6 -enable-ipv6 true/false
Enable or disable IPv6 for next boot.
-r -restore
Restore Service Console NIC settings from persistent storage. This should be used only on system startup and should not be used by users.
-h -help
Print a help message for this command.

 

EXAMPLES

esxcfg-vswif \fIOPTIONS [VSWIF]\fR --add --ip=x.x.x.x --netmask=x.x.x.x vswif_name

esxcfg-vswif \fIOPTIONS [VSWIF]\fR --add --ip=DHCP vswif_name  

COPYRIGHT

VMware ESX is Copyright 1998-2009 VMware, Inc. All rights reserved.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
COPYRIGHT

This document was created by man2html, using the manual pages. Brought to you by Bouke Groenescheij, www.jume.nl
Time: 15:25:08 GMT, May 26, 2009