[Top] [Prev] [Next] [Contents] [Index]

Using SNMP Remote Reset/Reboot

On a TCP/IP network, terminals can be reset remotely using SNMP and the ncdreset(1) command. The host from which terminals are reset must be an SNMP manager host. ncdreset (1) provides the following choices:

The following sections describe the host and terminal configuration required before you can reset a terminal remotely.

Configuring a Host for SNMP Remote Reset

Complete the following steps to set up the host from which the remote reset command is issued:

  1. Install the ncdreset executable and the NCD MIB from the NCDware distribution, if necessary. They are installed when you install NCDware with the ncdinstall script.

  2. Make sure the host has SNMP management software.

Configuring a Terminal for SNMP Remote Reset

Complete the following steps to configure a terminal for remote reset:

  1. Set the snmp-allow-reset parameter to "true" (Setup -> Change Setup Parameters -> Access Control [SNMP section] -> Allow SNMP Reset). Reset is disabled by default.

  2. The default is to allow reset from any host and by any user. To restrict access to the reset function, do the following:

    These parameters are described in
    "Controlling Access to Terminals through SNMP".

Resetting Session and Rebooting Terminals

You can use the ncdreset utility or the unit-administrative-status remote configuration parameter to reset terminals remotely.

Using the ncdreset Utility for Remote Reset

To use ncdreset to remotely reset a terminal or restart the X session, enter an ncdreset command from a host designated as an SNMP manager. The default action of this command is to reset the terminal after the last client closes.

The reset process is irreversible. You cannot change to another reset level after resetting the terminal.

The syntax of ncdreset is:

ncdreset [ -V -v -c community -r reset_level ] hostname


-V Prints version information for the program on the standard output.

Prints a message on the standard output when the terminal is actually reset.
-c community

Is the community name. If the community name is not the default (manager), you must supply the community name.

Is the hostname of the terminal being reset.
-r reset_level Is the reset level. The values are:
1 Establishes an SNMP connection without resetting the terminal.
2 Restarts the X session.
3 Reboots the terminal when the last client closes. This is the default reset level.
4 Reboots the terminal immediately.

For example, the following command reboots the terminal when the last client closes and prints a message on the standard output when the terminal resets:

# ncdreset -v -r3 ncdu203

Using unit-administrative-status for SNMP Remote Reset

The unit-administrative-status remote configuration parameter (Setup -> Change Setup Parameters -> Unit -> Administrative Status) both displays the SNMP administrative status of terminals and provides for immediate or delayed resetting of terminals from a remote location.

Use of unit-administrative-status for remote reset requires that the snmp-allow-reset parameter be set to "true." The possible values for this parameter are described in Table 16-5. The parameter is not saved in NVRAM.

Table 16-5 unit-administrative-status Parameter Values
Possible Values
default running
running The terminal is running; no reset commands are pending.
session-reset The terminal restarts the session. This option is the same as logging out of the current session (in the Console, select Login -> Logout).
last-client-close-reset The terminal reboots when the last client closes.
unit-reset The terminal reboots immediately. This option is the same as rebooting the terminal (in the Console, select Console -> Reboot).

[Top] [Prev] [Next] [Contents] [Index]

Send comments, suggestions, or questions about this document to the NCD Technical Publications Department by Internet e-mail. Write to us at techpubs@ncd.com.
Copyright © 1997, NCD Inc. All rights reserved.