Enterprise RTView® 
User Guide


Application Options

To access the Application Options dialog, in the Display Builder select Tools>Options. There are three Application Options tabs for JMX: JMX Connections, JMX Administration and JMX Connection Groups.

Options specified in JMX tabs can be saved in an initialization file (JMXOPTIONS.ini). On startup, the initialization file is read by the Display Builder, Display Viewer, Display Server, Data Server and Historian to set initial values. If no directory has been specified for your initialization files and JMXOPTIONS.ini is not found in the directory where you started the application, then Enterprise RTView will search under lib in your installation directory. NOTE: When you start an Enterprise RTView application from the Windows Start menu, it runs from the demos directory.  

NOTE: Options specified using command line arguments will override values set in initialization files.

 


JMX Connections
This tab allows you to add or remove connections and set your default connection.

When you add a JMX connection to the list it will be highlighted in yellow indicating that Enterprise RTView has not connected to it. To attempt to connect to a JMX connection, click OK, Apply or Save. If the background remains yellow, then Enterprise RTView was unable make a connection. Check that your JMX connection was setup correctly and that the JMX instrumented application is running. NOTE: Regardless of which tab you are currently working from in the Application Options dialog, each time you click OK, Apply, or Save Enterprise RTView will attempt to connect to all unconnected connections.
 

 

Default Connection Name of connection used as the default for data attachments. Select from drop down menu to change default setting.
Add Connection Click to open the Add JMX Connection dialog. To edit an existing connection, double-click on a selection from the JMX Connections list.
Connection Name Name to use when referencing this JMX connection in your data attachments. 
Host or IP Host name or IP address of the MBean server.
Port Port that your JMX instrumented application is using to expose MBean methods.
Enter URL Select to enter the URL (below) that should be used to create this connection. Otherwise, the Host/IP and Port specified will be used to construct a URL for this connection.
URL URL that should be used to create this connection. Select Enter URL to enable this field. Enter local to make a local connection to an in-process MBean server.
Use Client Credentials If selected, the User Name and Password from the Enterprise RTView login will be used instead of the User Name and Password entered in the Add JMX Connection dialog. Connections to this database will only be made when you are running with login enabled.

If you will be using the Data Server or the Display Server with a JMX connection that has this option enabled, you must enable Use Client Credentials for Database Login in these applications. In both of these deployments, a connection will be made for each client login, as the users log in. Once all of the clients for a login have closed, the connection for that login is removed.

User Name User name to use when creating this connection. This parameter is optional.
Password Password to use when creating this connection. This parameter is optional.
Additional Properties Property Name  
Property Value  
Add Property Enter a Property Name and Property Value and click Add Property to insert.
Remove Property Select a Property Name from the list and click Remove Property to delete.
Remove Connection Select a connection from the list and click Remove Connection to delete.
Remove All Connections Removes all connections.

 



JMX Administration
 

 

Expand Composite Attributes Select to expand composite attributes so that you display one column for each item when a composite attribute is displayed in a table with other attributes.

The column name will be compositename.itemname.

Default Poll Interval Enter the time in milliseconds to control how often MBean attributes are polled or operations in data attachments are executed if no Poll Interval is specified in the data attachment. Default is 0, which polls MBean attributes and operations according to the General Update Period specified in Application Options on the General tab.

NOTE: Because the Default Poll Interval is superseded by the
General Update Period, the amount of time elapsed between MBean polls may be longer than the value entered. For example, if the General Update Period is 2000 milliseconds and the Default Poll Interval is 5000 milliseconds, MBean attributes and operations will be polled every six seconds.
Automatically Discover Local MBean Servers If selected, RTView will get the list of local MBean Servers once each poll interval. NOTE: Poll interval is determined by either the Default Poll Interval or according to the General Update Period specified in Application Options on the General tab.

All new servers that are discovered are added as connections using the process ID for the connection name. Connections to servers that have exited will be removed. Auto-discovered connections are not saved to JMXOPTIONS.ini.

All auto-discovered connections are added to a JMX Connection Group named RTViewDs-Auto. This group cannot be removed or edited and is not saved to JMXOPTIONS.ini.

NOTE: This option requires JDK 1.6 and you must include the tools.jar file (from your JDK installation) in RTV_USERPATH.



JMX Connection Groups
 

JMX Connection Group Name Add Enter a JMX Connection Group Name and click Add to insert.

Once you have added a group, double-click on the name of that group to define its connections in the Select Connections dialog.

NOTE: It is possible to enter a Connection Name that contains one or more wildcard (i.e. *) characters. For example, rtvdisplay* or *jmx*.

Remove Select a group from the list and click Remove to delete.
   

 
Enterprise RTView contains components licensed under the Apache License Version 2.0.

 

Treemap Algorithms v1.0  is used without modifications and licensed by MPL Version 1.1. Copyright © 2001 University of Maryland, College Park, MD

 

Datejs is licensed under MIT. Copyright © Coolite Inc.

 

JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

jQuery is licensed under MIT. Copyright © John Resig,

 
JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2009 Sherrill-Lubinski Corporation. All Rights Reserved.