Command Line Interface Reference, Commands I - Q, StarOS Release 20

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents

Find Matches in This Book

Results

Updated:: March 31, 2016

Chapter: Loopback Interface Configuration Mode Commands

crypto-map
description
end
exit
ip address
ip ranged-address
ip vrf
ipv6 address
ipv6 ospf

Loopback Interface Configuration Mode Commands

Mode

The Loopback Interface Configuration Mode is used to create and manage an internal IP network address. The address must be configured with a 32-bit mask.

Exec > Global Configuration > Context Configuration > Ethernet Interface Configuration

configure > context context_name > interface interface_name loopback

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-if-loopback)#

Important:

Available commands or keywords/variables vary based on platform type, product version, and installed license(s).

crypto-map
description
end
exit
ip address
ip ranged-address
ip vrf
ipv6 address
ipv6 ospf

crypto-map

Applies the specified IPSec crypto-map to this interface.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

crypto-map map_name [ secondary-address sec_ip_addr ]
no crypto-map map_name

no

Deletes the application of the crypto map on this interface.

map_name

Specifies the name of the crypto map being applied as an alphanumeric string of 1 through 127 characters that is case sensitive.

secondary-address sec_ip_addr

Applies the crypto map to the secondary address for this interface. sec_ip_addr must be specified using the IPv4 dotted-decimal or IPv6 colon-separated-hexadecimal notation.

Usage Guidelines

In order for ISAKMP and/or manual crypto maps to work, they must be applied to a specific interface using this command. Dynamic crypto maps should not be applied to interfaces.

The crypto map must be configured in the same context as the interface.

Examples

To apply the IPSec crypto map named cmap1 to this interface, use the following command:

crypto-map cmap1

description

Sets the descriptive text for the current interface.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

description  text
no description

no

Clears the description for the interface.

text

Specifies the descriptive text as an alphanumeric string of 0 through 79 characters.

Usage Guidelines

Set the description to provide useful information on the interface's primary function, services, end users, etc. Any information useful may be provided.

Examples

description sampleInterfaceDescriptiveText

end

Exits the current configuration mode and returns to the Exec mode.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

end

Usage Guidelines

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

exit

Usage Guidelines

Use this command to return to the parent configuration mode.

ip address

Specifies the primary and optional secondary IPv4 addresses and subnets for this interface.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

ip address ip_address { mask | /mask } [ secondary ip_address ] [ srp-activate ]
no ip address ip_address

no

Removes the IPv4 address from this interface.

ip_address{ mask | /mask }

Configures the IPv4 address and mask for the interface. ip_address must be entered using IPv4 dotted-decimal notation. IPv4 dotted-decimal or CIDR notation is accepted for the mask.

Important:

For IPv4 addresses, 31-bit subnet masks are supported per RFC 3021.

secondary ip_address

Configures a secondary IPv4 address on the interface.

Important:

You must configure the primary IPv4 address before you will be allowed to configure a secondary address.

srp-activate

Activates the IP address for Interchassis Session Recovery (ICSR). Enable this IPv4 address when the Service Redundancy Protocol (SRP) determines that this chassis is ACTIVE. Requires an ICSR license on the chassis to activate.

Usage Guidelines

The following command specifies the primary IP address and subnets for this interface.

Examples

The following example configures an IPv4 address for this interface:

ip address 192.154.3.5/24

ip ranged-address

Specifies an IPv4 address and subnet; all addresses in the subnet are local. Configures the range or group of IP address for the loopback interface. This command enables support for multiple Enterprise HAs in one HA service.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

[ no ] ip ranged-address ip_address [ mask | /mask ]

no

Removes the IPv4 ranged address from this interface.

ip_address[ mask | /mask ]

Configures the IPv4 address and mask for the interface. ip_address must be entered using IPv4 dotted-decimal notation. IPv4 CIDR notation is accepted for the mask.

Important:

This interface configuration is allowed only for IPv4 addresses and must be bound to the HA Service.

Usage Guidelines

This command provide Enterprise HA support on HA service for multiple enterprise nodes. Refer HA Administration Guide for more information.

This IP address range configuration must meet the following criteria:

The ranged address must be a primary address.
The ranged address must be unique across the interface configuration.
The ranged address must be unique across the context.
The IP address specified in the ranged address must not be part of any other interface.
The ranged-address can be a n SRP-activated address.

Examples

The following example configures a ranged IPv4 address for this interface:

ip ranged-address 192.154.3.5/24

ip vrf

Associates this interface with a specific Virtual Routing and Forwarding (VRF) table.

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

[ no ] ip vrf forwarding vrf_name

no

Removes the specified VRF table from this interface.

vrf_name

Specifies the name of an existing VRF table as an alphanumeric string of 1 through 63 characters.

Use the Context Configuration mode ip vrf forwarding command to preconfigure the VRF name.

Usage Guidelines

The following command specifies a ranged IP address for this interface.

Examples

The following example elasticities this interface with VRF named vrf_012:

ip vrf forwarding vrf_012

ipv6 address

Specifies an IPv6 address and subnet mask.

Product

PDSN

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

[ no ] ipv6 address ipv6_address/mask

no

Removes the IPv6 address from this interface.

ipv6_address/mask

Specifies an individual host IP address to add to this host pool in IPv6 colon-separated-hexadecimal CIDR notation.

Important:

On the ASR 5000, routes with IPv6 prefix lengths less than /12 and between the range of /64 and /128 are not supported.

Usage Guidelines

Configures the IPv6 address and subnet mask for a specific interface.

Examples

The following example configures an IPv6 address for this interface:

ipv6 address 2002:0:0:0:0:0:c014:101/128

ipv6 ospf

Enables Open Shortest Path First Version 3 (OSPFv3) functionality on this IPv6 a interface.

Product

PDSN

GGSN

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

[ no ] ipv6 ospf [ area { integer | ipv4-address } | cost cost-value | dead-interval dead-intrv | hello-interval hello-intrvl | priority p-value | retransmit-interval retx-interval | transmit-delay td-interval ]

no

Removes a previously configured access group association.

area { integer | ipv4-address

Specifies an OSPFv3 area.

decimal_value: Specifies the identification number of the area as an integer from 0 through 4294967295.

ipv4address: Specifies the IP address of the area in IPv4 dotted-decimal notation.

cost cost-value

Specifies a link cost as an integer from 1 through 65535. The link cost is carried in the LSA updates for each link. The cost is an arbitrary number.

dead-interval dead-intrv

Specifies the interval (in seconds) after which a neighbor is declared dead when no hello packets as an integer from 1 through 65535.

hello-interval hello-intrvl

Specifies the interval (in seconds) between hello packets that OSPFv3 sends on an interface as an integer from 1 through 65535.

priority p-value

Specifies the of the interface as an integer from 0 through 255.

retransmit-interval retx-interval

Specifies the time (in seconds) between link-state advertisement (LSA) retransmissions for adjacencies belonging to the OSPFv3 interface as an integer from 1 through 65535.

transmit-delay td-interval

Specifies the estimated time (in seconds) required to send a link-state update packet on the interface as an integer from 1 through 65535.

Usage Guidelines

Configure an OSPFv3 interface in this context.

Examples

ipv6 ospf area 334 cost 555 dead-interval 40 hello-interval 10 priority 10 retransmit-interval 5 transmit-delay 10

Was this Document Helpful?

Feedback

Contact Cisco

Open a Support Case
(Requires a Cisco Service Contract)