OPERATIONS RUNBOOK · REPLICA SET rs1

MongoDB 7.0.12 → 7.0.48
Windows 서비스 업그레이드 작업 절차

데이터 노드 2대 + 아비터 1대 · 노드별 순차 교체 및 Primary 전환

작성일: 2026-11-13 · 대상: Windows x64 / Community · 방식: 기존 서비스 경로의 바이너리 교체

문서 기준
작업 시작 시 .27은 Arbiter, .28은 Primary, .29는 Secondary입니다. 이 문서는 재사용 가능한 작업 절차이며, 확인란은 실제 작업자가 확인 후 기록합니다. 현재 운영 상태나 작업 완료를 미리 보증하는 문서는 아닙니다.

1. 구성과 작업 순서

서버Replica Set 등록 주소작업 전 역할기본 절차 완료 후 역할
192.168.75.27192.168.75.27:27017ARBITERARBITER
192.168.75.28FLOWSOFTServerT:27017PRIMARYSECONDARY
192.168.75.29192.168.75.29:27017SECONDARYPRIMARY
① .27 아비터 → ② .29 Secondary → ③ .28에서 Primary 전환 → ④ .28 교체 → ⑤ 최종 검증
필수 순서 — .28 서비스를 내리기 전에 .29를 Secondary → Primary로 전환
① 실행 중인 .28 Primary의 mongosh에서 rs.stepDown(300, 60) 실행
② .29에 직접 접속하여 db.hello().isWritablePrimary가 true인지 확인
③ 확인 후에만 .28의 Windows MongoDB 서비스 중지 및 파일 교체
stepDown은 서비스 종료 명령이 아닙니다. .28을 먼저 중지한 뒤 실행하는 절차가 아닙니다.

7.0 계열 안에서의 패치 업그레이드입니다. 중간 패치를 순차 설치하지 않고 7.0.48로 업그레이드합니다. FCV 변경이나 Replica Set 재초기화는 이번 작업에 포함하지 않습니다.

PSA 구성의 서비스 영향
투표 과반수와 쓰기 확인 조건은 다릅니다. 데이터 노드 한 대와 아비터가 살아 있으면 선거 과반수는 유지할 수 있지만, w: "majority" 쓰기를 완료하려면 데이터 노드 2대가 필요합니다. 데이터 노드 재시작·복제 따라잡기 및 Primary 전환 구간에는 쓰기 지연·실패가 발생할 수 있습니다.
권장 점검 범위: ② 시작 전 쓰기·배치 중지 → ⑤ 복제·애플리케이션 검증 후 재개.

2. 사전 점검

2.1 백업 및 환경 확인

각 노드에 직접 연결한 mongosh · 기존 버전/에디션 확인
db.serverBuildInfo().version  // 작업 전 기대값: 7.0.12
db.serverBuildInfo().modules  // Community 기대값: []
별도 준비 폴더의 새 파일 · PowerShell · 경로는 예시
& 'C:\Temp\MongoDB-7.0.48\bin\mongod.exe' --version
# 기대값: db version v7.0.48, modules: [], windows, x86_64

mongod.exe는 Primary·Secondary·Arbiter 모두에서 사용합니다. mongos.exe는 샤딩 라우터용이므로, 본 Replica Set 작업의 교체 대상이 아닙니다.

2.2 Replica Set 및 선출 조건 확인

실행 위치: .28 Primary의 mongosh
rs.status().members.map(m => ({
  name: m.name, health: m.health, state: m.stateStr
}))

rs.printSecondaryReplicationInfo()

rs.conf().members.map(m => ({
  host: m.host, priority: m.priority, votes: m.votes
}))

db.adminCommand({ getDefaultRWConcern: 1 })
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })

3. Windows 서비스 공통 교체 절차

아래 절차는 각 서버에 직접 로그인하여 실행합니다. 서비스 이름과 실행 경로는 서버마다 다를 수 있으므로 먼저 확인합니다.

관리자 PowerShell · 조회
Get-CimInstance Win32_Service |
    Where-Object { $_.PathName -match 'mongod\.exe' } |
    Format-List Name, State, StartName, ProcessId, PathName

Name은 서비스 이름, StartName은 실행 계정, PathName은 실행 파일 및 설정 파일 경로입니다. 다음 예시는 서비스 이름이 MongoDB일 때 사용합니다.

관리자 PowerShell · 대상 노드 한 대에서만 실행
Stop-Service -Name 'MongoDB' -ErrorAction Stop

(Get-Service -Name 'MongoDB').WaitForStatus(
    [System.ServiceProcess.ServiceControllerStatus]::Stopped,
    [TimeSpan]::FromMinutes(5)
)

Get-Service -Name 'MongoDB'
  1. Stopped 상태와 MongoDB 로그의 정상 종료를 확인합니다. 종료 지연 시 원인을 확인하고 강제 종료부터 하지 않습니다.
  2. 서비스가 실제로 참조하는 기존 mongod.exe와 설정을 별도 백업 폴더에 보관합니다.
  3. 동일 실행 경로에 새 mongod.exe를 복사합니다. 공식 배포본에 함께 제공된 DLL이 있으면 같이 반영합니다.
  4. 기존 mongod.cfg, storage.dbPath 데이터, 로그 경로, replication.replSetName: rs1, 인증·TLS·네트워크 설정을 유지합니다.
  5. 서비스 계정의 읽기·실행 권한을 확인하고, 교체된 실행 파일의 버전을 확인합니다.
관리자 PowerShell · 실제 서비스 실행 경로로 수정
& 'C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe' --version
# 7.0.48 확인 후 시작

Start-Service -Name 'MongoDB' -ErrorAction Stop
Get-Service -Name 'MongoDB'
동일 실행 경로를 유지하므로 서비스 삭제·재등록은 필요하지 않습니다. Running만으로 완료를 판단하지 말고, 해당 노드에 새로 연결한 mongosh에서 실행 중인 버전과 역할을 확인합니다. ZIP 교체는 MSI 설치 이력의 버전을 갱신하지 않을 수 있으므로 보안 점검 도구의 판정 기준도 확인합니다.

4. 노드별 실행 절차와 진행 조건

STEP 01.27 아비터 업그레이드

.28과 .29가 정상인 상태에서 .27에 공통 교체 절차를 적용합니다. 아비터 중지 중에는 다른 노드를 중지하지 않습니다.

.27에 직접 연결한 mongosh
db.version()           // 7.0.48
db.hello().arbiterOnly  // true
.28 Primary의 mongosh
rs.status()
  • .27이 ARBITER / health: 1로 복귀했다.
  • .28 PRIMARY, .29 SECONDARY가 정상이며 세 노드가 모두 health: 1이다.

STEP 02.29 Secondary 업그레이드

쓰기·배치 점검 구간을 시작합니다. .28과 .27을 유지한 상태에서 .29에 공통 교체 절차를 적용합니다.

.29에 직접 연결한 mongosh
db.hello().me         // 192.168.75.29:27017
db.version()          // 7.0.48
db.hello().secondary  // true
.28 Primary의 mongosh
rs.status()
rs.printSecondaryReplicationInfo()
  • .29가 7.0.48이며 SECONDARY / health: 1로 복귀했다.
  • .29의 복제가 따라잡혔고 지연이 지속적으로 증가하지 않는다.
  • .27 ARBITER와 .28 PRIMARY가 정상이다.

진행 기준: .29가 STARTUP2 또는 RECOVERING 상태이면 기다립니다. 버전이 7.0.12이면 서비스 실행 경로와 실제 교체 파일을 다시 확인합니다.

STEP 03 · .28 중지 전 필수.29를 Secondary → Primary로 전환

.29의 선출 조건과 최신 복제 상태를 재확인한 뒤 실행합니다. Primary 전환 중 쓰기·트랜잭션이 실패할 수 있으므로 점검 구간을 유지합니다.

.28 현재 Primary의 mongosh에서 실행
rs.stepDown(300, 60)

역할 변화: .28 PRIMARY → SECONDARY / .29 SECONDARY → PRIMARY. 명령은 .28에서 실행하지만, 실제 목표는 .29가 새 Primary가 된 것을 확인하는 것입니다. 이 단계에서는 .28의 Windows 서비스를 계속 실행 상태로 유지합니다.

선출 가능한 Secondary의 따라잡기를 최대 60초 기다리고, 기존 Primary는 명령 수신 시점부터 300초 동안 재선출 대상에서 제외됩니다. ok: 1만으로 다음 단계에 진입하지 말고 새 Primary를 확인합니다.

.29에 직접 연결한 mongosh에서 확인
db.hello().isWritablePrimary  // 반드시 true 확인
rs.status()
  • .29의 isWritablePrimary가 true이다.
  • 상태 조회에서 .29 PRIMARY / .28 SECONDARY / .27 ARBITER이며 모두 정상이다.
.29의 Primary 선출을 확인한 뒤에만 .28 서비스를 중지합니다. stepDown 실패 또는 .29의 결과가 false이면 .28을 중지하지 말고 원인을 확인합니다. 강제 전환 옵션으로 진행하지 않습니다.

STEP 04.28 기존 Primary 업그레이드

서비스 중지 직전 확인: STEP 03에서 .29의 isWritablePrimary = true를 확인했습니까?
확인되지 않았으면 여기서 멈추고 Primary 전환을 먼저 완료합니다. 확인되었으면 .28은 이미 Secondary이므로 .28 서비스 중지·교체를 진행합니다.

.29가 Primary임을 확인한 상태에서 .28에 공통 교체 절차를 적용합니다. .29와 .27은 계속 실행 상태로 유지합니다.

재시작 후 .28에 직접 연결한 mongosh
db.version()          // 7.0.48
db.hello().secondary  // true
.29 새 Primary의 mongosh
rs.status()
rs.printSecondaryReplicationInfo()
  • .28이 7.0.48이며 SECONDARY / health: 1로 복귀했다.
  • .28의 복제가 따라잡혔고 지연이 안정적이다.
  • .29 PRIMARY, .27 ARBITER가 정상이다.

5. 최종 검증 및 서비스 재개

.29 Primary의 mongosh
rs.status().members.map(m => ({
  name: m.name, health: m.health, state: m.stateStr
}))

rs.printSecondaryReplicationInfo()

db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })
대상완료 기준확인
.27직접 접속한 db.version() = 7.0.48 / ARBITER / health: 1☐
.28직접 접속한 db.version() = 7.0.48 / SECONDARY / health: 1☐
.29직접 접속한 db.version() = 7.0.48 / PRIMARY / health: 1☐
복제지연이 해소되거나 운영 기준 안에서 안정적이며, 지속적으로 증가하지 않음☐
설정FCV와 Replica Set 구성 등 의도하지 않은 변경 없음☐
애플리케이션새 Primary 연결 및 정상 읽기·쓰기, 사용하는 트랜잭션 동작 확인☐
운영 상태로그 오류, 쓰기 지연·타임아웃, 디스크·캐시 지표에 이상 없음☐
서비스 재개검증 후 쓰기·배치 재개 및 오류율 관찰☐

1초 정도의 일시적 지연만으로 이상을 판단하지 않습니다. 새 Primary에서 반복 확인하고 추이를 봅니다. 다른 멤버의 정보에는 하트비트 수집 시차가 포함될 수 있습니다.

완료 후 Primary는 .29입니다.
.28을 Primary로 되돌리는 작업은 본 기본 절차에 포함하지 않습니다. 원래 역할 복원이 운영 요구사항이면 별도 전환 작업으로 계획하며, .28의 선출 가능 여부·복제 상태·stepDown 제한 시간 경과를 확인한 뒤 수행합니다.

6. 작업 중단 기준과 기록

작업 구간시작 / 종료 시간결과 및 특이사항작업자
.27 교체 및 복귀   
.29 교체 및 복제 확인   
Primary 전환 .28 → .29   
.28 교체 및 복제 확인   
최종 검증 / 서비스 재개   

7. 공식 참고 문서