Starting the JMX Agent

To start the SQLFire JMX Agent, use the sqlf agent command to invoke the Agent script.

The general syntax for using sqlf agent to start an Agent is:
sqlf agent start [-Jvmarg]* [-dir=dir] [prop=value]*
-Jvmarg A JVM option passed to the Agent’s JVM. For example, to define a 1 GB heap, you include this option: -J-Xmx1024M. To set a system property to “true�?, you add
-dir=dir The directory in which the Agent’s log file is written. The default is the current directory. For details, see Agent Log File.

A configuration property and value passed to the Agent. You can define configuration properties on the command line or in the Agent properties file. For details, see Agent Properties File.

This command line instantiates a JMX Agent with a non-default working directory and property file:

sqlf agent start -dir=/usr/local/sqlfire property-file=/usr/local/sqlfire/agent/myprops.props

When you launch the JMX Agent, you identify the distributed system to which you want to connect by specifying the lookup method (used to discover and communicate with other members of the distributed system) as either IP multicast or a SQLFire locator member. See Configuring Discovery Mechanisms.

You specify these attributes as a list of prop=value pairs on the agent command line, or in the agent property file. For example, to connect to a SQLFire system that uses a locator:


To connect to a system that uses multicast:


The agent registers an AdminDistributedSystem MBean with the SQLFire distributed system.

See Distributed System Properties for JMX Agent for a list of additional properties. Additional properties are available to configure the supported JMX connectors/adaptors (RMIConnectorServer and HTTPAdaptor). For details, see the tables under Configuring JMX Connectors and Adapters.