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.
This chapter describes how to manage the terminal settings and sessions on a Cisco NX-OS device.
This chapter includes the following sections:
This section includes information about terminal settings and sessions.
The Cisco NX-OS software features allow you to manage the following characteristics of terminals:
The console port is an asynchronous serial port that allows you to connect to the device for initial configuration through a standard RS-232 port with an RJ-45 connector. Any device connected to this port must be capable of asynchronous transmission. You can configure the following parameters for the console port:
Configure your terminal emulator with 9600 baud, 8 data bits, 1 stop bit, and no parity.
A COM1 port is an RS-232 port with a DB-9 interface that enables you to connect to an external serial communication device such as a modem. You can configure the following parameters for the COM1 port:
Configure your terminal emulator with 9600 baud, 8 data bits, 1 stop bit, and no parity.
You can use virtual terminal lines to connect to your Cisco NX-OS device. Secure Shell (SSH) and Telnet create virtual terminal sessions. You can configure an inactive session timeout and a maximum sessions limit for virtual terminals.
You can connect a modem to the COM1 or console ports on the supervisor module. The following modems were tested on devices running the Cisco NX-OS software:
MultiTech MT2834BA (http://www.multitech.com/en_us/support/families/multimodemii/)
Hayes Accura V.92 (http://www.hayesmicro.com/Products/accura-prod-v92.htm)
Note |
Do not connect a modem when the device is booting. Only connect the modem when the device is powered-up. |
The Cisco NX-OS software has the default initialization string (ATE0Q1&D2&C1S0=1\015) to detect connected modems. The default string is defined as follows:
Except for removing the configuration for a missing module, the configuration file operations are local to the virtual device context (VDC). You can remove the missing module configuration only from the default VDC. For more information on VDCs, see the Cisco Nexus 7000 Series NX-OS Virtual Device Context Configuration Guide, Release 4.2.
The following table shows the licensing requirements for this feature:
Product |
License Requirement |
---|---|
Cisco NX-OS |
Terminal setting configuration requires no license. Any feature not included in a license package is bundled with the Cisco NX-OS system images and is provided at no extra charge to you. For a complete explanation of the Cisco NX-OS licensing scheme, see the Cisco Nexus 7000 Series NX-OS Licensing Guide, Release 4.2. |
You can set the following characteristics for the console port:
Log in to the console port.
Ensure that you are in the default VDC.
Command or Action | Purpose | |
---|---|---|
Step 1 | configure terminal Example: switch# configure terminal switch(config)# |
Enters global configuration mode. |
Step 2 | line console Example: switch# line console switch(config-console)# |
Enters console configuration mode. |
Step 3 | databits bits Example: switch(config-console)# databits 7 |
Configures the number of data bits per byte. The range is from 5 to 8. The default is 8. |
Step 4 | exec-timeout minutes Example: switch(config-console)# exec-timeout 30 |
Configures the timeout for an inactive session. The range is from 0 to 525600 minutes (8760 hours). A value of 0 minutes disables the session timeout. The default is 0 minutes. |
Step 5 | parity {even | none | odd} Example: switch(config-console)# parity even |
Configures the parity. The default is none. |
Step 6 | speed {300 | 1200 | 2400 | 4800 | 9600 | 38400 | 57600 | 115200} Example: switch(config-console)# speed 115200 |
Configures the transmit and receive speed. The default is 115200. |
Step 7 | stopbits {1 | 2} Example: switch(config-console)# stopbits 2 |
Configures the stop bits. The default is 1. |
Step 8 | exit Example: switch(config-console)# exit switch(config)# |
Exits console configuration mode. |
Step 9 | show line console Example: switch(config)# show line console |
(Optional) Displays the console settings. |
Step 10 | copy running-config startup-config Example: switch(config)# copy running-config startup-config |
(Optional) Copies the running configuration to the startup configuration. |
You can set the following characteristics for the COM1 port:
Log in to the console port or COM1 port.
Ensure that you are in the default VDC.
Command or Action | Purpose | |
---|---|---|
Step 1 | configure terminal Example: switch# configure terminal switch(config)# |
Enters global configuration mode. |
Step 2 | line com1 Example: switch# line com1 switch(config-com1)# |
Enters COM1 configuration mode. |
Step 3 | databits bits Example: switch(config-com1)# databits 7 |
Configures the number of data bits per byte. The range is from 5 to 8. The default is 8. |
Step 4 | flowcontrol hardware Example: switch(config-com1)# flowcontrol hardware |
Enables flow control on the hardware. The default is enabled. Use the no flowcontrol hardware command to disable flow control on the hardware. |
Step 5 | parity {even | none | odd} Example: switch(config-com1)# parity even |
Configures the parity. The default is none. |
Step 6 | speed {300 | 1200 | 2400 | 4800 | 9600 | 38400 | 57600 | 115200} Example: switch(config-com1)# speed 115200 |
Configures the transmit and receive speed. The default is 9600. |
Step 7 | stopbits {1 | 2} Example: switch(config-com1)# stopbits 2 |
Configures the stop bits. The default is 1. |
Step 8 | exit Example: switch(config-com1)# exit switch(config)# |
Exits COM1 configuration mode. |
Step 9 | show line com1 Example: switch(config)# show line com1 |
(Optional) Displays the COM1 port settings. |
Step 10 | copy running-config startup-config Example: switch(config)# copy running-config startup-config |
(Optional) Copies the running configuration to the startup configuration. |
This section describes how to configure virtual terminals on Cisco NX-OS devices.
You can configure a timeout for inactive virtual terminal sessions on a Cisco NX-OS device.
Command or Action | Purpose | |
---|---|---|
Step 1 | configure terminal Example: switch# configure terminal switch(config)# |
Enters global configuration mode. |
Step 2 | line vty Example: switch# line vty switch(config-line)# |
Enters line configuration mode. |
Step 3 | exec-timeout minutes Example: switch(config-line)# exec-timeout 30 |
Configures the inactive session timeout for the VDC. The range is from 0 to 525600 minutes (8760 hours). A value of 0 minutes disables the timeout. The default value is 0. |
Step 4 | exit Example: switch(config-line)# exit switch(config)# |
Exits line configuration mode. |
Step 5 | show running-config all | begin vty Example: switch(config)# show running-config all | begin vty |
(Optional) Displays the virtual terminal configuration. |
Step 6 | copy running-config startup-config Example: switch(config)# copy running-config startup-config |
(Optional) Copies the running configuration to the startup configuration. |
You can limit the number of virtual terminal sessions on your Cisco NX-OS device.
Command or Action | Purpose | |
---|---|---|
Step 1 | configure terminal Example: switch# configure terminal switch(config)# |
Enters global configuration mode. |
Step 2 | line vty Example: switch# line vty switch(config-line)# |
Enters line configuration mode. |
Step 3 | session-limit sessions Example: switch(config-line)# session-limit 10 |
Configures the maximum number of virtual sessions for the Cisco NX-OS device. The range is from 1 to 64. The default is 32. |
Step 4 | exit Example: switch(config-line)# exit switch(config)# |
Exits line configuration mode. |
Step 5 | show running-config all | being vty Example: switch(config)# show running-config all | begin vty |
(Optional) Displays the virtual terminal configuration. |
Step 6 | copy running-config startup-config Example: switch(config)# copy running-config startup-config |
(Optional) Copies the running configuration to the startup configuration. |
You can connect a modem to either the COM1 port or the console port.
We recommend that you use the COM1 port to connect the modem.
You must enable the modem connection on the port before you can use the modem.
Log in to the console port.
Ensure that you are in the default VDC.
The Cisco NX-OS software provides a default initialization string that you can download for connecting with the modem. The default initialization string is ATE0Q1&D2&C1S0=1\015.
Log in to the console port.
Ensure that you are in the default VDC.
Command or Action | Purpose | |||||||
---|---|---|---|---|---|---|---|---|
Step 1 | configure terminal Example: switch# configure terminal switch(config)# |
Enters global configuration mode. |
||||||
Step 2 | Enter one of the following commands:
Example: switch# line com1 switch(config-com1)# |
|||||||
Step 3 | modem init-string default Example: switch(config-com1)# modem init-string default |
Writes the default initialization string to the modem. |
||||||
Step 4 | exit Example: switch(config-com1)# exit switch(config)# |
Exits COM1 or console configuration mode. |
||||||
Step 5 | show line Example: switch(config)# show line |
(Optional) Displays the COM1 and console settings. |
||||||
Step 6 | copy running-config startup-config Example: switch(config)# copy running-config startup-config |
(Optional) Copies the running configuration to the startup configuration. |
You can configure and download your own initialization when the default initialization string is not compatible with your modem.
Log in to the console port.
Ensure that you are in the default VDC.
Command or Action | Purpose | |||||||
---|---|---|---|---|---|---|---|---|
Step 1 | configure terminal Example: switch# configure terminal switch(config)# |
Enters global configuration mode. |
||||||
Step 2 | Enter one of the following commands:
Example: switch# line com1 switch(config-com1)# |
|||||||
Step 3 | modem set-string user-input string Example: switch(config-com1)# modem set-string user-input ATE0Q1&D2&C1S0=3\015 |
Sets the user-specified initialization string for the COM1 or console port. The initialization string is alphanumeric and case sensitive, can contain special characters, and has a maximum of 100 characters.
|
||||||
Step 4 | modem init-string user-input Example: switch(config-com1)# modem init-string user-input |
Writes the user-specified initialization string to the modem connected to the COM1 or console port. |
||||||
Step 5 | exit Example: switch(config-com1)# exit switch(config)# |
Exits COM1 or console configuration mode. |
||||||
Step 6 | show line Example: switch(config)# show line |
(Optional) Displays the COM1 and console settings. |
||||||
Step 7 | copy running-config startup-config Example: switch(config)# copy running-config startup-config |
(Optional) Copies the running configuration to the startup configuration. |
If you connect a modem to a powered-up physical device, you must initialize the modem before you can use it.
After waiting until the Cisco NX-OS device has completed the boot sequence and the system image is running, connect the modem to either the COM1 port or the console port on the device.
Enable the modem connection on the port.
Ensure that you are in the default VDC.
Command or Action | Purpose | |
---|---|---|
Step 1 | modem connect line {com1 | console} Example: switch# modem connect line com1 |
Initializes the modem connected to the device. |
You can clear terminal sessions on the Cisco NX-OS device.
Command or Action | Purpose | |
---|---|---|
Step 1 | show users Example: switch# show users |
(Optional) Displays the user sessions on the device. |
Step 2 | clear line name Example: switch# clear line pts/0 |
Clears a terminal session on a specific line. The line name is case sensitive. |
To display terminal and session information, perform one of the following tasks:
Command |
Purpose |
---|---|
show terminal | Displays terminal settings. |
show line | Displays the COM1 and console ports settings. |
show users | Displays virtual terminal sessions. |
show running-config [all] | Displays the user account configuration in the running configuration. The all keyword displays the default values for the user accounts. |
For detailed information about the fields in the output from these commands, see the Cisco Nexus 7000 Series NX-OS Fundamentals Command Reference, Release 4.2.
Parameters |
Default |
---|---|
Default filesystem |
bootflash: |
Related Topic |
Document Title |
---|---|
Licensing |
Cisco Nexus 7000 Series NX-OS Licensing Guide, Release 4.2 |
Command reference |
Cisco Nexus 7000 Series NX-OS Fundamentals Command Reference, Release 4.2 |