VDI Operations Guide

VDI 운영 가이드

VDI(가상 데스크톱) 에이전트의 일상 운영 방법을 안내합니다. 매일 아침 업무 시작 전 에이전트 상태 확인과 재시작 절차를 다룹니다.

VDI × 4대 운영

매일 오전 재시작 권장

포털 세션 24시간 유지

매일 아침 확인 필수
포털(sp.hi.co.kr) 로그인 세션은 일정 시간 후 만료될 수 있습니다. 업무 시작 전 Admin 대시보드에서 각 VDI 상태가 준비완료인지 확인하세요.

VDI 대수

001 · 002 · 003 · 004

재시작 소요 시간

~40초

대시보드 버튼 기준

포털 자동 로그인

자동

재시작 시 에이전트가 처리

방법 1 — 대시보드 재시작 버튼 (권장)

원클릭 자동 재시작

VDI에 직접 접속하지 않고, Admin 대시보드에서 버튼 한 번으로 재시작합니다. 에이전트가 Edge를 재실행하고 포털에 자동 로그인합니다.

Admin 대시보드 접속

브라우저에서 Admin 패널을 엽니다. https://ks-rpa.nodeplug.com/admin

에이전트 상태 확인

에이전트 현황 섹션에서 각 VDI 상태를 확인합니다.
준비완료 상태이면 정상 — 재시작 불필요합니다.
오프라인 또는 온라인(대기중) 이면 재시작이 필요합니다.

재시작 버튼 클릭

해당 VDI 카드의 재시작 버튼을 클릭합니다.
확인 팝업이 나타나면 확인을 누릅니다.

자동으로 진행되는 과정
① 기존 Edge 브라우저 강제 종료
② Edge를 디버그 모드(1920×1200)로 새로 실행, 포털 주소 열기
③ 에이전트 재시작 후 로그인 페이지 감지
④ 아이디/비밀번호 자동 입력 → 포털 메인 진입
⑤ 상태가 준비완료로 변경 (약 30~40초)

준비완료 확인

약 30~40초 후 대시보드를 새로고침하면 상태가 준비완료로 변경됩니다. 이제 작업 전송이 가능합니다.

작업 중에는 재시작 불가
에이전트가 현재 작업(본인인증 처리)을 수행 중이면 재시작이 거부됩니다. 처리중 상태가 아닐 때 시도하세요.

방법 2 — 수동 재시작 (대시보드 버튼이 동작하지 않을 때)

Kind Sisters VDI 원격 접속 후 직접 재시작

에이전트가 응답하지 않거나 대시보드 버튼이 실패할 때 사용합니다. Admin 패널의 원격 접속 버튼으로 해당 VDI에 직접 접속합니다.

Admin 대시보드에서 원격 접속

해당 VDI 카드의 원격 접속 버튼을 클릭합니다.
새 탭으로 VDI 바탕화면이 표시됩니다.

화면이 검거나 바탕화면이 보이지 않으면 잠시 기다린 뒤 새로고침 해보세요. 세션 유지(Keeper) 서비스가 먼저 연결 중일 수 있습니다.

기존 프로세스 종료

VDI 바탕화면에서 실행 중인 창들을 모두 닫습니다.

종료해야 할 항목

Edge 브라우저	작업 표시줄에서 우클릭 → 모든 창 닫기, 또는 아래 CMD 명령 사용
CMD 창	에이전트가 실행 중인 검은 CMD 창 닫기 (X 버튼)

새 CMD 창 열기

바탕화면 빈 곳 우클릭 → 터미널 열기 또는
Win + R 키를 눌러 실행 창을 열고 cmd 입력 후 Enter.

기존 Edge 프로세스 강제 종료 (필요 시)

Edge가 완전히 닫히지 않았을 경우 CMD에 다음 명령을 입력합니다.

C:\> taskkill /F /IM msedge.exe

RPA 프로젝트 폴더로 이동

CMD에서 프로젝트 폴더로 이동합니다.

C:\> cd C:\RPA\ks_rpa_project

start_vdi.bat 실행

아래 명령을 입력하고 Enter를 누릅니다.

C:\RPA\ks_rpa_project> start_vdi.bat

스크립트가 자동으로 진행합니다:
① Edge 기존 프로세스 종료 → ② 포털 주소로 Edge 재실행 (1920×1200) → ③ 5초 대기 → ④ 에이전트 시작 → ⑤ 로그인 자동 수행 → ⑥ 준비완료

완료 확인

CMD 창에 [INFO] Agent status: READY 로그가 출력되고, Admin 대시보드에서 준비완료로 변경되면 정상입니다.

에이전트 상태 표시 안내

상태	의미	설명	조치
준비완료	작업 대기 중	포털 메인 화면에 로그인된 상태. 작업 전송 가능.	조치 불필요
처리중	작업 수행 중	현재 본인인증 작업을 처리하고 있음. 정상 상태.	작업 완료 대기
온라인	에이전트 실행됨	에이전트는 살아있으나 포털 메인 화면에 아직 없음. 로그인 진행 중일 수 있음.	잠시 대기 후 확인
오프라인	연결 없음	에이전트가 서버에 하트비트를 보내지 못하는 상태. VDI 자체가 꺼져 있거나 에이전트가 미실행.	재시작 필요
정비중	수동 비활성화	관리자가 정비 모드로 전환. 작업이 이 VDI에 배정되지 않음.	정비 완료 후 활성화

자주 발생하는 문제 해결

재시작 버튼을 눌렀는데 상태가 바뀌지 않는다

에이전트가 완전히 응답 불능 상태이거나 이미 오프라인인 경우 발생합니다.

현재 상태 확인

에이전트가 오프라인이면 대시보드 버튼이 VDI까지 명령을 전달할 수 없습니다. 수동 재시작(방법 2)을 사용해야 합니다.

원격 접속으로 VDI 상태 직접 확인

Admin 패널 → 원격 접속 버튼을 눌러 VDI 바탕화면 상태를 확인합니다.

방법 2(수동 재시작) 진행

위 방법 2 절차에 따라 CMD에서 직접 start_vdi.bat를 실행합니다.

start_vdi.bat 실행 후 에이전트가 준비완료가 되지 않는다

자동 로그인 실패, 포털 응답 지연, 네트워크 문제 등이 원인일 수 있습니다.

Edge 브라우저 상태 확인

VDI 화면에서 Edge 브라우저가 열려 있고, 포털(sp.hi.co.kr) 로그인 화면 또는 메인 화면이 표시되어 있는지 확인합니다.

포털에 직접 로그인 후 재시작

Edge 브라우저에서 포털 로그인 화면이 보이면 수동으로 로그인합니다. 로그인 완료 후 CMD 창에서 에이전트가 READY 상태로 전환되는지 확인합니다. 또는 start_vdi.bat을 다시 실행합니다.

CMD 로그 확인

에이전트가 실행 중인 CMD 창에 출력되는 로그를 확인합니다. 오류 메시지가 있으면 담당자에게 전달합니다.

원격 접속이 연결되지 않는다

세션 유지 서비스가 VDI에 먼저 연결된 상태여야 원격 접속이 가능합니다.

세션 유지 상태 확인

Admin 패널 → 세션 유지 관리 섹션에서 해당 VDI Keeper 상태를 확인합니다. stopped 또는 failed이면 시작 버튼을 눌러 재시작합니다.

VDI 전원 상태 확인

Proxmox 관리 패널에서 해당 VDI 가상머신이 실행 중인지 확인합니다. 꺼져 있으면 시작(Start) 버튼을 눌러 부팅합니다.

정비 모드 — 특정 VDI 임시 비활성화

특정 VDI를 잠시 작업에서 제외하고 싶을 때

에이전트를 종료하지 않고 작업 배정만 차단합니다. 재시작 중이거나 점검 중에 사용합니다.

정비 모드 켜기

해당 VDI 카드의 토글 스위치를 클릭합니다.
녹색(운영) → 회색(정비중)으로 변경됩니다.
확인 팝업에서 예를 누르면 즉시 작업 배정에서 제외됩니다.

정비 모드에서는 에이전트가 계속 실행 중이며, 세션 유지(Keeper)도 정상 동작합니다. 새 작업만 배정되지 않습니다.

정비 완료 후 복귀

같은 토글 스위치를 다시 클릭하면 운영 모드로 복귀합니다. 이후 새 작업이 이 VDI에도 배정됩니다.