Cisco Service and Application Module for IP User Guide
SAMI LCP Commands
Downloads: This chapterpdf (PDF - 372.0KB) The complete bookPDF (PDF - 3.24MB) | Feedback

SAMI LCP Commands

Table Of Contents

SAMI LCP Commands

boot eobc:

clear cde

clear cores

clear daughtercard fpga statistics

config-register

confreg (LCP ROM monitor)

console-select

debug sami bouncer_svc

debug sami dc_health

debug sami ppc_download

debug sami session_agent

delete

dir

erase ppc-flash

exception ixp

hostname

interface

ip route

processor config-register

reload

reload sami processor

reprogram bootflash

set cde destindex

set cde vlan

show cde

show cde destindex

show cde vlan

show daughtercard fpga statistics

show daughtercard registers

show login timeout

show running-config

show startup-config

show tech-support

show version

upgrade-rommon

write

Network Processor Console Command

shutdown


SAMI LCP Commands


The following commands, listed in alphabetical order, are introduced or modified for the Cisco SAMI, and are supported at a SAMI LCP console:

boot eobc: (LCP ROM monitor command)

clear cde

clear cores

clear daughtercard fpga statistics

confreg (LCP ROM monitor)

console-select

debug sami bouncer_svc

debug sami dc_health

debug sami ppc_download

debug sami session_agent

delete

dir

erase ppc-flash

exception ixp

hostname

interface

ip route

processor config-register (LCP ROM monitor command)

processor config-register

reload

reload sami processor

reprogram bootflash

set cde destindex

set cde vlan

show cde

show cde destindex

show cde vlan

show daughtercard fpga statistics

show daughtercard registers

show login timeout

show running-config

show startup-config

show tech-support

show version

upgrade-rommon

write

boot eobc:

To boot the SAMI from the image on the supervisor engine, use the boot eobc: ROM-monitor command.

boot eobc:

Syntax Description

This command has no keywords or arguments.

Defaults

No default behavior or values exist.

Command Modes

ROM monitor

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

Use the boot eobc: command to boot the SAMI using the image on the supervisor engine.

Examples

The following example shows how to boot the SAMI from the image on the supervisor engine:

rommon 1> boot eobc:

Related Commands

Command
Description

boot device module

Sets the boot variable for the SAMI LCP. (This is supervisor console command.)


clear cde

To clear the classification and distribution engine (CDE) statistics and interrupt counts, use the clear cde command.

clear cde {interrupt | stats}

Syntax Description

interrupt

Clears the CDE interrupt counts.

stats

Clears the CDE statistics.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

This command clears the statistics and counts that display using the show cde command.


Note This command is for use by trained personnel for troubleshooting purposes only.


Examples

To clear the CDE interrupt counts, enter:

switch# clear cde interrupt

Related Commands

Command
Description

show cde

Displays CDE statistics and counts.


clear cores

To clear all of the core dumps stored in the core file system, use the clear cores command.

clear cores

Syntax Description

This command has no keywords or arguments.

Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

To view the list of core files in the core file system, use the dir core command.

To save a copy of a core dump to a remote server before clearing it, use the copy capture command.

To delete a specific core dump file from the core file system, use the delete core command.


Note The SAMI creates a core dump when it experiences a fatal error. Core dump information is for Cisco Technical Assistance Center (TAC) use only. We recommend that you contact TAC for assistance in interpreting information in a core dump.


Examples

To clear all core dumps, enter:

switch# clear cores

Related Commands

Command
Description

delete

Deletes core dumps stored in the core.

dir

Displays core dumps stored in the core.


clear daughtercard fpga statistics

To clear all field programmable gate array (FPGA) statistics for a SAMI daughter card, use the clear daughtercard fpga statistics command.

clear daughtercard card_number fpga statistics

Syntax Description

card number

Number of the card for which you want to clear FPGA-related statistics. A valid value is 1 or 2.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

This command clears the statistics displayed by the show daughtercard fpga statistics command.

Examples

To clear all FPGA statistics on SAMI daughter card 1, enter:

switch# clear daughtercard 1 fpga statistics

Related Commands

Command
Description

show daughtercard fpga statistics

Displays the FPGA statistics for a SAMI daughter card.


config-register

To change the configuration register settings of the SAMI LCP, use the config-register command.

config-register value

Syntax Description

value

Configuration register value that you want to use next time you restart the SAMI LCP. The supported values are:

0—Upon reboot, the SAMI LCP boots to ROM monitor and remains in ROM monitor mode at startup.

1—Upon reboot, the SAMI LCP boots the system image identified in the Boot environment variable.


Defaults

This command has no default.

Command Modes

Configuration

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The config-register command affects only the configuration register bits that control the boot field and

leaves the remaining bits unaltered.

To configure the SAMI LCP to autoboot the system image identified in the boot environment variable, use the config-register command and set the configuration register to 1.

Examples

The following example sets the boot field in the configuration register to boot the system image identified in the Boot environment variable upon reboot:

switch(config)# config-register 1

Command History

Command
Description

boot system image

Specifies the system image that the router loads at startup.

processor config-register

Sets the configuration register for the SAMI PPCs.


confreg (LCP ROM monitor)

To change the configuration register settings while in ROM monitor mode, use the confreg command in ROM monitor mode.

confreg value

Syntax Description

value

Configuration register value that you want to use next time you restart the SAMI LCP. The supported values are:

0—Upon reboot, the SAMI LCP boots to ROM monitor and remains in ROM monitor mode at startup.

1—Upon reboot, the SAMI LCP boots the system image identified in the BOOT environment variable.


Defaults

This command has no default.

Command Modes

ROM monitor

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The config-register command affects only the configuration register bits that control the boot field and

leaves the remaining bits unaltered.

Examples

The following example sets the boot field in the configuration register to boot the system image identified in the Boot environment variable upon reboot:

rommon 1># confreg 1

Related Commands

Command
Description

boot eobc:

Boots the SAMI from the image on the supervisor engine.


console-select

To configure a SAMI powerPC (PPC) on daughter card 1 to be accessible from the console port on the SAMI front panel, use the console-select db1 command.

console-select {db1 processor_number | db2 processor_number}

Syntax Description

db1 processor_number

Number of the PPC on daughter card 1 to be connected to the console port on daughter card 1. A valid value is a number between 3 and 5.

db2 processor_number

Number of the PPC on daughter card 2 to be connected to the console port on daughter card 2. A valid value is a number between 6 and 8.


Defaults

Daughter card 1—Console 3 is connected to the daughter card 1 console port on the SAMI front panel.

Daughter card 2—Console 6 is connected to the daughter card 2 console port on the SAMI front panel.

Command Modes

Configuration

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use this command to configure one of the three PPCs on daughter card 1 of a SAMI to be accessible externally using the daughter card console port on the SAMI front panel.

By default, PPC 3 can be accessed by console port for db1 and PPC 6 can be accessed by console port of db2. After a different PPC is configured to be accessible from the console port on the SAMI front panel using the console-select commands, the newly configured PPC will continue to be accessible across router reloads.

Examples

To configure the PPC4 on daughter card 1 to be accessible from the daughter 1 console port on the SAMI front panel, enter:

switch(config)# console-select db1 4

debug sami bouncer_svc

To display information on bouncer svc daemon processing, use the debug sami bouncer_svc command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug sami bouncer {errors | events | packets}

no debug sami bouncer {errors | events | packets}

Syntax Description

errors

Displays errors.

events

Displays events.

packet

Displays information per-packet.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use the debug sami bouncer_svc command to view bouncer svc daemon debugging information.

Examples

The following example shows events that occur during bouncer svc daemon processing.

switch# debug sami bouncer_svc events

debug sami dc_health

To display information on sami cd health daemon processing, use the debug sami dc_health command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug sami dc_health {errors | events}

no debug sami dc_health {errors | events}

Syntax Description

errors

Displays errors.

events

Displays events.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use the debug sami dc_health command to view sami cd health daemon debugging information.

Examples

The following example shows events that occur during sami cd health processing.

switch# debug sami dc_health events

debug sami ppc_download

To display information on ppc download daemon processing, use the debug sami ppc_download command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug sami ppc_download {errors | events}

no debug sami ppc_download {errors | events}

Syntax Description

errors

Displays errors.

events

Displays events.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use the debug sami ppc_download command to view ppc download daemon debugging information.

Examples

The following example shows errors that occur during ppc download daemon processing.

switch# debug sami ppc_download errors

debug sami session_agent

To display information on session agent daemon processing, use the debug sami session_agent command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug sami session-agent {errors | events | packets}

no debug sami session-agent {errors | events | packets}

Syntax Description

errors

Displays errors.

events

Displays events.

packet

Displays information per-packet.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use the debug sami session-agent command to view session agent daemon debugging information.

Examples

The following example shows errors that occur during session agent processing.

switch# debug sami session_agent errors

delete

To delete a specific file in the LCP file system, use the delete command.

delete {core:filename | disk0:[path/]filename | image:filename | volatile:filename}

Syntax Description

core:filename

Deletes the specified file from the core file system.

disk0:[path/]filename

Deletes the specified file from the disk0 file system. If you do not specify the optional path, the LCP looks for the file in the root directory of the disk0 file system.

image:filename

Deletes the specified file from the image file system.

volatile:filename

Deletes the specified file from the volatile file system.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

To delete a specific file from the LCP file system, use the delete command.

If you do not specify a filename with the file system keyword, the SAMI LCP prompts you for a filename.

To display the list of files that reside in a file system, use the dir sami# command.

Examples

The following example shows how to delete a file named "0x401_VSH_LOG.25256.TAR.GZ" from the core file system:

switch# delete core:0x401_VSH_LOG.25256.TAR.GZ

Related Commands

Command
Description

dir

Displays the contents of a specified SAMI LCP file system.


dir

To list files in the various file systems on the LCP, use the dir command.

dir {core: | disk0: | image: | volatile}

Syntax Description

core:

Displays the contents of the core: file system.

disk0:

Displays the contents of the disk0: file system.

image:

Displays the contents of the image: file system.

volatile:

Displays the contents of the volatile: file system.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

Use the dir command to list the files in the various file systems on the SAMI LCP.

To delete a file from a file system, use the delete command. To delete all core dumps, use the clear cores command.

Examples

The following example shows how to display the contents of the disk0 file system:

switch# dir disk0:

Related Commands

Command
Description

delete

Deletes a specified file in the SAMI LCP file system.

more

Displays the contents of a file.


erase ppc-flash

To erase the ROM monitor area of a SAMI powerPC (PPC) boot flash and program ROM monitor using the default image in the SAMI software bundle, use the erase ppc-flash command.

erase ppc-flash [image_name:] {ppc_number | all-ppc}

Syntax Description

image_name:

Name of the ROM monitor image in the SAMI software bundle.

ppc_number

Erases the ROM monitor area of the PCC boot flash and programs ROM monitor with the default image on a specific PCC. Enter a between value 3 and 8.

all-ppc

Erases the ROM monitor area of the PCC boot flash and programs ROM monitor with the default image on all the SAMI PPCs.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use the erase ppc-flash command to erase the ROM monitor area of the PPC boot flash and program ROM monitor using the default image in the SAMI software bundle.

Examples

To erase the ROM monitor area of the boot flash on PCC 6 and program ROM monitor using the image in the SAMI software bundle, enter:

switch# erase ppc-flash image_name 6

Related Commands

This command has no related commands.

exception ixp

To enable a coredump to be collected from IXP, use the exception ixp command in configuration mode. Use the no form of the command to disable collecting coredump information.

exception ixp IXP-Proc

no exception ixp

Syntax Description

IXP-Proc

IXP processor number ( 1 or 2 ).


Defaults

none

Command Modes

Configuration

Command History

Release
Modification

SAMI Release 4.0

This command was introduced in conjunction with Cisco CSG2 Release 6.0, and LTE Release 2.0.


Usage Guidelines

The coredump gets stored under "crashinfo_collection-XXXXX-YYYY.tar", which resides on LCP "dir:core". The naming convention for the coredump file is as below :-

coredump_proc<Num>- XXXXX-YYYY.gz

where

Num -- Represents either 1 or 2 depending on IXP1 or IXP2 respectively

XXXXX-YYYY-- Represents the timestamp


Caution Collecting IXP coredump will increase reboot time by an average of 4 to 5 minutes.

Examples

To change the hostname of the SAMI LCP from host1 to SAMI1-LCP, enter:

switch(config)# hostname SAMI1-LCP
SAMI_LCP(config)# exception ixp 1
				  exception ixp 2
 
   

hostname

To change the hostname of the SAMI LCP, use the hostname command. Use the no form of this command to reset the hostname to the default of switch.

hostname name

no hostname name

Syntax Description

name

New hostname for the SAMI LCP. Enter a case-sensitive text string that contains from 1 to 32 alphanumeric characters.


Defaults

The hostname is host1.

Command Modes

Configuration

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

By default, the hostname for the SAMI LCP is host1.

The hostname is used for the command line prompts and default configuration filenames. If you establish sessions to multiple devices, the hostname helps you track where you enter commands.

Examples

To change the hostname of the SAMI LCP from host1 to SAMI1-LCP, enter:

switch(config)# hostname SAMI1-LCP
SAMI_LCP(config)# 

Related Commands

This command has no related commands.

interface

To create a bridge-group virtual interface (BVI) or VLAN interface, use the interface command. To remove the interface, use the no form of this command.

interface {bvi group_number | vlan number}

no interface {bvi group_number | vlan number}


Note If a VLAN interface is configured on the LCP, then a sub-interface for the same VLAN should not be configured on the PPCs.


Syntax Description

bvi group_number

Creates a BVI for a bridge group and accesses interface configuration mode commands for the BVI. The group_number argument is the bridge-group number configured on a VLAN interface.

vlan number

Assigns the VLAN to the context and accesses interface configuration mode commands for the VLAN. The number argument is the number for a VLAN assigned to the SAMI LCP.


Defaults

No default behavior or values exist.

Command Modes

Configuration

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

Use the interface command to create a BVI or VLAN interface.

When entered, the command prompt changes to (config-if).

Examples

To assign VLAN interface 100 to the Admin context and access interface configuration mode, enter:

switch(config)# interface vlan 100
switch(config-if)#

Related Commands

Command
Description

clear interface

Resets the hardware logic on an interface.

show interface

Displays statistics for all interfaces configured on the router or access server.


ip route

To configure a default or static IP route, use the ip route command. Use the no form of this command to remove a default or static IP route from the configuration.

ip route dest_ip_prefix netmask gateway_ip_address

no ip route dest_ip_prefix netmask gateway_ip_address

Syntax Description

dest_ip_prefix

IP address for the route. The address that you specify for the static route is the address that is in the packet before entering the SAMI LCP and performing network address translation.

netmask

Subnet mask for the route.

gateway_ip_address

IP address of the gateway router (the next-hop address for this route). The gateway address must be in the same network as specified in the ip address command for a VLAN interface.


Defaults

No default behavior or values exist.

Command Modes

Configuration

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The default route identifies the router IP address to which the SAMI LCP sends all IP packets for which it does not have a route.

Dynamic routing is not supported. You must use static routes for any networks to which the SAMI LCP is not directly connected; for example, use a static route when there is a router between a network and the SAMI LCP.

The SAMI LCP supports up to eight equal cost routes on the same interface for load balancing.

Routes that identify a specific destination address take precedence over the default route.

Examples

To configure a default route, set the IP address and the subnet mask for the route to 0.0.0.0. For example, if the SAMI LCP receives traffic that it does not have a route, it sends the traffic out the interface to the router at 192.168.4.8, enter:

switch(config)# ip route 0.0.0.0 255.255.255.0 192.168.4.8

processor config-register

To change the configuration register settings of a SAMI PPC, use the processor config-register configuration command.

processor {proc_number | all-ppc} config-register value

no processor {proc_number | all-ppc} config-register value

Syntax Description

proc_number

Number of the PPC on the SAMI for which you want to change the configuration register settings. Valid values are 3 through 8.

all-ppc

Sets the configuration register settings for all of the PPCs.

config-register value

Hexadecimal value that represents the 16-bit configuration register value that you want to use the next time the router is restarted. The value range is from 0x0 to 0xFFFF.


Defaults

0—The front panel connection rather than the on-the-board connection will make the PPCs automatically load the Cisco software application image upon startup.

Command Modes

Configuration

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

You can modify the boot method that a SAMI PPC uses at the next startup by setting the boot field in the software configuration register. The configuration register identifies how the PPC should boot and where the system image is stored. You can modify the boot field to force a PPC to boot a particular system image at startup instead of using the default system image.

The processor config-register command affects only the configuration register bits that control the boot field and leaves the remaining bits unaltered.

Examples

The following example sets the boot field in the configuration register to boot the system image identified in the BOOT environment variable upon reboot for PPC 5:

switch(config)# processor 5 config-register 1

Related Commands

Command
Description

confreg

Set the configuration register settings of a SAMI PPC.


reload

To reload the configuration on the SAMI LCP, use the reload command.

reload

Syntax Description

This command has no keywords or arguments.

Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The reload command reboots the SAMI LCP and performs a full power cycle of both the hardware and software. The reset process can take several minutes. Any open connections with the SAMI are dropped after you enter the reload command.


Caution Configuration changes that have not been written to flash memory are lost during a reload. Before reloading, enter the copy running-conf startup-config command to save a copy of the running configuration to the startup configuration in flash memory. If you fail to save your running configuration changes, the SAMI LCP reverts to the last saved version of the startup configuration when restarted.

Examples

To execute a soft reboot, enter:

switch# reload
This command will reboot the system
Save configurations for all the contexts. Save? [yes/no]: [yes]

Related Commands

Command
Description

show running-config

Displays the running configuration information on the SAMI LCP.

show startup-config

Displays information about the startup configuration on the SAMI LCP


reload sami processor

To reload a specific SAMI powerPC (PPC), use the reload sami processor command.

reload sami processor {ppc_num | all-ppc}

Syntax Description

ppc_num

Specifies the specific PPC. Enter a value 3 through 8.

all-ppc

Specifies that the ROM monitor image on all PPCs be upgraded.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

The reload sami processor command reboots a single SAMI PPC. The reload process can take several minutes. Any open connections with the SAMI PPC are dropped after you enter the reload sami processor command.


Caution Configuration changes that have not been written to flash memory are lost during a reload. Therefore, before reloading, enter the copy running-conf startup-config command to save a copy of the running configuration to the startup configuration in flash memory. If you fail to save your running configuration changes, the PPC reverts to the last saved version of their startup configuration when restarted.


Note This command is not available for distributed Cisco software applications such as the Cisco Content Services Gateway - 2nd Generation.


Examples

To reload processor 4 on a SAMI, enter:

switch# reload sami processor 4
 
   

Related Commands

Command
Description

show running-config

Displays the running configuration information on the SAMI LCP.

show startup-config

Displays information about the startup configuration on the SAMI LCP


reprogram bootflash

To reprogram the Field Upgradable (FUR) partition of the rommon image on the LCP, use the reprogram bootflash command with the fur-image keyword specified.

reprogram bootflash fur-image

Syntax Description

fur-image

Reprograms the rommon image FUR partition.


Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced.


Usage Guidelines

The reprogram bootflash command is for use by trained Cisco personnel only. Entering this command may cause unexpected results. Do not attempt to use the reprogram bootflash command without guidance from Cisco support personnel.

Examples

To reprogram the rommon image FUR partition on the image: file system, enter:

switch# reprogram bootflash fur-image

Related Commands

This command has no related commands.

set cde destindex

To set the destination index table from index x to y to one of several options, use the set cde destindex command in EXEC configuration mode. Use the no form of the command to disable this feature.

set cde destindex x [to y] [cp | ixp0 | ixp1 | nitrox | dc1 | dc2 | invalid]

no set cde destindex

Syntax Description

cp

Sets CDE destination for packets in the VLAN to Proc 0 (LCP).

ixp0

Sets CDE destination for packets in the VLAN to IXP0.

ixp1

Sets CDE destination for packets in the VLAN to IXP1.

nitrox

Sets CDE destination for packets in the VLAN to Nitrox (Used only in specific SAMI applications).

dc1

SAMI daughtercard 1.

dc2

SAMI daughtercard 2.

invalid

No destination.


Command Default

The default value is invalid..

Command Modes

This command is available in Processor 0 (LCP) console, and not under configuration mode.

Command History

Release
Modification

Release 3.4

This command was introduced.


Usage Guidelines

This command is only available with the debug plugin for the LCP.

Examples

Here is an example of the set cde destindex command:

SAMI-slot8# set cde destindex 0 to 4 dc2
dest index 3 lsb 0 - 4 dest dc2
 
   

set cde vlan

To configure vlan destinations for packets in a VLAN(s) to one of several options, use the set cde vlan command in privileged EXEC mode.

set cde vlan x [cp | ixp0 | ixp1 | nitrox | dc1 | dc2 | invalid | gtpipdesthash | ipsrchash ]

Syntax Description

vlan id

VLAN id or a range of VLAN ids.

cp

Sets CDE destination for packets in the VLAN to Proc 0 (LCP).

ixp0

Sets CDE destination for packets in the VLAN to IXP0.

ixp1

Sets CDE destination for packets in the VLAN to IXP1.

nitrox

Sets CDE destination for packets in the VLAN to Nitrox (Used only in specific SAMI applications).

dc1

SAMI Daughtercard 1.

dc2

SAMI Daughtercard 2.

invalid

No destination.

gtpipdesthash

CDE Destination is set to IXP. The destination IXP (IXP0/IXP1) to which CDE would send packets in the VLAN is identified by doing a hash in destination IP address in the packet and in case of GTP packet, hash over GTP port.

ipsrchash

CDE Destination is set to IXP. The destination IXP (IXP0/IXP1) to which CDE would send packets in the VLAN is identified by doing a hash in source IP address in the packet.


Command Default

By default, CDE destinations in enhanced CDE (version 406 onwards) is set to gtpipdesthash. For previous versions of CDE, the CDE destination is set to ixp0 by default.

Command Modes

EXEC

Command History

Release
Modification

SAMI Release 3.4

This command was introduced in conjunction with the CSG2 Release 5.0, and the Cisco LTE Release 1.0.


Usage Guidelines


Caution This command has a direct impact on the packet processing in SAMI PPC and IXP processors. You should only use this command when directed by Cisco Technical Assistance Center (TAC) engineers.

Examples

Here is an example of the set cde vlan command:

SAMI-LCP# set cde vlan 100 ixp1
This can drastically affect the way system behaves.Are you sure? [yes/no] [no] yes
vlan 100 dest ixp1 
 
   
SAMI-LCP# set cde vlan 101 gtpipdesthash
This can drastically affect the way system behaves.Are you sure? [yes/no] [no] yes
vlan 101 dest gtpipdesthash 
 
   
SAMI-LCP#set cde vlan 102 to 105 ipsrchash
This can drastically affect the way system behaves.Are you sure? [yes/no] [no] yes
vlan 102 - 105 dest ipsrchash
 
   

If a vlan in the range is being used by the LCP (proc 0), a warning is issued that the particular vlan is being used by the LCP and that VLAN is dropped from the configuration. The sample output of the command is as follows:

 
   
	SAMI-LCP# set cde vlan 7 to 12 ixp1
vlan 7 - 12 dest ixp1 
Warning: vlan 10 is being used by proc 0 and this CLI will not update it.
Please use 'set cde vlan 10' to override.
 
   
SAMI-LCP# set cde vlan 10 ixp1
 
   
 
   

show cde

To display the classification and distribution engine (CDE) register values, use the show cde command.

show cde {all | count | dist | hash index_number | health | interrupts | reg cde_number register | stats {cumulative | stats} | vlan vlan_number} [|] [>]

Syntax Description

all

Displays all CDE register values.

count

Displays the cumulative count of the CDE interrupts.

dist

Displays the CDE distribution type.

hash index_number

Displays the hash distribution table. Enter a value from 0 to 31.

health

Displays the CDE health.

interrupts

Displays the CDE interrupts.

reg

Displays the specified CDE register.

cde_number

CDE number.

register

Register value. Enter a hexadecimal value from 0x0 to 0x1d9.

stats

Displays the specified CDE statistics.

cumulative

Displays the cumulative CDE statistics from the last invocation of the show cde command.

stats

Displays the delta CDE statistics from the last invocation of the show cde command.

vlan vlan_number

Displays the VLAN distribution table for the specified VLAN. For SAMI, this will be either IXP0 or CP (the LCP). Enter the desired VLAN number.

|

(Optional) Pipe character (|) for enabling an output modifier that filters the command output. For a complete description of the options available for filtering the command output, see the show command.

>

(Optional) Greater-than character (>) for enabling an output modifier that redirects the command output to a file. For a complete description of the options available for redirecting the command output, see the show command.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

This command is for use by trained Cisco personnel for troubleshooting purposes only. You can also use the show cde vlan command to verify if the CDE is programmed correctly for the subscriber VLAN.

Examples

To display all of the CDE register values, enter:

switch# show cde all

Related Commands

Command
Description

clear cde

Clear the CDE statistics and interrupt counts.


show cde destindex

To display the destination index table for all indices x to y, use the show cde destindex command in EXEC mode.

show cde vlan x [to y]

Syntax Description

There are no arguments or keywords.

Defaults

0 <= x <= y <= 7

Command Modes

EXEC

Command History

Release
Modification

SAMI Release 3.4

This command was introduced in conjunction with the CSG2 Release 5.0, and the Cisco LTE Release 1.0.


Usage Guidelines

Examples

To display destinations for all vlans from x to y enter:

slot8# show cde destindex 0 to 7
Destination index & 0x7 == 0 --> daughter card 2
Destination index & 0x7 == 1 --> daughter card 2
Destination index & 0x7 == 2 --> daughter card 2
Destination index & 0x7 == 3 --> daughter card 2
Destination index & 0x7 == 4 --> daughter card 2
Destination index & 0x7 == 5 --> ixp1
Destination index & 0x7 == 6 --> ixp0
Destination index & 0x7 == 7 --> ixp1
 
   

show cde vlan

To display destinations for the specified VLANs, use the show cde vlan command in EXEC mode.

show cde vlan vlan_id [ to vlan_id ]

Syntax Description

vlan_id

VLAN id, or a range of VLAN ids for which output is needed.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

SAMI Release 3.4

This command was introduced in conjunction with the CSG2 Release 5.0, and the Cisco LTE Release 1.0.


Usage Guidelines

Examples

To display destinations for all vlans from x to y enter:

SAMI-LCP# show cde vlan 7 to 12
Vlan 7 --> ixp1 
Vlan 8 --> ixp0 
Vlan 9 --> gtpipdesthash 
Vlan 10 --> ipsrchash
Vlan 11 --> cp
Vlan 12 --> ixp1 
 
   
 
   

show daughtercard fpga statistics

To display the field programmable gate array (FPGA) statistics for a daughter card on the SAMI, use the show daughtercard fpga statistics command.

show daughtercard card_number fpga statistics

Syntax Description

card number

Number of the daughter card for which you want to display FPGA-related statistics. A valid value is 1 or 2.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

If a daughter card number is not specified, the FPGA statistics for both daughter cards will display.

Examples

To display the FPGA statistics for daughter card 2, enter:

switch# show daughtercard 2 fpga statistics
 
   

Related Commands

Command
Description

clear daughtercard fpga statistics

Clears all FPGA statistics for a SAMI daughter card

show daughtercard registers

Displays FPGA or complex programmable logic device (CPLD) registers for a SAMI daughter card.


show daughtercard registers

To display the field programmable gate array (FPGA) or complex programmable logic device (CPLD) registers for a daughter card on the SAMI, use the show daughtercard registers command.

show daughtercard card_number [fpga | cpld] registers

Syntax Description

card number

Daughter card for which you want to display registers. Enter 1 or 2.

fpga

(Optional) Displays FPGA-related registers.

cpld

(Optional) Displays CPLD registers.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

If a daughter card number is not specified, the FPGA and/or CPLD registers for both daughter cards will display.

Examples

To display the FPGA counters for daughter card 2, enter:

switch# show daughtercard 2 fpga registers

Related Commands

Command
Description

clear daughtercard fpga statistics

Clears all FPGA statistics for a SAMI daughter card

show daughtercard fpga statistics

Displays FPGA statistics for a SAMI daughter card.


show login timeout

To display the amount of time, a session can remain inactive before it is ended (the login session idle timeout value), use the show login timeout command.

show login timeout

Syntax Description

This command has no keywords or arguments.

Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

To configure the login timeout value, use the login timeout command in configuration mode.

Examples

To display the login timeout value, enter:

switch# show login timeout

Related Commands

Command
Description

login timeout

Modifies the length of time that a user can be idle before the LCP terminates the console, Telnet, or SSH session.


show running-config

To display the running configuration information on the SAMI LCP, use the show running-config command.

show running-config [aaa | access-list | action-list | class-map | context | dhcp | domain | ft | interface | object-group | parameter-map | policy-map | probe | resource-class | role | rserver | serverfarm | sticky] [|] [>]

Syntax Description

aaa

(Optional) Displays authentication, authorization, and accounting (AAA) information.

action-list

(Optional) Displays action list information.

access-list

(Optional) Displays access control list (ACL) information.

class-map

(Optional) Displays the list of all class maps configured for the current context. The SAMI LCP also displays configuration information for each class map listed.

context

(Optional) Displays the list of contexts configured on the SAMI LCP. The SAMI LCP also displays the resource class (member) assigned to each context. The context keyword only works from within the admin context.

dhcp

(Optional) Displays Dynamic Host Configuration Protocol (DHCP) information.

domain

(Optional) Displays the list of domains configured for the current context. The SAMI LCP also displays configuration information for each domain listed.

ft

(Optional) Displays the list of redundancy or fault-tolerance (ft) configurations configured for the current context. The SAMI LCP also displays configuration information for each ft configuration listed.

interface

(Optional) Displays interface information.

object-group

(Optional) Displays object group information.

parameter-map

(Optional) Displays parameter map information.

policy-map

(Optional) Displays policy map information.

probe

(Optional) Displays probe information.

resource-class

(Optional) Displays resource class information.

role

(Optional) Displays the list of roles configured for the current context. The SAMI LCP also displays configuration information for each role on the list.

rserver

(Optional) Displays rserver information.

serverfarm

(Optional) Displays server farm information.

sticky

(Optional) Displays sticky information.

|

(Optional) Pipe character (|) for enabling an output modifier that filters the command output. For a complete description of the options available for filtering the command output, see the show command.

>

(Optional) Greater-than character (>) for enabling an output modifier that redirects the command output to a file. For a complete description of the options available for redirecting the command output, see the show command.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The show running-config command is a context-sensitive command.

Use the copy capture command to do the following:

Save a copy of the running configuration to a file on one or more destination locations.

Save the running configuration as the startup configuration.

Save the startup configuration as the running configuration.

Examples

To display the entire running configuration, enter:

switch# show running-config

Related Commands

Command
Description

show startup config

Displays information about the startup configuration on the SAMI LCP

show tech-support

Displays information that is useful to technical support when reporting a problem with your SAMI LCP

write

Manages persistent and nonpersistent configuration information


show startup-config

To display information about the startup configuration on the SAMI LCP, use the show startup-config command.

show startup-config [|] [>]

Syntax Description

|

(Optional) Pipe character (|) for enabling an output modifier that filters the command output. For a complete description of the options available for filtering the command output, see the show command.

>

(Optional) Greater-than character (>) for enabling an output modifier that redirects the command output to a file. For a complete description of the options available for redirecting the command output, see the show command.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

To clear the startup configuration, use the clear startup-config command. To copy the running configuration to the startup configuration, or copy the startup configuration to the running configuration, use the copy running-config command.

Examples

To display information about the startup configuration, enter:

switch# show start-config

Related Commands

Command
Description

clear startup-config

Clears the startup configuration.

show running-config

Displays information about the running configuration on the SAMI LCP.


show tech-support

To display information that is useful to technical support when reporting a problem with your SAMI LCP, use the show tech-support command.

show tech-support [details] [|] [>]

Syntax Description

details

(Optional) Provides detailed information for each of the show commands described below in the "Usage Guidelines" section.

|

(Optional) Pipe character (|) for enabling an output modifier that filters the command output. For a complete description of the options available for filtering the command output, see the show command.

>

(Optional) Greater-than character (>) for enabling an output modifier that redirects the command output to a file. For a complete description of the options available for redirecting the command output, see the show command.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The show tech-support command is useful when collecting a large amount of information about your SAMI LCP for troubleshooting purposes with Cisco technical support. The output of this command can be provided to technical support representatives when reporting a problem.

The show tech-support command displays the output of several show commands at once. The output from this command varies depending on your configuration. The default output of the show tech-support command includes the output of the following commands:

show environment—See the show environment command.

show hardwareSee the show hardware command.

show interfaceSee the show interface command.

show process—See the show processes command.

show running-config—See the show running-config command.

show versionSee the show version command.

Explicitly set the terminal length command to 0 (zero) to disable autoscrolling and enable manual scrolling. Use the show terminal command to view the configured terminal size. After obtaining the output of this command, reset your terminal length as required.

You can save the output of this command to a file by appending > filename to the show tech-support command. If you save this file, verify that you have sufficient space to do so as each of these files may take about 1.8 MB.

Examples

To display the summary version of the technical support report, enter:

switch# show tech-support

Related Commands

Command
Description

show interface

Displays the statistics for all interfaces configured on the SAMI LCP.

show running-config

Displays information about the running configuration on the SAMI LCP

show version

Displays information about the currently loaded software version along with hardware and device information.


show version

To display the version information of system software that is loaded in flash memory and currently running on the SAMI LCP, use the show version command.

show version| >

Syntax Description

|

(Optional) Pipe character (|) for enabling an output modifier that filters the command output. For a complete description of the options available for filtering the command output, see the show command.

>

(Optional) Greater-than character (>) for enabling an output modifier that redirects the command output to a file. For a complete description of the options available for redirecting the command output, see the show command.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The show version command also displays information related to the following SAMI hardware components:

Slot number—Slot number that the SAMI LCP occupies on the Cisco 7600 series chassis.

CPU—Number of CPUs and type and model

Memory—Total and shared volatile memory

Flash memory—Total and used flash memory

Use the show version command to verify the software version on the SAMI LCP before and after an upgrade.

Examples

To display the software version information, enter:

switch# show version

upgrade-rommon

To upgrade the ROM monitor of one or more of the SAMI PPCs with a specific ROM monitor image, use the upgrade-rommon command.

upgrade-rommon rommon_image {ppc_num | all-ppc}

Syntax Description

rommon_image

Name of the ROM monitor image available in the SAMI software bundle.

ppc_num

Specifies the specific PPC. Enter a value 3 through 8.

all-ppc

Specifies that the ROM monitor image on all PPCs be upgraded.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use this command to upgrade the ROM monitor of one or more of the SAMI PPCs with a specific ROM monitor image.

Examples

To upgrade the ROM monitor image on SAMI PPC 3, enter:

switch# upgrade-rommon image_name 3

Related Commands

This command has no related commands.

write

To manage persistent and nonpersistent configuration information, use the write command.

write {erase | memory [all] | terminal}

Syntax Description

erase

Erases the entire startup configuration with the exception of any configuration that affects the loader functionality. The startup configuration then reverts back to the factory-default values. The running configuration is not affected.

memory

Writes the running configuration to the startup configuration.

all

(Optional) Writes configurations for all existing contexts. This keyword is available only in the Admin context.

terminal

Writes the running configuration to the terminal.


Defaults

No default behavior or values exist.

Command Modes

EXEC

Command History

Release
Modification

Release 1.0

This command was integrated into Cisco SAMI Release 1.0.


Usage Guidelines

The different versions of this command require the following user role or feature in your user role:

write erase—Admin user

write mem—config-copy feature

write all—Admin user

To write the running configuration to the startup configuration, you can also use the copy running-config startup-config command. To erase the startup configuration, you can also use the clear startup-config command. To display the running configuration, you can also use the show running-config command.

Examples

To write running configuration to the startup configuration, enter:

switch# write memory

Related Commands

Command
Description

clear startup-config

Command to clear the startup configuration.

show running-config

Command to display information about the running configuration on the SAMI LCP


 
   

Network Processor Console Command

The following command is supported at the IXP console:

shutdown

shutdown

To shut down the network processor (IXP) on the SAMI, use the shutdown command.

shutdown

Syntax Description

shutdown

Specifies shutdown.


Defaults

No default behavior or values exist.

Command Modes

Command History

Release
Modification

Release 1.0

This command was introduced.


Usage Guidelines

Use this command to shutdown the network processor (IXP) on the SAMI.

Examples

The following examples illustrates how to use the shutdown command.

shutdown