Cisco ASR 9000 Series Aggregation Services Router Interface and Hardware Component Command Reference, Release 5.1.x
Satellite nV System Commands on the Cisco ASR 9000 Series Router
Downloads: This chapterpdf (PDF - 1.35MB) The complete bookPDF (PDF - 8.13MB) | Feedback

Satellite nV System Commands on the Cisco ASR 9000 Series Router

Satellite nV System Commands on the Cisco ASR 9000 Series Router

This module describes the commands used to configure the Satellite nV system on the Cisco ASR 9000 Series Router.

hw-module satellite reload

To reload and perform a soft reset of individual slots of the satellite device, use the hw-module satellite reload command in the EXEC mode.

hw-module satellite { satellite id | all } reload

Syntax Description

satellite id

Specifies the unique identifier of the satellite device on which reload has to be performed.

all

Performs the reload operation on all the currently active satellites.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows a sample output of the hw-module satellite reload command:

RP/0/RSP0/CPU0:routerhw-module satellite 101 reload

Reload operation completed successfully.
RP/0/RSP0/CPU0:May 3 20:26:51.883 : invmgr[254]: %PLATFORM-INV-6-OIROUT : OIR: Node 101
removed

install nv satellite

To download and activate the software image on the satellite, use the install nv satellite command in the EXEC mode.

install nv satellite { satellite id | all } { transfer | activate }

Syntax Description

satellite id

Specifies the unique identifier of the satellite on which the image must be transferred.

all

Performs the operation on all currently active satellites that are not already at the target version.

transfer

Downloads the image from the host to the satellite device.

activate

Performs the install operation on the satellite.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.


Note


This command only works on satellites that are fully connected and authenticated.



Note


If the activate keyword is run directly, then the software image is transferred to the satellite and also activated.


Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows the sample output of the install nv satellite transfer and install nv satellite activatecommands:

RP/0/RSP0/CPU0:routerinstall nv satellite 100 transfer

Install operation initiated successfully.

RP/0/RSP0/CPU0:sat-host#RP/0/RSP0/CPU0:May 3 20:12:46.732 : icpe_gco[1146]:
%PKT_INFRA-ICPE_GCO-6-TRANSFER_DONE : Image transfer completed on Satellite 100

RP/0/RSP0/CPU0:router# install nv satellite 100 activate
Install operation initiated successfully.
LC/0/2/CPU0:May 3 20:13:50.363 : ifmgr[201]: %PKT_INFRA-LINK-3-UPDOWN : Interface
GigabitEthernet100/0/0/28, changed state to Down
RP/0/RSP0/CPU0:May 3 20:13:50.811 : invmgr[254]: %PLATFORM-INV-6-OIROUT : OIR: Node 100 removed

nv

To enter the satellite network virtualization configuration mode, use the nv command in global configuration mode.

nv

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

Global Configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to enter the nv configuration mode:

RP/0/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:router(config)# nv
RP/0/RSP0/CPU0:router(config-nV)#
   

satellite

To declare a new satellite that is to be attached to the host and enter the satellite configuration mode, use the satellite command in the Satellite nV configuration mode.

satellite id

Syntax Description

id

The id is a number in the range of 100 to 65534.

Command Default

No default behavior or values

Command Modes

Satellite Network Virtualization Configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Each satellite must be declared in a separate line with an unique identifier.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to declare a new satellite device using the satellite command:

RP/0/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:router(config)# nv
RP/0/RSP0/CPU0:router(config-nV)# satellite 1250
   

satellite-fabric-link satellite

To specify an interface as a ICPE inter-chassis link, use the satellite-fabric-link satellite command in the satellite nV interface configuration mode.

satellite-fabric-link satellite id { slot | slot | ports | ports | network }

Syntax Description

satellite id

Specifies the satellite id. It is a number in the range 0-65536.

slot slot id

(Optional) Specifies the slot number. The slot ID consists of two slash-separated numbers, representing the slot and sub-slot IDs on the satellite device of the node from which to cross-link ports. This is not supported on single-node satellites.

ports ports

Specifies the port number. The ports are specified as a range, not necessarily consecutive, of port IDs to crosslink to this IC Link. The range consists of one or more comma-separated sub-ranges. Each sub-range can either be a single number, or a hyphen separated consecutive range (where the left number must be smaller than the right number).

network

(Optional) Specifies a network of satellites.

Command Default

The slot defaults to 0/0. The ports default to all available ports.

Command Modes

Satellite Network Virtualization Interface Configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to execute the satellite-fabric-link satellite command:

RP/0/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:router(config)# interface TenGigE0/2/1/0
RP/0/RSP0/CPU0:router(config-int)# ipv4 point-to-point
RP/0/RSP0/CPU0:router(config-int)# interface unnumbered loopback0 
RP/0/RSP0/CPU0:router(config-int)# nV
RP/0/RSP0/CPU0:router(config-int-nV)# satellite-fabric-link satelite 200

satellite type

To define the expected type of the attached satellite device, use the satellite type command in the satellite nV configuration mode.

satellite id typetype name

Syntax Description

type type name

Specifies the type name of the attached satellite. The satellite types are ASR9000v, ASR9000v-V2, ASR901v, and ASR 903v.

Command Default

No default behavior or values

Command Modes

Satellite Network Virtualization Configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.0

The Cisco ASR901 and ASR903 Series Routers were included as satellites.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The type string is used to lookup satellite capabilities, allowing other configuration to be verified accurately. The string is user-visible, and must match the publicly known names of the Satellite devices.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows a sample output of how to use the satellite type command:

RP/0/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:router(config)# nv
RP/0/RSP0/CPU0:router(config-nV)# satellite 200
RP/0/RSP0/CPU0:router(config-nV)# satellite 200 type asr9000v 

serial-number

To authenticate the serial number for a defined satellite, use the serial-number command in the Satellite nV configuration mode.

serial-number string

Syntax Description

string

Specifies the alphanumeric string that is assigned to a satellite.

Command Default

No default behavior or values

Command Modes

Satellite Network Virtualization Configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to specify the serial number for a satellite:

RP/0/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:router(config)# nv
RP/0/RSP0/CPU0:router(config-nV)# satellite 1250
RP/0/RSP0/CPU0:router(config-nV)# serial-number CAT1521B1BB
   

show nv satellite protocol control

To display the control protocol statistics and details of the SDAC (Satellite Discovery And Control) protocol, use the show nv satellite protocol control in the EXEC mode.

show nv satellite protocol control { brief | satellite }

Syntax Description

brief

Displays a brief information of the control protocol statistics.

satellite

Displays the control protocol information based on the specified satellite device.

Command Default

No default behavior or values.

Command Modes

EXEC

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to run the show nv satellite protocol control command:

RP/0/RSP0/CPU0:router show nv satellite protocol control brief

Related Commands

Command

Description

show nv satellite protocol discovery

Displays the statistics of satellite discovery protocol.  

show nv satellite protocol discovery

To display the current FSM states and discovery protocol statistics such as packets, messages, and bytes from the SDAC (Satellite Discovery And Control) protocol , use the show nv satellite protocol discovery in the EXEC mode.

show nv satellite protocol discovery { interface | interface-name | brief }

Syntax Description

interface interface-name

Displays the discovery protocol information based on the interface type.

briefid

Displays a brief discovery protocol information.

Command Default

No default behavior or values.

Command Modes

EXEC

Command History

Release Modification

Release 4.2.1

This command was introduced.

Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
ethernet-services

read, write

Examples

This example show how to execute the show nv satellite protocol discovery command:

RP/0/RSP0/CPU0:router show nv satellite protocol discovery brief

show frequency synchronization clock-interfaces

To display the frequency synchronization information for all clock-interfaces or for a specific node, use the show frequency synchronization clock-interfaces command in EXEC mode.

show frequency synchronization clock-interfaces [brief] [ location node-id ]

Syntax Description

brief

Displays summary information for all clock interfaces.

location node-id

Displays information for a specific interface. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows the output for the show frequency synchronization clock-interfaces command:

RP/0/RSP0/CPU0:router# show frequency synchronization clock-interfaces

Node 0/0/CPU0:
==============
  Clock interface Sync0 (Up):
    Assigned as input for selection
    SSM supported and enabled
    Input:
      Going down in 00:00:20
      Last received QL: OPT-II,1/PRC
      Effective QL: OPT-II,1/PRC, Priority: 200
    Output:
      Selected source: GigabitEthernet0/0/0/3
      Selected source QL: OPT-II,1/PRC
      Effective QL: DNU
  Next selection points: RP_SELECTOR

  Clock interface Sync1 (Down: mode is not configured):
    Assigned as input for selection
    SSM supported and enabled
    Input:
      Restore in 00:02:00
      Last received QL: Opt-II,2/ST3
      Effective QL: Opt-II,2/ST3, Priority: 100
    Output:
      Selected source: GigabitEthernet0/0/0/3
      Selected source QL: Opt-II,2/PRC
      Effective QL: DNU
  Next selection points: RP_SYSTEM

  Clock interface Internal0 (Up):
    Input:
      Default QL: OPT-II,2/ST3
      Effective QL: OPT-II,2/ST3, Priority 255
  Next selection points: RP_SELECTOR
  

Note


The last received QL and effective output QL are only shown if SSM is supported and enabled on the clock.


The output in brief mode is as follows:

RP/0/RSP0/CPU0:router# show frequency synchronization clock-interfaces brief 

Flags:  > - Up                D - Down              S - Assigned for selection
        d - SSM Disabled      s - Output squelched  L - Looped back
Node 0/0/CPU0:
==============
  Fl    Clock Interface     QLrcv  QLuse  Pri QLsnd  Source
  ===== =================== ====== ====== === ====== ========================
  >S    Sync0               PRC     PRC   100 DNU    GigabitEthernet0/0/0/3
  DS    Sync1               FAILED  DNU   100 n/a    GigabitEthernet0/0/0/3
  >S    Internal0           ST3     ST3   255 n/a
   

clear frequency synchronization esmc statistics

To clear the Ethernet Synchronization Messaging Channel (ESMC) statistics, use the clear frequency synchronization esmc statistics command in EXEC mode.

clear frequency synchronization esmc statistics interface { interface | all | summary location { node-id | all } }

Syntax Description

interface

The command can be restricted to clear the ESMC statistics for a particular interface by specifying the interface.

node-id

The output can be restricted to clear the ESMC statistics for a particular node by specifying the location. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to clear the ESMC statistics:

RP/0/RSP0/CPU0:router# clear frequency synchronization esmc statistics interface gigabitethenet 0/1/0/1