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. |
|