Skip to main content
Skip table of contents

Server Agents for RDP

Overview

QueryPie enables access control and permission management for Windows Servers. To establish a remote connection via the RDP Protocol, you must install the Server Agent on the Windows Server you wish to manage. Additionally, you can monitor active RDP sessions in real-time and use the Kill Session feature to forcibly terminate any ongoing RDP sessions.

  • The Windows Server Agent supports only Windows Server versions 2012 and later.

  • To ensure RDP communication, the following ports must be allowed between QueryPie and the Windows Server:

    • HTTP Port 13389: Inbound connections must be allowed.

    • TCP Port 13390: Inbound connections must be allowed.

    • Port 443: Access to QueryPie Web must be allowed.

image-20240728-151609.png

Administrator > Servers > Connection Management > Server Agents for RDP

Viewing Server Agents

  1. Navigate to the Administrator > Servers > Connection Management > Server Agents for RDP menu.

  2. Use the search bar in the upper-left corner of the table to search for server names.

  3. Refresh the server list using the refresh button in the upper-right corner of the table.

  4. The table provides the following column information:

    1. Name: The name of the server agent (Computer name of the Windows Server).

    2. Host: The IP of the server.

    3. Linked Server: The server associated with the server agent.

    4. Status: The status of the server agent.

      1. Offline: The server agent is offline or unable to communicate.

      2. Online: The server agent is online, and RDP access is available.

      3. Connection Fail: The server agent responds, but packets cannot be transmitted. Clicking on Connection Fail allows you to manually input an IP address for the target Windows server.

    5. Linked At: The time when the server agent first communicated.

    6. Updated At: The most recent communication time with the server agent.

Creating a Server Agent

  1. Server agents are automatically created in the Server Agents for RDP screen when the server agent installed on a Windows Server communicates with the QueryPie server.

  2. When Server Agents communicate with the QueryPie server, the Windows Server is automatically registered in QueryPie’s Servers.

  3. Refer to the Install and Uninstall Server Agents for instructions on how to install the Server Agent.

The port and IP of an automatically registered Windows Server cannot be changed.

  • In version 10.0.0, Windows Servers cannot be manually registered in QueryPie’s Servers.

  • In version 10.0.0, Windows Servers cannot be synchronized through Cloud Provider integration.

Handling Communication Failures with Server Agents

After installing the Server Agent on a Windows Server, the server agent information may appear in the Server Agents for RDP page, but the status may show as "Connection Failed."

The Host information registered in QueryPie for the Server Agent is automatically selected as the Host with a communicable IP from the IP information held by the Windows Server. However, if communication occurs from the Server Agent to QueryPie, but not from QueryPie to the Server Agent, the Server Agent will be added, but the status will show as "Connection Failed."

To resolve this issue:

image-20240731-024502.png
  1. Navigate to the Administrator > Servers > Connection Management > Server Agents for RDP menu.

  2. Click on the Connection Failed item.

  3. In the popup, enter an IP address that can connect to the Windows Server in the Host field.

  4. Click the Save button.

    image-20240731-024626.png

Deleting a Server Agent

image-20240728-154821.png
  1. Navigate to the Administrator > Servers > Connection Management > Server Agents for RDP menu.

  2. Check the checkbox next to the server you want to delete.

  3. Click the Delete button that appears in the table column line.

  4. When the popup appears, type DELETE and click the Delete button to confirm and proceed with deletion.

In QueryPie, you must first delete the Server Agents installed on the Windows Server before deleting the Server Agents from the Server Agents for RDP menu in QueryPie.

If you do not delete the Server Agents installed on the Windows Server first, the Server Agents will be re-registered in QueryPie, and a new Windows Server will be created.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.