Gauge Agent

The InfinityQS Gauge Agent is a service that runs on the workstation or server and manages communication between the locally connected gauges and the cloud-based Enact software.

Troubleshooting Gauge Agent

The InfinityQS technical experts have provided a troubleshooting guide for Gauge Agent, which will walk you through all the steps to ensure your Gauge Agent is configured and running correctly. To troubleshoot your installation of Gauge Agent, please follow the steps included in the Gauge Agent Troubleshooting Guide.

Consider the following:

  • Prior to installing Gauge Agent on the workstation or server, you must ensure you have an Administrator account, that you have opened specific ports, and that you configured your firewall to make the gauge connection and gauge data transmission accessible. InfinityQS strongly recommends that you contact your IT department prior for this procedure, as installation requires proper permissions.

    • Operating system. Microsoft Windows 10 or higher
    • Memory. 512 MB of RAM (minimum)
    • Hard disk space. 100 MB of available hard disk space

    • Firewall. Allow outbound rule: 443 (HTTPS)

      • Protocol = TCP, Destination = ANY

        If you need to lock down your network to external connections, you must whitelist the following:

        • Enact Web App, Gauge, CDN (Enact Fonts), Storage Accounts (Enact Images): *.InfinityQS.com through Port 443
        • ADC (DCS, EIS) Connections to Enact: us1enactexternaleventhubnamespace.servicebus.windows.net through Port 443

    • Network Connection. The connection between Gauge Agent (the application) and Gauge Server (the InfinityQS web server that processes gauge data) occurs through TCP, which is a protocol that includes both the HTTPS and WSS (WebSocket Secure) protocols.

      Bi-directional data transmission is done through the WSS protocol. This is established with an initial handshake (request/response) via HTTPS, during which a request is made to upgrade to WSS.

      All of the traffic from Gauge Agent is made through the following connections:

      • https://us1enactweb.infinityqs.com: Gauge Agent download, authentication, and auto-update
      • https://us1enactgs.infinityqs.com: Initial HTTPS connection to request a WSS connection
      • wss://us1enactgs.infinityqs.com: WSS data transfer between Gauge Agent and Gauge Server; data transfer between Gauge Server and client browser

    • Data Communications Encryption. Transport Layer Security (TLS) 1.2 is enforced.

      For more information, see Enact Security Enhancement Notification.

    Verify that you have an administrator account on the workstation or server.

  • When installing Gauge Agent, you must log into Enact and download the Gauge Agent installer. To successfully install, you must run the Gauge Agent installer using an administrator account.

    1. You must download the Gauge Agent installer executable. To download the Gauge Agent installer executable, please see Downloading Gauge Agent.

    2. You must run the Gauge Agent installer executable using an administrator account on the workstation or server. To run the Gauge Agent installer executable, please see Installing Gauge Agent.

      During installation, you must type a meaningful Gauge Agent name in the Agent Configuration dialog box.

    If the installation fails, please see the Gauge Agent error logs for more information about installation issues. Typically, you can locate the InfinityQS Messaging Service program at C:\Program Files (x86)\GaugeAgent\InfinityQS.Enact.AgentService\Logs.

  • Gauge Agent allows the gauges to connect with the workstation and Enact. You do not need an administrator account to run Gauge Agent. If you reconnect a gauge device, Gauge Agent will attempt to automatically restore that device without requiring you to restart the service.

  • You must assign the Gauge Agent to a Gauge Device and Gauge Interface Connection. You do not need an administrator account to configure Gauge Agent. However, if you are configuring Gauge Agent under a non-administrator account, you must ensure that account has privileges to configure or edit Gauge Agent in Enact.

    To configure Gauge Agent, do the following:

    1. Create the gauge interface. To create the gauge interface, please see Creating Gauge Interfaces.
    2. Create the gauge format. To create the gauge format, please see Creating Gauge Formats.
    3. Create the gauge device. To create the gauge device, please see Creating Gauge Devices.