10.2.13-cc2a93b Server Agent Deployment Guide

1 Overview
2 Server Agent 버전 업데이트 사항
- 2.1 10.2.13-cc2a93b
  - 2.1.1 AS-IS (10.2.13-2201e85)
  - 2.1.2 TO-BE (10.2.13-cc2a93b)
- 2.2 10.2.13-2201e85
- 2.3 10.2.10
3 CONFIG / Windows Installer 변경 사항
- 3.1 CONFIG: 10.2.13
- 3.2 CONFIG: 10.2.10
- 3.3 Windows Installer: 10.2.13
- 3.4 Windows Installer: 10.2.10
4 Known Issue
5 10.2.13-cc2a93b 설치 시 유의사항

Overview

이번 Server Agent 업데이트(10.2.13-cc2a93b)는 Windows Server 환경에서 AMI 이미지 기반으로 배포되는 서버 간의 고유 식별 문제를 해결하기 위한 개선 사항을 포함합니다.

기존에는 Server Agent가 Machine ID를 통해 서버를 식별했으나, AMI 배포 환경에서는 이 ID가 중복되어 여러 인스턴스가 하나로 인식되는 문제가 있었습니다. 이번 버전에서는 Machine ID 생성 시 MAC Address 정보를 포함함으로써, 동일한 이미지에서 생성된 인스턴스라도 고유하게 구분되도록 개선되었습니다.

이 업데이트는 특히 AMI 기반의 CI/CD 환경에서 배포되는 Windows Server 내 설치되는 QueryPie Server Agent를 안정적으로 운영하려는 사용자를 위한 중요한 개선입니다.

Server Agent 버전 업데이트 사항

10.2.13-cc2a93b

기존 Server Agent는 QueryPie 로 서버를 구분하는 고유값으로 Machine ID 를 전달합니다.
이 Machine ID 는 윈도우 내부 고유값들을 조합 후, SHA256 으로 해싱한 값 입니다.
이 Machine ID 조합에, Network Interface 의 MAC Address 정보를 추가합니다.
이를 활용하여 (AWS 기준으로) Windows Instance 를 Disk 포함하여 AMI 로 생성 후, CI/CD 로 배포하는 케이스에서 발생하는 Server Agent 가 중첩 되는 문제를 해결합니다.

AS-IS (10.2.13-2201e85)

EC2AMAZ-4SO3B0J 라는 Windows Server Instance 3대를 배포 후 Server Agent 를 설치하였을 때, QueryPie RDP Server Agent 에서는 하나의 Instance로 인식하였습니다.

TO-BE (10.2.13-cc2a93b)

기존에 설치한 Server Agent 들을 삭제 후, 새로운 Server Agent 를 배포 시 새로운 Windows Server Instance 3대가 확인됩니다.
기존 Server Agent 는 Offline 처리되며 Delete 로 삭제가 가능힙니다.

10.2.13-2201e85

사용자가 Windows App을 수행하더라도 RDP 클라이언트 종료 (logoff) 하지 않습니다. 이에 접속한 사용자의 세션으로 실행한 모든 사용자 세션 프로그램이 다음 접속 시에도 종료되지 않고 그대로 유지됩니다.
설치 시 HTTP proxy를 사용하지 않도록 강제하는 옵션을 전달할 수 있게 합니다. 이 경우를 활성화하는 방법은 CONFIG 파일 내 use_http_proxy 로 변경 후 설치 또는 Windows Installer 프로그램 내 Custom Mode 단계에서, Use HTTP Proxy 설정을 default 가 아닌 false 로 변경 후 설치 수행하면 됩니다.

10.2.10

사용자가 Windows App 사용 종료 시, RDP 클라이언트 종료 (logoff) 됩니다. 이에 접속한 사용자의 세션으로 실행한 모든 사용자 세션 프로그램이 종료됩니다.
일부 윈도우 서버는 HTTP proxy가 설정되어 있는데, 이것이 제대로 동작하지 않아 웹브라우저에서는 쿼리파이 접근 가능함에도 서버에이전트는 쿼리파이에 접근 불가능한 경우가 있습니다.

해당 서버 에이전트는 수동 배포만 가능합니다. 아래의 경우로는 설치할 수 없습니다.

PowerShell 을 이용한 기존에 설치된 패키지 덮어쓰기
QueryPie URL Download (기존 에이전트가 다운로드 됨)

CONFIG / Windows Installer 변경 사항

CONFIG: 10.2.13

[server]
web_url=http://SERVER_URL
agent_port=13389
use_http_proxy=default

CONFIG: 10.2.10

[server]
web_url=http://SERVER_URL
agent_port=13389

Windows Installer: 10.2.13

Windows Installer: 10.2.10

Known Issue

일반적인 설치 / 사용 상황에서는 발생하지 않을 사소한 Known Issue 가 하나 있습니다.

QueryPie 를 경유하지 않고 신규 에이전트 설치 →

→ User Agent 로 접근해서 접속해서 신규 에이전트 삭제

→ 다시 QueryPie 를 경유하지 않고 신규 에이전트 설치

→ User Agent 로 접근

을 반복하는 경우 Audit → Session Monitoring 에 기존 에이전트 삭제 시점의 세션이 유지되는 것 처럼 보입니다.

해당 세션 데이터는 가비지 데이터로, 웹 콘솔에서 직접 삭제 또는 사용자 User Agent 를 Logout → Login 수행하면 제거가 됩니다.

10.2.13-cc2a93b 설치 시 유의사항

Server Agent 는 각 Windows Server 내 수동 설치가 필요합니다.
AMI 배포로 서버 고유값이 중첩되는 Windows Server 를 대상으로 우선 배포합니다.
이외 단일로 운영하는 서버들은 Server Agent 재 설치 없이 당분간은 사용이 가능하나, 추후 QueryPie 업그레이드 시 Server Agent 도 변경 설치가 필요합니다. 이 때, 기존 서버들의 고유값 또한 신규 Server Agent에 맞춰 변경이 됩니다.
이 경우, 기존 RDP Server Agent 들이 Offline 으로 되며, 새로운 RDP Server Agent 리스트들이 Online 으로 등록됩니다. Offline 으로 된 Server Agent들을 unlink/delete 하고, Online 으로 활성화된 Server Agent에 다시 맵핑해 주시면 됩니다.