System administration commands

admin

Syntax

admin

Context

<root>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure administrative system commands. Only authorized users can execute the commands in the admin context.

auto-init

Syntax

auto-init stop

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode; not supported on 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS platforms configured in the standalone-VC operating mode

Description

This command specifies that the system saves the BOF with the BOF parameter primary-image pointing to the both.tim on the local flash. When the system boots up for the first-time, auto-init can potentially use the TiMOS images available on the local flash to boot up and provide a user login prompt. With this command, user is provided with an option to stop the auto-init process and complete successful boot.

If the user does not use this command to stop the auto-init process, the system reboots and attempts to find the BOF again using DHCP.

debug-save

Syntax

debug-save file-url

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command saves existing debug configuration. Debug configurations are not preserved in configuration saves.

Parameters

file-url

Specifies the file URL location to save the debug configuration.

Values

file-urllocal-url | remote-url

local-url — [cflash-id/ | usb-flash-id] [file-path]

  • 255 chars maximum, including cflash-id
  • directory length 99 characters maximum each

remote url — [{ftp://} login:password@remote-location/][file- path]

  • 255 characters maximum
  • directory length 99 characters maximum each

remote-location — [hostname | ipv4-address]

  • ipv4-address — a.b.c.d

usb-flash-id

uf1: (7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE)

uf1:, uf1-A:, uf1-B: (7210 SAS-R6 and 7210 SAS-R12)

cflash-id

cf1:, cf2: (7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-Sx 10/100GE, and 7210 SAS-Sx 1/10GE: standalone and standalone-VC)

cf2:, cf2-A:, cf2-B: (7210 SAS-R6 and 7210 SAS-R12)

disconnect

Syntax

disconnect {address ip-address | username user-name | console | telnet | ftp | ssh | netconf}

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command disconnects a user from a console, Telnet, FTP, or SSH session.

If any of the console, Telnet, FTP, SSH, or NETCONF options are specified, only the respective console, Telnet, FTP, SSH, or NETCONF sessions are affected.

If no console, Telnet, FTP, SSH, or NETCONF options are specified, all sessions from the IP address or from the specified user are disconnected.

Any task that the user is executing is terminated. FTP files accessed by the user will not be removed.

A major severity security log event is created specifying what was terminated and by whom.

Parameters

address ip-address

Specifies the IP address to disconnect, specified in dotted-decimal notation.

Values

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x (eight 16-bit pieces)

  • x:x:x:x:x:x:d.d.d.d
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)
username user-name

Specifies the name of the user.

console

Keyword to disconnect the console session.

telnet

Keyword to disconnect the Telnet session.

ftp

Keyword to disconnect the FTP session.

ssh

Keyword to disconnect the SSH session.

netconf

Keyword to disconnect the NETCONF session.

display-config

Syntax

display-config [detail | index]

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command displays the system’s running configuration.

By default, only non-default settings are displayed.

Parameters

detail

Displays default and non-default configuration parameters.

index

Displays only persistent-indexes.

reboot

Syntax

reboot [active | standby | upgrade] [auto-init {chassis-role factory-default | satellite | standalone}] [now]

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode; not supported on 7210 SAS platforms configured in the standalone-VC operating mode

Description

This command is used only to reboot the system, initiate an upgrade of the firmware along with a reboot of the node, or initiate an auto-init boot procedure along with a reboot of the node.

If no options are specified, the user is prompted to confirm the reboot operation. For example:

ALA-1>admin# reboot
Are you sure you want to reboot (y/n)?

If the now option is specified, no boot confirmation messages appear.

Parameters

active

Keyword to reboot the active CPM. This keyword is only supported on 7210 SAS-R6 and 7210 SAS-R12 platforms.

standby

Keyword to reboot the standby CPM. This keyword is only supported on 7210 SAS-R6 and 7210 SAS-R12 platforms.

upgrade

Keyword to upgrade card firmware (CPLD and ROM) during chassis reboot. The 7210 SAS OS and the boot.tim support functionality to perform automatic firmware upgrades. The automatic upgrade must be enabled in the 7210 SAS OS Command Line Interface (CLI) when rebooting the system.

When the upgrade keyword is specified, a chassis flag is set for the boot loader (boot.tim) and on the subsequent boot of the 7210 SAS OS on the chassis, any firmware images requiring upgrading will be upgraded automatically.

If an 7210 SAS is rebooted with the admin reboot command (without the upgrade keyword), the firmware images are left intact.

During any firmware upgrade, automatic or manual, it is imperative that during the upgrade procedure:

  • Power must NOT be switched off or interrupted.

  • The system must NOT be reset.

  • No cards are inserted or removed.

Any of the above conditions may render cards inoperable requiring a return of the card for resolution.

now

Keyword to force a reboot of the router immediately without an interactive confirmation.

auto-init

Keyword to reset the BOF and initiates a reboot. This keyword is not supported on 7210 SAS-R6 and 7210 SAS-R12 platforms.

chassis-role

Specifies the operating mode of the chassis at boot up. This keyword is only supported on 7210 SAS-Sx/S 1/10GE, 7210 SAS-Sx 10/100GE, and 7210 SAS-Mxp platforms.

Values

factory-default, satellite, standalone

save

Syntax

save [file-url] [detail] [index]

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command saves the running configuration to a configuration file. For example:

A:ALA-1>admin# save ftp://test:test@192.168.x.xx/./100.cfg
Saving configuration .........Completed.

By default, the running configuration is saved to the primary configuration file.

Parameters

file-url

Specifies the file URL location to save the configuration file.

Values

file-url — local-url | remote-url

local-url — [cflash-id/] [file-path]

  • 255 chars maximum, including cflash-id
  • directory length 99 characters maximum each

remote url — [{ftp:// | tftp://}login:password@remote-location/][file- path]

  • 255 characters maximum
  • directory length 99 characters maximum each

remote-location — [hostname | ipv4-address | ipv6-address]

  • ipv4-address — a.b.c.d
  • ipv6-address — x:x:x:x:x:x:x:x[-interface]
  • x:x:x:x:x:x:d.d.d.d[-interface]
  • x — 0 to FFFF (hexadecimal)
  • d — 0 to 255 (decimal)
  • interface — 32 characters maximum, for link local addresses

usb-flash-id

uf1: (7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE)

uf1:, uf1-A:, uf1-B: (7210 SAS-R6 and 7210 SAS-R12)

cflash-id

cf1:, cf2: (7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-Sx 10/100GE, and 7210 SAS-Sx 1/10GE: standalone and standalone-VC)

cf2:, cf2-A:, cf2-B: (7210 SAS-R6 and 7210 SAS-R12)

Default

the primary configuration file location

detail

Keyword to save both default and non-default configuration parameters.

index

Keyword to force a save of the persistent index file regardless of the persistent status in the BOF file. The index option can also be used to avoid an additional boot required while changing your system to use the persistence indexes.

enable-tech

Syntax

[no] enable-tech

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command enables the shell and kernel commands.

Note:

This command should only be used with authorized direction from the Nokia Technical Assistance Center (TAC).

tech-support

Syntax

tech-support file-url

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command creates a system core dump.

Note:

This command should only be used with authorized direction from the Nokia Technical Assistance Center (TAC).

Parameters

file-url

Specifies the file URL location to save the binary file.

Values

file-url — local-url | remote-url

local-url — [cflash-id/ | usb-flash-id]] [file-path]

  • 255 chars maximum, including cflash-id
  • directory length 99 characters maximum each

remote url — [{ftp://}login:password@remote-location/][file- path]

  • 255 characters maximum
  • directory length 99 characters maximum each

remote-location — [hostname | ipv4-address]

  • ipv4-address — a.b.c.d

usb-flash-id

uf1: (7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE)

uf1:, uf1-A:, uf1-B: (7210 SAS-R6 and 7210 SAS-R12)

cflash-id

cf1:, cf2: (7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-Sx 10/100GE, and 7210 SAS-Sx 1/10GE: standalone and standalone-VC)

cf2:, cf2-A:, cf2-B: (7210 SAS-R6 and 7210 SAS-R12)

virtual-chassis

Syntax

virtual-chassis {slotid | slotid-range} image-sync

Context

admin

Platforms

7210 SAS-Sx 1/10GE standalone-VC, 7210 SAS-S 1/10GE: standalone-VC

Description

This command upgrades the boot.tim file on the IMM-only node in a virtual chassis (VC) and ensures that on the next reboot of the node, the newer bootloader image is used to boot the system. Bootloader images are copied to all the available storage locations on the card, ensuring that a back up copy is available if the primary storage device fails.

The boot.tim file can be upgraded on a single IMM-only node or on a range of IMM-only nodes in a VC.

The image-sync keyword initiates image synchronization of the IMM-only node. It copies the boot.tim from the active CPM to the card/node identified by the slot-id or slotid-range parameter.

Parameters

slotid

Specifies the card slot number.

Values

1 to 8

slotid-range

Specifies the card slot numbers for a range of cards.

Values

1 to 8

image-sync

Keyword to initiate image synchronization of the IMM-only node.