Chapter 3. Configuring Sites

This chapter explains how to use the IRISconsole graphical user interface (GUI) to set up a site, configure a site, edit a site configuration, add a system to a site, or delete a site configuration. The major sections in this chapter are as follows:

Starting the IRISconsole Graphical User Interface

The IRISconsole GUI main window enables you to set up a site, configure a site, edit a site configuration, add a system to a site, or delete a site configuration.

To start the IRISconsole GUI, follow these steps:

Make sure the OCTANE, O2, or Indy workstation, multiplexer, and the Origin, CHALLENGE, Onyx2, and Onyx systems to be administered are cabled as described in the IRISconsole Multiplexer Installation Guide and online man pages.

  1. Make sure all systems are powered on.

  2. The IRISconsole security feature is on by default; to check it or toggle it on or off, follow instructions in “Determining Whether IRISconsole Security Is On or Off” and “Setting IRISconsole Security On or Off” in Chapter 2.

  3. To start the IRISconsole graphical user interface in an IRIX window, enter

    ic 
    

    The IRISconsole GUI main window appears, as shown in Figure 3-1.

    Figure 3-1. IRISconsole Graphical User Interface Main Window

    Figure 3-1 IRISconsole Graphical User Interface Main Window

To exit the IRISconsole GUI, choose Quit from the File menu or press Ctrl+Q.

Setting User Preferences

The Edit menu in the IRISconsole GUI main window lets you turn on or turn off dialog boxes that ask you to confirm closing IRISconsole, closing a site, deleting a site, deleting a system, discarding site changes, overwriting a configuration, saving a site configuration, and saving a system configuration.

To set IRISconsole user preferences, follow these steps:

  1. From the Edit menu, choose User Preferences.... The Change IRISconsole Preferences dialog menu appears, as shown in Figure 3-2.

    Figure 3-2. Change IRISconsole Preferences Dialog Menu

    Figure 3-2 Change IRISconsole Preferences Dialog Menu

  2. Click the box to the left of each action to turn on (inserts a check mark) or turn off (deletes the check mark) the dialog box that asks you to confirm the associated actions that appear when you choose User Preferences ... from the Edit menu.

Each menu selection toggles between on or off.

Adding a Site

To set up an IRISconsole site and to specify the directories that receive console and alarm messages, follow these steps:

  1. From the Edit menu, choose Add New Site.... The Change IRISconsole Config dialog box appears, as shown in Figure 3-3.

    Figure 3-3. Change IRISconsole Config Dialog Box

    Figure 3-3 Change IRISconsole Config Dialog Box

  2. In the Site field, type a name for the site.

  3. In the Console Logs Directory field, type the pathname of the directory that will receive console messages.

  4. In the Alarm Logs Directory field, type the pathname of the directory that will receive alarm messages.

  5. Click the Apply button.

    The name of the configuration file as defined in the /var/IRISconsole/2.0/.IC/<site_name>/<system_names> directory appears in the Config field. The system_names are the configuration files which contain the configuration information for all the systems in a particular site defined by site_name.

  6. To save the new site configuration, choose Save IRISconsole Config from the File menu in the main IRISconsole window.


    Note: If you do not save the site configuration at this time, you can not save system configurations later.


  7. To add another site, edit the entry in the Site field or click the Reset button to clear the field. After you click the Apply button, the name of the new configuration file appears automatically in the Config field. Figure 3-4 shows a site named CM_cluster. Save the new site configuration as in step 6.

    Figure 3-4. IRISconsole Graphical User Interface Main Window with Cluster Icon

    Figure 3-4 IRISconsole Graphical User Interface Main Window with Cluster Icon

  8. When you are finished adding systems to the site, close the site window by clicking the Close button.

  9. To save the configuration, choose Save IRISconsole Config from the File menu. The site_name directories and system_name configuration files are saved to the IRISconsole directory /var/IRISconsole/2.0/.IC. Click the Close button to exit the Change IRISconsole Config dialog box.

Adding a System to a Site

To add a system to a site, follow these steps:

  1. In the IRISconsole main window, double-click the site to which you want to add a system or select the system and choose Open Site... from the Operations menu. The site window opens, as shown in Figure 3-5.

    Figure 3-5. Site Window

    Figure 3-5 Site Window

  2. In the site window, choose Add New System... from the Edit menu. If IRISconsole security is on, you are prompted for your password.

    After you enter your password, the Change Site Config dialog box appears, as shown in Figure 3-6.

    Figure 3-6. Change Site Config Dialog Box

    Figure 3-6 Change Site Config Dialog Box

  3. In the System Name field, type the hostname of the system you want to add to this site.

  4. From the System Type option menu, choose the type of system you want to add to this site. The choices are Origin200, Origin2000, CHALLENGE, Onyx2, and Onyx systems.

  5. From the Console Connection option menu, choose the type of multiplexer for this system and the Console port number. A number of multiplexers may be listed, such as ST-1600, ST-1616, ST-1620, ST-1032, EL-8, or EL-16. Use the Console Port# and Remote System Control Port# entries you made in the table similar to Table 2-1 to choose the appropriate multiplexer port numbers for each respective cable connection. You can have different multiplexers for each port; one for the console and another, if present and desired, for the remote system controller.

  6. From the Remote SystCtrl Connectionoption menu, choose the type of multiplexer for this system and the Remote System Control Connection port number.

  7. In the Login field, enter the login under which all operations requiring access to the system via the network can be performed. This login is the one used in the command

    rsh login@system /usr/etc/sysctlrd -r
    


    Note: The IRISconsole security login is separate from this system login; IRISconsole security is explained in “IRISconsole Security” in Chapter 1.


  8. From the Baud Rate option menu, choose the baud rate at which this system sends data to IRISconsole; the default is 9600. If you enter a different baud rate, be sure that the system has been configured for that rate.

  9. Click the box at Log Console Activity to File if you want console activity logged to a file in the /var/IRISconsole/logs/console_logs directory that has the format systemname.<timestamp>.log. The format of this filename cannot be changed.


    Note: To view a log of a system's console activity (Spy Console button or command) or to view console activity logs (View Console Logs button or command), this box must be checked when the system is added to a site.

    The console logs and alarm log directories may be changed in the Site Configuration dialog box.

  10. Click the box at Default System Controller Password if the system controller password has the default value. This box applies only to Origin and Onyx2 systems. If the system controller doesn't have the default password, the operations Generate NMI, HW Reset, and Power Cycle are not available; Connect SYSCTLR must be used instead (see the section “Viewing Site Characteristics” in Chapter 4).

  11. Click the box at FailSafe Controls SysCtrl Port if this system control port is to be controlled by Silicon Graphics IRIS FailSafe 1.2 or FailSafe 2.0 high-availability software.


    Note: To use this feature you must be familiar with IRIS FailSafe software. For information about IRIS FailSafe 1.2 or FailSafe 2.0, see the IRIS FailSafe Administrator's Guide, 007-3109-003, or IRIS FailSafe 2.0 Administrator's Guide, 007-3901-001, respectively.

    When a system control port is being controlled by FailSafe software and you try to reset the system after changing the system configuration, you see a warning dialog box instructing you to use the appropriate FailSafe command as shown in Figure 3-7.

    Figure 3-7. FailSafe Warning Dialog Box

    Figure 3-7 FailSafe Warning Dialog Box

  12. Click the box at Partitioned System if the system you are adding to the site is a partitioned system. A system partition is represented by a unique icon as shown in Figure 3-8.

  13. When you are satisfied with the settings for this system, click the Apply button to add this system to the site.

  14. To save the configuration, choose Save Site Config from the site window File menu.

  15. To add another system to the site, edit the entries in the fields of the Change Site Config dialog box, or click the Reset button to clear all entries and begin entering again. Follow instructions in steps 3 through 14 for the new system. An IRISconsole site with four systems is shown in Figure 3-8.

    Figure 3-8. IRISconsole Site With Four Systems

    Figure 3-8 IRISconsole Site With Four Systems

  16. When you are finished adding systems to the site, close the Change Site Config dialog box by clicking the Close button.

Performing Site Operations

The bottom of the IRISconsole main window, as shown in Figure 3-9, has four buttons that allow you to perform the following operations:

  • open a site

  • shut down all systems in a site

  • set system alarms

  • show the system logs for all systems in a site

Alternatively, you can choose these operations in the Operations menu on the IRISconsole main window, as shows in Figure 3-9.

Figure 3-9. IRISconsole Main Window Operations Menu

Figure 3-9 IRISconsole Main Window Operations Menu

These operations are described in greater detail in Chapter 4, “Administering Sites.”