C H A P T E R  8

Monitoring the Sun Ray System

This chapter describes how to use the Sun Management Center software to monitor the Sun Ray System. Installation instructions for the Sun Management Center are located in Installing the SunMC Software of the Sun Ray System Software 4.0 Installation and Configuration Guide.

Topics include:


Sun Management Center (SunMC) Software Features

The Suntrademark Management Center software monitors managed objects in the Sun Ray system. A managed object is any object that can be monitored. Sun Ray nodes contain many managed objects. The Create Topology Object dialog box enables you to create a Sun Ray node. If the Sun Ray packages are installed when you create a Sun Ray node, the following managed objects are created by default:

Each managed object is monitored separately and has independent alarm settings.

For example, in a failover configuration, the entire group as well as any part of the group can be monitored--each server and its load, each interconnect, and each DTU. Sun Management Center software also monitors Sun Ray Server Software daemons that:

After you set an alarm, the Sun Management Center software notifies you when your specified parameter value has been reached. For example, you might want to track the number of DTUs on a server so that you can monitor possible overload scenarios. Other alarms can be set to notify you when a server, interconnect, or DTU goes down or when a daemon is not running.

The three Sun Management Center components (TABLE 8-1) can be installed on three separate machines.


TABLE 8-1 Three Components of Sun Management Center Software

Component

Function

Console

Enables you to set and view alarms and to request system information. Requests can be automated or on demand.

Server

Processes requests and passes them on to the appropriate agent. The agent returns the requested information to the server, which then forwards it to the console.

Agents

Monitor the system. Agents return the requested information to the server. These agents, based on SNMP (Simple Network Management Protocol), monitor the status of the managed object (server, interface, or DTU).


Sun Ray system monitoring consists of a set of packages, which are installed as part of Sun Ray Server Software. If you run the Sun Management Center on a non-Sun Ray server, you must add some packages that contain localized messages and icons to the Sun Management Center monitoring server.

This feature interfaces with the Sun Management Center software using SNMP. For information on additional monitoring programs that interact with Sun Management Center software, see Using Other Monitoring Programs.


Additional Sun Management Center Modules

There are other useful Sun Management Center modules available to monitor processes and help tune your Sun Ray system. For example, the Health Monitor module monitors resources on the Sun Ray server so you know when to add memory, swap space, or additional CPUs. The Sun Management Center Process Monitoring module helps identify runaway processes and limit multimedia applications.


Setting Up the Monitoring Environment

After installing the Sun Management Center software, you need to set up your monitoring environment. A default administrative domain is automatically created for you based on the Sun Management Center server component. You need to set a home administrative domain. This domain is displayed whenever the console is started. Next, create the hierarchy of the system you want to monitor. This can be done manually by adding nodes to the administrative domain or by using the Discovery Manager.


procedure icon  To Set Up the Monitoring Environment

1. After installing the Sun Management Center software, start the console on the server that has the console component installed:


# /opt/SUNWsymon/sbin/es-start -c &

The login screen is displayed.

2. Enter your user name and password.

Specify the Sun Management Center server.

3. Click Login.

The Sun Management Center window is displayed. If this is your first time using the SunMC console, the Set Home Domain window is also displayed.

4. In the Set Home Domain window, highlight the appropriate domain and click Go To.

The panels in the Sun Management Center window are populated.

5. Click Close to dismiss the Set Home Domain window.


procedure icon  To Create an Object

1. Expand the Sun Management Center Domains list.

2. Select the domain you plan to add an object to.

The selected domain is displayed.

3. Select Edit -> Create an Object.

The Create Topology Object pop-up window is displayed.

4. On the Node page, enter a Node Label and Description. Then enter the Hostname (server name), IP Address, and Port for the Sun Ray server.

The port entered here must be the same port you configured (entered) during the installation of the Sun Management Center.

Setting Alarms

Alarms are used to notify you when errors occur or your performance needs to be tuned. Alarms are triggered (tripped) if:

These alarms are set by default, but you can change them. Base a tuning alarm on the number of active sessions on each server in a failover group to determine if one of the servers is overloaded. You set the thresholds that trigger this type of alarm.


procedure icon  To Set an Alarm

1. After creating an object, bring up the Details window of the object.

FIGURE 8-1 Sun Management Center Details Window


Systems, services, failover groups, desktops, etc., can be managed via CLI

2. Double-click, for example, Failover Group in the left panel.

3. Right-click the value portion (Status) of the table row.

FIGURE 8-2 Example Using the Failover Group Panel


Three columns show host name, host type, and status

A pop-up menu is displayed.

4. Select Attribute Editor.

The Attribute Editor window for that table entry is displayed.

5. Select the Alarms tab (See FIGURE 8-3.)

The possible alarm values are:

6. Supply an appropriate number for the type of alarm that you choose to monitor.

In this example, the Alert Threshold alarm is set at greater than 1 to notify you when that server in the failover group is down.

7. Click the Apply button to save the value of the alarm and continue setting other values in the Attribute Editor

8. Click the OK button, which saves the value of the alarm and closes the window.

As soon as you set an alarm it takes effect.

9. Select the Actions tab and enter an action to perform.

Here you can also specify an action such as sending email or running a script for each alarm.

10. Select the Refresh tab to set the number of seconds between pollings.

The default value is 300 seconds (5 minutes).

11. Select the History tab to view information about the log file that records monitored values.

FIGURE 8-3 Alarm Window


Fields for thresholds: critical, alert, caution, etc.

If an alarm is tripped, a critical alarm displays as red, an alert alarm displays as yellow, and a caution displays as blue (see FIGURE 8-4).


procedure icon  To Start Monitoring

1. Start the Sun Management Center software:


# /opt/SUNWsymon/sbin/es-start -c &

A window for the Default domain is displayed.

2. Log in to the Sun management Center server.

3. Double-click the server in either panel.

The server Details window is displayed.

4. Expand the hierarchy in the left or right panel until it displays the level you want.

FIGURE 8-4 Details Window With Alarms


Systems, services, failover groups, alarms, etc. can all be managed via CLI

This console Details window shows the hierarchical details of your system. You can immediately see if any alarms have been tripped. An alarm’s area and type appear in the left panel as a colored circle with a bar. The Alert alarm also shows up on the title bar by the server node name and at the Operating System, Sun Ray, and Failover Group levels. Double-clicking the area where an alarm icon is present updates the right panel with the detailed information. If you position the mouse pointer over one of the colored circles in either panel, a pop-up window is displayed detailing the alarm information.

If you click the Alarms tab in the Details window, a window is displayed that lists a summary of all the current alarms. When you stop the Sun Ray services (daemons), the alarms display as shown in FIGURE 8-5.

FIGURE 8-5 Alarm Summary Window


Window lists the various alarms and for each a state, an action, and a message

The total number of alarms set for the current server object is displayed at the top of the alarm summary window. Critical alarms (red), alert alarms (yellow), and caution alarms (blue) that are tripped are listed below. Details and comments are displayed in the Message column.

Some cells in the table respond to a mouse-over event by displaying a pop-up window called a Tool Tip window. This window shows the current status and when it last changed, plus the type of alarm, its value, and when it occurred or when the last alarm was cleared. The Tool Tip time can also be the last time the agent was restarted. For example, on the Sun Ray System panel, a Tool Tip for Up Time (1/100ths sec.) would be:

Clear. Up Time (1/100th sec.) OK   Status changed Mar. 6, 15:23:55. 

indicating that the server was restarted and the alarm cleared on March 6 at 15:23:55. Similar information is provided for Active Sessions, Desktops, Users, and Total Sessions.


Setting Monitoring Guidelines

There are five managed objects that you can monitor:

Sun Ray System Panel

The Sun Ray System panel displays an overview of your Sun Ray system. From this window you can set specific alarms to monitor the server and its load.


procedure icon  To Display the Sun Ray System Panel

single-step bullet  Double-click the Sun Ray System icon in the left panel.

The Operating System/Sun Ray/Sun Ray System panel is populated.

FIGURE 8-6 Sun Ray System Panel


Software version, installation date, number of users and desktops, patch information


procedure icon  To Refresh the Sun Ray System Panel

single-step bullet  Click the refresh button (circular arrow in the upper right corner).

The entire system panel is refreshed.

The Up Time, session, DTU (desktop), and user information is refreshed periodically based on the number of seconds you set in the Attribute Editor. However, the console is updated only every five minutes unless an alarm occurs. The number of seconds set in the Attribute Editor only changes how soon an alarm is triggered.



Tip - Do not set the seconds to less than 60. The load interferes with the Sun Ray server performance.


In this panel, you set alarms to monitor the status of the server; how many sessions, users, or DTUs are active; and how many total sessions exist.


procedure icon  To Set Alarms

1. Click the Value cell of the Property you want to set an alarm for with the right mouse button.

2. Select Attribute Editor.

3. Click the Alarms tab.

4. Enter a value for each threshold you want to monitor.

5. Click OK.


TABLE 8-2 Properties on the Sun Ray System Panel

Property

Value

Host Name

Name of server that was queried. This information is obtained when Sun Ray System is selected or on manual refresh.

Contact Name

This information is obtained when Sun Ray System is selected or on manual refresh.

Up Time (measured in hundredths of a second)

Number of hundredths of a second since the last of all the daemons critical to the Sun Ray server was started. A value of 0 means the server is down and an alarm is tripped. The default refresh rate is 300 seconds (five minutes)

Version

List of version, build, and date of build of Sun Ray Server Software. This information is obtained when Sun Ray System is selected or on manual refresh.

Install Date

Date Sun Ray Server Software was installed. This information is obtained when Sun Ray System is selected or on manual refresh.

Patch Information

List of Sun-Ray-specific patches. This information is obtained when Sun Ray System is selected or on manual refresh.

Active Sessions

Number of sessions based on logged-in sessions with a smart card plugged in, plus sessions for DTUs logged in without smart cards. Set an alarm here to watch for overloading of this server. The default refresh rate is 300 seconds (five minutes).

Total Sessions

Number of active and suspended sessions. The default refresh rate is 300 seconds (five minutes).

Active Desktops

Number of connected DTUs. The default refresh rate is 300 seconds.

Active Users

Number of currently active users. When pseudo-tokens are allowed (this is a policy setting for non-smart card users), this number includes DTUs at the login prompt. The default refresh rate is 300 seconds (five minutes).

Policy

The policy that has been set. This information is obtained when Sun Ray System is selected or on manual refresh.


Sun Ray Services Panel

The Sun Ray Services panel displays the status of the Sun Ray daemons. If, for example, utauthd is not running, all user sessions are disconnected.

On the Sun Ray Services panel, default alarm values are set for the status of each daemon and the number of instances. Some of the daemons have two instances, corresponding to their two functions: one to listen and one to interact. You can reset them if you want to.

FIGURE 8-7 Sun Ray Services (daemons) Panel


This screen lists the daemons running at the moment.

The Status values are:


1

The daemon is running.

2

The daemon is down.


Failover Group Panel

The Failover Group panel displays the topography of your failover group. The panel lists the primary and secondary servers and their status.

FIGURE 8-8 Failover Group Panel


The Status values are:


1

The server is running.

2

The server is down (displays a yellow alert).


Interconnect Panel

The Interconnect panel lists all the network interfaces usable by the Sun Ray server.

FIGURE 8-9 Interconnect Panel


The DHCP Table lists the interfaces that are used for the Sun Ray interconnect. Available Addresses lists the number of addresses available for new end users. The alarms that are set here let the system administrator know when the Sun Ray server is running out of addresses to give to users.

The Interface Table lists all the interfaces on the Sun Ray server. The Address is the IP address for the interface. You entered this address as the Net Mask when you first configured your system. The Status values are:


1

The interface is up.

2

The interface is down.



procedure icon  To Set an Alarm for Running Out of Addresses

1. Click the Available Addresses cell in the DHCP Table using the right mouse button.

2. Select Attribute Editor.

3. Click the Alarms tab.

4. Enter the number of addresses left when an alarm should be tripped.

5. Click OK.

Desktops Panel

The Desktops panel is where you can select individual DTUs to monitor. DTUs can be added and deleted from the Monitored Desktops list. In a failover group, you can monitor any desktop from any server. The default polling time is 300 seconds (5 minutes). The Status values are:


1

The DTU is running.

2

The DTU is down.

3

The DTU is displaying the hourglass cursor.


FIGURE 8-10 Desktops Panel


Monitored and unmonitored desktops with their status, server name, packet loss, etc.

TABLE 8-3 describes the information in each column:


TABLE 8-3 Desktop Information

Property

Value

Name

Ethernet or MAC address of the DTU

IP Address

Assigned DHCP address of the DTU

Status

1 running, 2 down, and 3 displaying the green hourglass cursor

Packets

Number of packets received by the DTU

Lost Packets

Number of packets the DTU reported lost

Lost Percent

Percentage of packets lost

Location

Optional field; information supplied by system administrator

Optional Data

Optional field; information supplied by system administrator

Server

Server that owns the DTU

Model

The type of DTU: Sun RayP1 (Sun Ray 1), Sun RayP2 (Sun Ray 100), Sun RayP3 (Sun Ray 150), etc.

Firmware Revision

List of version, build, and build date



procedure icon  To Add a DTU to Be Monitored

1. Click Name using the right mouse button.

A pop-up menu is displayed.

2. Click Add Row.

A pop-up window is displayed.

3. In the Add Row window, enter the MAC address of the DTU you want to monitor in the Name field.

4. Click OK.


procedure icon  To Delete a DTU to Exclude Monitoring

1. Using the right mouse button, click the cell containing the MAC address.

A pop-up menu is displayed.

2. Click Delete Row.

A pop-up window is displayed.

3. Confirm the deletion by clicking Yes on the pop-up window.

Sample results of polling the Desktops are provided below.


Using Other Monitoring Programs

System administrators using HP OpenViewtrademarkVPO, Tivoli TMS, or CA Unicenter can also monitor Sun Ray servers. An interoperability interface exists between each of these packages and the Sun Management Center software. These interfaces translate Sun Management Center alarms appropriately so that you are notified when problems arise. These interfaces also enable you to view the server status. Hewlett- Packard provides the interface needed between HP OpenViewtrademarkVPO and Sun Management Center. Sun provides the interface needed between Sun Management Center and Tivoli TMS or CA Unicenter.

FIGURE 8-11 Example of Interoperability


System A connects to B, which in turn connects to C and E. System E connects to D.

In FIGURE 8-11, systems B and E must be Solaris SPARC systems; system C can be either a Solaris SPARC or a Solaris x86 system.


Removing the Sun Ray Module from SunMC

The Sun Ray module is uninstalled automatically when the utinstall script uninstalls Sun Ray Server Software. If you are uninstalling the Sun management Center software manually, please remove the Sun Ray module first.


procedure icon  To Remove the Sun Ray Module

single-step bullet  To unregister the module on the Sun Ray server, type:


# /opt/SUNWut/sbin/utsunmc -u

If the SunMC agent is running, utsunmc stops and restarts the Sun Management Center agent software.

single-step bullet  To remove the Sun Ray module on the SunMC server, type:


# /opt/SUNWut/lib/utsunmcinstall -u