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.
Line templates define standard attribute settings for incoming and outgoing transport over physical and virtual terminal lines (vtys). Vty pools are used to apply template settings to ranges of vtys.
![]() Note | Before creating or modifying the vty pools, enable the telnet server using the telnet server command in XR Config mode. See IP Addresses and Services Configuration Guide for Cisco NCS 6000 Series Routers and IP Addresses and Services Command Reference for Cisco NCS 6000 Series Routers for more information. |
This module describes the new and revised tasks you need to implement physical and virtual terminals on your Cisco IOS XR network.
For more information about physical and virtual terminals on the Cisco IOS XR software and complete descriptions of the terminal services commands listed in this module, see Related Documents. To locate documentation for other commands that might appear in the course of running a configuration task, search online in .
Release |
Modification |
---|---|
Release 5.0.0 |
This feature was introduced. |
This module contains the following topics:
You must be in a user group associated with a task group that includes the proper task IDs. The command reference guides include the task IDs required for each command. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
To implement physical and virtual terminals, you need to understand the concepts in this section.
The following line templates are available in the Cisco IOS XR software.
Changes to line template attributes are made in line template configuration mode. To enter line template configuration mode, issue the line command from XR Config mode, specifying the template to be modified. These line templates can be configured with the line command:
After you specify a template with the line command, the router enters line template configuration mode where you can set the terminal attributes for the specified line. This example shows how to specify the attributes for the console:
RP/0/RP0/CPU0:router(config)# line console RP/0/RP0/CPU0:router(config-line)#
From line template configuration mode, use the online help feature ( ? ) to view all available options. Some useful options include:
absolute-timeout—Specifies a timeout value for line disconnection.
escape-character—Changes the line escape character.
exec-timeout—Specifies the EXEC timeout.
length—Sets the number of lines displayed on the screen.
session-limit—Specifies the allowable number of outgoing connections.
session-timeout—Specifies an interval for closing the connection if there is no input traffic.
timestamp—Displays the timestamp before each command.
width—Specifies the width of the display terminal.
The following guidelines apply to modifying the console template and to configuring a user-defined template:
Modify the template for virtual lines by configuring a user-defined template with the line template-name command, configuring the terminal attributes for the user-defined template from line template configuration, and applying the template to a range of virtual terminal lines using the vty pool command.
Attributes not defined in the console template, or any virtual template, are taken from the default template.
The default settings for the default template are described for all commands in line template configuration mode in the Terminal Services Commands on module in System Management Command Reference for Cisco NCS 6000 Series Routers.
![]() Note | Before creating or modifying the vty pools, enable the telnet server using the telnet server command in XR Config mode. See IP Addresses and Services Configuration Guide for Cisco NCS 6000 Series Routers and IP Addresses and Services Command Reference for Cisco NCS 6000 Series Routers for more information. |
The physical terminal lines for the console port is identified by its location, expressed in the format of rack/slot/module , on the active or standby route processor (RP) where the respective console port resides. For virtual terminals, physical location is not applicable; the Cisco IOS XR software assigns a vty identifier to vtys according to the order in which the vty connection has been established.
Each virtual line is a member of a pool of connections using a common line template configuration. Multiple vty pools may exist, each containing a defined number of vtys as configured in the vty pool. The Cisco IOS XR software supports the following vty pools by default:
Default vty pool—The default vty pool consists of five vtys (vtys 0 through 4) that each reference the default line template.
Default fault manager pool—The default fault manager pool consists of six vtys (vtys 100 through 105) that each reference the default line template.
In addition to the default vty pool and default fault manager pool, you can also configure a user-defined vty pool that can reference the default template or a user-defined template.
When configuring vty pools, follow these guidelines:
How to Implement Physical and Virtual Terminals on Cisco IOS XR Software
This task explains how to modify the terminal attributes for the console and default line templates. The terminal attributes that you set will modify the template settings for the specified template.
1.
configure
2.
line
{console | default}
3. Configure the terminal attribute settings for the specified template using the commands in line template configuration mode.
4.
Use one of the following commands:
This task explains how to create and modify vty pools.
You can omit 3 to 5 if you are configuring the default line template to reference a vty pool.
1.
configure
2.
telnet
{ipv4 | ipv6} server max-servers limit
3.
line
template
template-name
4. Configure the terminal attribute settings for the specified line template using the commands in line template configuration mode.
5.
exit
6.
vty-pool {default |
pool-name |
eem}
first-vty
last-vty [line-template {default |
template-name}]
7.
commit
This task explains how to monitor terminals and terminal sessions using the show EXEC commands available for physical and terminal lines.
![]() Note | The commands can be entered in any order. |
1.
(Optional)
show
line [aux
location
node-id | console
location
node-id | vty
number]
2.
(Optional)
show
terminal
3.
(Optional)
show
users
Command or Action | Purpose | |
---|---|---|
Step 1 |
show
line [aux
location
node-id | console
location
node-id | vty
number]
Example:
RP/0/RP0/CPU0:router# show line
| (Optional)
Displays the terminal parameters of terminal lines.
|
Step 2 |
show
terminal
Example:
RP/0/RP0/CPU0:router# show terminal
| (Optional)
Displays the terminal attribute settings for the current terminal line. |
Step 3 |
show
users
Example:
RP/0/RP0/CPU0:router# show users
| (Optional)
Displays information about the active lines on the router. |
The Craft Panel is an easily-accessible and user-friendly interface which assists the field operator in troubleshooting the router. It consists of a LCD display and three LEDs. The LEDs indicate minor, major and critical alarms.
For more details of the Craft Panel Interface, refer the Hardware and System set-up guides.
This configuration example shows how to modify the terminal attribute settings for the console line template:
line console exec-timeout 0 0 escape-character 0x5a session-limit 10 disconnect-character 0x59 session-timeout 100 transport input telnet transport output telnet
In this configuration example, the following terminal attributes are applied to the console line template:
To verify that the terminal attributes for the console line template have been applied to the console, use the show line command:
RP/0/RP0/CPU0:router# show line console location 0/0/CPU0
Tty Speed Modem Uses Noise Overruns Acc I/O
* con0/0/CPU0 9600 - - - 0/0 -/-
Line con0_0_CPU0, Location "Unknown", Type "Unknown"
Length: 24 lines, Width: 80 columns
Baud rate (TX/RX) is 9600, 1 parity, 2 stopbits, 8 databits
Template: console
Config:
Allowed transports are telnet.
This configuration example shows how to override the terminal settings for the default line template:
line default exec-timeout 0 0 width 512 length 512
In this example, the following terminal attributes override the default line template default terminal attribute settings:
This configuration example shows how to configure a user-defined line template (named test in this example) for vtys and to configure the line template test to reference the default vty pool:
line template test exec-timeout 100 0 width 100 length 100 exit vty-pool default 0 4 line-template test
This configuration example shows how to configure a user-defined line template (named test2 in this example) for vtys and to configure the line template test to reference a user-defined vty pool (named pool1 in this example):
line template test2 exec-timeout 0 0 session-limit 10 session-timeout 100 transport input all transport output all exit vty-pool pool1 5 50 line-template test2
This configuration example shows how to configure a user-defined line template (named test3 in this example) for vtys and to configure the line template test to reference the fault manager vty pool:
line template test3 width 110 length 100 session-timeout 100 exit vty-pool eem 100 106 line-template test3
The following sections provide references related to implementing physical and virtual terminals on Cisco IOS XR software.
Related Topic |
Document Title |
---|---|
Cisco IOS XR terminal services commands |
Terminal Services Commands on module of System Management Command Reference for Cisco NCS 6000 Series Routers |
Cisco IOS XR command master index |
|
Information about getting started with Cisco IOS XR software |
|
Information about user groups and task IDs |
Configuring AAA Services on module of System Security Configuration Guide for Cisco NCS 6000 Series Routers |
Standards |
Title |
---|---|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature. |
— |
MIBs |
MIBs Link |
---|---|
— |
To locate and download MIBs using Cisco IOS XR software, use the Cisco MIB Locator found at the following URL and choose a platform under the Cisco Access Products menu: http://cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml |
RFCs |
Title |
---|---|
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature. |
— |
Description |
Link |
---|---|
The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content. |