작업 시작 시 .27은 Arbiter, .28은 Primary, .29는 Secondary입니다. 이 문서는 재사용 가능한 작업 절차이며, 확인란은 실제 작업자가 확인 후 기록합니다. 현재 운영 상태나 작업 완료를 미리 보증하는 문서는 아닙니다.
1. 구성과 작업 순서
| 서버 | Replica Set 등록 주소 | 작업 전 역할 | 기본 절차 완료 후 역할 |
|---|---|---|---|
| 192.168.75.27 | 192.168.75.27:27017 | ARBITER | ARBITER |
| 192.168.75.28 | FLOWSOFTServerT:27017 | PRIMARY | SECONDARY |
| 192.168.75.29 | 192.168.75.29:27017 | 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 재초기화는 이번 작업에 포함하지 않습니다.
투표 과반수와 쓰기 확인 조건은 다릅니다. 데이터 노드 한 대와 아비터가 살아 있으면 선거 과반수는 유지할 수 있지만,
w: "majority" 쓰기를 완료하려면 데이터 노드 2대가 필요합니다. 데이터 노드 재시작·복제 따라잡기 및 Primary 전환 구간에는 쓰기 지연·실패가 발생할 수 있습니다.권장 점검 범위: ② 시작 전 쓰기·배치 중지 → ⑤ 복제·애플리케이션 검증 후 재개.
2. 사전 점검
2.1 백업 및 환경 확인
- 복구 가능한 최신 데이터 백업과 복구 절차를 확보한다. 실행 중인 데이터 폴더의 단순 복사를 유효한 백업으로 간주하지 않는다.
- 사전 환경에서 동일한 버전·설정·설치 방식의 업그레이드와 애플리케이션 동작을 확인한다.
- 세 서버의 기존 바이너리, 설정 파일, 서비스 실행 정보, keyFile·인증서를 보관한다.
- 기존 버전과 에디션을 각 서버에서 확인한다. 본 절차는 Community → Community를 기준으로 한다.
- 공식 Windows x64 Community 7.0.48 배포본을 준비하고, 함께 제공된 DLL이 있으면 같이 준비한다.
- 7.0.12 이후 릴리스 노트와 사용하는 드라이버의 호환성을 검토한다.
- 애플리케이션의 Replica Set 연결·재연결을 확인한다. 단일 노드 직접 연결이면 Primary 변경 후 자동 전환되지 않을 수 있다.
- 애플리케이션 및 멤버 서버에서 FLOWSOFTServerT 이름이 192.168.75.28로 정상 해석되는지 확인한다.
- Windows OS 지원 여부, 디스크 여유 공간 및 서비스 계정의 파일 접근 권한을 확인한다.
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의 mongoshrs.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 })
- 세 노드가 모두 health: 1이고 .28 PRIMARY / .29 SECONDARY / .27 ARBITER이다.
- .29의 votes가 1이고 priority가 0보다 커서 Primary 선출이 가능하다.
- 복제 지연이 작고 안정적이다. 지연이 계속 증가하면 작업 전 원인을 해결한다.
- 서버 기본 writeConcern과 애플리케이션이 별도로 지정한 writeConcern을 확인한다.
- FCV를 기록한다. 예상과 다르면 원인을 검토하고, 패치 작업과 FCV 변경을 함께 진행하지 않는다.
3. Windows 서비스 공통 교체 절차
아래 절차는 각 서버에 직접 로그인하여 실행합니다. 서비스 이름과 실행 경로는 서버마다 다를 수 있으므로 먼저 확인합니다.
관리자 PowerShell · 조회Get-CimInstance Win32_Service |
Where-Object { $_.PathName -match 'mongod\.exe' } |
Format-List Name, State, StartName, ProcessId, PathName
Name은 서비스 이름, StartName은 실행 계정, PathName은 실행 파일 및 설정 파일 경로입니다. 다음 예시는 서비스 이름이 MongoDB일 때 사용합니다.
Stop-Service -Name 'MongoDB' -ErrorAction Stop
(Get-Service -Name 'MongoDB').WaitForStatus(
[System.ServiceProcess.ServiceControllerStatus]::Stopped,
[TimeSpan]::FromMinutes(5)
)
Get-Service -Name 'MongoDB'
Stopped상태와 MongoDB 로그의 정상 종료를 확인합니다. 종료 지연 시 원인을 확인하고 강제 종료부터 하지 않습니다.- 서비스가 실제로 참조하는 기존
mongod.exe와 설정을 별도 백업 폴더에 보관합니다. - 동일 실행 경로에 새
mongod.exe를 복사합니다. 공식 배포본에 함께 제공된 DLL이 있으면 같이 반영합니다. - 기존
mongod.cfg,storage.dbPath데이터, 로그 경로,replication.replSetName: rs1, 인증·TLS·네트워크 설정을 유지합니다. - 서비스 계정의 읽기·실행 권한을 확인하고, 교체된 실행 파일의 버전을 확인합니다.
& '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에 직접 연결한 mongoshdb.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에 직접 연결한 mongoshdb.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를 확인합니다.
db.hello().isWritablePrimary // 반드시 true 확인
rs.status()
- .29의 isWritablePrimary가 true이다.
- 상태 조회에서 .29 PRIMARY / .28 SECONDARY / .27 ARBITER이며 모두 정상이다.
STEP 04.28 기존 Primary 업그레이드
확인되지 않았으면 여기서 멈추고 Primary 전환을 먼저 완료합니다. 확인되었으면 .28은 이미 Secondary이므로 .28 서비스 중지·교체를 진행합니다.
.29가 Primary임을 확인한 상태에서 .28에 공통 교체 절차를 적용합니다. .29와 .27은 계속 실행 상태로 유지합니다.
재시작 후 .28에 직접 연결한 mongoshdb.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의 mongoshrs.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에서 반복 확인하고 추이를 봅니다. 다른 멤버의 정보에는 하트비트 수집 시차가 포함될 수 있습니다.
.28을 Primary로 되돌리는 작업은 본 기본 절차에 포함하지 않습니다. 원래 역할 복원이 운영 요구사항이면 별도 전환 작업으로 계획하며, .28의 선출 가능 여부·복제 상태·stepDown 제한 시간 경과를 확인한 뒤 수행합니다.
6. 작업 중단 기준과 기록
- 서비스 시작 실패, 예상하지 않은 역할, health: 0, 복제 지연 증가 또는 로그의 중대한 오류가 있으면 다음 노드 작업을 중지합니다.
- 정상 동작하는 노드를 유지하고 서비스 실행 경로·설정·권한 및 MongoDB 로그를 확인합니다. 동시에 다른 노드를 재시작하지 않습니다.
- 기존 exe 백업만으로 데이터까지 원복되는 것은 아닙니다. 구버전 재설치를 임의로 진행하지 말고 버전별 다운그레이드 제한과 사전 복구 계획을 확인합니다.
| 작업 구간 | 시작 / 종료 시간 | 결과 및 특이사항 | 작업자 |
|---|---|---|---|
| .27 교체 및 복귀 | |||
| .29 교체 및 복제 확인 | |||
| Primary 전환 .28 → .29 | |||
| .28 교체 및 복제 확인 | |||
| 최종 검증 / 서비스 재개 |
7. 공식 참고 문서
- MongoDB 7.0 패치 업그레이드 절차 — 백업, 사전 검증, 바이너리 교체, Secondary 우선 업그레이드
- Windows 설치 및 서비스 관리
- rs.stepDown() 동작 및 매개변수
- PSA 구성의 majority 쓰기 제약
- MongoDB 7.0 릴리스 노트