Table Of Contents

L Commands

lifetime seconds

line com1

line console

line vty

logging abort

logging commit

logging console

logging distribute

logging level

logging logfile

logging module

logging monitor

logging server

L Commands

---

The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.

lifetime seconds

To configure the security association (SA) lifetime duration for an IKE protocol policy, use the lifetime seconds command in IKE policy configuration submode. To revert to the default, use the no form of the command.

lifetime seconds seconds

no lifetime [seconds seconds]

Syntax Description

seconds

Specifies the lifetime duration in seconds. The range is 600 to 86400.

Defaults

86,400 seconds.

Command Modes

IKE policy configuration submode.

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

To use this command, the IKE protocol must be enabled using the crypto ike enable command.

The lifetime seconds command overrides the default.

Examples

The following example shows how to configure the SA lifetime duration for the IKE protocol.

switch# config terminal

switch(config)# crypto ike domain ipsec

switch(config-ike-ipsec)# policy 1

switch(config-ike-ipsec-policy)# lifetime seconds 6000

Related Commands

Command	Description
crypto ike domain ipsec	Enters IKE configuration mode.
crypto ike enable	Enables the IKE protocol.
policy	Configures IKE protocol policy.
show crypto ike domain ipsec	Displays IKE information for the IPsec domain.

line com1

To configure auxiliary COM 1 port, use the line com1 command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

line com1 -->
databits number |
flowcontrol hardware |
modem {in | init-string {default | user-input} | set-string user-input string} |
parity {even | none | odd} |
speed speed |
stopbits {1 | 2}

line com1 -->
no databits number |
no flowcontrol hardware |
no modem {in | init-string | set-string user-input} |
no parity {even | none | odd} |
no speed speed |
no stopbits {1 | 2}

Syntax Description

databits number	Specifies the number of databits per character. The range is 5 to 8.
flowcontrol hardware	Enables modem flowcontrol on the COM1 port.
modem	Enables the modem mode.
in	Enables the COM 1 port to only connect to a modem.
init-string default	Writes the default initialization string to the modem.
set-string user-input string	Sets the user-specified initilization string to its corresponding profile. Maximum length is 80 characters.
init-string user-default	Writes the provided initialization string to the modem.
parity	Sets terminal parity.
even	Sets even parity.
none	Sets no parity.
odd	Sets odd parity.
speed speed	Sets the transmit and receive speeds. The range is 110 to 115, 200 baud.
stopbits	Sets async line stopbits.
1	Sets one stop bit.
2	Sets two stop bits.

Defaults

9600 Baud

8 databits

1 stopbit

Parity none

Default init string

Command Modes

Configuration mode.

Command History

This command was modified in Cisco MDS SAN-OS Release 1.2(2).

Usage Guidelines

The line com1 command available in config t command mode. The line com1 configuration commands are available in config-com1 submode.

You can perform the configuration specified in this section only if you are connected to the console port or the COM1 port.

We recommend you use the default initialization string. If the required options are not provided in the user-input string, the initialization string is not processed.

You must first set the user-input string before initializing the string.

Examples

The following example configures a line console and sets the options for that terminal line.

switch## config terminal

switch(config)#

switch(config)# line com1

switch(config-com1)# databits 6

switch(config-com1)# parity even

switch(config-com1)# stopbits 1

The following example disables the current modem from executing its functions.

switch# config terminal

switch(config)# line com1

switch(config-com1)# no modem in

The following example enables (default) the COM1 port to only connect to a modem.

switch# config terminal

switch(config)# line com1

switch(config-com1)# modem in 

The following example Writes the provides initialization string to the modem. This is the default.

switch# config terminal

switch(config)# line com1

switch(config-com1)# modem init-string default

The following example assigns the user-specified initialization string to its corresponding profile.

switch# config terminal

switch(config)# line com1 

switch(config-com1)# modem set-string user-input ATE0Q1&D2&C1S0=3\015

The following example deletes the configured initialization string.

switch# config terminal

switch(config)# line com1 

switch(config-com1)# no modem set-string user-input ATE0Q1&D2&C1S0=3\015

The following example writes the user-specified initialization string to the modem.

switch# config terminal

switch(config)# line com1 

switch(config-com1)# modem init-string user-input

Related Commands

Command	Description
line console	Configure primary terminal line.
line vty	Configure virtual terminal line.
show line com1	Displays COM1 information.

line console

To configure a terminal line, use the line console command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

line console -->
databits number |
exec-timeout minutes |
modem {in | init-string | set-string user-input} |
parity {even | none | odd} |
speed speed |
stopbits {1 | 2}

line console -->
no databits number |
no exec-timeout minutes |
no modem {in | init-string {default | user-input} | set-string user-input string} |
no parity {even | none | odd} |
no speed speed |
no stopbits {1 | 2}

Syntax Description

databits number	Specifies the number of databits per character. The range is 5 to 8.
exec-timeout minutes	Configure exec timeout in minutes. The range is 0 to 525,600. To disable, set to 0 minutes.
modem	Enables the modem mode.
in	Enables the COM 1 port to only connect to a modem.
init-string default	Writes the default initialization string to the modem.
set-string user-input string	Sets the user-specified initilization string to its corresponding profile. Maximum length is 80 characters.
init-string user-input	Writes the provided initialization string to the modem.
parity	Sets terminal parity.
even	Sets even parity.
none	Sets no parity.
odd	Sets odd parity.
speed speed	Sets the transmit and receive speeds. The range is 110 to 115, 200 baud.
stopbits	Sets async line stopbits.
1	Sets one stop bit.
2	Sets two stop bits.

Defaults

9600 Baud

8 databits

1 stopbit

Parity none

Default init string

Command Modes

Configuration mode.

Command History

This command was modified in Cisco MDS SAN-OS Release 1.2(2).

Usage Guidelines

The line console command available in config t command mode. The line console configuration commands are available in config-console submode.

Examples

The following example configures a line console and sets the options for that terminal line.

switch## config terminal

switch(config)##

switch(config)# line console

switch(config-console)# databits 60

switch(config-console)# exec-timeout 60

switch(config-console)# flowcontrol software

switch(config-console)# parity even

switch(config-console)# stopbits 1

The following example disables the current modem from executing its functions.

switch# config terminal

switch(config)# line console

switch(config-console)# no modem in

The following example enables (default) the COM1 port to only connect to a modem.

switch# config terminal

switch(config)# line console

switch(config-console)# modem in 

The following example Writes the provides initialization string to the modem. This is the default.

switch# config terminal

switch(config)# line console

switch(config-console)# modem init-string default

The following example assigns the user-specified initialization string to its corresponding profile.

switch# config terminal

switch(config)# line console 

switch(config-console)# modem set-string user-input ATE0Q1&D2&C1S0=3\015

The following example deletes the configured initialization string.

switch# config terminal

switch(config)# line console 

switch(config-console)# no modem set-string user-input ATE0Q1&D2&C1S0=3\015

The following example writes the user-specified initialization string to the modem.

switch# config terminal

switch(config)# line console 

switch(config-console)# modem init-string user-input

Related Commands

Command	Description
line vty	Configure virtual terminal line.
line com1	Configures the auxiliary COM 1 port
show line console	Displays console information.

line vty

To configure a virtual terminal line, use the line vty command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

line vty -->
exec-timeout minutes |
session-limit number

line vty -->
no exec-timeout |
no session-limit number

Syntax Description

exec-timeout minutes	Configures timeout in minutes. The range is 0 to 525600. To disable, set to 0 minutes.
session-limit number	Configures the number of VSH sessions. The range is 1 to 64.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The line vty command available in config t command mode. line vty configuration commands available in config-line submode.

Examples

The following example configures a virtual terminal line and sets the timeout for that line.

switch## config terminal

switch(config)# line vty

switch(config-line)# exec-timeout 60

Related Commands

Command	Description
line console	Configure primary terminal line.
line com1	Confgiures the auxiliary COM 1 port

logging abort

To discard the logging Cisco Fabric Services (CFS) distribution session in progress, use the logging abort command in configuration mode.

logging abort

Syntax Description

This command has no other arguments or keywords.

Defaults

None.

Command Modes

Configuration mode.

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

None.

Examples

The following example shows how to discard logging CFS distribution session in progress.

switch# config terminal

switch(config)# logging abort

Related Commands

Command	Description
show logging	Displays logging information.

logging commit

To apply the pending configuration pertaining to the logging Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the logging commit command in configuration mode.

logging commit

Syntax Description

This command has no other arguments or keywords.

Defaults

None.

Command Modes

Configuration mode.

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

None.

Examples

The following example shows how to commit changes to the active logging configuration.

switch# config terminal

switch(config)# logging commit

Related Commands

Command	Description
show logging	Displays logging information.

logging console

To set console logging, use the logging console command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

logging console [severity-level]

no logging console [severity-level]

Syntax Description

severity-level

Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.

Defaults

Disabled.

The default severity level is 2.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The switch logs messages at or above the configured severity level.

Examples

The following example reverts console logging to the factory set default severity level of 2 (critical). Logging messages with a severity level of 2 or above will be displayed on the console.

switch# config terminal

switch(config)# logging console 2

Related Commands

Command	Description
show logging	Displays logging configuration information.

logging distribute

To enable Cisco Fabric Services (CFS) distribution for logging, use the logging distribute command. To disable this feature, use the no form of the command.

logging distribute

no logging distribute

Syntax Description

This command has no other arguments or keywords.

Defaults

Disabled.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the logging commit command.

Examples

The following example shows how to change the distribute logging configuration changes.

switch# config terminal

switch(config)# logging distribute

Related Commands

Command	Description
logging commit	Commits the logging configuration changes to the active configuration.
show logging	Displays logging information.

logging level

To modify message logging facilities, use the logging level command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

logging level facility-name severity-level

no logging level facility-name severity-level

Syntax Description

facility-name	Specifies the required facility name (for example acl, or ivr, or port, etc.)
severity-level	Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.

Defaults

Disabled

Command Modes

Configuration mode

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

The switch logs messages at or above the configured severity level.

Examples

Configures Telnet or SSH logging for the kernel facility at level 4 (warning). As a result, logging messages with a severity level of 4 or above will be displayed.

switch# config terminal

switch(config)# logging level kernel 4

logging logfile

To set message logging for logfile, use the logging logfile command.To negate the previously issued command or to revert to factory defaults, use the no form of the command.

logging logfile filename severity-level [size filesize]

no logging logfile

Syntax Description

filename	Specifies the log filename. Maximum length is 80 characters.
severity-level	Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.
size filesize	Specifies the log file size. The range is 4096 to 4194304 bytes.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The switch logs messages at or above the configured severity level.

Examples

The following example configures logging information for errors or events above a severity level of 3 (errors) to be logged in a file named ManagerLogFile. By configuring this limit, the file size is restricted to 3,000,000 bytes.

switch# config terminal

switch(config)# logging logfile ManagerLogFile 3 size 3000000

Related Commands

Command	Description
show logging	Displays logging configuration information.

logging module

To set message logging for linecards, use the logging module command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

logging module [severity-level]

no logging module [severity-level]

Syntax Description

severity-level

Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example sets message logging for modules at level 7.

switch## config terminal

switch(config)# logging module 7

Related Commands

Command	Description
show logging	Displays logging configuration information.

logging monitor

To set monitor message logging, use the logging monitor command. To negate the previously issued command or to revert to factory defaults, use the no form of the command.

logging monitor severity level

Syntax Description

logging monitor	Sets message logging.
severity level	0-7 0-emerg;1-alert;2-crit;3-err;4-warn;5-notif;6-inform;7-debug

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example sets terminal line (monitor) message logging at level 2.

switch## config terminal

switch(config)# logging monitor 2

Related Commands

Command	Description
show logging	Displays logging configuration information.

logging server

To set message logging for the remote server, use the logging server command.

logging server [hostname | ip address severity_level | facility auth | authpriv | cron | daemon | ftp | kernel | local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7 | lpr | mail | news | syslog | user | uucp]

Syntax Description

logging server	Sets message logging for remote server.
hostname	Enters host name for remote server.
ip address	Enters the IP address for the remote server.
severity_level	Enter severity level of message. 0-emerg;1-alert;2-crit;3-err;4-warn;5-notif;6-inform;7-debug
facility	Facility to use when forwarding to server
auth	Use auth facility
authpriv	Use authpriv facility
cron	Use Cron/at facility
daemon	Use daemon facility
ftp	Use file transfer system facility
kernel	Use kernel facility
local0	Use local0 facility
local1	Use local1 facility
local2	Use local2 facility
local3	Use local3 facility
local4	Use local4 facility
local5	Use local5 facility
local6	Use local6 facility
local7	Use local7 facility
lpr	Use lpr facility
mail	Use mail facility
news	Use USENET news facility
syslog	Use syslog facility
user	Use user facility
uucp	Use Unix-to-Unix copy system facility

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

Enable message logging to the specified remote server for level 7 messages.

switch## config terminal

switch(config)# logging sever sanjose 7 

Related Commands

Command	Description
show logging	Displays logging configuration information.