Table Of Contents

H Commands

halt

help

hostname

H Commands

---

This chapter covers the following commands:

•halt

•help

•hostname

halt

To prepare the storage router to be powered down, issue the halt command.

halt [force] [fast]

Syntax Description

force	(Optional) Force an immediate halt of the storage router.
fast	(Optional) Bypass hardware diagnostics when the storage router is next restarted.

Defaults

If there are unsaved configuration changes when the command is issued, the default is to save all changes before halting. If the command is issued with the optional force keyword, any unsaved configuration changes are discarded.

Command Modes

Administrator.

Command History

Release	Modification
2.2.1	This command was introduced for the SN 5428.
3.2.1	This command was introduced for the SN 5428-2.

Usage Guidelines

The halt command prepares the storage router file system to be powered down. If the storage router is participating in a cluster, the halt command will cause any SCSI routing instances running on this storage router to failover to another storage router in the cluster.

If the halt command is issued with no keywords and there are unsaved changes to the current configuration, you are prompted to save or discard the changes.

Use the force keyword to cause an immediate halt of the storage router, discarding any unsaved configuration changes. Append the optional fast keyword to bypass diagnostics when the storage router is restarted.

When the halt command completes, the storage router displays the following system prompt:

[HALTED]# 

The storage router can be safely powered down when the HALTED system prompt appears. The only CLI command that can be issued from the storage router at the HALTED system prompt is the reboot command.

---

Note When the storage router is restarted, the cluster determines any SCSI routing instances that should be started. If the storage router is identified as the preferred storage router for any SCSI routing instance (via the scsirouter primary command), that instance will start running (assuming targets and critical resources are available).

---

Examples

The following prompt is received if you issue a halt command (without the force keyword) when the storage router has unsaved configuration changes.

[SN5428-2A]# halt

*** Warning: This will halt the system.

Do you want to continue? [yes/no (no)] yes

Changes have been made to the current configuration of the system which

have not been saved.

yes    - all of the configuration data will be saved,

no     - modifications to the configuration data will not be saved.

Save ALL configuration data? [yes/no (yes)] no

Halting system............!

[HALTED]# 

The following example halts the storage router (after prompting you to save any unsaved configuration changes). Diagnostics will be bypassed when the storage router is restarted.

[SN5428-2A]# halt fast

Related Commands

Command	Description
reboot	Cause the storage router to shut down and then restart.

help

To display information on how to use the CLI, issue the help command.

help

Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

Administrator or Monitor.

Command History

Release	Modification
2.2.1	This command was introduced for the SN 5428.
3.2.1	This command was introduced for the SN 5428-2.

Usage Guidelines

The help command displays information about the various CLI commands that can be issued, based on the mode currently in use. The help command also displays information about the special keys that can be used in the CLI.

Examples

The following example shows the special key information returned as a result of the help command:

[SN5428-2A]# help

Special keys:

  ?                     list choices

  Backspace             delete character backward

  Tab                   complete current word

  Ctrl-A                go to beginning of line

  Ctrl-B or Arrow Left  go backward one character

  Ctrl-D                delete character

  Ctrl-E                go to end of line

  Ctrl-F or Arrow Right go forward one character

  Ctrl-K                delete from current position to end of line

  Ctrl-N or Arrow Down  go to next line in history buffer

  Ctrl-P or Arrow Up    go to previous line in history buffer

  Ctrl-T                transpose current character and previous character

  Ctrl-U                delete line

  Ctrl-W                delete previous word

Related Commands

Command	Description
enable	Enter Administrator mode.
exit	Leave Administrator mode and enter Monitor mode.

hostname

To specify a new system name for the storage router, use the hostname command. The storage router is recognized by this name through the management interface.

This command takes effect immediately, and the new system name is automatically integrated into the prompt string.

hostname sysname

Syntax Description

sysname

The name of the storage router. This may be the fully qualified domain name. Maximum length is 19 characters. The name cannot contain blanks, white space, or control characters.

Defaults

None.

Command Modes

Administrator.

Command History

Release	Modification
2.2.1	This command was introduced for the SN 5428.
3.2.1	This command was introduced for the SN 5428-2.

Usage Guidelines

The storage router must have a system name, which is assigned to the storage router during initial configuration. Use this command to change the system name.

If you wish to enable network management on the storage router using the facilities of a Domain Name Server (DNS), you must make the storage router system name and IP address known to the DNS. Use the system name specified in this command.

Examples

The following example changes the storage router name to sn5428-2lab1.

[SN5428-2A]# hostname sn5428-2lab1

Related Commands

Command	Description
save all	Save all configuration information.
save system	Save selected system configuration information.
show system	Display selected system information, including system name.