The Web console uses the initialization parameter agent.property.resources to determine which JMX agents it can connect to. This parameter is defined in the mgmt servlet properties, and can be changed using Jaguar Manager. The parameter is specified within the plugins property. During installation, it is set to this value (all on one line, including the curly braces):
{name=JMX,classname=com.sybase.servlet.jmx.JMXPlugin,
agent.property.resources=agent.properties}
JMX is the only plug-in included in the installation.
The agent.property.resources property value is a comma-separated list of resource identifiers, initially set to “agent.properties.” Each resource must be located in the servlet’s CLASSPATH. This release contains one resource, agent.properties, which is located in the Repository/WebApplication/SysMgmt/WEB-INF/classes/com/sybase/servlet/jmx subdirectory of your EAServer installation.
There must be one resource file for each agent. If the resource name does not begin with a forward slash (“/”), then the resource is located relative to com/sybase/servlet/jmx in the CLASSPATH.
Setting the agent.property.resources property
Using Jaguar Manager, connect to the EAServer where the Web application was deployed.
Expand these successive folders: Servers | Jaguar | Installed Web Applications, and highlight SysMgmt.
In the right pane, highlight mgmt, and select File | Properties.
On the Init-Params tab, highlight “plugins,” and click Modify.
In the Modify Property dialog box, edit the value of agent.property.resources appropriately, and click OK.
You can specify multiple resources by separating them with
commas, but you must escape each comma using a backslash to ensure
that subsequent entries are not treated as property names. For example,
to set the value to a1.props and a2.props,
use this syntax:
agent.property.resources=a1.props\,a2.props
Do not change any other values within the plugins property.
Click OK to close the Web Application Component Properties dialog box.
Highlight the SysMgmt Web application, right-click, and select Refresh.
A resource file associated with an agent contains lines similar to the following:
agent.name=Local com.sybase.management.jmx.mbeanserver.locator=com.sybase.management.jmx.util.MX4JRMIConnectorServerLocator com.sybase.management.jmx.mbeanserver.hostname=localhost com.sybase.management.jmx.mbeanserver.port=1099 com.sybase.management.jmx.security.principal=sybrmiclient com.sybase.management.jmx.security.credentials=_5y6rm1cl1en4 com.sybase.management.jmx.adaptor.rmi.truststore.resource=/clienttrust.store com.sybase.management.jmx.adaptor.rmi.keystore.resource=/clientkey.store com.sybase.management.jmx.adaptor.rmi.keymanager.password=keypwd
The agent.name property identifies the agent; the other property values are used to obtain a connection to the agent.
com.sybase.management.jmx.mbeanserver.locator identifies the class that is used to locate the MBeanServer. Do not change this value.
com.sybase.management.jmx.mbeanserver.hostname defines where the agent is located.
com.sybase.management.jmx.mbeanserver.port identifies the port used by the agent to receive connection requests. This must match the RMI listener port specified in the boot.xml file used to boot the JMX agent.
com.sybase.management.jmx.security.principal specifies the user name for connecting to the JMX agent. This must match the user name specified in the boot.xml file.
com.sybase.management.jmx.security.credentials specifies the password. Again, this must match the value in the boot.xml file.
com.sybase.management.jmx.adaptor.rmi.truststore.resource identifies the location of the truststore; used when SSL is required between the client and the JMX agent.
com.sybase.management.jmx.adaptor.rmi.keystore.resource identifies the location of the keystore; used when SSL is required between the client and the JMX agent.
com.sybase.management.jmx.adaptor.rmi.keymanager.password specifies the keymanager password; used when SSL is required between the client and the JMX agent.
| Copyright © 2003. Sybase Inc. All rights reserved. |
|
|
