You can read and write SNMP variables using the SNMP utilities provided with your SNMP host software. In addition, you can read a few variables using the ncdquery(1) utility provided on the NCDware distribution.
Reading a Terminal's SNMP Variables
The following sections describe how to use SNMP management software or the ncdquery utility to read a terminal's SNMP variables.
Using SNMP Management Software
A host's SNMP management software usually includes a get command that allows you to read a terminal's SNMP variables. Reading variables requires read-only or read/write access to the terminal, which is allowed by default.
Using the ncdquery Utility
The ncdquery utility allows you to display the contents of a few MIB variables for a specified terminal. An ncdquery command must be executed from a host designated as an SNMP manager or monitor:
For more information about community names, see "Configuring Read/Write Access" and "Configuring Read-Only Access".
The command syntax is:
ncdquery [ -V -v -c community -d variable_options ] hostname
Displays version information for ncdquery
Displays the hostname
Is the community name. If the community name is not one of the defaults (manager for manager hosts and public for monitor hosts), you must supply the community name.
Displays debugging information
Specifies the variable(s) to display. The default is to display the X server version. The options and variables displayed by each are:
X server version
Boot Monitor version
Keyboard controller version
Amount of memory installed
Amount of free memory
All of the above
Is the hostname of the terminal.
For example, the following command displays the X server and Boot Monitor versions, assuming the default community name and MIB file:
% ncdquery -s -b ncdu60
server version: NCD19c server 3.1.0 03/12/91 downloaded
boot monitor version: Boot PROM V2.2.4
For more information about the ncdquery command and its options, see the man page.
Writing SNMP Variables-Configuring Terminals
You can modify an NCD terminal's SNMP variables using your host SNMP management software. Host SNMP software usually includes a set command for modifying variables. Modifying variables requires read/write access to the terminal, which is allowed by default.
Consult your SNMP management documentation for information about commands to use for modifying SNMP variables.
Each remote configuration parameter has a variable name and path assigned to it. You can obtain SNMP variable names and paths for the read/write parameters from the Remote Configuration Parameter Quick Reference.
Depending on the SNMP management software at your site, you may need to assign numerical values to parameters that accept choices or Boolean values. To assign numerical values to a parameter, complete the following steps:
%xsnmpi -a 126.96.36.199 -c manager set ncdBootDesiredSource.0=5 where:
|188.8.131.52||Is the IP address of the terminal|
|-c manager||Is the community name for read/write permission|
|ncdBootDesiredSource||Is the SNMP variable name for the boot-desired-source parameter|
|5||Is the choice "local"|