T Commands

This chapter describes the Cisco NX-OS system management commands that begin with the letter T.

tag

To correlate multiple events in the policy, use the tag command.

tag tag {and | andnot | or} tag [and | andnot | or {tag}] {happens occurs in seconds}

 
Syntax Description

tag

Tag name. The tag name can be any 29 alphanumeric characters.

and

(Optional) Specifies to use boolean and logic

andnot

(Optional) Specifies to use boolean andnot logic

or

(Optional) Specifies to use boolean or logic

happens

Specifies the number of occurrences before raising the event.

in

Specifies the number of occurrences must occur within this time period.

occurs

Numbers of times that the event occurs. The range is from 1 to 4294967295.

seconds

Amount of time, in seconds, that the next event occurs. The range is from 0 to 4294967295 seconds.

 
Defaults

None

 
Command Modes

(config-applet)

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

5.2(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to correlate multiple events in the policy:

switch# configuration terminal
switch(config)# event manager applet “monitorShutdown”
switch(config-applet)# description “Monitors interface shutdown.”
switch(config-applet)# event cli match “shutdown”
switch(config-applet)# tag one or two happens 1 in 10000
switch(config-applet)# action 1.0 cli show interface e 3/1

 
Related Commands

Command
Description

show flow exporter

Displays information about NetFlow exporters.

 

template data timeout

To configure the template data timeout parameter for the NetFlow exporter, use the template data timeout command. To remove the template data timeout parameter, use the no form of this command.

template data timeout time

no template data timeout [ time ]

 
Syntax Description

time

(Optional) Time in seconds. The range is from 1 to 86400.

 
Defaults

None

 
Command Modes

NetFlow exporter version 9 configuration (config-flow-exporter-version-9)

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the template data timeout parameter:

switch(config)# flow exporter Netflow-Exporter-1
switch(config-flow-exporter)# version 9
switch(config-flow-exporter-version-9)# template data timeout 120
 

This example shows how to remove the template data timeout parameter configuration:

switch(config-flow-exporter)# version 9
switch(config-flow-exporter-version-9)# no template data timeout 120

 
Related Commands

Command
Description

show flow exporter

Displays information about NetFlow exporters.

terminal event-manager bypass

To allow the CLI commands that match an Embedded Event Manager (EEM) policy to continue to run, use the terminal event-manager bypass command. To prevent such commands from running, use the no form of this command.

terminal event-manager bypass

terminal no event-manager bypass

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

 
Command History

Release
Modification

4.2(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to allow the CLI commands that match an EEM policy to continue to run:

switch# terminal event-manager bypass
switch#

 

This example shows how to prevent the CLI commands that match an EEM policy from running:

switch# terminal no event-manager bypass
switch#

 
Related Commands

Command
Description

event manager policy

Registers an Embedded Event Manager (EEM) policy with the EEM.

test watchdog

To test the watchdog feature, use the test watchdog command.

test watchdog

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to test the watchdog feature:

switch(config)# test watchdog
Warning: This command will reboot the system if watchdog is functioning properly
.
Do you wish to proceed anyway? (y/n)

 
Related Commands

Command
Description

system watchdog

Enables the watchdog feature.

system no watchdog

Disables the watchdog feature.

transport email mail-server

To configure up to five SMTP servers as the domain name server (DNS) names, IPv4 addresses, or IPv6 addresses for Call home, use the transport email mail-server command.

transport email mail-server ip-address [ port port-number] [ priority priority - number] [ use-vrf vrf-name ]

 
Syntax Description

ip-address

Domain name server (DNS) name, IPv4 address, or IPv6 address.

port port-number

(Optional) Specifies the port number. The range is from 1 to 65535. The default port number is 25.

priority priority-number

(Optional) Specifies the priority of the SMTP server. The range is from 1 to 100, with 1 being the highest priority and 100 the lowest. If you do not specify a priority, the default value of 50 is used.

use-vrf vrf-name

(Optional) Specifies the virtual routing and forwarding (VRF) name.

 
Defaults

None

 
Command Modes

Call home configuration

 
Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

 
Command History

Release
Modification

5.0(1)

This command was introduced.

 
Usage Guidelines

You can configure up to five SMTP servers for Call home. The VRF specified in the transport email mail-server command is not used to send messages using HTTP. When CFS distribution is enabled, devices that run Release 4.2 or earlier releases accept only the transport email smtp-server command configurations while devices that run Release 5.0(1) or later releases accept both the transport email smtp-server and transport email mail-server command configurations.

When a device accepts both the transport email smtp-server and transport email mail-server commands, the transport email smtp-server command has a priority of 0, which is the highest. The server specified by this command is tried first followed by the servers specified by the transport email mail-server commands in order of priority.

This command does not require a license.

Examples

This example shows how to configure multiple SMTP servers for Call home messages:

switch(config)# callhome
switch(config-callhome)# transport email mail-server 192.0.2.1 port 33 priority 1 use-vrf Red
switch(config-callhome)# transport email mail-server 192.0.2.10 priority 4

switch(config-callhome)# transport email mail-server 172.21.34.193

switch(config-callhome)# transport email smtp-server 10.1.1.174

switch(config-callhome)# transport email mail-server 64.72.101.213 priority 60

switch(config-callhome)# transport email from person@company.com

switch(config-callhome)# transport email reply-to person@company.com
switch(config-callhome)#
 

Based on the configuration above, the SMTP servers would be tried in this order:

10.1.1.174 (priority 0)

192.0.2.1 (priority 1)

172.21.34.193 (priority 50, which is the default)

64.72.101.213 (priority 60)

 
Related Commands

Command
Description

transport http use-vrf

Configures a VRF to send Call home messages using HTTP.

transport email smtp-server

Distributes the SMTP server configuration to devices that run Release 4.2 or earlier releases.

transport http proxy enable

To enable Smart Call Home to send all HTTP messages through the HTTP proxy server, use the transport http proxy enable command.

transport http proxy enable

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

Call home configuration mode (config-callhome)

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

5.2(1)

This command was introduced.

 
Usage Guidelines

You can use this command only after the proxy server address has been configured.

The virtual routing and forwarding (VRF) instance used for transporting messages through the proxy server is the same as that configured using the transport http use-vrf command.

This command does not require a license.

Examples

This example shows how to enable Smart Call Home to send all HTTP messages through the HTTP proxy server:

switch# configure terminal
switch(config)# callhome
switch(config-callhome)# transport http proxy server 192.0.2.1
switch(config-callhome)# transport http proxy enable
switch(config-callhome)#

 
Related Commands

Command
Description

transport http proxy server

Configures the HTTP proxy server domain name server (DNS) name, IPv4 address, or IPv6 address.

show callhome transport

Displays the transport-related configuration for Smart Call Home.

transport http proxy server

To configure the HTTP proxy server domain name server (DNS) name, IPv4 address, or IPv6 address, use the transport http proxy server command.

transport http proxy server {ip-address | proxy-server-name} [port port-number]

 
Syntax Description

ip-address

IPv4 or IPv6 address of the proxy server.

proxy-server-name

DNS name of the proxy server.

port port-number

(Optional) Specifies the port number. The range is from 1 to 65535. The default port number is 8080.

 
Defaults

Disabled

 
Command Modes

Call home configuration mode (config-callhome)

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

5.2(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the HTTP proxy server DNS name, IPv4 address, or IPv6 address:

switch# configure terminal
switch(config)# callhome
switch(config-callhome)# transport http proxy server http://www.yoursite.com port 5050

 
Related Commands

Command
Description

transport http proxy enable

Enables Smart Call Home to send all HTTP messages through the HTTP proxy server.

show callhome transport

Displays the transport-related configuration for Smart Call Home.

transport http use-vrf

To configure the virtual routing and forwarding (VRF) instance used to send e-mail and other Call home messages over the Hypertext Transfer Protocol (HTTP), use the transport http use-vrf command.

transport http use-vrf vrf-name

 
Syntax Description

vrf-name

Virtual routing and forwarding (VRF) name. The name can any alphanumeric string up to 255 characters.

 
Defaults

None

 
Command Modes

Call home configuration

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

5.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a VRF to send Call home messages using HTTP:

switch(config)# callhome
switch(config-callhome)# transport http use-vrf Blue
switch(config-callhome)#

 
Related Commands

Command
Description

transport email mail-server

Configures multiple SMTP servers as the domain name server (DNS) names, IPv4 addresses, or IPv6 addresses for Call home.

transport udp

To configure a NetFlow exporter to transport over UDP, use the transport udp command. To remove the transport configuration, use the no form of this command.

transport udp port-number

no transport udp [ port-number ]

 
Syntax Description

port-number

(Optional) Destination UDP port number.

 
Defaults

None

 
Command Modes

NetFlow exporter configuration (config-flow-exporter)

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a NetFlow exporter to transport over UDP:

switch(config)# flow exporter Netflow-Exporter-1
switch(config-flow-exporter)# transport udp 200
switch(config-flow-exporter)#
 

This example shows how to remove the UDP configuration:

switch(config-flow-exporter)# no transport udp 200
switch(config-flow-exporter)#

 
Related Commands

Command
Description

show flow exporter

Displays information about NetFlow exporters.