logo

Manual Pages


Table of Contents

NAME

na_halt - stop the filer

SYNOPSIS

halt [ -d halt_string ] [ -t mins ] [ -f ]

DESCRIPTION

halt flushes all cached data to disk and drops into the monitor.

NFS clients can maintain use of a file over a halt or reboot (although experiencing a failure to respond during that time), but CIFS, FCP, and iSCSI clients cannot do so safely. Therefore, if the filer is running CIFS, FCP, or iSCSI you may use the -t option to specify the time before shutdown. If halt is invoked without -t, it displays the number of CIFS users, the number of open CIFS files, the number of mapped LUNs and the number of connected FCP and iSCSI clients. Then it prompts you for the number of minutes to delay. cifs terminate automatically notifies all CIFS clients that a CIFS shut-down is scheduled in mins minutes, and asks them to close their open files. CIFS files that are still open at the time the filer halts will lose writes that had been cached but not written. FCP and iSCSI will not notify clients, but will allow administrators to confirm that the mapped LUNs are not in use. LUNs that are in use at the time the filer halts will result in client failures.

halt logs a message in /etc/messages to indicate that the filer was halted on purpose.

OPTION

-d halt_string Dumps system core before halting. The halt string should indicate the reason why the system was halted.

-t mins
Halts after the indicated number of minutes.

-f
Applies only to filers in a cluster. If you enter the halt -f command on a filer, its partner does not take over.

CLUSTER CONSIDERATIONS

After you enter the halt command on a filer in a cluster, the other filer in the cluster automatically takes over the filer that you halted. If you do not want takeover to happen, use the halt -f command.

The halt command is not available in partner mode. That is, you cannot enter the partner halt command on the live filer after it takes over the failed partner. This is because a filer that has been taken over is no longer running and cannot be halted.

SEE ALSO

na_cifs_terminate(1), na_partner(1), na_reboot(1), na_savecore(1), na_messages(5)


Table of Contents