This chapter explains the various parameters that can be configured for connectors used in the FioranoMQ Server (JMX & RMI) for handling remote connection requests to access/modify server configurations at runtime. These are the various parameters that are configured under the FioranoMQàFioranoàjmxàconnectoràJMSBasedJMXConnector2 and FioranoMQàFioranoàjmxàconnectoràRMIBasedJMXConnector tree nodes in Offline configuration through Studio.
For more information on JMX Connectors, refer Chapter 3 Connection Management of FioranoMQ Concepts Guide.
JMS Based Connector Configuration
Presented below are the details for the parameters present in JMX->Connector->JMSBasedJMXConnector.
InterceptorClassName
The InceptorClassName parameter is the Class Name that is used to intercept all jmx calls. When JMX calls arrive at the container, this parameter is used to intercept and process these calls.
Default Value:
fiorano.jmx.connector.FioranoJMXInterceptor - The name of the class used to intercept all jmx calls.
SecurityProtocol
The SecurityProtocol is the secure protocol used if the Connector Server the Server is connected to is running on a secure protocol. Example: SUN_SSL, NO_SECURITY.
Valid values:
- NO_SECURITY - No Security protocol is used.
- SUN_SSL - Sun_SSL is the security protocol that is used.
Default Value:
- NO_SECURITY - No security protocol is used by default.
Protocol
The Protocol parameter is the transport protocol used to connect to the JMS Server. This parameter allows the user to choose between available protocols such as LPC, TCP, and HTTP.
Valid values:
- TCP - TCP is the transport protocol that is used.
- HTTP - HTTP is the transport protocol that is used.
- LPC - LPC is the transport protocol that is used.
Default value:
LPC - LPC is the default protocol used to connect to the JMS Server.
SecurityManagerClass
The SecurityManagerClass parameter is the Security Manager class implementats IFMQSecurityManager.
Valid values:
NO_SECURITY - No Security Manager class is being used.
fiorano.jmx.connector.fmq.security.JSSESecurityManager - The Security Manager class name for Sun_SSL.
Default value:
NO_SECURITY – If the No Security Protocol is used, no the SecurityManagerClass will be used by default. However if a SecurityProtocol is used, say SUN_SSL, then the corresponding SecurityManagerClass, such as fiorano.jmx.connector.fmq.security.JSSESecurityManager must be used.
Dependencies:
SecurityProtocol
QueueConnectionFactory
The QueueConnectionFactory parameter is used by the Connector Server. It can be either LPC enabled or normal. LPC Enabled connectionfactory is used when Connector Server connects to the local server.
Default value:
primaryLQCF - The name of the default QueueConnectionFactory being used.
ServerPort
The ServerPort is the port of the JMS Server to which the ConnectorServer connects.
The ServerPort allows the User to configure the server to run on different ports. When a User has to run two or more servers on the same machine, changing the ServerPort value is mandatory since two servers cannot run from the same port.
Default value:
1856 - The default port number of the JMS server.
ServerAddress
The ServerAddress parameter is the IP of the FioranoMQ Server to which the ConnectorServer connects.
Note: ServerAddress should be localhost/LocalIP/MachineName when the LPC QueueConnectionFactory is being used.
Default Value:
localhost - The default ServerAddress of the JMS Server.
Username
The UserName parameter is the User Name that is used to connect to the JMS Server.
Default Value:
Admin – Default username.
Password
Password is the parameter that serves as the password used to connect to the JMS Server.
ConnectQueueName
The ConnectQueueName parameter is the Connect Queue Name on which the Connector Server listens for connection requests.
Default Value: JMX_CONNECT_QUEUE
RequestQueueName
The RequestQueueName parameter is the Request Queue Name on which the Connector Server listens for jmx queries
Default Value: JMX_SERVICE_QUEUE
NotifQueueName
The NotifQueueName parameter is the Notification Queue Name on which the Connector Server sends notifications.
Default Value: JMX_SERVICE_QUEUE
RMI Based Connector Configuration
Presented below are the details for the parameters present in JMX->Connector->RMIBasedJMXConnector.
RMIServerPort
The RMIServerPort parameter is the port on which the Mx4J RMIConnector Server connects.
This parameter allows the User to configure the RMI port of the Server. When a User runs two or more Servers on the same machine, changing the RMIServerPort value is mandatory as two Servers cannot run on the same RMI port.
Default Value: 1858 - The default RMI port of the Server.
InterceptorClassName
The InterceptClassName parameter is the class Name that is used to intercept all jmx calls
Default Value: fiorano.jmx.connector.FioranoJMXInterceptor - The name of the class used to intercept all jmx calls.
RmiPortExportObjects
Port on which Rmi Registry will export the Mx4J RMIConnector stubs. If set to 0, stubs will be exported at a random port at runtime.
Default Value: 0
Hostname
Specifies host name on which the registry would export objects. The system property 'java.rmi.server.hostname' is set to this value before starting the rmi registry.
Note: It can take comma separated values too.Example:192.168.1.2, 10.0.0.1
Default Value: null
RmiServerSocketFactoryClassName
This parameter denotes the name of server socket factory class to be used by rmi runtime. This class implements ‘java.rmi.server. RMIServerSocketFactory’ interface.
Default Value: fiorano.rmi.serverfac.def.FioranoRMIServerSocketFactory
RmiClientSocketFactoryClassName
This parameter denotes the name of client socket factory class to be used by rmi runtime. This class implements ‘java.rmi.server. RMIClientSocketFactory’ interface.
Default Value: fiorano.rmi.clientfac.def.FioranoRMIClientSocketFactory
JMX Engine Configuration
Presented below are the details for the parameters present in Fiorano->jmx->engine->JMXEngine->ClientJMXEngine.
SecurityProtocol
The SecurityProtocol is the secure protocol used if the Connector Server the Server is connected to is running on a secure protocol. Example: SUN_SSL,NO_SECURITY.
Valid values:
- NO_SECURITY - No Security protocol is used.
- SUN_SSL - Sun_SSL is the security protocol that is used.
Default Value:
NO_SECURITY - No security protocol is used by default.
Protocol
The Protocol parameter is the transport protocol used to connect to the JMS Server. This parameter allows the user to choose between available protocols such as LPC, TCP, and HTTP.
Valid values:
- TCP - TCP is the transport protocol that is used.
- HTTP - HTTP is the transport protocol that is used.
- LPC - LPC is the transport protocol that is used.
Default value:
LPC - LPC is the default protocol used to connect to the JMS Server.
SecurityManagerClass
The SecurityManagerClass parameter is the Security Manager class implements IFMQSecurityManager.
Valid values:
NO_SECURITY - No Security Manager class is being used.
fiorano.jmx.connector.fmq.security.JSSESecurityManager - The Security Manager class name for Sun_SSL.
Default value:
NO_SECURITY – If the No Security Protocol is used, no the SecurityManagerClass will be used by default. However if a SecurityProtocol is used, say SUN_SSL, then the corresponding SecurityManagerClass, such as fiorano.jmx.connector.fmq.security.JSSESecurityManager must be used.
Dependencies:
SecurityProtocol
QueueConnectionFactory
The QueueConnectionFactory parameter is used by the Connector Server. It can be either LPC enabled or normal. LPC Enabled connectionfactory is used when Connector Server connects to the local server.
Default value:
primaryLQCF - The name of the default QueueConnectionFactory being used.
ServerPort
Port of JMS Server to which this ConnectorServer connects.
Allows the user to configure the server to run on different ports (when two or more instances of FioranoMQ Server need to be run on the same box).
Default value:
1856 - This is the default server port.
ServerAddress
The ServerAddress parameter is the IP of the FioranoMQ Server to which the ConnectorServer connects.
Note: ServerAddress should be localhost/LocalIP/MachineName when the LPC QueueConnectionFactory is being used.
Default Value:
localhost - The default ServerAddress of the JMS Server.
Username
The UserName parameter is the User Name that is used to connect to the JMS Server.
Default Value:
Admin – Default username.
Password
Password is the parameter that serves as the password used to connect to the JMS Server.
ConnectQueueName
The ConnectQueueName parameter is the Connect Queue Name on which the Connector Server listens for connection requests.
Default Value: JMX_CONNECT_QUEUE
RequestQueueName
The RequestQueueName parameter is the Request Queue Name on which the Connector Server listens for jmx queries
Default Value: JMX_SERVICE_QUEUE
NotifQueueName
The NotifQueueName parameter is the Notification Queue Name on which the Connector Server sends notifications.
Default Value: JMX_SERVICE_QUEUE