The FmqQueueTest reports general statistics pertaining to the queues on the FioranoMQ server. This page depicts the default parameters that need to be configured for the the FmqQueueTest.

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

• In the HOMEDIR text box, specify the full path to the directory in which the FioranoMQ server has been installed. 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.

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

When changing default configurations of tests, the values with "$" indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to "xyz" and $port will be changed to "80" when configuring a test.

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:

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:

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.