This chapter explains how to use the IRISconsole graphical user interface (GUI) and IRISconsole commands to administer IRISconsole and the servers and other devices in sites that it controls. The major sections in this chapter are as follows:
The icpass command is used to list administrators and users, change their passwords, and delete them. Performing these tasks is described in the following subsections. (Adding administrators and users is described in the sections “Adding an IRISconsole Administrator” and “Adding an IRISconsole User” in Chapter 2.)
To display a list of IRISconsole administrators, type
icpass -list icadmin |
To display a list of IRISconsole users, type
icpass -list icuser |
In each case, IRISconsole prints the path of the password file.
To change an IRISconsole administrator's or user's password, type
icpass -change icuser |
or
icpass -change icadmin |
The window shown in Figure 4-1 appears.
Enter the login for the user whose password you want to change. Enter the user's old password and new password, and click the Apply button.
To delete an IRISconsole administrator or user, you must be an IRISconsole administrator. Type
icpass -delete icadmin icadminlogin |
or
icpass -delete icuser icuserlogin |
The security window shown in Figure 2-2 appears. After you enter correct information, a confirmation window appears with the message
Entry deleted from password database |
You can use the command ictelnet to access the IRISconsole text-based menu from another system. Follow these steps:
If you haven't already done so, configure the IRISconsole system for remote access. Follow the instructions in the section “Setting Up IRISconsole for Remote Access” in Chapter 2.
To use ictelnet from any system, type
ictelnet consolehostname port
The port number should be the port number value for ictelnet services in the /etc/services file determined in step 1 of “Setting Up IRISconsole for Remote Access” in Chapter 2“ of this manual.
Note: The recommended port number is 5000. The software prompts for your IRISconsole login and password.
Enter your IRISconsole login and password as they were entered with icpass -add icuser or icpass -add icadmin; see “Adding an IRISconsole Administrator” in Chapter 2 for details.
After a few lines of response, the available IRISconsole sites are listed, for example:
Main Menu: Available Sites --------------- 1. eng1a 2. eng1b 3. eng1c Enter choice (1 - 3) or 'q' to Quit:
If a network connection from the remote host you are using to the IRISconsole system is not available, you have two choices:
log in to the IRISconsole system via modem and use ictelnet from there
if you have a (modem) SLIP or PPP connection, you can run the IRISconsole GUI remotely
Enter the number for the site to which you want to connect.
Text like the following appears:
Site 'eng1a': Available Systems ----------------- 1. eng1a 2. eng1b 3. eng1c Enter choice (1 - 3) or '..' for Main Menu:If an entry beneath the Available Systems heading is a partitioned array, “(Partitioned System)” is appended to the system name. If this system is chosen, another submenu is displayed, and a list of partition names appears, for example:
System: elements Available Partitions --------------------- 1. mercury 2. argonne Enter choice (1 - 2) or ` ..' for Main Menu:
Enter the number for the system to which you want to connect.
The Available Operations menu appears, for example:
System 'eng1a': Available Operations -------------------- 1. Connect to Console 2. Hardware Reset 3. Generate NMI 4. Power Cycle 5. Power On 6. Power Off 7. Steal Occupied Console Line 8. Connect to System Controller 9. Start Service Tool Enter choice (1 - 5) or '..' for Systems Menu:Note: HW Reset, Generate NMI, and Power Cycle on an Origin or Onyx2 system require that the system controller have the default password. Enter the number for the operation you want to perform.
The following message appears:
This operation is protected. Please enter your IRISconsole login and password. IRISconsole Login:Enter your IRISconsole login and password at the prompt.
Status and other information like the following appears:
------Connected Port=/dev/ttyd043 ------ 9600 BAUD 8 NONE 1 SWFC=ON HWFC=OFF CAR=ON DTR=ON RTS=ON CTS=ON DSR=ON Type ~? for Help, ~X to Exit. Connection Ready.
Use the tilde commands ((+-)Baud Csize Dtr Framing Hwfc Info breaK Modem Oflush Parity Rts Swfc eXit) to change settings; you need not press <Enter>.
For example, ~S (note that this letter is uppercase) toggles software flow control and displays a message similar to:
9600 BAUD 8 NONE 1 SWFC=OFF HWFC=OFF ^^^^^^^^To exit ictelnet, type ~X.
This command returns you to the Available Operations menu for the system that was described in step 5 of this procedure.
From the Available Operations menu, type .. to exit to the Systems Menu, type .. to exit to the Main Menu, then type q to exit to the IRIX prompt.
To see characteristics for a site, double-click its name in the scrolling list of sites in the IRISconsole main window. Figure 4-2 shows an example main window.
Alternatively, you can select a site and then choose Open Site from the IRISconsole main window Operations menu. Figure 4-3 shows an example site window.
To get a console for a system that is part of a partitioned system, you must choose a partition from the list that appears when you choose Select System Partition... from the Edit menu as shown in Figure 4-4. If you attempt to choose a system by double-clicking on the partitioned system icon, you see the error message shown in Figure 4-5.
You can use the buttons in the site window (see Figure 4-3) for system administration tasks. All but the HW Status button display a window in which you type your IRISconsole login and password as it was entered in the IRISconsole security facility; see “IRISconsole Security” in Chapter 1. The buttons are as follows:
| Get Console | To access and display a system's console window, select the system and click the Get Console button. The console window appears on the workstation screen. | |||
| Connect SYSCTRL |
| |||
| Steal Console | To take control of a system console that another user is currently using, select the system and click the Steal Console button. The console window appears on the workstation screen. The original user sees the message IRISconsole DINC closing...; that user's session is killed. | |||
| Spy Console | To display a window showing console activity of a system in progress, select the system and click the Spy Console button. In order to view this activity, the Log Console Activity to File option must have been checked when the system is added to a site, as explained in step 9 in “Adding a System to a Site” in Chapter 3. | |||
| Show Console Logs |
| |||
| HW Status | To display graphs of system activity, click the HW Status button. The Hardware Status Monitor appears; this feature is explained in detail in the section “Displaying Hardware Status Information” later in this chapter. This feature requires a network connection between the OCTANE, O2, or Indy host and the target system. | |||
| Generate NMI |
| |||
| Start Serv Tool |
| |||
| HW Reset | To reset a system in a site (hardware reset), select the system and click the HW Reset button. A confirmation message appears.
| |||
| Power Off | To power off a system, select the system and click the Power Off button. | |||
| Power Cycle | To power-cycle a system, or to power on a system that has been turned off, select the system and click the Power Cycle button. In the case of a power cycle, the system controller removes the power enable control signals, waits five seconds, and restores power. Boot arbitration is started after power is reapplied.
that system's system controller have the default password. | |||
| Power On | To power on a system, select the system and click the Power On button. |
For each of these tasks, you can also choose the corresponding command from the Operations menu.
When you configure a system within a site, you have the option of specifying one or both port connections, the console and/or the remote system control port, described in “Adding a System to a Site”. Once a system is configured and you select it by double-clicking the appropriate icon on the IRISconsole site window, only those operation buttons and corresponding pulldown menu selections that can be used are activated.
For example, if only the console port is configured, then only the Get Console, Steal Console, Spy Console, Show Console Logs, and HW Status buttons are activated for use.
The following operation buttons require a Console connection:
Get Console
Steal Console
The following operation buttons require a Remote System Controller connection:
Connect SYSCTRL
Generate NMI
Start Serv Tool
HW Reset
Power Off
Power Cycle
Power On
The following operation button requires a network connection for rsh:
HW Status
The following operation buttons do not require any connection:
Spy Console
Show Console Logs
The IRISconsole Availmon report gives a snapshot of availability information on a system. It is a condensation of the information in /var/adm/avail/availlog, displayed in a format similar to that of /var/adm/avail/amreport.
To display the Availmon report, follow these steps:
Make sure that availmon is installed and active on the Origin, CHALLENGE, Onyx2, and Onyx systems you wish to access (use /etc/chkconfig).
In the site window, select the system for which you want a report.
Choose Availmon Report... from the Monitor menu. A window like the one in Figure 4-6 appears.
To display the SYSLOG for a system, select the system in the site window. Choose Show Syslog... from the Monitor menu.
To update the SYSLOG display, close the syslog window and choose Show Syslog... again.
To display the SYSLOG for all of the systems in a site, choose All Systems
You can use the Show SYSLOGs button on the IRISconsole GUI main window to view the system log messages for all systems in a site using the System Log Viewer window as shown in Figure 4-7.
You can store the SYSLOG entries for all systems in a site in the same log file on the system running IRISconsole 2.0. To do this, add a line similar to the following example in each /etc/syslogd.conf file for each system:
*.crit;*.notice;*.info;*.debug @cmindy.cray.com |
where @cmindy.cray.com is the name of the system running IRISconsole 2.0. This line instructs the syslogd daemon to send all critical, notice, information, and debug messages to @cmindy.cray.com.
To display a hardware inventory of an attached system, select the system in the site window and click Hardware Inventory... from the Monitor menu. The output of hinv for that system appears in a window.
| Note: Hardware status information is not available for Origin or Onyx2 systems. This section and its subsections do not apply to Origin or Onyx2 systems. |
To display hardware operating information on a CHALLENGE or Onyx system in a site, follow these steps:
In the IRISconsole main window, double-click on the site containing the system whose hardware operating information you want to check. The site window appears.
In the Systems scrolling list of the site window, select the system for which you want information.
Click the HW Status button. The IRISconsole Hardware Status Monitor appears, as shown in Figure 4-8.
The subsections below explain how to customize the Hardware Status Monitor display, change the point and line styles for graphs, and use graph control panels for specific graphs.
To change the height of a graph in the IRISconsole Hardware Status Monitor, put the mouse cursor on one of the two sashes (small square at the extreme right between the graphs) and drag it down or up; the relative heights of the graphs above and below it change.
To zoom an area of the display, select the graph you want to zoom; holding down the Ctrl key and pressing the middle mouse button, move the mouse. Press r to reset the display.
You can further customize the display using options from the Hardware Status Monitor View menu. Figure 4-9 shows the View menu.
Finally, you can use the Global Controls dialog box to customize the graph data. Choose Global Controls...from the Options menu; Figure 4-10 shows this dialog box.
To change the point or line style in a graph display, follow these steps:
| Note: Style changes apply onscreen and for printing only; point and font style changes are not saved when the graph is saved to a file. |
From the Selected menu, choose Styles... or click the Styles button in the Graph Control dialog box. Figure 4-11 shows the Graph Style dialog box.
In the Hardware Status Monitor, click the left mouse button on the graph whose style you want to change. The graph background turns yellow.
Put the mouse cursor on the line whose style you want to change and click the right mouse button.
Note: To facilitate selecting a line, zoom the display by holding down the Ctrl key, pressing the middle mouse button, and moving the mouse. To reset the display,
type r.In the Graph Style dialog box, select the point or line style you want and click the Apply button to save the setting.
When you are satisfied with the settings, click the Close button to exit the Graph Style dialog box.
A graph control panel is associated with each graph. To display the control panel for a graph, follow these steps:
In the Hardware Status Monitor, select the graph for which you want to display a control panel. The graph background turns yellow.
From the Selected menu, choose Graph Controls.... Figure 4-12 shows the graph control panel for blower speed(s).
Use features of this panel to
set an alarm threshold, as described in “Using Alarms,” later in this chapter
set actions to be performed if the threshold is exceeded, as described in “Using Alarms,” later in this chapter
clear an alarm
change the point and line style of the graphs, as described in “Changing Point or Line Styles for Graphs,” earlier in this chapter
print the graphs, as described in “Saving Graph Data to a File,” later in this chapter
save the graphs as graphs or PostScript files, as described in “Printing a Graph,” later in this chapter
| Note: Alarms are not available for Origin or Onyx2 systems. This section and its subsections do not apply to Origin or Onyx2 systems. |
You can set a threshold value for a hardware operating parameter, such as blower speed. When the value is exceeded, the graph that maps it changes color to alert you that the threshold has been exceeded and its contents are saved to a file. You can also set IRISconsole to perform any of the following actions when the threshold is exceeded:
For example, you can set the operating temperature threshold for a CHALLENGE XL in a site to 37, so that when the system internal temperature exceeds 37 degrees C, the alarm is triggered.
This section explains
setting a threshold for an alarm
clearing an alarm
viewing an alarm graph file
using a notify script
To set a threshold, follow these steps:
Select the graph for which you want to set an alarm threshold. The graph background turns yellow.
From the Selected menu, choose Graph Controls.... The Graph Control Panel appears; Figure 4-13 shows the panel for the Temperature graph.
If desired, change the data density (number of points) of the data being sampled.
Select the high and low alarm threshold values you want from the choices in the High and Low fields.
If desired, select one or more alarm actions in the Global Controls window.
When the threshold value is reached or exceeded, the graph display turns hot pink when unselected (bright red when selected).
To clear an alarm, select the graph whose alarm you want to clear and click the Clear Alarm button in the Graph Control panel, or choose Clear Alarm from the Selected menu. To clear all alarms, choose Clear All Alarms from the Options menu.
When a threshold is exceeded, the graph for which the alarm is set is automatically saved to a file in the directory /var/IRISconsole/logs/alarms. The filename has the format graphname.<timestamp>.xrt; for example, voltage.951231.1144.0.xrt.
You can view alarm graph files by choosing Display Saved Graph... from the IRISconsole Hardware Status Monitor File menu; see “Displaying a Graph File,” later in this chapter.
An option in the Global Controls window enables IRISconsole to run a script—/var/IRISconsole/adm/scripts/icnotify.tclX—when an alarm threshold is exceeded. This script, which was written in tclX (extended tcl), is self-documenting.
To edit this script, choose Edit Operator Notify Script from the main window Options window. You must be root to edit this script.
For example, to cause an alarm threshold to send an e-mail message to a specified user, enter e-mail address(es) in the curly braces in the line
set OPERATORS { }
|
You can edit icnotify.tclX to include other scripts.
| Note: Graph files are not available for Origin or Onyx2 systems. This section and its subsections do not apply to Origin or Onyx2 systems. |
You can save, display, and print graph data for CHALLENGE and Onyx systems in files in either PostScript or image form. The subsections below describe how to perform these operations.
You can save a graph to a PostScript file or image file to send to service personnel, or to compare with other graph data saved to files.
To save a graph to a PostScript file, click the Save As PS... button in the Graph Control panel. Enter a filename and click the Save button to save the file and exit the dialog box.
To save a graph to an image file, follow these steps:
Freeze the data by clicking the Live Data Feed check box off in the Graph Control panel (see Figure 4-12 or Figure 4-13). The scroll bars under the graphs are activated.
Click the Save As Graph button in the Graph Control panel. A file selection dialog box appears, as shown in Figure 4-14.
If desired, click the Filter button to display a dialog box in which you can exclude filename patterns to restrict the filenames displayed.
Enter a filename for the graph file in the Selection field.
Click the Save button to save the file and exit the dialog box.
You can display the saved graph in IRISconsole by choosing Display Saved Graph... from the IRISconsole Hardware Status Monitor File menu. A dialog box similar to that shown in Figure 4-14 appears, in which you select the file to display. Files saved as graphs appear when they are selected.
To display files saved as PostScript files, use your PostScript viewer.
You can print a PostScript graph file just as you would print any other PostScript file.
You can also print a graph as it is displayed in the Hardware Status Monitor. Follow these steps:
In the Hardware Status Monitor, select the graph you want.
If desired, change the dimensions of the graph by moving a sash (small square at the extreme right between the graphs).
If desired, select an area of the display by holding down the Ctrl key and pressing the left mouse button; zoom the selection by moving the middle mouse button. (Press r to reset the display.)
When the screen displays the graph as you want it to be printed, click the Print button. In the Print dialog box, choose the print options you want.
You can rename or delete a site using options from the IRISconsole main window Edit menu.
If your hardware configuration changes, choose Modify System Config... from the site window Edit menu to change the parameters for a system in a site.
To delete a system from a site, select it in the site window and choose Delete Selected System from the Edit menu.
| Note: The Save As... option in the site window Edit menu was removed in the IRISconsole 1.3 release. |