HQCenter: 서버 플릿
여러 서버를 하나의 콘솔에서
HQCenter는 고객 사이트에 있는 하나의 Linux 서버입니다. 고객의 모든 에이전트가 이 서버에 연결합니다. 에이전트는 데이터를 이곳으로 보내고, 설정, 명령, 라이선스, 새 버전을 이곳에서 가져옵니다. 관리자는 HQ Monitor에서 전체 서버를 확인하고 브라우저에서 관리합니다.
- 센터와 통신하기 위한 인바운드 포트 0개
- 에이전트마다 mTLS 인증서
- 데이터가 센터에 도달하기까지 3분
- 설정이 에이전트에 도달하기까지 ~1분
- 롤백 지원 에이전트 및 센터 업데이트
Agent · nginx · goafts · fblogspacker · HQ Monitor
인바운드 포트 없는 연결
에이전트가 모든 연결을 엽니다. HQCenter는 데이터베이스 서버에 절대 연결하지 않습니다. 따라서 센터와 통신하기 위해 Firebird 서버의 포트를 열 필요가 없으며, NAT 뒤에 있는 지사 사무실의 서버도 바로 옆 랙에 있는 서버와 똑같이 동작합니다.
HQCenter의 nginx 뒤에서 세 개의 프로그램이 실행됩니다. goafts는 아카이브를 수신하고, 인증서를 발급하며, 설정, 명령, 라이선스, 새 버전을 저장합니다. fblogspacker는 아카이브를 에이전트 폴더로 분류합니다. HQ Monitor는 이 폴더들을 브라우저에 표시합니다.
| HQCenter 포트 | 연결하는 주체 | 확인 |
|---|---|---|
:443 | 에이전트: 아카이브, 설정, 명령, 라이선스, 새 버전 | TLS 1.3 및 에이전트 인증서, 폐기된 인증서는 거부됨 |
:9443 | 첫 연결 시의 새 에이전트 및 설치 프로그램 | 에이전트 인증서 없음: attach.json의 키를 사용한 인증서 요청, 센터 키 지문, 설치 프로그램 다운로드 |
:8443 | 관리자 및 콘솔: 관리 | 관리자 인증서 및 허용된 주소 목록 |
:8085 | 브라우저: HQ Monitor 콘솔 | 허용된 주소 목록 |
- 하나의 명령으로 연결센터가 파일
attach.json을 제공합니다: 주소, 키 지문, 만료일. 서버에서:fbagent --attach --file attach.json. HQbird 2027 설치 프로그램이 이를 대신 수행합니다. 일반 키를 사용한 요청은 센터 패널에서 관리자가 승인합니다. 라이선스 키는 라이선스에 여유 좌석이 있는 동안 요청 자체를 승인합니다. - 에이전트 이름은 인증서 이름에이전트의 데이터 폴더, 설정, 콘솔 행에 이 이름이 사용됩니다. Windows 설치 프로그램이 서버 이름을 묻습니다. 기본값은 컴퓨터 이름입니다. 인증서는 1년간 유효하며, 폐기된 인증서는 즉시 작동을 멈춥니다.
- 아무것도 손실되지 않음아카이브는 최대 120 MiB입니다. 네트워크 오류 시 3회 재시도합니다. 전송된 아카이브는 삭제되고, 전송되지 않은 아카이브는 절대 삭제되지 않습니다. 각 에이전트는 최대 150초의 자체 오프셋으로 전송하므로, 하나의 센터에 속한 에이전트들이 같은 초에 도착하지 않습니다.
- 센터에서 라이선스 제공에이전트는 약 1분 안에 새 라이선스를 가져옵니다. 설정 폴링에 대한 응답이 라이선스를 알려줍니다. 에이전트는 시작 시와 6시간마다 라이선스도 요청합니다. 네트워크 없이 자체적으로 라이선스를 확인합니다. 라이선스 페이지에 각 서버의 상태가 표시됩니다.
- 콘솔은 데이터베이스를 건드리지 않음HQ Monitor는 에이전트 파일로 페이지를 구성합니다. Firebird에 연결하지 않으며 데이터베이스에 부하를 주지 않습니다.
- 하나의 Linux 서버Ubuntu 또는 AlmaLinux. 하나의 스크립트가 센터를 설치하며, 두 번째 실행은 기존 항목을 업데이트하고 비밀번호와 키를 유지합니다.
IBSurgeon은 요약 정보를 받습니다: 서버 상태, 서버 목록, 백업 및 복원 목록(파일 제외), 이벤트 및 주간 보고서, 클러스터 설명, 라이선스. 로그, 트레이스, 백업 파일, 비밀번호, 감사 로그는 고객에게 남습니다.
설정 편집기 · 지금 실행 · 전달 상태
센터에서의 설정
센터는 각 에이전트의 설정 사본을 보관합니다. 관리자는 에이전트 옆에서와 동일한 편집기에서 작업과 설정을 변경하고 Save and Send to agent를 클릭합니다. 에이전트는 약 1분 안에 변경 사항을 가져옵니다.
에이전트는 새 설정을 작동 중인 설정 위에 덮어쓰지 않습니다. 먼저 후보 설정을 확인합니다. 잘못된 후보는 따로 보관되고, 작동 중인 설정은 유지되며, 콘솔에 거부 이유가 표시됩니다.
서버 페이지의 상태
각 서버에 대해 마지막 변경이 어디까지 진행되었는지 확인할 수 있습니다: 상태 아이콘, 전송 시간(push), 에이전트 응답 시간(ack). 아이콘의 힌트는 에이전트가 거부한 이유와 정확한 시간을 보여줍니다.
1분 안에 어떤 서버가 새 백업 작업을 받아들였고, 어떤 서버가 받아들이지 않았으며, 그 이유가 무엇인지 확인할 수 있습니다.
목록의 서버 수준은 서버 전체에 대한 에이전트의 판정입니다. 아이콘 아래에는 주요 발견 사항이 한 줄로 표시됩니다. 별도의 "Agent" 아이콘은 에이전트 자체의 상태가 서버의 상태보다 나쁠 때만 나타납니다.
30분 넘게 조용한 서버는 회색 "no data since …" 아이콘이 표시되고 목록 맨 끝으로 이동합니다. 목록 위의 요약 줄은 서버를 레벨별로 집계합니다.
에이전트가 서버를 보호합니다
에이전트는 자체 메모리와 CPU를 감시합니다. 에이전트 작업이 너무 많은 리소스를 사용하면 해당 작업을 일시 중지하고 메모리를 점유한 실행을 중단합니다. 백업과 데이터 업로드는 건드리지 않습니다. 그래도 에이전트 메모리가 계속 증가하면 에이전트가 스스로 재시작합니다. 에이전트가 꺼 놓은 작업은 상태 보고서와 편집기에 표시되며, 버튼 하나로 다시 켤 수 있습니다.
센터에서 지금 실행
스케줄을 기다리지 않고 백업, 복원, sweep, gfix 검사 또는 인덱스 재계산을 지금 시작할 수 있습니다. 요청은 같은 경로를 거칩니다. goafts로 들어가면 에이전트가 폴링할 때 가져와서 평소와 같은 검사를 거쳐 큐에 넣습니다.
- 초안콘솔에서 변경 사항을 저장하고 나중에 보냅니다. 상태를 볼 수 있습니다: 전송 안 됨, 전송됨, 적용됨, 대체됨.
- 비밀번호는 센터에서 숨겨집니다콘솔은 새 비밀번호를 에이전트 공개 키로 암호화합니다. 자체 서버의 에이전트만 이를 복호화할 수 있습니다.
- 설정 사본교체할 때마다 에이전트가 사본을 저장합니다: 최근 10개, 최소 14일간. 거부된 후보는 90일간 보관됩니다.
- 서버 전용릴리스 서명 검사, 라이선스, 원격 명령, 프로그램 경로 및 콘솔 로그인은 센터에서 변경할 수 없습니다.
- 데이터베이스 교체는 양측 동의 필요운영 중인 데이터베이스를 교체하는 원격 복원은 서버 자체가 허용하고 사용자에게 별도 권한이 있을 때만 실행됩니다. 시작 전에 데이터베이스 파일 이름을 입력해야 합니다.
- 센터에서 databases.conf파일을 한 에이전트에 보낼 수 있습니다. goafts는 전달만 하며, 에이전트가 파일을 검사하고 기록하며 기존 파일은 옆에 보관합니다.
Signature · rollback point · check
롤백이 있는 업데이트
에이전트는 인터넷이 아니라 HQCenter에서 새 버전을 받습니다. 에이전트는 자체, HQ Monitor, 클러스터 프로그램 및 Firebird를 업데이트합니다. 모든 업데이트는 하나의 절차를 따릅니다: 서명 확인, 롤백 지점 저장, 설치, 작동 확인. 작동하지 않으면 이전 버전으로 되돌립니다.
- 1서명IBSurgeon이 서명한 릴리스
- 2롤백 지점현재 버전의 사본
- 3설치파일 교체
- 4확인새 버전이 "I am working"을 보고하고 45초간 실행
- 5완료새 버전이 작동함
- ↺롤백롤백 지점의 사본 복원
- ✓이전 버전 작동롤백 2회 후 해당 버전 차단
| 업데이트 대상 | 시점 | 보호 |
|---|---|---|
| 에이전트 | 설정 폴링 응답에 새 버전이 보고되면 즉시, 그리고 1시간마다; 그러한 응답이 없으면 180초마다 | 서명, 롤백 지점 2개. 새 버전은 "I am working"을 보고하고 45초간 실행되어야 함. 롤백 2회 후 해당 버전 차단. |
| HQ Monitor | 설정 폴링이 작동하는 동안 1시간마다; 그렇지 않으면 180초마다 | 30초간 콘솔 상태 확인, 이전 버전 사본. |
| 클러스터 프로그램 | 180초마다 확인 | 레플리카 먼저, 그다음 마스터. |
| Firebird | 지정된 시간대에만, 기본 03:30–04:00 | 백업 완료를 기다림. 설치 후 확인, 실패 시 롤백. 롤백된 빌드는 다시 설치되지 않음. |
| HQCenter | 이 센터에 대해 IBSurgeon이 업데이트를 켠 경우 15분마다; IBSurgeon이 설정한 시간대(예: 02:00–05:00)에 | 기본적으로 꺼짐. 센터 소유자는 업데이트를 금지할 수 있음: STACK_UPDATE=off. 스택 서명을 확인한 후 최대 5분간 서비스를 확인. 실패하면 캐시의 이전 스택을 설치. |
- 먼저 테스트, 그다음 전체IBSurgeon은 릴리스를 먼저 테스트 영역에 게시하고, 검사 후 프로덕션 영역에 게시합니다. HQCenter는 해당 영역의 릴리스를 1시간마다 복사합니다.
- 서명을 두 번 확인센터는 다운로드 전에 서명을 확인하고 기록된 바이트에서 다시 확인합니다. 에이전트는 설치 전에 다시 확인합니다.
- 다운그레이드 불가서버 자체가 허용하지 않는 한 현재 버전보다 낮은 버전을 설치할 수 없습니다.
- Linux에서는 root가 파일을 변경합니다에이전트 서비스는 root로 실행되지 않으므로 신뢰할 수 있는 설치 파일을 교체할 수 없습니다.
상태 감시 · 이메일 · 웹훅
문제 알림 이메일과 주간 보고서
HQCenter는 각 에이전트의 상태 스냅샷을 읽습니다. 새로운 문제나 악화된 문제는 이벤트입니다. 이메일이나 웹훅은 센터 자체에서 발송합니다. 매주 한 번 센터가 전체 플릿에 대한 보고서를 작성합니다.
센터는 스스로 아무것도 변경하지 않습니다. 문제가 몇 주 동안 지속되는데 그것이 해당 서버에서 정상이라면, 센터는 새로운 임계값을 제안합니다. 적용은 사람만 할 수 있습니다.
- 1상태 읽기에이전트 파일이 변경된 경우 2분마다
- 2이벤트신규, 악화, 해소, 재발
- 3이메일또는 웹훅, 24시간 이내 반복 없음
- 4주간 보고서기본값은 월요일 07:00
- 5✓ 제안새 임계값, 관리자가 적용
14일간의 전체 플릿
각 서버별로: 문제 없는 시간 비율, 주당 발생 횟수, 그리고 어떤 발견 사항이 "고착"되었는지.
노이즈가 아니라 정상
최소 절반의 시간 동안, 그리고 최소 1주일 연속으로 활성 상태인 경우. 예를 들어 서버 CPU가 항상 임계값 근처에 있는 경우입니다.
실제 데이터 기반 임계값
서버가 보여준 값보다 조금 더: 최댓값보다 4분의 1 높게. 여유 공간처럼 낮은 쪽 임계값은 최솟값보다 5분의 1 낮게. 승인 전에 변경할 수 있으며, 30일간 유효합니다.
- 호스트당 이메일 하나한 호스트에서 여러 에이전트가 실행되는 경우, 호스트 CPU, 메모리 또는 디스크 문제는 한 번만 집계됩니다.
- 해소 또는 숨김이벤트는 문제가 사라진 이유를 알려줍니다: 해결됨, 관리자가 확인함, 또는 정보로 전환됨.
- 승인은 새 설정 버전임계값은 관리자를 대신하여 일반 전달 방식으로 에이전트에 전송됩니다. 각 승인과 거부는 감사 로그에 기록됩니다.
- 이메일 내 링크이메일에는 호스트 이름, 힌트, 그리고 HQ Monitor의 해당 서버로 가는 링크가 포함됩니다.
센터 관리자가 이메일과 웹훅을 켭니다. 설정되기 전까지는 이메일이 발송되지 않습니다. 이벤트와 보고서는 센터 패널과 API에서 확인할 수 있습니다.
사용자 · 권한 · 감사 · 언어
사용자와 권한
각 사용자는 자신의 서버만 볼 수 있습니다. 변경 권한은 하나씩 개별적으로 부여됩니다.
관리자는 모든 서버를 보고 사용자를 관리합니다. 일반 사용자는 자신의 목록에 있는 서버를 봅니다. 새 권한이나 새 목록은 다음 페이지 로드 시 적용되며, 새 비밀번호는 모든 브라우저에서 사용자를 로그아웃시킵니다.
| 권한 | 허용되는 작업 |
|---|---|
| 설정 전송 | 센터를 통해 변경된 설정을 에이전트에 전송합니다. |
| 작업 실행 | 백업, 복원, sweep 또는 인덱스 재계산을 시작하고 취소합니다 (지금 실행). |
| 데이터베이스를 교체하는 작업 | 운영 중인 데이터베이스를 교체하는 복원을 시작합니다. 실행 권한과 함께여야 하며, 에이전트도 이를 허용해야 합니다. |
- 감사 로그각 저장, 전송, 비밀번호 변경, 작업 시작은 사용자 로그인과 함께 기록됩니다. goafts에서는 해시 체인이 로그를 보호합니다.
- 에이전트 요청 로그에이전트 자체가 서버를 변경하는 각 요청과 각 접근 거부에 대해 한 줄을 기록합니다: Local API, 센터로부터의 명령, 지금 실행, 설정 변경, 업데이트. 비밀번호와 요청 본문은 로그에 기록되지 않습니다. 이 파일은 로그와 함께 센터로 전송됩니다.
- HQ Monitor 로그인세션은 7일간 지속됩니다. 한 주소에서 15분 이내에 최대 8회까지 로그인 시도가 가능합니다.
- 센터 관리자 패널별도의 로그인으로, 관리자 인증서가 있어야만 가능합니다. 세션은 8시간 지속됩니다. 15분 이내에 5회 실패하면 15분간 로그인이 차단됩니다.
- 최대 2000명의 사용자각자 자신의 비밀번호와 서버 목록을 가지며, 서버를 할당할 때 서버별로 검색할 수 있습니다.
- 5개 인터페이스 언어영어, 러시아어, 독일어, 포르투갈어(브라질), 스페인어. 통계 보고서도 선택한 언어를 사용합니다.