Troubleshooting Messaging Service

Providing application-to-application (A2A) communication, the InfinityQS Messaging Service facilitates operations between applications on a single computer, which enables the following:

• Communication between the DMS Browser and the DMS Windows Service
• Communication between Data Collection Service (DCS) and DMS.
• Integration between the DMS Software Development Toolkit and DMS.

As a core service, the InfinityQS Messaging Service is critical to the success of several InfinityQS software applications. Occasionally, issues can come up that affect the Messaging Service's normal operation, and this section addresses those issues.

Messaging Diagram

• Why won't the Messaging Service start in a Virtual Environment?

  Verify that your virtual network environment is configured as Bridged instead of NAT (Network Address Translation).

  • Bridged Interface. The virtual machine uses the underlying hardware and network setup without repackaging requirements.
  • NAT Interface. The virtual machine intercepts all network traffic and spoofs critical information, which can slow or block Messaging Service data.
• Why am I still having problems in my Bridged Virtual Environment?

  Because of recent Windows security enhancements that specifically target network traffic, your virtual environment may not be fully trusted by the underlying operating system.

  By configuring the Messaging Service in the virtual environment to run as credentialed user on the underlying system, you can address these security issues.

  1. In the InfinityQS Service Properties panel, click the Log On tab.

  2. Under Log on as, click the This account radio button and then do the following:

     • This account: Type the name of a user (including domain) with network access to the underlying operating system. For example, type localadmin@Domain or type Domain\localadmin.
     • Password: Type the password for the above user.

     • Confirm Password: Retype the password for the above user.

       InfinityQS recommends that you create a services user account, and that you set that account to Password never expires.

  3. Click the OK button, and then restart the Messaging Service.

  For more information about configuring InfinityQS services, please see the Service Accounts reference sheet.

• Why is the Messaging Service consuming CPU time or slowing down?

  By design, the Messaging Service forwards data from one source to one or more destinations, which typically does not require considerable resources. If you note that CPU time or memory consumption is climbing, this usually indicates that another application (for example, DMS) is placing large amounts of data on the Messaging Service.

  To see if an InfinityQS application is using large amounts of CPU time, do the following:

  1. On the ProFicient computer, click Start | Run.
  2. In the Run dialog box, type taskmgr, and then click the OK button.
  3. In the Windows Task Manager, click the Processes tab.
  4. Under Image Name, locate the InfinityQS processes, and examine the CPU and Mem Usage columns for climbing CPU time or memory consumption, and troubleshoot that application.
  5. If the InfinityQS processes are not exhibiting climbing CPU time or memory consumption, shut down each InfinityQS application until the consumption stops, and then troubleshoot that application.
• Why aren't Messaging Service clients seeing data published from servers?

  Unfortunately, there could be a few reasons for this issue. To ensure that the Messaging Service clients are seeing published data, do the following:

  Restarting Messaging Service

  1. On the DMS computer, click Start | Settings | Control Panel, open Administrative Tools, and then open Services.
  2. In the Services panel, locate and right click InfinityQS Message Service, and then click Restart.
  3. Click the OK button.

  Verifying Firewall Rules

  For the Messaging Service to run correctly, you must apply the following firewall rules. Usually, these rules are automatically added during installation.

  1. On the DMS computer, click Start | Settings | Control Panel, open Security Center, and then open Windows Firewall.

  2. Under the Exceptions tab, click the Add Port button, and then do the following:

     1. In the Name data field, type the name for the InfinityQS Messaging port. Ensure the name is unique and descriptive.
     2. In the Port number data field, type the DMS port number.
     3. Click the TCP radio button, click the Change scope button, click the My network (subnet) only radio button, which restricts port access and data retrieval to those on your trusted network, and then click the OK button.

  Verifying Application Rules

  1. Under the Exceptions tab, click the Add Program button, and then do the following:

     1. In the Add a Program dialog box, click the Browse button, browse to and click the InfinityQS Messaging Service program (InfinityQS.ServiceProcess.Messaging.exe), and then click the Open button.

        Typically, you can locate the InfinityQS Messaging Service program at C:\Program Files (x86)\InfinityQS International\ProFicient\Applications.

     2. In the Change Scope dialog box, click the My network (subnet) only radio button, which restricts application access to those on your trusted network, and then click the OK button.
  2. Click the OK button, and then click the OK button.