L Commands

This chapter describes the system management commands that begin with L.

locator-led

form of this command.

 
Syntax Description

Specifies the Blink chassis LED.

Specifies the LED blink pattern.

Specifies a long LED blink.

Specifies a medium LED blink.

Specifies a short LED blink.

Fabric Extender number. The range is from 100 to 199.

 
Command Default

None

 
Command Modes

EXEC mode

 
Command History

Release
Modification

5.0(2)N1(1)

This command was introduced.

 
Usage Guidelines

command to toggle the locator LED of a Fabric Extender, which allows you to easily identify the machine in a busy data center.

Examples

This example shows how to turn on the locator LED for a specific Fabric Extender chassis:

switch# locator-led fex 100
switch#
 

This example shows how to turn off the locator beacon LED for a specific Fabric Extender chassis:

switch# no locator-led fex 100
switch#
 

 
Related Commands

Command
Description

Displays all configured Fabric Extender chassis connected to the switch.

Displays the status of the locator LED in Fabric Extender modules.

logging abort

command.

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.

Examples

This example shows how to discard the changes made to the syslog server configuration:

switch(config)# logging distribute
switch(config)# logging abort
switch(config)#
 

 
Related Commands

Command
Description

Enables the distribution of the syslog server configuration to network switches using the CFS infrastructure.

Displays the pending changes to the syslog server configuration.

Displays the logging status.

logging commit

command.

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.

Examples

This example shows how to commit the distribution of the syslog server configuration:

switch(config)# logging distribute
switch(config)# commit
switch(config)#
 

 
Related Commands

Command
Description

Enables the distribution of the syslog server configuration to network switches using the CFS infrastructure.

Displays the logging status.

logging console

form of this command.

]

 
Syntax Description

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

  • 0 —emergency: System unusable
  • 1 —alert: Immediate action needed
  • 2 —critical: Critical condition—default level
  • 3 —error: Error condition
  • 4 —warning: Warning condition
  • 5 —notification: Normal but significant condition
  • 6 —informational: Informational message only
  • 7 —debugging: Appears during debugging only

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

Examples

This example shows how to enable logging messages with a severity level of 4 (warning) or higher to the console session:

switch# configure terminal
switch(config)# logging console 4
 

 
Related Commands

Command
Description

Displays the console logging configuration.

logging distribute

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

Distribution is disabled.

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1)

This command was introduced.

Examples

This example shows how to enable the distribution of the syslog server configuration:

switch(config)# logging distribute
switch(config)#
 

This example shows how to disable the distribution of the syslog server configuration:

switch(config)# no logging distribute
switch(config)#
 

 
Related Commands

Command
Description

Cancels the pending changes to the syslog server configuration.

Commits the changes to the syslog server configuration for distribution to the switches in the fabric.

Displays the logging status.

logging event

form of this command.

 
Syntax Description

Specifies to log all UP/DOWN and CHANGE messages.

Specifies to log all TRUNK status messages.

Specifies to the default logging configuration is used by interfaces not explicitly configured.

Enables the logging to override the port level configuration.

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

Examples

This example shows how to log interface events:

switch# configure terminal
switch(config)# logging event link-status default
 

 
Related Commands

Command
Description

Displays the logging status.

logging event port

form of this command.

 
Syntax Description

Specifies to log all UP/DOWN and CHANGE messages.

Specifies to log all TRUNK status messages.

(Optional) Specifies the default logging configuration that is used by interfaces not explicitly configured.

 
Command Default

None

 
Command Modes

Interface configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

Examples

This example shows how to log interface events:

switch# configure terminal
switch(config)# interface ethernet 1/1
switch(config-if)# logging event port link-status default
 

 
Related Commands

Command
Description

Displays the interface configuration information.

Displays the logging status.

logging ip access-list cache

form of this command.

}}

}}

 
Syntax Description

Specifies the maximum number of log entries that are cached in the software. The range is from 0 to 1048576. The default value is 8000 entries.

Specifies the maximum time interval before an entry is sent to a syslog. The range is from 5 to 86400. The default value is 300 seconds.

Specifies the number of packet matches (hits) before an entry is sent to a syslog. The range is from 0 to 1000000. The default value is 0 packets—rate limiting is off; the system log is not triggered by the number of packet matches.

 
Defaults

None

 
Command Modes

Global configuration

 
Supported User Roles

network-admin

 
Command History

Release
Modification

5.2(1)N1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to to specify the maximum number of log entries that are cached in the software:

switch# configure terminal
switch(config)# logging ip access-list cache entries 200
switch(config)#
 

This example shows how to specify the maximum time interval before an entry is sent to the system log:

switch# configure terminal
switch(config)# logging ip access-list cache interval 350
switch(config)#
 

This example shows how to specify the number of packet matches before an entry is sent to the system log:

switch# configure terminal
switch(config)# logging ip access-list cache threshold 125
switch(config)#

 
Related Commands

Command
Description

Displays the status of IP access list logging.

logging level

form of this command.

 
Syntax Description

facility.

Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

  • 0 —emergency: System unusable
  • 1 —alert: Immediate action needed
  • 2 —critical: Critical condition—default level
  • 3 —error: Error condition
  • 4 —warning: Warning condition
  • 5 —notification: Normal but significant condition
  • 6 —informational: Informational message only
  • 7 —debugging: Appears during debugging only

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

5.0(3)N1(1)

Support for multicast and unicast routing features was added.

5.0(3)N2(1)

Support for Flex Links and Fibre Channel over Ethernet (FCoE) N-Port Virtualizer (NPV) was added.

Examples

This example shows how to enable logging messages from the AAA facility that have a severity level of 2 or higher:

switch(config)# logging level aaa 2
 

 
Related Commands

Command
Description

Displays the facility logging level configuration.

logging logfile

form of this command.

]

]]]

 
Syntax Description

Name of the log file to be used to store system messages.

Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

  • 0 —emergency: System unusable
  • 1 —alert: Immediate action needed
  • 2 —critical: Critical condition—default level
  • 3 —error: Error condition
  • 4 —warning: Warning condition
  • 5 —notification: Normal but significant condition
  • 6 —informational: Informational message only
  • 7 —debugging: Appears during debugging only

(Optional) Specifies a maximum file size. The default file size is 4194304 bytes and can be configured from 4096 to 4194304 bytes.

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

Examples

This example shows how to configure a log file called logfile to store system messages and set its severity level to 4:

switch(config)# logging logfile logfile 4
 

 
Related Commands

Command
Description

Displays the log file.

logging module

form of this command.

]

 
Syntax Description

  • 0 —emergency: System unusable
  • 1 —alert: Immediate action needed
  • 2 —critical: Critical condition
  • 3 —error: Error condition
  • 4 —warning: Warning condition
  • 5 —notification: Normal but significant condition—default level
  • 6 —informational: Informational message only
  • 7 —debugging: Appears during debugging only

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

 
Usage Guidelines

Set a specified severity level or use the default.

Examples

This example shows how to enable module log messages:

switch(config)# logging module
 

 
Related Commands

Command
Description

Displays the module logging status.

logging monitor

form of this command.

]

 
Syntax Description

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

  • 0 —emergency: System unusable
  • 1 —alert: Immediate action needed
  • 2 —critical: Critical condition—default level
  • 3 —error: Error condition
  • 4 —warning: Warning condition
  • 5 —notification: Normal but significant condition
  • 6 —informational: Informational message only
  • 7 —debugging: Appears during debugging only

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

 
Usage Guidelines

This configuration applies to Telnet and Secure Shell (SSH) sessions.

Examples

This example shows how to enable monitor log messages:

switch(config)# logging monitor
 

 
Related Commands

Command
Description

Displays the status of monitor logging.

logging server

form of this command.

 
Syntax Description

Hostname or IPv4/IPv6 address of the remote syslog server.

(Optional) Number of the desired severity level at which messages should be logged. Messages at or numerically lower than the specified level are logged. Severity levels are as follows:

  • 0 —emergency: System unusable
  • 1 —alert: Immediate action needed
  • 2 —critical: Critical condition—default level
  • 3 —error: Error condition
  • 4 —warning: Warning condition
  • 5 —notification: Normal but significant condition
  • 6 —informational: Informational message only
  • 7 —debugging: Appears during debugging only

.

(Optional) Specifies the virtual routing and forwarding (VRF) to be used in the remote server. The name can be a maximum of 32 alphanumeric characters.

Specifies the management VRF. This is the default VRF.

 
Command Default

.

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

4.1(3)N2(1)

keyword was added.

Examples

This example shows how to configure a remote syslog server at a specified IPv4 address, using the default outgoing facility:

switch(config)# logging server 192.168.2.253
 

This example shows how to configure a remote syslog server at a specified hostname with severity level 5 or higher:

switch(config)# logging server syslogA 5
 

 
Related Commands

Command
Description

Displays the configured syslog servers.

logging timestamp

form of this command.

}

}

 
Syntax Description

.

Specifies the units to use for logging timestamps in milliseconds.

.

 
Command Default

None

 
Command Modes

Global configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

 
Usage Guidelines

By default, the units are seconds.

Examples

This example shows how to set the logging time-stamp units to microseconds:

switch(config)# logging timestamp microseconds
 

 
Related Commands

Command
Description

Displays the logging time-stamp configuration.