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 parameters. Only authorized users can execute the commands in the admin context.

check-golden-bootstrap

Syntax

check-golden-bootstrap

Context

admin

Platforms

7210 SAS-D

Description

This command validates the current golden bootstrap image, and displays its version, if found to be valid. If the golden bootstrap image is not found to be a valid, an error message is displayed to that effect.

auto-init

Syntax

auto-init stop

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

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

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

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-url — local-url | remote-url

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

200 chars maximum, including the cflash-id directory length, 99 chars maximum each

remote-url — [{ftp://} login:pswd@remote-locn][file-path]

remote-locn — [hostname | ipv4-address]

ipv4-addressa.b.c.d

cflash-id — cf1:

usb-flash-id — uf1:

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

Description

This command disconnects a user from a console, Telnet, FTP, SSH, or NETCONF 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 are not 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.

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. This keyword is supported only on the 7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T.

display-config

Syntax

display-config [detail | index]

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document

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-indices.

reboot

Syntax

reboot [upgrade] [auto-init] [now]

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command reboots the system or initiates 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.

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

Parameters

upgrade

Keyword to enable card firmware (CPLD and ROM) to be upgraded 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 is 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 forces a reboot of the router immediately without an interactive confirmation.

auto-init

Keyword to reset the BOF and initiate a reboot.

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.

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-urllocal-url | remote-url (255 characters max)

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

200 chars maximum, including the cflash-id directory

length, 99 chars maximum each

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

remote-locn — [hostname | ipv4-address]

ipv4-addressa.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 — a string up to 32 characters, for link local addresses

cflash-id — cf1:

usb-flash-id — uf1:

Default

the primary configuration file location

detail

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

index

Keyword to 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 indices.

enable-tech

Syntax

[no] enable-tech

Context

admin

Platforms

Supported on all 7210 SAS platforms as described in this document

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

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],

200 chars maximum, including the cflash-id directory

length, 99 chars maximum each

remote-url — [{ftp://} login:pswd@remote-locn][file-path]

remote-locn — [hostname | ipv4-address]

ipv4-addressa.b.c.d

cflash-id — cf1:

usb-flash-id — uf1:

update-golden-bootstrap

Syntax

update-golden-bootstrap [file-url]

Context

admin

Platforms

7210 SAS-D

Description

This command updates the golden bootstrap image with the file-url, after validating it as a bootstrap image for the 7210 SAS platforms. Only on newer 7210 SAS-D platforms, the admin>update-golden-bootstrap CLI command does not update the golden-bootstrap image with the boot.tim specified in the parameter value, if the boot.tim is not a newer image.

Default

cf1:/boot.tim

Parameters

file-url

Specifies the file URL.