Table of Contents

2

interface port-channel

Use the interface port-channel command to access or create the IDB port-channel.

Syntax Description

channel-group

Port-channel group number; valid values are from 1 to 256.

Defaults

This command has no default setting.

Command Modes

Global configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

Layer 2 port-channels can be created dynamically or by entering the interface port-channel command. Layer 3 port-channels can be created by entering the interface port-channel command only. They cannot be created dynamically.

Only one port-channel in a channel-group is allowed.

Caution The Layer 3 port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical Fast Ethernet interfaces.

As you work with the interface port-channel command, consider the following points:

• If you configure ISL, you must assign the IP address to the SVI.

• If you want to use the CDP, you must configure it only on the physical Fast Ethernet interface and not on the port-channel interface.

• If you do not assign a static MAC address on the port-channel interface, a MAC address is automatically assigned. If you assign a static MAC address and then later remove it, the MAC address is automatically assigned.

Examples

This example creates a port-channel interface with a channel group number of 256:

Router(config)# interface port-channel 256
Creating a switch port Po256. channel-group 256 is L2
Router(config-if)#

Related Commands

channel-group,
show etherchannel,

interface range

Use the interface range command to execute a command on multiple ports at the same time.

Syntax Description

port-range	Port range; for a list of valid values for port-range, see the "Usage Guidelines" section for additional information.
macro name	Keyword and variable to specify the name of a macro.

Defaults

This command has no default setting.

Command Modes

Global or interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

You can use the interface range command on existing VLAN SVIs only. To display VLAN SVIs, enter the show running config command. VLANs not displayed cannot be used in the interface range command.

The commands entered under interface range command are applied to all existing VLAN SVIs.

Before you can use a macro, you must define a range using the define interface-range command.

All configuration changes made to a port range are saved to NVRAM, but port ranges created with the interface range command do not get saved to NVRAM.

You can enter the port range in two ways:

• Specifying up to five port ranges

• Specifying a previously defined macro

You can either specify the ports or the name of a port-range macro. A port range must consist of the same port type, and the ports within a range cannot span slots.

You can define up to five port ranges on a single command, with each range separated by a comma.

When you define a range, you must enter a white space between the first port and the hyphen (-):

interface range gigabitethernet 7/1 -7, gigabitethernet9/5 -408.
 

When you define a VLAN range, valid values are from 1 to 1005. The last VLAN number cannot exceed 1005.

When entering the port-range, these formats can be used:

• card-type{slot}/{first-port} - {last-port}

• card-type {slot}/{first-port} - {last-port}

Valid values for card-type are:

• Ethernet

• FastEthernet

• GigabitEthernet

• Vlan vlan

You cannot specify both a macro and an interface range in the same command. After creating a macro, the CLI does not allow you to enter additional ranges. Likewise, if you have already entered an interface range, the CLI does not allow you to enter a macro.

A single interface can also be specified in port-range (this would make the command similar to the interface interface-number command).

Examples

This example shows how to use the interface range command to interface to two port ranges:

Router(config)# interface range fastethernet 5/18 - 20, ethernet 3/1 - 24
Router(config-if)#
 

This command shows how to execute a port-range macro:

Router(config)# interface range macro macro1
Router(config-if)#

Related Commands

define interface-range,
show running config (refer to Cisco IOS documentation)

interface vlan

Use the interface vlan command to create or access a dynamic SVI. Use the no form of this command to delete an SVI.

Syntax Description

vlan	Number of the VLAN; valid values are from 1 to 1001.

Defaults

The default is Fast EtherChannel is not specified.

Command Modes

Global configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

SVIs are created the first time you enter the interface vlan vlan command for a particular vlan. The vlan corresponds to the VLAN-tag associated with data frames on an ISL or 802.1q encapsuulated trunk, or the VLAN ID configured for an access port. A message is displayed whenever a VLAN interface is newly created, just in case you may have mistakingly entered an incorrect VLAN number.

If you delete an SVI by entering the no interface vlan vlan command, the associated IDB-pair is forced into an administrative-down state and marked as deleted. The deleted interface will no longer be visible in a show interface command.

You can reinstate a deleted SVI by entering the interface vlan vlan command for the deleted interface. The interface comes back up, but much of the previous configuration will be gone.

Examples

This example shows the output when you enter the interface vlan vlan command for a new vlan number:

Router (config)# interface vlan 23
% Creating new VLAN interface.
Router (config)#

ip cgmp router-only

Use the ip cgmp router-only command to configure a VLAN interface to dynamically access a multicast router. Use the no form of this command to remove the configuration.

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default setting.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

To enable dynamic access, you must also enter the ip cgmp router-only command on any external multicast routers connected to the Catalyst 6000 family switch.

Examples

This example shows how to configure a VLAN interface to dynamically access a multicast router:

Router(config-if)# ip cgmp router-only
Router(config-if)# 

Related Commands

ip igmp snooping mrouter,
show ip igmp snooping mrouter,

ip igmp query-interval

Use the ip igmp query-interval to configure the frequency at which the Catalyst 6000 family IOS software sends IGMP host-query messages. Use the no form of this command to return to the default frequency.

Syntax Description

seconds

Frequency, in seconds, at which to transmit IGMP host-query messages; valid values depend on the IGMP snooping mode. See the "Usage Guidelines" section for additional information.

Defaults

The default is 60 seconds.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

If you use the default IGMP snooping configuration, the valid query-interval values are from 1 to 65535 seconds. If you have changed the default configuration to support CGMP as the IGMP snooping learning method, the valid query-interval values are from 1 to 300 seconds.

The designated router for a LAN is the only router that sends IGMP host-query messages. For IGMP version 1, the designated router is elected according to the multicast routing protocol that runs on the LAN. For IGMP version 2, the designated querier is the lowest IP-addressed multicast router on the subnet.

If no queries are heard for the timeout period (controlled by the ip igmp query-timeout command), the switch becomes the querier.

Note   Changing the timeout period may severely impact multicast forwarding.

Examples

This example shows how to change the frequency at which the designated router sends IGMP host-query messages:

Router(config-if)# ip igmp query-interval 120
Router(config-if)#

Related Commands

ip pim query-interval (refer to Cisco IOS documentation)
show ip igmp groups (refer to Cisco IOS documentation)
ip igmp query-timeout (refer to Cisco IOS documentation)

ip igmp snooping

Use the ip igmp snooping command to enable IGMP snooping. Use the no form of this command to disable IGMP snooping.

Syntax Description

This command has no arguments or keywords.

Defaults

The default is IGMP snooping is enabled on the switch and not configured on multicast routers.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

Before you can enable IGMP snooping on the Catalyst 6000 family switches, you must configure the VLAN interface for multicast routing.

Examples

This example shows how to enable IGMP snooping:

Router(config-if)# ip igmp snooping
Router(config-if)#
 

This example shows how to disable IGMP snooping:

Router(config-if)# no ip igmp snooping
Router(config-if)#

Related Commands

ip igmp snooping fast-leave,
ip igmp snooping mrouter,
ip igmp snooping static,

ip igmp snooping fast-leave

Use the ip igmp snooping fast-leave command to enable IGMP fast-leave processing. Use the no form of this command to disable fast-leave processing.

Syntax Description

This command has no arguments or keywords.

Defaults

The default is IGMP fast-leave processing is disabled.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

You should use the fast-leave feature only when there is a single receiver for the MAC group for a specific VLAN.

Fast leave is supported only with IGMP version 2 hosts.

Examples

This example shows how to enable IGMP fast-leave processing:

Router(config-if)# ip igmp snooping fast-leave
Router(config-if)#
 

This example shows how to disable IGMP fast-leave processing:

Router(config-if)# no ip igmp snooping fast-leave
Router(config-if)#

Related Commands

ip igmp snooping,
ip igmp snooping mrouter,
ip igmp snooping static,
show ip igmp interface (refer to Cisco IOS documentation)
show mac-address-table multicast,

ip igmp snooping mrouter

Use the ip igmp snooping mrouter command to configure a Layer 2 port as a multicast router port. Use the no form of this command to remove the configuration.

Syntax Description

interface	Keyword to specify the next-hop interface to multicast router.
Ethernet interface-number	Keyword and variable to specify the Ethernet 802.3 interface; valid values are from 1 to 9.
FastEthernet interface-number	Keyword and variable to specify the Fast Ethernet 802.3 interface; valid values are from 1 to 9.
GigabitEthernet interface-number	Keyword and variable to specify the Gigabit Ethernet 802.3z interface; valid values are from 1 to 9.
Port-channel number	Keyword and variable to specify the channel interface; valid values are from 0 to 256.
learn	Keyword to specify the multicast router learning method.
cgmp	Keyword to specify the multicast router snooping CGMP packets.
pim-dvmrp	Keyword to specify the multicast router snooping PIM-DVMRP packets.

Defaults

The default is pim-dvmrp.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

The CGMP learn method is useful for cutting down on control traffic.

The learn method you configure is saved in NVRAM.

Static connections to multicast routers are supported only on switch ports.

Examples

This example shows how to specify the next-hop interface to multicast router:

Router(config-if)# ip igmp snooping mrouter interface fastethernet 5/6
Router(config-if)#
 

This example shows how to specify the multicast router learning method:

Router(config-if)# ip igmp snooping mrouter learn cgmp
Router(config-if)#

Related Commands

ip igmp snooping,
ip igmp snooping fast-leave,
ip igmp snooping static,
show ip igmp snooping mrouter,

ip igmp snooping static

Use the ip igmp snooping static command to configure a Layer 2 port as a member of a group. Use the no form of this command to remove the configuration.

Syntax Description

mac-address	Group MAC address.
interface	Keyword to specify the next-hop interface to multicast router.
Ethernet interface-number	Keyword and variable to specify the Ethernet 802.3 interface; valid values are from 1 to 9.
FastEthernet interface-number	Keyword and variable to specify the Fast Ethernet 802.3 interface; valid values are from 1 to 9.
GigabitEthernet interface-number	Keyword and variable to specify the Gigabit Ethernet 802.3z interface; valid values are from 1 to 9.
Port-channel number	Keyword and variable to specify the channel interface; valid values are from 0 to 256.

Defaults

The default is pim-dvmrp.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

The CGMP learn method is useful for cutting down on control traffic.

The learn method you configure is saved in NVRAM.

Examples

This example shows how to configure a host statically on an interface:

Router(config-if)# ip igmp snooping static 0100.5e02.0203 interface fas 5/11
Configuring port FastEthernet5/11 on group 0100.5e02.0203 vlan 4
Router(config-if)#

Related Commands

ip igmp snooping,
ip igmp snooping fast-leave,
ip igmp snooping mrouter,
show mac-address-table multicast,

ip local-proxy-arp

Use the ip local-proxy-arp command to enable the local proxy ARP feature. Use the no form of this command to disable the feature.

Syntax Description

This command has no arguments or keywords.

Defaults

The default is disabled.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.1(2)E	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

The local proxy ARP feature allows the MSFC to respond to ARP requests for IP addresses within a subnet where normally no routing is required. With the local proxy ARP feature enabled, the MSFC responds to all ARP requests for IP addresses within the subnet and forwards all traffic between hosts in the subnet. Use this feature only on subnets where hosts are intentionally prevented from communicating directly by the configuration on the switch to which they are connected.

ICMP redirects are disabled on interfaces where the local proxy ARP feature is enabled.

Examples

This example shows how to enable the local proxy ARP feature:

Router(config-if)# ip local-proxy-arp
Router(config-if)#

ip rgmp

Use the ip rgmp command to enable RGMP on an interface. Use the no form of this command to disable RGMP.

Syntax Description

This command has no arguments or keywords.

Defaults

The default is RGMP is enabled globally.

Command Modes

Interface configuration mode.

Command History

Release	Modification
12.1(3a)E	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

The following restrictions apply to RGMP on the MSFC:

• You can enable RGMP on interfaces configured to support multicast routing.

• IGMP snooping must be enabled on the switch.

• PIM must be enabled on the switch.

• Sparse-mode only.

  RGMP supports PIM sparse-mode only. RGMP does not support PIM dense-mode. RGMP explicitly supports the two AutoRP groups in dense-mode by not restricting traffic to those groups but by flooding it to all router ports. For this reason, you should configure PIM sparse-dense-mode. If you configure groups other than the AutoRP groups for dense-mode, their traffic will not be correctly forwarded through router ports that have been enabled for RGMP.

• To effectively constrain multicast traffic with RGMP, connect RGMP-enabled routers to separate ports on RGMP-enabled switches.

• RGMP only constrains traffic that exits through ports on which it detects an RGMP-enabled router. If a non-RGMP enabled router is detected on a port, that port receives all multicast traffic.

• RGMP does not support directly connected sources in the network. A directly connected source will send traffic into the network without signaling this through RGMP or PIM. This traffic will not be received by an RGMP-enabled router unless the router already requested receipt of that group through RGMP. This restriction applies to hosts and to functions in routers that source multicast traffic, such as the ping and mtrace commands and multicast applications that source multicast traffic, such as UDPTN.

• RGMP supports directly connected receivers in the network. Traffic to these receivers will be restricted by IGMP snooping, or if the receiver is a router itself, by PIM and RGMP. CGMP is not supported in networks where RGMP is enabled on routers.

• Enabling RGMP and CGMP on a router interface is mutually exclusive. If RGMP is enabled on an interface, CGMP is silently disabled or vice versa.

Examples

This example shows how to enable RGMP:

Router(config-if)# ip rgmp
Router(config-if)#
 

This example shows how to disable RGMP snooping:

Router(config-if)# no ip rgmp
Router(config-if)#

Related Commands

ip igmp snooping,

mac-address-table aging-time

Use the mac-address-table aging-time command to configure the aging time for entries in the Layer 2 table. Use the no version of this command to reset the seconds value to the default setting.

Syntax Description

seconds	Aging time; valid values are 0 and from 10 to 1,000,000 seconds.
vlan vlan	(Optional) Keyword and variable to specify the VLAN to apply the changed aging time.

Defaults

The default aging time is 300 seconds.

Command Modes

Global configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

If you do not enter a VLAN, the change is applied to all routed-port VLANs.

Enter 0 to disable aging.

Examples

This example shows how to configure the aging time:

Router(config)# mac-address-table aging-time 400
Router(config)#
 

This example shows how to disable aging:

Router(config)# mac-address-table aging-time 0
Router(config)

Related Commands

show mac-address-table aging-time,

mac-address-table static

Use the mac-address-table static command to add static entries to the MAC address table. Use the no form of this command to remove entries profiled by the combination of specified entry information.

Syntax Description

mac_addr	Address to add to the MAC address table.
any	Keyword to accept a specific input interface on other platforms that support this command and utilize the input interface-mac entry association.
output i/f	(Optional) Keyword and variable to specify the output interface interface associated with the entry.
vlan vlan	(Optional) Keyword and variable to specify the VLAN associated with the MAC address entry.
protocol	(Optional) Keyword to specify the protocol associated with the entry.
ip	Keyword to specify IP protocol.
ipx	Keyword to specify IPX protocol.
assigned	Keyword to specify assigned protocol bucket accounts for such protocols as DECnet, Banyan VINES, and AppleTalk.
other	Keyword to specify all remaining protocol types.
slot slot-num	(Optional) Keyword and variable to specify the slot number of the module where the entry will be installed.

Defaults

This command has no default setting.

Command Modes

Global configuration mode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

This command is not supported for the installation of multicast entries.

The output interface specified must be a Layer 2 IDB and not an SVI.

You can enter multiple VLAN IDs after the vlan keyword to install the entry for each VLAN entered.

If you do not enter a protocol type, an entry is automatically created for each of the four protocol types.

You can enter multiple slot numbers to place the entry in the MAC address table for each slot specified. If you do not enter a slot number, the entry is placed in the address table for all slots.

Entering the no version of this command does not remove system MAC addresses.

Examples

This example shows how to add static entries to the MAC address table:

Router(config)# mac-address-table static 0050.3e8d.6400 interface fastethernet5/7 vlan 100
Router(config)# 

Related Commands

show mac-address-table address,

maxconns

Use the maxconns command to limit the number of active connections to the real server. Use the no form of this command to change the maximum number of connections to the default value.

Syntax Description

number-conns

Maximum number of active connections on the real server at any one point in time; valid values are from 0 to 4294967295.

Defaults

The default number-conns is 0.

Command Modes

Real server configuration submode.

Command History

Release	Modification
12.0(7)XE	This command was introduced on Catalyst 6000 family switches.

Usage Guidelines

If you do not specify the number-conns, the default value is 0, meaning the maximum number of connections to the real server are not monitored.

Examples

This example shows how to limit the number of active connections to the real server:

Router(config-if)# maxconns 49672
Router(config-if)# 
 

This example shows how to revert to the default value:

Router(config-if)# no maxconns
Router(config-if)# 

Related Commands

faildetect numconns (refer to Cisco IOS documentation)
inservice (refer to Cisco IOS documentation)
real,
reassign,
retry,
weight,

Posted: Mon Sep 18 10:57:45 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.