Agents Administration - Tests
 

Configuration of FmqTopicTest

The FmqTopicTest reports measures pertaining to the durable subscribers on the FioranoMQ server.  

The default parameters associated with this test are as follows:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed. 

  • Specify the IP/hostname of the server being monitored, in the HOST text box.

  • The PORT at which the specified host listens, should be specified in the PORT text box. 

  • In the HOMEDIR text box, specify the full path to the directory in which the FioranoMQ server has been installed.  mso-bidi-language:AR-SA" class="text">For example, the HOMEDIR for a Windows installation of the FioranoMQ server will be of the following format: >C:\PROGRA~1\Fiorano\FIORAN~1.0. The format for a Unix installation will be: /user/egurkha/Fiorano/FioranoMQ7.0.

  • In the SVRBINDIR text box, provide the full path to the bin directory of the FioranoMQ server installation. While the bin directory of the FioranoMQ server 6.0 contains the  ConnectionManager.xml file, the bin directory of the FioranoMQ server 7.0 comprises of the FMQListeners.xml file. These files, which are essential for starting the corresponding servers, also help this test determine the version number of the FioranoMQ server installation being monitored. For example, the SRVBINDIR for a Windows installation of the server will be of the format: C:\PROGRA~1\Fiorano\FIORAN~1.0\bin. The format for Unix installations will be: /user/egurkha/Fiorano/FioranoMQ7.0/bin.

  • The SERVERMODE text box should indicate the mode in which the FioranoMQ server is running. This parameter can take any of the following values:

    • tcp: In this mode, the FioranoMQ server accepts non-secure TCP connections. This is the default value for SERVERMODE parameter.

    • ssljsse: In this mode, the FioranoMQ server accepts secure connections which are serviced using Sun's JSSE implementation.

    • sslphaos: In this mode, the FioranoMQ server accepts secure TCP connections and secure connections using Phaos.

    • http: In this mode, the FioranoMQ server accepts non-secure HTTP connections.

    • httpjsse: In this mode, the FioranoMQ server accepts secure HTTPS connections which are serviced using Sun's JSSE implementation.

    • httpphaos: In this mode, the FioranoMQ server accepts secure HTTPS connections using Phaos.

  • In the ADMINID text box, specify the user name of the FioranoMQ server's administrator. The default is "admin". 

  • The password corresponding to the specified admin user name should be entered in the ADMINPASSWORD text box. 

  • Confirm the password by retyping it in the CONFIRMPASSWORD text box. 

  • ACF stands for Admin Connection Factory object. This object is used to obtain a handle to an Admin connection. To know the value of this configuration parameter, run the administrator tool named runadmin.bat available in the <FMQ_SERVER_INSTALL_DIR>\shell directory (on Windows). On Unix installations of the FioranoMQ server, you need to run the runadmin.sh file that is available in the <FMQ_SERVER_INSTALL_DIR>/scripts directory .  Executing this file will invoke the FioranoMQ server's admin console. In the admin console, select the Admin CFs tab. This tab lists the names of all the available Admin connection Factory objects. Specify the name of one of the listed objects in the ACF text box.

  • TCF stands for Topic Connection Factory object. This object is used to set up a connection with the provider. To know the value of this configuration parameter, run the administrator tool named runadmin.bat available in the <FMQ_SERVER_INSTALL_DIR>\shell directory. On Unix installations of the FioranoMQ server, you need to run the runadmin.sh file that is available in the <FMQ_SERVER_INSTALL_DIR>/scripts directory . Executing this file will invoke the FioranoMQ server's admin console. In the admin console, select the  TCFs tab. This tab lists the names of all the available Topic connection factory objects. Specify the name of one of the listed objects in the TCF text box.

  • In the TRUSTSTORE text box, specify the truststore or keystore database which the JVM uses to verify certificates. For example, this parameter can take the value c:\FioranoMQ\bin\jssecacerts on Windows (on Unix, the path would be expressed as: /user/egurkha/Fiorano/FioranoMQ7.0/bin/jssecacerts), where jssecacerts is the truststore database which the JVM uses.

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.

Note:

FioranoMQ Server 6.0

To know the value of the SERVERMODE parameter for a FioranoMQ server 6.0, do the following:

  1. Open the ConnectionManager.xml file in the <FIORANO_INSTALL_DIR>/bin directory.

  2. In this file, look for the value of the ConnectionFactoryInfo type. For example,  <ConnectionFactoryInfo type="HTTPS_SUN">.

  3. If the ConnectionFactoryInfo type is HTTPS_SUN (as indicated by the example), then the SERVERMODE will be httpjsse.

  4. The SERVERMODES that correspond to the ConnectionFactoryInfo type are:

ConnectionFactoryInfo type

SERVERMODE

HTTPS_SUN

httpjsse

HTTP

http

HTTPS_PHAOS

httpphaos

SUN_SSL

ssljsse

PHAOS_SSL

sslphaos

To know the value of the ACF and TCF parameters of a FioranoMQ server 6.0, do the following:

  1. Open the ConnectionManager.xml file in the <FIORANO_INSTALL_DIR>/bin directory.

  2. In this file, look for an entry that begins in the following manner: ConnectionFactoryName fmq_type='TOPIC'. For example,  <ConnectionFactoryName fmq_type='TOPIC'>primaryTCF</ConnectionFactoryName>

  3. The term primaryTCF in the example above, is the name of the TCF object. Specify the same as the TCF parameter.

  4. Similarly, look for an entry that begins in the following manner in the ConnectionManager.xml file: ConnectionFactoryName fmq_type='ADMIN'. For example, <ConnectionFactoryName fmq_type='ADMIN'>primaryACF</ConnectionFactoryName>.

  5. In the above-mentioned example, the term primaryACF is the name of the ACF object. Specify this name as the ACF parameter.

FioranoMQ Server 7.0

To know the value of the SERVERMODE parameter for a FioranoMQ server 7.0, do the following:

  1. Open the AdminTool.xml file in the <FIORANO_INSTALL_DIR>/bin directory.

  2. In this file, look for the value of the TransportProtocol parameter. For example, <Param Name="TransportProtocol">HTTP</Param>.

  3. In the example mentioned above, the term HTTP refers to the SERVERMODE http. The TransportProtocols corresponding to the server modes are:

Transportprotocol

SERVERMODE

HTTPS_SUN

httpjsse

HTTP

http

HTTPS_PHAOS

httpphaos

SUN_SSL

ssljsse

PHAOS_SSL

sslphaos

 

To know the value of the ACF and TCF parameters of a FioranoMQ server 7.0, do the following:

  1. Open the AdminTool.xml file in the <FIORANO_INSTALL_DIR>/bin directory.

  2. In this file, look for the value of the AdminCF Name. For example, <AdminCF Name="primaryACF"></AdminCF>.

  3. In the example mentioned above, primaryACF is the name of an ACF object on the FioranoMQ server. Specify the same in the ACF text box.

  4. Similarly, look for the value of the TopicCF Name in the AdminTool.xml file. For example, <TopicCF Name =”primaryTCF”></TopicCF>.

  5. Here, primaryTCF is the name of a TCF object on the FioranoMQ server. Specify the same as the TCF parameter.