Using the Java Performance Monitor

The Administration Page contains a link to the Java Performance Monitor. If you use the Administration Page, you do not need to follow the steps for configuring a Java Performance Monitor, unless you want to be able to monitor any RealServer or want to monitor a RealServer from a computer that doesn't have a Web browser.

The Java Performance Monitor can be run two ways: as a stand-alone application or as an applet that you view within a Web browser.

If you want to monitor performance on any server, run the Java Performance Monitor as a stand-alone application. If you're only interested in viewing server activity on a specific Web site, or if you want users to be able to view that site, use the Java Performance Monitor as an applet.


Monitoring Activity of Any Server

Two sets of Java files enable you to use the Java Performance Monitor to monitor activity on any server. One such file, jview.exe, is installed with Microsoft Internet Explorer versions 3.0 and later. If you have this file on your computer, you can monitor server activity immediately. If you do not have this file, you'll need to download files from Sun Microsystems.

Java Performance Monitor as Application

Internet Explorer

To use the jview program

  1. Locate the jview.exe file on your computer. It is typically found in the Windows directory. The Windows directory is typically in the path, but if jview.exe is not in a directory that's in the path, you'll need to type its full path in step 3.
  2. At a command line, change to the JavaMonitor directory.
  3. Type the following:
    jview monitor

The Java Performance Monitor runs as an application. To connect to the server, follow the instructions in "Connecting to the Server," below.

All Others

To use the Java Runtime Environment

  1. Download the Java Runtime Environment (JRE) from Sun Microsystems at the following address: http://java.sun.com
    Follow the installation instructions on the Web site.
  2. At a command prompt, change to the directory where JRE is installed.
  3. Type the following:
    jre -cp <path to JavaMonitor directory> monitor

The Java Performance Monitor starts as an application. To connect to the server, follow the instructions in Connecting to the Server.

Monitoring Activity of a Specific Server

RealServer includes the file monitor.htm which is preconfigured to display server status when viewed from the RealServer computer.

If you want to view the RealServer computer from any other computer, you must edit monitor.htm and ensure that the files in the JavaMonitor directory are available to the Web server or ftp server.

If you open the supplied monitor.htm without having made any changes, the Server box will be blank.

To view this server's performance from any other computer:

  1. Ensure that all the .class files in the RealServer JavaMonitor directory are available to Web browsers pointing to your site. You can copy the entire JavaMonitor directory, or you can copy just the .class files to a Web server directory.
  2. In a text editor, open the file monitor.htm, located in the RealServer JavaMonitor directory.
  3. Look for the APPLET tag:
    <applet code = "Monitor.class" width = 700 height = 400>
  4. Add the CODEBASE variable after the CODE variable:
    CODEBASE = "http://ServerName/JavaClassDirectoryPath/"

    where "ServerName" is the name of your Web or ftp server and "JavaClassDirectoryPath" is the directory where you copied the .class files in step 1. If your server is an ftp server, you can substitute "ftp" for "http."
    If you are using an ftp server, you must configure an anonymous account that permits directory read access to the location you specified in the CODEBASE variable.
  5. The tag should now look similar to the following example:
    <applet code = "Monitor.class" CODEBASE = "http://www.YourWebSite.com/YourJavaFilesDirectory/" width = 700 height = 400>
  6. Save the file under a different name.
  7. Put the new .htm file on your Web server.


 

Connecting to the Server

Once you have started the Java Performance Monitor, you'll use it to view and edit information about your server.

  1. In the Server box, type the name of the computer running the RealServer you want to monitor.
  2. In the Port box, type the port number to use to reach RealServer. This is the port specified in the PnaPort setting for the RealServer (the default is 7070).
  3. Type the password for the RealServer. (For more information, see MonitorPassword)
  4. Click Log on.


 

Monitoring Performance

In the Java Performance Monitor, double-click the Monitor button to see a display of your server. The Monitor window appears.

Usage Window

This area displays the number of players viewing content over time on the RealServer listed at the top of the window.

Interval Window

The Interval Window specifies how often information in the Monitor window is updated. This information is given in minutes.

Reset Graphic Button

The Reset Graphic button acts as a "refresh" or "reload" button, to clear the Usage screen.

Reset Peak Button

To update the peak shown in the Usage and Sources window to its current value, click Reset Peak.

Sources Window

The Sources window tells what files are being accessed and the number of times each file is being played. This helps you determine which files are most and least popular, which could help you decide what new fields to add or remove to improve the popularity of your site.

Connections Window

The Connections window indicates how many clients are connected to your site simultaneously.

© 1997 RealNetworks, Inc.