이 페이지는 기계 번역되었습니다. 영어 원본을 읽어보세요. English

클러스터 및 복제 HQbird Cluster

마스터는 변경 사항을 세그먼트에 기록하고 보안 채널을 통해 복제본으로 전송합니다. 노드는 nbackup을 통해 새 복제본용 데이터베이스 복사본을 직접 만들며, 그동안 사용자는 계속 작업할 수 있습니다. 클러스터 관리자(RCM)는 모든 노드의 지연, 대기열, 오류를 보여줍니다. 또한 마스터를 다른 호스트로 이동시킵니다. 데이터 손실 없이 계획된 이동으로, 또는 마스터 호스트가 손실되었을 때 긴급 이동으로 수행합니다.

  • Firebird 2.5 · 3 · 4 · 5
  • nbackup 마스터를 중지하지 않고 복사
  • switchover 데이터 손실 없이
  • failover 수동 또는 규칙에 따라
  • router 연결 문자열이 변경되지 않음
  • mTLS 모든 채널에 적용

노드 · RCM · 레이아웃

클러스터 작동 방식

각 Firebird 옆에서 노드가 실행됩니다. 노드는 마스터 또는 복제본 중 하나의 역할을 가집니다. 마스터 노드는 세그먼트를 전송하고, 복제본 노드는 이를 수신하며, 복제본의 Firebird가 이를 데이터베이스 복사본에 적용합니다.

클러스터당 하나의 RCM이 있습니다. 모든 노드에 접근할 수 있는 호스트에서 실행됩니다. 노드는 RCM에 통계를 보내고, RCM은 운영자 명령을 노드로 전달합니다. RCM은 노드 이름이 아닌 데이터베이스 GUID로 마스터와 복제본을 연결합니다.

RCM은 자체적으로 설치되지 않습니다. 클러스터가 필요할 때 한 호스트에서 활성화합니다. 애플리케이션 앞에 라우터를 배치할 수 있으며, 라우터는 항상 현재 마스터로 연결합니다.

클러스터 다이어그램: 마스터 노드가 복제본 노드로 세그먼트를 전송하고, RCM이 모든 노드를 감시함
구성 요소수량기능
Firebird (HQbird)각 데이터베이스 서버에데이터베이스를 저장하고 복제 세그먼트를 기록합니다.
fbagentFirebird 인스턴스당 하나노드가 요청할 때 Firebird를 중지하고 시작합니다.
hqclusternode인스턴스 및 역할당 하나복제를 설정하고, 세그먼트를 전송하며, 복제본용 데이터베이스 복사본을 만듭니다.
hqbirdrcm (RCM)클러스터당 하나웹 인터페이스, 명령, 경고, 통계. 스위치오버와 페일오버를 실행합니다.
라우터 (hqclusternode router)선택 사항, 애플리케이션 호스트(Linux)에HAProxy가 각 서비스의 마스터를 가리키도록 유지합니다. 애플리케이션은 라우터에 연결합니다.
  • 동일한 주 버전마스터에 5.0, 복제본에 5.0. 그렇지 않으면 복제본이 데이터 전송 전에 거부합니다.
  • HQbird 2.5 및 3.0replconf 플러그인을 통한 복제. 필터가 테이블 집합을 정의합니다.
  • 각 마스터에 자체 폴더복제본은 마스터 노드 이름을 딴 폴더에 데이터베이스를 저장합니다. 서로 다른 마스터의 동일한 이름 데이터베이스는 충돌하지 않습니다.
  • fbagent 없으면 변경 없음fbagent를 사용할 수 없으면 노드는 구성을 변경하는 모든 작업을 거부합니다. "부분적으로" 작동하지 않습니다.
  • RCM 없는 노드노드는 독립적으로 작동할 수 있습니다. RCM은 개요와 명령에 필요합니다.
  • 채널 압축느린 네트워크용: 피어별 zstd, 즉시 적용됩니다.
  • HQCenter 없이 최대 3개 호스트마스터 또는 복제본이 있는 각 호스트는 클러스터에서 한 자리를 차지합니다. RCM은 네 번째 호스트를 허용하지 않습니다.

RCM · 페어링 윈도우 · 호스트 연결 · 슬롯

클러스터 구축 방법

HQbird 설정은 각 서버에 클러스터 프로그램을 설치하지만 활성화하지는 않습니다. RCM과 페어링 윈도우는 기본적으로 꺼져 있습니다. 클러스터는 세 단계로 구축합니다: 한 호스트에서 RCM을 켜고, 다른 호스트에서 페어링 윈도우를 열고, 버튼 하나로 호스트를 연결합니다.

  1. 1RCM 켜기한 호스트에서: HQ Monitor 또는 fbagent --cluster-init 사용
  2. 2페어링 윈도우 열기다른 호스트에서 24시간 동안
  3. 3호스트 연결RCM이 에이전트를 찾고, 인증서를 발급하고, 노드를 시작합니다

1단계. 한 호스트에서 RCM

HQ Monitor에서 "이 서버의 클러스터" 섹션을 열고 RCM을 켭니다. 호스트에서 명령을 실행해도 동일하게 동작합니다. 에이전트가 클러스터 CA, RCM 인증서, 첫 번째 사용자를 생성합니다. 방화벽에서 포트 7443과 7444가 열립니다.

fbagent --cluster-init <id>

설치 중에는 스위치 --rcm on(Linux) 또는 /RCM(Windows)이 동일하게 동작합니다.

2단계. 페어링 윈도우

클러스터에 참여할 각 호스트에서 에이전트가 24시간 동안 페어링 포트를 엽니다. 윈도우가 끝나거나 에이전트가 클러스터에 참여하면 포트는 스스로 닫힙니다.

fbagent --cluster-pairing on

HQ Monitor의 버튼도 동일하게 동작합니다. 설치 중에는 --cluster-pairing on 또는 /DISCOVERY를 사용합니다.

3단계. 호스트 연결

RCM에서 Settings → Link hosts를 열고 호스트를 한 줄에 하나씩 입력합니다. Check hosts 버튼은 각 호스트의 포트 7450–7459를 읽습니다. 응답한 각 에이전트가 표의 한 행이 됩니다.

  • 행에는 포트, 인스턴스, Firebird 버전과 포트, 노드 포트, 인증서 지문이 표시됩니다.
  • 체크 박스로 행을 선택하고 마스터를 고릅니다. 오류가 있는 행이 다른 행을 막지 않습니다.
  • Link는 각 에이전트에 인증서를 발급하고, 멤버와 마스터 → 레플리카 링크를 생성합니다.
  • RCM은 에이전트 인증서를 최대 10분, 노드 시작을 최대 20분 기다립니다.
hqbirdrcm cluster link -hosts db1,db2,db3 -master db1

행의 지문을 에이전트가 해당 호스트에서 보여준 지문과 비교하십시오. 이렇게 하면 올바른 서버를 연결했는지 알 수 있습니다.

  • 한 호스트의 여러 에이전트각 에이전트는 0부터 9까지의 자체 슬롯을 가집니다. 페어링 포트 7450 + 슬롯, 노드 포트 7051 + 슬롯 및 7061 + 슬롯입니다. 설치 시 슬롯을 선택하며, 스위치 --pairing-port로 명시적으로 설정할 수 있습니다.
  • 멤버 추가Cluster 페이지는 사용 가능한 노드 포트를 제안하고, 이 호스트의 다른 멤버가 사용 중인 포트는 거부합니다.
  • 멤버 이름<host name>-master 및 <host name>-replica. RCM은 멤버 이름을 변경하지 않습니다. 새 이름은 새 멤버입니다.
  • 페어링 윈도우 없이RCM은 한 에이전트에 대해 24시간 동안 유효한 토큰을 발급합니다. 새 호스트에서 이 토큰과 CA 해시를 사용하여 fbagent --cluster-join을 실행합니다.
  • RCM 소유자호스트에서 RCM을 켠 에이전트입니다. 이 호스트의 두 번째 에이전트는 거부됩니다. 소유자가 제거되면 fbagent --cluster-init --rcm-takeover가 RCM을 다른 에이전트로 옮깁니다. 클러스터는 새 CA를 받게 되며, 멤버를 다시 연결해야 합니다.
  • 클러스터 탈퇴fbagent --cluster-leave는 노드를 중지하고 포트를 닫으며 클러스터 인증서를 삭제합니다. 노드 폴더는 남아 있으며, --remove-data로 삭제할 수 있습니다. RCM이 에이전트를 폐기하거나 마지막 멤버를 제거하면 에이전트는 스스로 탈퇴합니다.
  • 방화벽에이전트는 클러스터 포트를 스스로 열고 닫습니다. 에이전트 이전에 열려 있던 포트는 닫지 않습니다.
  • HQbird 제거다른 에이전트가 RCM 소유자의 RCM을 사용하는 동안에는 RCM 소유자가 제거되지 않습니다. 설치 마법사가 확인을 요청하며, 자동 모드에서는 --force 또는 /FORCE가 필요합니다.

로컬 HQ Monitor의 Clusters 페이지는 RCM 호스트의 에이전트를 통해 동작합니다. RCM 비밀번호는 필요하지 않습니다. 관리자만 "이 서버의 클러스터" 섹션을 볼 수 있습니다.

초기화 · reinit

마스터를 중지하지 않고 새 레플리카 만들기

레플리카는 마스터에서만 데이터베이스를 받습니다. 마스터 노드는 nbackup -L로 파일을 고정하고, 파일을 나누어 전송한 뒤 즉시 잠금을 해제합니다. 마스터 사용자는 그동안 계속 작업할 수 있으며, 변경 사항은 .delta로 전달되었다가 나중에 데이터베이스로 돌아갑니다.

gbak과 수동 파일 복사는 여기서 동작하지 않습니다. gbak은 데이터베이스 GUID를 변경하여 마스터–레플리카 링크를 끊습니다. 실행 중인 데이터베이스의 파일 복사는 일관성이 없습니다.

    마스터 사용자

    작업 중

    파일

    • 연결 끊김전송은 마지막으로 받은 부분부터 계속됩니다. 완료되지 않은 복사본은 레플리카에 24시간 동안 남습니다.
    • 오류노드는 잠금을 해제하고, 완료되지 않은 파일을 삭제하며, 데이터베이스를 FAILED로 설정합니다. 다음 시도는 알려진 상태에서 시작됩니다.
    • 잠금 중 트랜잭션손실되지 않습니다. Firebird 4 및 5: 노드는 nbackup -L 시점에 열려 있던 트랜잭션을 찾고, 레플리카는 세그먼트에서 해당 트랜잭션을 재실행합니다. HQbird 2.5 및 3.0: 노드는 해당 트랜잭션이 끝날 때까지(약 1분) 기다리며, 그렇지 않으면 복사가 시작되지 않습니다.
    • 한 번에 하나의 데이터베이스기본적으로 마스터 노드는 하나의 데이터베이스를 복사합니다. 나머지는 대기열에서 기다립니다.
    • 이 데이터베이스의 다른 레플리카복사가 실행되는 동안에는 이 데이터베이스의 세그먼트를 받지 않습니다. 나중에 따라잡습니다.
    • 자동 재초기화RCM은 NEEDS_REINIT 상태의 데이터베이스를 설정된 윈도우 내에서만 스스로 다시 복사할 수 있습니다. 기본값은 꺼짐입니다.

    완만한 모드는 긴 트랜잭션을 기다립니다

    잠금 전에 노드는 마스터 아카이브의 가장 오래된 세그먼트보다 먼저 시작된 쓰기 트랜잭션을 찾습니다. 아카이브가 비어 있으면(첫 복사) 노드가 게시를 켠 시점이 기준이 됩니다. 레플리카는 그러한 트랜잭션을 재실행할 수 없어 중지됩니다. 따라서 그러한 트랜잭션이 열려 있는 동안에는 복사가 시작되지 않습니다.

    RCM은 가장 오래된 트랜잭션을 가진 다섯 개의 연결(사용자, 클라이언트, 경과 시간, 현재 쿼리)을 표시합니다. 해당 연결을 끊고 즉시 복사를 다시 시도할 수 있습니다. 복사가 대기하는 동안 마스터의 아카이브는 정리되지 않지만, 최대 1000개 세그먼트까지만 그렇습니다. 그 후 정리가 계속되고 RCM이 경고를 발생시킵니다.

    일반 모드는 확인 없이 즉시 데이터베이스를 잠급니다.

    복사 시작. 모드(완만한 모드 또는 일반 모드), 체크 표시가 있는 레플리카 폴더, 레플리카의 Firebird 중지 허용.

    공간과 속도

    위치필요한 것
    마스터, 데이터베이스 볼륨데이터베이스 크기의 최소 105 %가 비어 있어야 합니다. 복사 중에 .delta가 증가합니다.
    레플리카, 데이터베이스 볼륨105 %에 볼륨 예약분 free_space_floor_gb(기본값 1 GB)를 더한 값입니다. 노드가 전체 크기를 미리 예약하므로 두 번째 복사본이 필요하지 않습니다. 반복 복사 시에는 이전 파일이 끝까지 남습니다. 두 파일 모두를 위한 공간이 없으면 “이전 레플리카 제거” 확인란이 전송 전에 이전 파일을 삭제합니다.
    야간 속도전송 시간대(기본값 23:00–05:00)에는 일정하며, 기본값은 100 MB/s입니다.
    주간 속도측정된 디스크 속도의 일부이며, 기본값은 절반입니다. 주간에 시작된 복사는 야간에 자동으로 빨라집니다.

    공간은 두 번 확인되며, 잠금 전에만 확인됩니다. 먼저 RCM이 통계를 기준으로 확인하고, 그다음 노드가 양쪽에서 실시간 측정으로 확인합니다. 노드 확인은 건너뛸 수 없습니다. 복사 도중 디스크가 가득 차는 것을 막아 주기 때문입니다.

    Firebird 4 및 5 · HQbird 2.5 및 3.0

    퍼블리케이션: 어떤 테이블이 레플리카로 전송되는가

    Firebird 4와 5는 퍼블리케이션이 켜져 있을 때만 퍼블리시된 테이블의 변경 사항을 세그먼트에 기록합니다. 퍼블리케이션이 없으면 변경 사항이 레플리카에 도달하지 않습니다. 노드가 이를 감지하고 경고를 발생시킵니다. “퍼블리케이션 동기화” 버튼을 누르면 퍼블리케이션이 켜지고 올바른 테이블 목록이 작성됩니다.

    퍼블리케이션 테이블. 각 테이블의 키와 상태: 퍼블리시됨, 아직 퍼블리시되지 않음, 제외됨, 키 없음.

    동기화가 하는 일

    • 운영자가 의도적으로 끄지 않은 한 퍼블리케이션을 켭니다;
    • 기본 키 또는 고유 인덱스가 있는 모든 테이블을 추가합니다;
    • 키가 없는 테이블과 운영자가 제외한 테이블을 제거합니다;
    • 새 테이블의 자동 추가를 끕니다.

    키가 없으면 레플리카가 UPDATE 및 DELETE를 위한 행을 찾을 수 없습니다. 따라서 그러한 테이블은 퍼블리시할 수 없습니다. 키를 추가하고 다시 동기화하십시오.

    • 매시간 확인퍼블리케이션이 꺼져 있으면 노드가 2분마다 확인합니다. 레플리카가 있는 데이터베이스의 경우 이것은 경고입니다.
    • 제외 목록마스터 노드에 저장됩니다. 레플리카가 마스터로 승격되면 목록이 새 마스터로 이동합니다.
    • 새 테이블자동으로 퍼블리케이션에 참여하지 않습니다. 키를 만들고 “퍼블리케이션 동기화”를 클릭하십시오.
    • 퍼블리케이션 없이 복사퍼블리케이션이 꺼져 있거나 테이블이 없으면 마스터 노드가 데이터베이스 복사를 거부합니다(publication_off). 초기화 창에서 “퍼블리케이션 동기화 및 초기화”를 제공합니다.
    • HQbird 2.5 및 3.0퍼블리케이션이 없습니다. 복제 설정의 포함 및 제외 필터가 테이블 집합을 정의합니다.

    퍼블리케이션이 꺼져 있거나 테이블이 제외된 동안 이루어진 변경 사항은 퍼블리케이션을 다시 켠 후에도 레플리카에 도달하지 않습니다. “검증”은 행 수만 비교하므로 손실된 UPDATE를 찾지 못합니다. 퍼블리케이션이 꺼져 있는 동안 데이터베이스에 쓰기가 발생했다면 데이터베이스를 다시 복사하십시오.

    지연 · 아카이브 · 경고 · 데이터 검사

    모니터링: 레플리카가 조용히 뒤처지지 않도록

    노드는 30초마다 RCM에 통계를 보냅니다. 각 마스터–레플리카 쌍에 대해 마지막 세그먼트, 전송된 수, 확인된 수, 적용된 수, 큐 및 초 단위 지연을 볼 수 있습니다.

    전송 및 큐. 마스터 → 레플리카 경로당 한 행: 세그먼트, 큐 및 지연.
    데이터베이스 상태RCM의 그룹의미
    IN_SYNC정상레플리카가 모든 세그먼트를 받았습니다.
    LAGGING대기 중레플리카가 뒤처져 있으며 세그먼트가 큐에 있습니다.
    SEEDING대기 중데이터베이스가 레플리카로 복사되고 있습니다.
    NEEDS_REINIT오류레플리카를 다시 복사해야 합니다.
    FAILED오류마지막 복사가 실패했습니다.

    마스터의 아카이브는 단계적으로 정리됩니다

    마스터는 레플리카가 다시 요청할 수 있도록 전송된 세그먼트를 보관합니다. 공간이 부족하면 확실히 필요 없는 것부터 먼저 삭제합니다.

    1. 1모두 적용됨, 한도보다 오래됨기본 한도는 2일
    2. 2적용됨, 그러나 한도보다 최근여유 공간이 1 GB 미만인 경우; 경고
    3. 3아직 적용되지 않음마지막 단계; 레플리카에 새 복사본이 필요함

    지침이 포함된 경고

    RCM은 20가지 이상의 경고 유형을 알고 있으며, 각 유형에는 무엇을 해야 하는지에 대한 지침이 있습니다. 경고를 확인 처리하거나, 60분 동안 음소거하거나, 삭제할 수 있습니다. 원인이 남아 있으면 경고가 다시 나타납니다.

    이메일이나 웹훅은 없습니다. “경고” 페이지를 지켜보거나 RCM API를 폴링하십시오.

    경고. 코드, 노드, 메시지 및 작업.
    코드발생한 일
    backlog_warn / backlog_critical마스터에 보관되지 않은 세그먼트가 32 / 48개 있습니다.
    apply_error, replication_stopped레플리카가 세그먼트를 적용할 수 없습니다.
    replication_guid_mismatch마스터 데이터베이스 GUID가 변경되었습니다: 복원 또는 파일 교체.
    segment_missing, sequence_gap세그먼트 시퀀스가 끊어졌습니다.
    firebird_down, firebird_log_errorFirebird가 중지되었거나 오류를 기록하고 있습니다.
    firebird_not_answeringFirebird 포트는 열려 있지만, 데이터베이스 연결이 1분 동안 실패했습니다.
    master_publication_off레플리카가 있는 데이터베이스에 대해 게시가 꺼져 있습니다.
    data_mismatch주기적 데이터 검사에서 차이가 발견되었습니다. 데이터 검사는 별도로 켜집니다.
    데이터 검사. 마스터와 레플리카의 각 테이블 행 수.

    마스터와 레플리카 비교

    Verify는 마스터와 레플리카에서 선택한 테이블의 행 수를 세고 비교합니다. 행 내용은 비교하지 않으므로 변경된 행은 찾지 못합니다. 한가한 시간에 실행하십시오: 쓰기가 활발한 중에는 행 수가 다를 수 있습니다.

    주기적 검사는 기본적으로 꺼져 있습니다: COUNT(*)는 전체 테이블을 읽습니다. 노드 매개변수 data_check_enabled로 켜며, 2시간마다 한 번 실행됩니다. 새 검사 설정은 노드 재시작 없이 즉시 적용됩니다. 검사는 마스터와 레플리카가 같은 세그먼트에 있을 때 데이터를 비교합니다. 차이가 있으면 경고가 발생합니다. 게시에서 제외된 테이블은 오류가 아니라 "게시되지 않음"으로 표시됩니다.

    • 전송 일시 중지하나 또는 여러 데이터베이스에 대해. "재개" 후에는 새 복사 없이 마지막 세그먼트부터 전송이 계속됩니다. 그동안 아카이브는 커집니다.
    • 원격 노드 로그서버에 로그인하지 않고 RCM에서 바로 replication.log, firebird.log 및 노드 로그를 확인합니다.
    • 라이선스 없음마스터는 전송을 중지하고, Firebird와 데이터베이스는 계속 작동합니다. 라이선스를 설치하면 1분 이내에 전송이 자동으로 재개됩니다.
    • 명령 로그각 RCM 명령은 작성자와 결과와 함께 기록됩니다. 클러스터 보고서는 하나의 JSON 파일로 제공됩니다.

    서비스 · 에포크 · 마스터의 위치

    서비스: 여러 호스트에 있는 하나의 데이터베이스

    서비스는 여러 호스트에 있는 하나의 논리적 데이터베이스입니다. 마스터는 호스트 간에 이동할 수 있지만, 서비스 이름과 데이터베이스 별칭은 변경되지 않습니다. 애플리케이션과 라우터는 RCM에 서비스의 마스터가 현재 어디에 있는지 묻습니다.

    각 마스터 변경에는 다음 번호가 부여됩니다: 에포크. RCM은 에포크 이력을 보관합니다: 마스터가 언제, 왜 변경되었는지. RCM은 GUID가 아니라 노드와 파일 경로로 서비스를 찾습니다: 전환 시 데이터베이스 GUID는 변경되지만 경로는 그대로 유지됩니다.

    서비스가 설명하는 것

    • alias: databases.conf의 데이터베이스 이름. 새 마스터가 직접 기록합니다.
    • members: 호스트당 하나의 항목: 마스터 노드, 레플리카 노드, 파일 경로, 우선순위.
    • router_port: 라우터가 이 서비스의 애플리케이션을 받는 포트.
    • policy: 자동 페일오버 규칙과 이전 마스터를 닫는 모드.

    서비스의 각 호스트는 하나의 Firebird에서 두 개의 노드를 실행합니다: 마스터 노드와 레플리카 노드. 이는 위 다이어그램의 "호스트당 두 노드" 배치와 동일합니다.

    마스터 노드에는 클라이언트용 Firebird 주소가 필요합니다: advertise_addr 매개변수. 이것이 없으면 RCM은 애플리케이션에 어디로 연결해야 하는지 알려줄 수 없습니다.

    마스터의 현재 위치

    hqbirdrcm services put -id shop -file shop.json
    hqbirdrcm services
    hqbirdrcm where -service shop
    hqbirdrcm where -db shop

    where는 마스터 호스트와 주소, 에포크 번호, 레플리카 및 발견된 문제로 응답합니다. API를 통해 애플리케이션은 매초 RCM을 폴링하지 않고 새 에포크를 기다릴 수 있습니다.

    RCM의 Services 페이지는 각 서비스에 대해 동일한 정보를 보여줍니다: 상태, 에포크, 마스터, Firebird 주소, 레플리카 및 문제. Find 필드는 별칭, 서비스 이름, GUID 또는 경로로 데이터베이스를 찾습니다.

    브라우저의 서비스

    hqbirdrcm 명령이 서비스에 대해 수행하는 모든 작업은 RCM 웹 인터페이스에서도 가능합니다. 이를 위해 명령줄이 필요하지 않습니다.

    • 서비스 페이지상태와 그 이유, 마스터, 지연이 있는 레플리카, 호스트와 그 역할, 라우터, 닫히기를 기다리는 이전 마스터, 자동 페일오버 규칙, 단계별로 실행 중인 작업 및 마스터 이력.
    • 작업 버튼Switchover, Failover, Rejoin, Resume. 각 버튼은 먼저 검사를 실행하고 문제를 표시합니다. 작업은 확인 후에만 시작됩니다. 두 번째 클릭은 두 번째 작업을 시작하지 않습니다.
    • 서비스 양식New service 버튼으로 서비스를 생성합니다: 이름, 별칭, 라우터 포트 및 각 호스트당 한 줄. 양식은 노드와 그들이 보는 데이터베이스를 제공합니다. Check는 양식을 검사하고, Save는 먼저 변경 목록을 표시합니다.
    • 작업모든 스위치오버, 페일오버 및 재조인을 최신 순으로 보여주는 페이지. 작업이 실행되는 동안 각 페이지의 헤더에 해당 작업으로 연결되는 레이블이 표시됩니다.
    • 서비스 삭제RCM의 레코드만 삭제됩니다. 대화상자는 유지되는 것(데이터베이스, 복제, 노드 역할, 별칭)과 손실되는 것(이력, 규칙, 라우터의 포트)을 알려주고 서비스 이름을 입력하도록 요청합니다.
    • 뷰어 역할이 역할을 가진 사용자는 모든 페이지를 보고 검사를 실행할 수 있지만 작업 버튼은 없습니다.
    서비스 상태의미수행할 작업
    ok마스터가 작동하고, 다른 호스트의 레플리카가 이를 따릅니다.없음.
    rejoining이전 마스터가 레플리카로 복귀 중입니다.기다리십시오: 데이터베이스가 복사되고 있습니다.
    degraded_no_replica마스터는 작동하지만 레플리카가 없습니다. 페일오버 후 또는 재조인 오류 후에 발생합니다.hqbirdrcm rejoin
    failedRCM이 상태를 확인할 수 없거나 마스터의 Firebird가 응답하지 않습니다.확인 후 hqbirdrcm resume

    failed 상태의 서비스는 스위치오버도 자동 페일오버도 시작하지 않습니다. 운영자만이 resume 명령, rejoin 또는 수동 페일오버를 통해 이 상태에서 벗어날 수 있습니다.

    데이터 손실 없는 마스터의 계획된 이동

    스위치오버: 마스터가 다른 호스트로 이동

    스위치오버는 데이터 손실 없이 서비스의 마스터를 다른 호스트로 이동합니다. RCM 자체가 이전 마스터의 쓰기를 중지하고, 레플리카가 마지막 세그먼트를 적용할 때까지 기다린 후, 레플리카를 마스터로 만듭니다. 그런 다음 이전 마스터는 동일한 경로에서 새 마스터의 레플리카로 클러스터에 복귀합니다.

    계획된 작업에 필요합니다: OS 업데이트, 디스크 교체, 다른 서버로의 부하 이동. 먼저 확인, 그다음 시작:

    hqbirdrcm switchover -service shop -check   # 확인만 수행, 아무것도 변경하지 않음
    hqbirdrcm switchover -service shop -to db2  # 마스터를 db2로 이동

    이 명령은 작업을 끝까지 실행하고 각 단계를 출력합니다. 종료 코드 0은 성공을 의미합니다. RCM의 서비스 페이지에 있는 Switchover 버튼도 동일하게 동작합니다: 먼저 확인, 그다음 승인, 그다음 화면에 작업 단계가 표시됩니다.

      애플리케이션

      작동 중

      호스트 및 서비스

      RCM이 시작 전에 확인하는 사항

      • 서비스가 ok 상태이고 마스터가 알려져 있습니다.
      • 대상 레플리카가 IN_SYNC 상태입니다.
      • 두 호스트의 네 개 노드 모두 응답합니다.
      • 대상 레플리카가 라이선스 때문에 일시정지되지 않았습니다.
      • 이 노드에서 데이터베이스 복사나 승격이 실행 중이 아닙니다.

      문제가 있으면 RCM은 거부하고 이유를 코드로 제공합니다. 이 시점까지는 아무것도 변경되지 않았습니다.

      문제가 발생하면

      • 돌이킬 수 없는 지점 이전. 오류, 타임아웃 또는 취소는 이전 마스터를 다시 온라인으로 복구합니다. 서비스는 이전 호스트에서 ok 상태로 유지됩니다. 이전 마스터가 다시 온라인으로 복구되지 않으면 서비스는 failed가 됩니다: gfix -online normal로 데이터베이스를 온라인으로 전환하고 resume을 실행하십시오.
      • 돌이킬 수 없는 지점 이후. 취소할 수 없습니다. 오류가 발생하면 서비스가 failed로 설정됩니다.
      • rejoin 중 오류. 새 마스터는 작동하지만 레플리카가 없습니다: degraded_no_replica. hqbirdrcm rejoin -service shop을 실행하십시오.
      hqbirdrcm operations show -id <id>
      hqbirdrcm operations cancel -id <id>

      브라우저에서는 Operations 페이지와 서비스 페이지의 Cancel 버튼입니다.

      • 쓰기 중지이전 마스터가 완전 종료로 전환됩니다. 노드는 연결이 끝날 때까지 기다립니다: 기본 120초, 최대 900초. -force N 스위치는 N초 후에 연결을 끊습니다.
      • 따라잡기매초 RCM은 레플리카에 마지막 세그먼트를 적용했는지 묻습니다. 기본 제한은 300초입니다.
      • Firebird 한 번 재시작새 마스터에서 윈도우를 기다리지 않고 수행됩니다. rejoin 중에는 레플리카 노드가 필요로 하는 경우에만 이전 호스트의 Firebird가 재시작됩니다.
      • Rejoin은 데이터베이스 복사새 마스터가 nbackup을 통해 이전 호스트로 데이터베이스를 복사합니다. 대용량 데이터베이스의 경우 시간이 오래 걸리므로 명령은 최대 2시간 동안 작업을 기다립니다.
      • RCM 재시작됨각 단계는 노드 호출 전에 디스크에 기록됩니다. 재시작 후 RCM은 현재 단계부터 작업을 계속합니다.
      • 서비스 잠금스위치오버나 rejoin이 실행되는 동안 RCM은 이 노드에서 다른 변경(설정, Firebird 재시작, 복사, 전송 일시정지)을 거부합니다.

      이전 마스터에 대한 연결은 쓰기 중지 단계에서 닫힙니다. 애플리케이션은 다시 연결해야 합니다. 라우터를 사용하면 연결 문자열이 동일하게 유지됩니다. 라우터가 없으면 애플리케이션은 새 마스터의 주소로 연결합니다: hqbirdrcm where -service shop이 주소를 제공합니다.

      HAProxy · Linux · 하나의 연결 문자열

      라우터: 애플리케이션이 동일한 주소를 유지

      라우터는 애플리케이션 호스트에서 실행되며 HAProxy가 각 서비스의 마스터를 가리키도록 유지합니다. 애플리케이션은 <router host>:<service port>에 연결합니다. 스위치오버나 페일오버 후에도 연결 문자열은 동일하게 유지됩니다.

      라우터 다이어그램: epoch 변경 전에는 애플리케이션이 라우터를 통해 db1로, 변경 후에는 db2로 연결됩니다 epoch 4 · master on db1 애플리케이션 router:3051 라우터 HAProxy db1 master db2 replica epoch 5 · master on db2 애플리케이션 router:3051 라우터 HAProxy db1 닫힘 (격리됨) db2 마스터
      에포크 변경. 라우터는 이전 마스터의 세션을 즉시 닫고, 새 마스터가 "준비됨"이라고 응답하면 새 마스터로 연결을 엽니다. 애플리케이션이 사용하는 주소와 포트는 변경되지 않습니다.

      라우터가 호스트를 선택하는 방법

      • RCM에서 서비스 테이블을 가져옵니다: 에포크, 마스터 호스트, Firebird 주소.
      • 2초마다 마스터 노드에 묻습니다: "이 에포크의 마스터입니까, 데이터베이스가 온라인입니까?"
      • "예"라고 응답하면: 해당 호스트가 연결을 받습니다.
      • "아니오"라고 응답하면: 새 연결은 받지 않지만 기존 연결은 유지됩니다.
      • 새 에포크: 이전 마스터의 세션이 즉시 닫힙니다.

      RCM을 사용할 수 없으면 라우터는 마지막 테이블로 동작합니다. 라우터는 이 테이블을 자체 디스크에 보관합니다.

      라우터를 추가하는 방법

      라우터는 router 역할을 가진 클러스터 구성원입니다. 마스터나 레플리카처럼 클러스터 페이지에서 추가합니다. 이 호스트의 fbagent가 인증서를 받고, 구성을 작성하고, 서비스를 등록합니다. 호스트에 HAProxy가 설치되어 있어야 합니다.

      서비스 설명의 router_port가 서비스 포트를 설정합니다. 라우터를 여러 개 둘 수 있습니다: 각 애플리케이션 호스트에 하나씩.

      RCM의 설정 → 라우터 페이지는 라우터와 그 보고를 보여줍니다: 라우터가 어떤 에포크를 적용했고 어떤 호스트로 연결하는지.

      • 연결 끊김마스터가 변경되면 열려 있던 연결이 닫힙니다. 애플리케이션은 같은 주소로 다시 연결해야 합니다.
      • 클라이언트 주소Firebird는 애플리케이션 주소가 아니라 HAProxy 주소를 봅니다. 클라이언트 IP 기반 접근 규칙은 라우터 뒤에서는 동작하지 않습니다.
      • Linux 전용라우터는 Linux에서 동작합니다. 데이터베이스 서버는 Windows와 Linux 모두에 둘 수 있습니다.
      • 위트니스라우터는 마스터의 Firebird 포트에 도달할 수 있는지 RCM에 알립니다. 위트니스가 없으면 자동 페일오버가 켜지지 않습니다.

      마스터 호스트 손실 · 수동 또는 규칙에 의해

      페일오버: 레플리카가 마스터 역할을 맡음

      마스터 호스트가 응답하지 않을 때 페일오버가 필요합니다. 레플리카는 자신이 받은 세그먼트로 마스터가 됩니다. 마스터가 보내지 않은 것은 손실됩니다. 따라서 운영자는 손실을 명시적으로 받아들여야 합니다.

      hqbirdrcm failover -service shop -check                       # 무엇이 손실될지
      hqbirdrcm failover -service shop -to db2 -accept-data-loss  # 시작

      -accept-data-loss 스위치가 없으면 명령은 검사만 수행하고 손실 추정치를 보여줍니다: 마스터의 마지막 세그먼트, 레플리카가 받아서 적용한 세그먼트 수, 최소한 손실되는 세그먼트 수.

      브라우저에서는 서비스 페이지의 페일오버 버튼입니다. 운영자가 데이터 손실 확인란을 선택하고 서비스 이름을 입력한 경우에만 작업을 시작합니다.

      1. 1검사마스터가 응답하지 않고, 레플리카에 사용 가능한 사본이 있음
      2. 2따라잡기레플리카가 받은 모든 것을 적용; 제한 60초
      3. 3승격돌아올 수 없는 지점: 새 GUID, Firebird 재시작
      4. 4새 에포크레플리카가 마스터가 됨; 이전 마스터는 닫히기를 기다림
      • 마스터가 여전히 응답함RCM이 거부합니다: master_reachable. 스위치오버를 실행하거나 먼저 마스터 노드를 중지하십시오.
      • 뒤처진 레플리카LAGGING 상태는 허용됩니다. 새 사본이 필요한 레플리카는 적합하지 않습니다.
      • 여러 레플리카기본적으로 RCM은 더 많은 세그먼트를 적용한 레플리카를 선택하고, 그다음 우선순위가 더 높은 레플리카를 선택합니다.
      • 페일오버 후서비스는 degraded_no_replica 상태가 됩니다: 마스터는 동작하지만 레플리카가 없습니다. 이전 호스트가 다시 살아나기 전까지 재합류는 없습니다.
      • 실패 상태의 서비스수동 페일오버도 이에 대해 동작합니다. 마스터의 Firebird가 멈춰서 빠르게 재시작할 수 없을 때의 해결 방법입니다.
      • 제외된 테이블RCM은 레플리카 또는 이전 마스터의 마지막 통계에서 목록을 가져옵니다. 목록이 없으면 새 마스터의 발행 페이지에서 테이블을 설정하십시오.
      • 따라잡기 제한-apply-timeout 스위치, 기본 60초, 최대 3600초.

      자동 페일오버 선택 사항

      RCM이 페일오버를 직접 시작할 수 있습니다. 기본적으로 꺼져 있습니다. 서비스별로 규칙을 켭니다: 브라우저의 서비스 페이지에서 또는 명령으로.

      hqbirdrcm policy -service shop                                     # 규칙 표시
      hqbirdrcm policy -service shop -auto-failover on -max-data-loss 30

      RCM은 10초마다 조건을 확인하고 모든 조건이 참일 때만 페일오버를 시작합니다.

      조건이유
      마스터 노드가 90초 동안 조용함마스터가 통계를 보내지 않습니다.
      RCM에서 마스터 노드로의 직접 호출이 실패함 (5초)단순히 통계가 늦은 것이 아닙니다.
      라우터의 절반 이상이 마스터의 Firebird 포트에 도달할 수 없음애플리케이션도 연결할 수 없습니다.
      레플리카 노드가 90초 동안 마스터를 보지 못함세 번째 위트니스.
      레플리카 지연이 30초 이하데이터 손실 제한.
      마지막 자동 페일오버 이후 1시간이 지남마스터가 호스트 사이를 오가지 않습니다.
      RCM이 90초 넘게 실행 중임재시작 후 RCM에는 최신 데이터가 없습니다.
      서비스가 ok 상태이며, 노드에서 복사나 승격이 실행되지 않습니다실행 중인 작업과 충돌하지 않습니다.
      • 라우터가 필요합니다규칙에는 라우터와 서비스 포트가 모두 필요합니다. 둘 중 하나라도 없으면 규칙이 켜지지 않습니다: no_witnesses. 라우터 대부분이 마스터 호스트에 있지 않도록 배치하십시오.
      • 한 번만자동 페일오버 후에는 규칙이 스스로 꺼집니다. 운영자만이 다시 켤 수 있습니다.
      • 시작되지 않은 이유RCM은 대기 이유를 서비스 규칙과 함께 보관하고, 각각의 새로운 이유를 로그에 한 번씩 기록합니다.
      • 로그작업은 system:autofailover로 실행됩니다. 첫 번째 항목은 witness가 본 내용을 나타냅니다.

      30초 제한은 복제본이 수신했지만 아직 적용하지 않은 큐에만 적용됩니다. 마스터가 기록했지만 전송하지 않은 세그먼트는 포함되지 않습니다. 작업 보고서에 해당 개수가 표시됩니다.

      펜스 · 재참여 · 멈춘 마스터 · 재개

      재참여 및 복구

      페일오버 후 클러스터에는 마스터였던 파일이 두 개 있습니다. 이전 파일이 쓰기를 받아들이지 않도록 닫고, 복제본으로 되돌려야 합니다. RCM은 첫 번째는 스스로 수행하고, 두 번째는 운영자 명령으로 수행합니다.

      이전 마스터 닫기(펜스)

      RCM은 10초마다 이전 마스터를 닫으려고 시도합니다. 해당 노드가 응답하면 "닫힘" 역할을 받고 세그먼트 전송을 중단합니다. 각 펜스는 감사 로그에 기록됩니다.

      • 모드 route(기본값). 이전 마스터 데이터베이스는 온라인 상태로 유지됩니다. 라우터는 더 이상 이를 사용하지 않습니다.
      • 모드 shutdown. RCM이 먼저 데이터베이스를 중지합니다. 연결은 5초 후에 닫힙니다.
      hqbirdrcm policy -service shop -fence-mode shutdown

      이전 마스터 되돌리기(재참여)

      이전 호스트가 다시 작동하면 재참여를 시작하십시오. RCM은 아직 닫히지 않았다면 먼저 이전 마스터를 닫습니다. 그런 다음 새 마스터가 자신의 데이터베이스를 같은 경로로 이전 호스트에 복사합니다.

      hqbirdrcm rejoin -service shop

      이전 파일은 삭제되지 않습니다. 새 파일 옆에 <name>.pre-reinit-<time>.fdb로 남습니다. 이 파일과 이전 마스터의 아카이브에는 새 마스터에 없는 변경 사항이 들어 있습니다.

      route 모드에서는 라우터를 거치지 않고 이전 호스트에 직접 연결하는 애플리케이션이 여전히 이전 데이터베이스에 쓸 수 있습니다. 이러한 변경 사항은 새 마스터에 도달하지 않습니다. 일부 애플리케이션이 라우터 없이 작동한다면 shutdown 모드를 켜십시오.

      멈춘 마스터

      Firebird는 포트는 열려 있지만 데이터베이스에 연결할 수 없을 정도로 멈출 수 있습니다. 포트 확인으로는 이를 감지할 수 없습니다. 따라서 노드 자체가 10초 제한으로 매분 데이터베이스에 연결합니다.

      • 1분 동안 응답 없음: 심각한 경고 firebird_not_answering.
      • RCM이 서비스를 failed로 설정하고 이유(노드, 호스트, 시간)를 기록합니다.
      • 이 상태에서는 자동 페일오버가 시작되지 않습니다.

      해야 할 일: Firebird 스레드 스택과 firebird.log를 저장하고, 마스터 호스트에서 Firebird를 재시작한 다음 resume을 실행하십시오. 빠르게 재시작할 수 없다면 마스터 노드를 중지하고 페일오버를 시작하십시오.

      실패 상태 벗어나기

      hqbirdrcm resume -service shop -check
      hqbirdrcm resume -service shop

      RCM이 마스터 노드에 직접 질의하고 다음을 확인합니다:

      • 서비스에서 실행 중인 작업이 없음;
      • 마스터 노드가 응답함;
      • 해당 Firebird가 연결을 받아들임;
      • 호스트가 현재 epoch의 마스터이고 데이터베이스가 온라인임.

      다른 호스트의 복제본이 마스터를 따라가면 서비스가 ok로 전환됩니다. 그렇지 않으면 degraded_no_replica로 전환됩니다: 이때 rejoin을 실행하십시오.

      일반으로 전환 · 마스터로 승격

      수동 복제본 승격: 단계별 안내

      서비스에 속한 데이터베이스에는 switchover와 failover를 사용하십시오: 이들이 아래의 모든 단계를 스스로 수행합니다. 수동 경로는 서비스가 없는 데이터베이스용으로 남아 있습니다. "일반으로 전환"은 복제본을 별도의 작업 데이터베이스로 만듭니다: 보고서, 테스트 또는 장애 대응용입니다. "마스터로 승격"은 복제본을 새 마스터로 만듭니다.

      승격은 동일한 Firebird 인스턴스에 있는 복제본 노드와 마스터 노드의 컴패니언 노드 쌍에서 작동합니다. 데이터베이스 파일은 제자리에 남고, 제어가 컴패니언으로 이동합니다. 각 단계는 데이터베이스 행에 표시됩니다. 단계가 중단되었다면 버튼을 다시 클릭하십시오: 완료된 단계는 반복되지 않습니다.

        연결

        유지됨

        RCM이 표시하는 내용

        데이터베이스 행의 단계. 완료된 단계는 녹색, 현재 단계는 빨간색, 다음 단계는 회색입니다.

        새 GUID가 필요한 이유

        새 GUID가 없으면 새 마스터가 이전 마스터의 GUID로 세그먼트를 기록하고, 해당 복제본이 이를 거부합니다. 노드는 Firebird를 재시작하지 않고 nbackup을 통해 데이터베이스에 새 GUID를 제자리에서 부여합니다. 이는 2.5, 3.0, 4.0 및 5.0에서 작동합니다.

        새 GUID 이후에는 이전 nbackup 체인이 더 이상 맞지 않습니다. 새 레벨 0 복사본을 만드십시오.

        서비스 없이 수동 switchover

        1. 이전 마스터에 대한 애플리케이션 쓰기를 중지합니다.
        2. IN_SYNC와 빈 큐를 기다립니다.
        3. "Verify"를 클릭합니다: 행 수가 일치합니다. 이는 행 수만 확인합니다.
        4. "마스터로 승격"을 클릭하고 FINALIZE 단계를 기다립니다.
        5. 애플리케이션을 새 마스터로 전환합니다.
        6. 레벨 0 nbackup 복사본을 만들고 새 레플리카를 연결합니다.

        수동 승격은 애플리케이션이 이전 마스터에 쓰기를 하는지 확인하지 않으며, 이전 마스터를 레플리카로 되돌리지도 않습니다. 먼저 직접 쓰기를 중지하십시오. Switchover는 두 단계를 모두 대신 수행합니다. 쓰기를 중지하고 이전 마스터를 다시 가져옵니다.

        재시작 · 매개변수 · 인증서

        설정 및 보안

        Firebird는 시작 시에만 복제 설정을 읽습니다. 따라서 누가 언제 재시작하는지가 중요합니다. 규칙은 간단합니다. 마스터의 Firebird는 절대 자동으로 재시작되지 않습니다. 예외가 하나 있습니다. switchover와 failover입니다. 여기서 재시작은 운영자가 시작한 작업의 일부이거나, 운영자가 활성화한 규칙이 시작한 작업의 일부입니다.

        노드Firebird를 재시작하는 주체
        마스터오직 사용자만. 마스터 노드는 스스로 Firebird를 재시작하지 않습니다.
        레플리카, 동일한 Firebird에 마스터 데이터베이스가 있는 경우사용자. 복사 창의 권한은 노드가 이전 레플리카 파일을 교체하거나 삭제하기 위해 Firebird를 중지하는 것만 허용합니다.
        레플리카, 자동 재시작이 허용되지 않는 경우사용자.
        기타 레플리카노드가 재시작 창 내에서 수행. 일련의 복사 후 한 번만, 각 데이터베이스마다가 아님.

        다수 데이터베이스에 대한 복제 매개변수

        데이터베이스 선택: RCM이 Firebird 버전과 역할별로 그룹화합니다. 각 매개변수에 대해 작업을 선택합니다. 유지, 설정, 상위 수준으로 재설정 또는 쓰지 않음. 현재 값의 출처(데이터베이스, 노드 또는 Firebird)를 확인할 수 있습니다.

        미리보기는 노드의 값을 확인하고 아무것도 변경하지 않습니다. 또한 누가 Firebird를 재시작할지, 그리고 이것이 몇 개의 데이터베이스에 영향을 미치는지도 보여줍니다.

        복제 매개변수. 각 키에 대한 힌트, 노드 및 Firebird 값, 미리보기: “사용자가 재시작함”.
        • 시간 창사용자가 요청한 마스터 재시작: 22:00–05:00. 레플리카: 언제든지. 마스터로의 수동 승격은 시간 창 없이 두 Firebird 서버를 동시에 재시작합니다. Switchover는 하나의 Firebird(새 마스터)를 재시작합니다. 전체 복사 속도: 23:00–05:00.
        • 세그먼트 속도기본 50 MB/s, 짧은 피크 200 MB. 재시작 없이 즉시 변경됩니다.
        • 레플리카 파일 이동새 복사 없이 다른 하위 폴더로 이동, 오류 시 롤백.
        • 수동으로 구성된 레플리카새 복사 없이 관리 대상으로 가져올 수 있습니다. RCM이 GUID로 파일을 일치시킵니다.
        • 명령줄복사, 확인, 일시 중지, 승격 및 기타 RCM 명령은 hqbirdrcm에도 있습니다. Switchover, failover 및 서비스 규칙은 브라우저, 명령 및 API의 세 가지 방법으로 사용할 수 있습니다.
        • 뷰어 역할뷰어 역할을 가진 RCM 사용자는 모든 것을 보고 검사를 실행할 수 있습니다. 이 사용자에게는 모든 변경이 금지됩니다.
        • 6개 언어RCM 인터페이스. 경고 지침은 영어로 제공됩니다.
        HQ Monitor의 클러스터 설명 (데모 모드). 구성원 및 역할, 마스터 → 레플리카 링크, 각 구성원의 인증서 만료.

        하나의 문서로 클러스터를 설명합니다

        구성원, 역할 및 마스터 → 레플리카 링크는 HQ Monitor 또는 RCM의 클러스터 페이지에서 설정합니다. 각 호스트의 fbagent가 설명을 받아 노드를 스스로 설치하고 구성합니다. HQCenter 없이 RCM은 최대 3개 호스트의 클러스터 하나를 관리합니다.

        mTLS 및 인증서

        모든 클러스터 채널은 공유 CA를 사용한 mTLS로 보호됩니다. 키는 구성원 호스트에서 생성되며 절대 외부로 나가지 않습니다. 인증서 요청만 외부로 전송됩니다. 인증서는 90일 동안 유효하며 만료 30일 전에 자동으로 갱신됩니다. 새 키와 새 CA는 관리자 명령으로 발급됩니다.

        RCM 웹 인터페이스는 포트 7444에서 HTTPS를 통해 작동합니다. 에이전트는 호스트에서 RCM이 켜지면 방화벽에서 이 포트를 엽니다. 로그인은 사용자 이름과 비밀번호로 이루어지며, 첫 비밀번호는 반드시 변경해야 합니다. 첫 비밀번호는 RCM 호스트의 rcm-initial-password 파일에 있으며 화면에 표시되지 않습니다. 비밀번호 변경 후 에이전트는 이 파일을 삭제합니다. 로그인 페이지에는 클러스터 CA 해시가 표시됩니다. RCM 호스트의 설정 요약에 있는 “CA hash” 줄과 비교하십시오. 모든 변경 및 로그인은 감사 로그에 기록됩니다.

        명령 · 시간 초과 · 포트 · 거부 코드

        참조

        명령

        작업명령
        호스트에서 RCM 켜기fbagent --cluster-init <id>
        페어링 창 열기 또는 닫기fbagent --cluster-pairing on|off
        호스트 연결hqbirdrcm cluster link -hosts db1,db2 -master db1
        페어링 창이 없는 호스트용 토큰hqbirdrcm cluster join-token -note db2
        클러스터 떠나기fbagent --cluster-leave
        서비스 설명hqbirdrcm services put -id shop -file shop.json
        마스터 위치hqbirdrcm where -service shop
        계획된 마스터 이동hqbirdrcm switchover -service shop [-to db2] [-check]
        긴급 이동hqbirdrcm failover -service shop -accept-data-loss
        이전 마스터를 레플리카로 복귀hqbirdrcm rejoin -service shop
        실패 상태에서 벗어나기hqbirdrcm resume -service shop [-check]
        자동 failover 규칙hqbirdrcm policy -service shop -auto-failover on|off
        작업 진행 상황 및 취소hqbirdrcm operations show|cancel -id <id>

        타임아웃 및 간격

        항목기본값변경 방법
        Switchover: 연결 종료 대기120초, 최대 900초-quiesce-timeout
        Switchover: 레플리카가 마지막 세그먼트 적용300초-apply-timeout
        Switchover: 명령이 작업 종료를 대기2시간-timeout
        Failover: 레플리카가 수신한 내용 적용60초, 최대 3600초-apply-timeout
        자동 failover: 마스터 무응답90초-failover-delay
        자동 failover: 지연 한도30초-max-data-loss
        자동 failover: 두 번 사이의 일시 정지1시간-min-interval
        Failover 조건 및 이전 마스터 fence 확인10초마다변경 불가
        Firebird 응답 없음: 연결 프로브1분에 한 번, 한도 10초변경 불가
        Router: 마스터 노드 폴링2초마다변경 불가
        페어링 윈도우, 조인 토큰24시간윈도우: 요청에 지정한 시간 수
        호스트 연결: 에이전트 인증서, 노드 시작최대 10분, 최대 20분변경 불가

        포트

        포트용도
        7443RCM: 노드, 에이전트 및 라우터, mTLS.
        7444RCM: 웹 인터페이스 및 운영자 명령, HTTPS.
        7450–7459에이전트 페어링 윈도우: 7450 + 슬롯.
        7051–7060에이전트의 첫 번째 노드: 7051 + 슬롯.
        7061–7070에이전트의 두 번째 노드: 7061 + 슬롯.
        router_port라우터의 서비스 포트, 예: 3051.

        거부 코드

        코드의미
        not_in_sync대상 레플리카가 뒤처져 있음: switchover가 시작되지 않음.
        busy노드에서 데이터베이스 복사 또는 승격이 실행 중임.
        service_busy서비스에서 이미 작업이 실행 중임.
        master_reachable마스터가 응답함: failover가 필요하지 않음.
        replica_unusable레플리카에 사용 가능한 데이터베이스 복사본이 없음.
        data_loss_not_accepted-accept-data-loss 스위치 없이 failover를 시도함.
        past_no_return돌아올 수 없는 지점 이후에 취소함.
        no_witnesses라우터 없이 자동 failover를 시도함.
        node_port_clash호스트의 다른 구성원이 노드 포트를 사용 중임.
        seats_exceeded클러스터에 이미 3개의 호스트가 있음.

        핵심 요점 한눈에 보기

        자주 묻는 질문

        switchover와 failover의 차이는 무엇인가요?

        Switchover는 계획된 작업입니다: 두 호스트가 모두 작동하고, 데이터가 손실되지 않으며, 이전 마스터는 스스로 레플리카로 복귀합니다. Failover는 비상 상황입니다: 마스터 호스트가 손실되고, 마스터가 전송하지 못한 내용은 손실되며, 별도의 명령으로 이전 마스터를 복귀시켜야 합니다.

        switchover 중에 애플리케이션은 무엇을 보게 되나요?

        RCM이 쓰기를 중지하면 이전 마스터에 대한 연결이 닫힙니다. 레플리카가 마스터가 될 때까지는 쓸 곳이 없습니다. 새 epoch 이후 애플리케이션은 다시 연결합니다: 동일한 라우터 주소 또는 새 마스터의 주소로 연결합니다.

        switchover는 얼마나 걸리나요?

        쓰기 일시 정지는 세 부분으로 구성됩니다: 연결 종료 대기(기본값 최대 120초), 마지막 세그먼트 따라잡기, 새 마스터에서의 Firebird 재시작 한 번. 이전 마스터의 재조인은 그 이후 백그라운드에서 실행됩니다. 그 시간은 데이터베이스 복사 시간입니다.

        라우터 없이 작업할 수 있나요?

        예. Switchover와 수동 failover는 라우터 없이 작동합니다. 이 경우 애플리케이션은 RCM 자체에서 마스터 주소를 받습니다. 자동 failover는 라우터 없이는 켜지지 않습니다: 라우터가 그 증인입니다.

        자동 failover는 얼마나 많은 데이터를 잃을 수 있나요?

        레플리카가 30초 이상 뒤처져 있으면 규칙이 시작되지 않습니다. 그러나 마스터가 기록했지만 전송하지 못한 세그먼트는 손실됩니다. 작업 보고서에 그 수가 표시됩니다. 이전 데이터베이스 파일은 보존됩니다: 해당 변경 사항은 그 파일과 이전 마스터의 아카이브에 남아 있습니다.

        서비스가 failed 상태입니다. 어떻게 해야 하나요?

        Services 페이지에서 원인을 확인하세요. 마스터의 Firebird가 응답하지 않으면 재시작하세요. 그런 다음 hqbirdrcm resume -service <id> -check로 서비스를 차단하는 항목을 확인하고, 스위치 없이 resume을 실행하면 서비스가 다시 작동합니다.

        이전 마스터의 재조인에는 얼마나 많은 공간이 필요한가요?

        재조인은 새로운 데이터베이스 복사입니다. 모든 복사에 적용되는 것과 동일한 규칙이 적용됩니다: 데이터베이스 크기의 105 %. failover 후에는 이전 파일이 새 파일 옆에 남으므로, 이전 호스트에는 두 파일 모두를 위한 공간이 필요합니다.

        Windows에서 작동하나요?

        노드와 RCM은 Windows와 Linux에서 작동합니다. 라우터는 Linux에서만 작동합니다.

        ← HQbird 2027 개요로 돌아가기