PVC Interface Configuration Mode Commands

The PVC (permanent virtual connection) Interface configuration mode is used to create and manage the IP parameters for PVC interface(s) associated with an OLC (ATM-type) for a specific context.

In this mode, the prompt line should appear similar to:
[<context_name>]hostname<config-if-pvc)#

All configuration information specified with these commands is displayed using the Exec mode.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

description

Defines descriptive text to provide useful information about the current interface.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
description textno description
no

Erases the port’s description from the configuration file.

text

text: Must be a string of 1 to 79 alphanumeric characters with no spaces or a string within double quotes that includes printable characters. The description is case-sensitive.


Usage:

Set the description to provide helpful information, for example the port’s primary function, services, end users. Define any information, the only limit is the number of characters, 79.

Example

Example
description “PVC12 connects
server 1 to home office.”
end

Exits the PVC interface configuration mode and returns to the Exec mode.

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
end

Usage:

Change the mode back to the Exec mode.

exit

Exits the interface configuration mode and returns to the context configuration mode.

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
exit

Usage:

Return to the context configuration mode.

ip

The commands in this section are used to configure the IP parameters for the PVC interface.

IMPORTANT:

Before configuring the OSPF parameters in this section, you need to enable OSPF using the router command and OSPF configuration sub-mode commands accessed in the Context configuration mode and documented in the Context Configuration Mode chapter of this Command Line Interface Reference.

ip access-group

This command identities the access control list (ACL to be associated with this PVC interface in this context.

IMPORTANT:

Prior to using this command, the access list must be created for this context with the ip access-list command in the Context configuration mode and then the ACL must be configured using the commands described in CLI chapter ACL Configuration Mode.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip access-group  name { in | out } no ip access-group name { in | out }
no

Indicates the specified access group to be removed from the access list.

name

Specifies the access control list (ACL) rule to be added or removed from the group.

name: Must be a string of 1 to 79 alphanumeric characters with no spaces.

IMPORTANT:

Up to 8 ACLs can be applied to a group provided that the number of rules configured within the ACL(s) does not exceed the 128 rule limit for the interface.

in | out

in: Specifies list is for in-bound access control.

out: Specifies the list is for out-bound access control.

IMPORTANT:

Even though “in” or “out” can be specified, context-level ACL rules are automatically applied to both directions.


Usage:

Use this command to add IP access lists configured for the same context to an IP access-group. The list can be configured to apply to all inbound and/or outbound traffic.


Example:
The following adds ACL access-list-1 to the IP access-group associated with this PVC for this context.
ip access-group access-list-1 in
ip address

Defines the primary IP address and the network mask to be associated with this PVC interface for this context. This command can also be used to configure the secondary IP address.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip address ip_address ip_mask [ secondary ] no ip address ip_address
no

Removes the IP address information for this PVC from the configuration. It is not necessary to include the subnet mask with the command.

The command must first be issued with the secondary IP address if one exists and then re-issued with the primary IP address.

address ip_address ip_mask

Configures the IP address and the network mask for this PVC interface. The first time this command is entered, it automatically defines the primary IP address for this interface.

ip_address and ip_mask must be specified using the standard IPv4 or IPv6 dotted decimal notation.

secondary

secondary: Including this keyword indicates the IP address and subnet mask being defined are to be used as the secondary IP address for this PVC interface. This is referred to as multi-homing of the interface.


Usage:

Configures or deletes the IPv4 or IPv6 addresses and subnet mask to be associated with this PVC.


Example:
The following configures the secondary IP address to associate with the interface.
ip address 131.2.3.4
255.255.255.0  secondary
The following set of commands removes the primary IP address from the PVC interface configuration for this context.
no ip address secondary address
no ip address primary address
ip mtu

Configures the maximum transmission unit (MTU) to be supported on this interface.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip mtu valueno ip mtu
no

Disables and/or restores the option to the system default.

mtu value

Configures the maximum transmission unit in octets.

value: Enter an integer between 576 and 1600. Default is 1500.


Usage:

Change the maximum transmission unit size to 1300.

Example

Example
ip mtu 1300
ip ospf authentication-key

This command configures the password or key to be used for OSPF (Open Shortest Path First) authentication with neighboring routers.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf authentication-key [ encrypted ] password auth_keyno ip ospf authentication-key
no

Deletes the authentication key.

encrypted

Enter this keyword if you are pasting a previously encrypted authentication key into the password auth_key for this command.

passwordauth_key

auth_key is a string variable, from 1 through 16 alphanumeric characters, that denotes the authentication key (password). This variable is entered in clear text format.


Usage:

Use this command to set the authentication key used when authenticating with neighboring routers.


Example:
To set the authentication key to 123abc, use the following command;
ip ospf authentication-key
password 123abc
Use the following command to delete the authentication key;
no ip ospf authentication-key
ip ospf authentication-type

This command configures the OSPF authentication method to be used with OSPF neighbors over the logical interface.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf authentication-type { message-digest | null | text }no ip ospf authentication-type { message-digest | null | text }
no

Disable this function.

message-digest

Set the OSPF authentication type to use the message digest (MD) authentication method.

null

Set the OSPF authentication type to use no authentication, thus disabling either MD or clear text methods.

text

Set the OSPF authentication type to use the clear text authentication method.


Usage:

Use this command to set the type of authentication to use when authenticating with neighboring routers.


Example:
To set the authentication type to use clear text, enter the following command;
ip ospf authentication-type text
ip ospf cost

This command configures the cost associated with sending a packet over this logical interface.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf cost valueno ip ospf cost
no

Disable this function.

value

Default: 10

The cost to assign to OSPF packets. This must be an integer from 1 through 65535.


Usage:

Use this command to set the cost associated with routes from the interface.


Example:
Use the following command to set the cost to 20;
ip ospf cost 20
Use the following command to disable the cost setting;
no ip ospf cost
ip ospf dead-interval

This command configures the dead-interval and the delay time in seconds, for OSPF communications.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf dead-interval
 valueno ip ospf dead-interval 
no

Deletes the value set and returns the value to its default.

value

The interval, in seconds, that the router should wait. During this interval, if no packets are received then the system considers the neighboring router to be off-line. This interval is typically 4 times the duration of the hello-interval.

value must be an integer from 1 through 65535. Default: 40


Usage:

Use this command to set the dead-intervals or delays for OSPF communications.


Example:
To set the dead-interval to 100, use the following command;
ip ospf dead-interval 100
To delete the setting for the dead-interval and reset the dead-interval value to its default of 40, use the following command’
no ip ospf dead-interval
ip ospf hello-interval

This command configures the delay time in seconds, for OSPF hello interval.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf hello-interval
 valueno ip ospf hello-interval
no

Deletes the value set and returns the value to its default.

value

The interval, in seconds, between sending hello packets. This value is typically set to be 1/4 of the value of the dead-interval.

value must be an integer from 1 through 65535. Default: 10


Usage:

Use this command to set the delays for the hello-interval.


Example:
To set the hello-interval to 25, use the following command;
ip ospf hello-interval
 25
To delete the setting for the hello-interval and reset the hello-interval value to its default of 10, use the following command’
no ip ospf hello-interval
ip ospf message-digest-key

This command enables the use of MD5-based OSPF authentication.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf message-digest-key key_id  md5 [ encrypted ] password authentication_keyno ip ospfmessage-digest-key
 key_id
no

Deletes the key.

message-digest-key key_id

Specifies the key identifier number. key_id must be an integer from 1 through 255.

encrypted

Use this if you are pasting a previously encrypted authentication key into the CLI command.

password authentication_key

The password to use for authentication. authentication_key is a string variable, from 1 through 16 alphanumeric characters, that denotes the authentication password. This variable is entered in clear text format.


Usage:

Use this command to create an authentication key that uses MD5-based OSPF authentication.


Example:
To create a key with the ID of 25 and a password of 123abc, use the following command;
ip ospf message-digest-key 25 md5 password 123abc
To delete the same key, enter the following command;
no ip ospf message-digest-key 25
ip ospf network

Configures the OSPF network type.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf network { broadcast | non-broadcast | point-to-multipoint | point-to-point }no ip ospf network
no

Disable this function.

broadcast

Sets the network type to broadcast.

non-broadcast

Sets the network type to non-broadcast multi access (NBMA).

point-to-multipoint

Sets the network type to point-to-multipoint.

point-to-point

Sets the network type to point-to-point.


Usage:

Use this command to specify the OSPF network type.


Example:
To set the OSPF network type to broadcast, enter the following command;
ip ospf network broadcast
To disable the OSPF network type, enter the following command;
no ip ospf network
ip ospf priority

This command designates the OSPF router priority.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf priority valueno ip ospf priority
 value
no

Disable this function.

value

The priority value to assign. This must be an integer from 0 through 255.


Usage:

Use this command to set the OSPF router priority.


Example:
To set the priority to 25, enter the following command:
ip ospf priority 25
To disable the priority, enter the following command:
no ip ospf priority
ip ospf retransmit-interval

This command configures the retransmit-interval and the delay time in seconds, for OSPF communications.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf dead-interval valueno ip ospf dead-interval
no

Deletes the value set and returns the value to its default.

value

The interval, in seconds, between LSA (Link State Advertisement) retransmissions.

value must be an integer from 1 through 65535. Default: 5


Usage:

Use this command to set the retransmit-intervals or delays for OSPF communications.


Example:
To set the dead-interval to 25, use the following command;
ip ospf retransmit-interval 25
ip ospf transmit-delay

This command configures the transmit-delay the OSPF communications parameters.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Security Administrator, Administrator


Syntax
ip ospf transmit-delay valueno ip ospf transmit-delay
no

Deletes the value set and returns the value to its default.

transmit-delay value

The interval, in seconds, that the router should wait before transmitting a packet.

value must be an integer from 1 through 65535. Default: 1


Usage:

Use this command to set the transmit-delay.


Example:
To set the transmit delay to 5 seconds, use the following command;
ip ospf transmit-delay 5
To delete the setting for the transmit-delay or reset the transmit-delay value to its default of 1, use the following command’
no ip ospf transmit-delay