2 min read

CQE 레포지토리 스크립트 관리 가이드

CQE(Custom Query Engine) 레포지토리에서 스크립트를 관리하고, 여러 서버에 등록하며, 실행 상태를 모니터링하는 방법을 안내합니다.

🤖 CQE 레포지토리 목록 페이지로 이동 →

📋 개요

CQE Repo List는 유지보수 및 진단용 스크립트를 중앙에서 관리하는 저장소입니다. 한 번 저장된 스크립트는 여러 논리 서버(LSVR)에 서로 다른 실행 파라미터로 배포하여 실행할 수 있습니다.

목록에서 스크립트를 클릭하면 상세 모달이 열리며, 다음 기능을 수행할 수 있습니다.

스크립트의 소스 코드를 전체 화면으로 확인합니다. (목록에서는 읽기 전용이며, 수정이 필요한 경우 편집 기능을 이용하세요.)

서버에 스크립트를 등록하기 전에 실행 방식을 설정할 수 있습니다.

현재 프로젝트의 서버 중 원하는 서버를 선택하여 스크립트를 배포할 수 있습니다.

모달 하단의 스크립트 등록 현황 테이블에서 현재 이 스크립트를 사용 중인 모든 서버 목록을 실시간으로 확인할 수 있습니다.

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 시스템 관리 API 레퍼런스

증상	원인	해결
큐 등록 후에도 스크립트가 실행되지 않음	실행 설정에서 활성(Active) 이 꺼져 있음	상세 모달에서 Active를 켠 뒤 다시 큐에 등록합니다.
LSVR 선택기에 대상 서버가 보이지 않음	현재 선택된 프로젝트에 서버가 없거나 서버가 다른 프로젝트에 속함	상단에서 올바른 프로젝트를 선택했는지 확인합니다.
반복 실행이 동작하지 않음	반복(Repeat) 은 켰지만 실행 간격(분) 이 비어 있음	실행 간격을 1 이상으로 설정한 뒤 다시 등록합니다.
등록 현황의 마지막 실행 이 갱신되지 않음	대상 서버의 에이전트가 아직 큐를 수신하지 못함	에이전트 연결 상태와 시작 일시가 과거 시각인지 확인합니다.

위 UI 동작은 다음 CQE API 버브(byAK/bySk 디스패처)에 대응합니다. 요청은 text(버브+파라미터 이름), jsondata(값), token을 보냅니다.

CQERepoPut msName msDetail msBody msPer msPrice msType — 스크립트를 repo에 등록. msType은 ps1 / cmd / wsf 중 하나.
CQEQueuePut mssn lssngroup csn interval active script_type custom_values repeat startdate auid — 서버에 스크립트 할당.
- lssngroup: 콤마 구분 LSSN 목록(서버마다 1건 할당).
- interval: 분. repeat: 0/1 = 일회성, 2 = 재귀(interval마다 반복).
- custom_values: 서버별 주입값 → 스크립트 본문의 {{CustomVariables}}로 치환.
CQEQueueGet lssn hostname os op — 에이전트가 폴링해 다음 스크립트 본문을 수신.

스크립트 본문 치환자: {{CustomVariables}}(할당별 custom_values, 서버측 주입), {{sk}}(에이전트 토큰), {{lssn}}(에이전트 LSSN).

실행 제한: 에이전트는 각 스크립트를 임시 파일로 60초 제한 실행하며, ps1은 Windows PowerShell 5.1로 실행됩니다. 스크립트는 짧게 유지하세요.

전체 사양: giipdb docs/30_Specs/CQE_SPECIFICATION.md.

버전: 1.2 최종 업데이트: 2026-07-23 소스 파일: giipv3/public/help/cqerepolist.ko.md