버전 5.0에서 변경되었습니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
중요
이 명령은 MongoDB Atlas 클러스터에서 지원되지 않습니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하세요.
구문
명령은 다음과 같은 구문을 가집니다:
db.adminCommand( { shutdown: 1, force: <boolean> timeoutSecs: <int>, comment: <any> } )
명령 필드
이 명령은 이러한 필드를 사용합니다.
필드 | 설명 |
|---|---|
| |
선택 사항. 을(를) 사용하여 진행 중인 인덱스 빌드를 일시 중지했다가 다시 시작할 수 | |
선택 사항. MongoDB 5.0부터
정지 기간은 다음과 같이 지정됩니다.
클라이언트는 종료되는 timeoutSecs는 초 단위로 기간을 지정합니다. 기본값 과 같습니다.
MongoDB 부터 5.0 | |
| 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
행동
mongod 자체 관리 배포서버에서 인증으로 시작한 의 경우 인증된 연결을 통해 shutdown 를 실행 해야 합니다. 자세한 내용은 액세스 제어를 참조하세요.
자체 관리 mongod 배포서버에서 인증 없이 시작된 의 경우 로컬 호스트 인터페이스에 연결된 클라이언트 shutdown --host "127.0.0.1" 에서 를 실행 mongosh 해야 합니다. 예시 들어 과 동일한 호스팅하다 머신에서 mongod 옵션을 사용하여 를 실행 .
shutdown 복제본 세트 멤버
복제본 세트shutdown 멤버가 인덱스 빌드와 같은 특정 작업을 실행 경우 가 실패합니다.force: true를 지정하여 멤버가 인덱스 빌드 진행 상황을 디스크에 저장하도록 할 mongod 수 있습니다. 는 다시 시작될 때 인덱스 빌드 복구하고 저장된 체크포인트 부터 계속 진행합니다.
복제본 세트 프라이머리, 세컨더리 또는 [mongos] 종료 mongos
MongoDB 5.0부터 mongod 및 mongos는 종료하기 전에 진행 중인 모든 데이터베이스 작업이 완료될 수 있도록 정지 기간을 입력합니다.
mongod 프라이머리가 종료 요청을 받으면 프라이머리는 다음을 수행합니다.
휴지기에 들어갑니다.
남은 모든 데이터베이스 작업을 종료합니다.
종료합니다.
mongod 세컨더리 또는 mongos 종료 요청의 경우, 종료가 요청된 후 정지 기간이 입력됩니다.
정지 기간은 다음과 같이 지정됩니다.
또는 명령이 실행 된
shutdowndb.shutdownServer()경우timeoutSecs 필드 또는shutdownTimeoutMillisForSignaledShutdown서버 매개 변수(SIGTERM신호가mongod로 전송된 경우) 또는SIGTERM신호가mongos로 전송된 경우mongosShutdownTimeoutMillisForSignaledShutdown서버 매개변수입니다.
클라이언트는 종료되는 mongod 또는 mongos에 대해 새 연결을 열 수 없습니다.
timeoutSecs는 초 단위로 기간을 지정합니다. 기본값 과 같습니다.
MongoDB 5.0에서 15초.
MongoDB 5.0 이전 버전에서는 10초입니다.
mongod 는 다음과 같이 timeoutSecs를 사용합니다.
현재 노드 복제본 세트 의 프라이머리 노드 인 경우
mongod는 프라이머리 노드 물러나기 전에 투표 선택 가능 노드 따라잡을 수 있도록 timeoutSecs 필드 에 지정된 시간(초)까지 기다립니다. 따라잡기 시간에 대한 자세한 내용은 복제 지연 참조하세요.프라이머리 노드에서 물러난 후 현재 노드 상태 인 경우, 기존 작업을 완료할
SECONDARY수 있는 정지 기간으로 timeoutSecs 에 지정된 나머지 시간을 사용합니다. 새 작업은 다른 복제본 세트 노드로 전송됩니다.
MongoDB 부터 5.0 mongos 는 기존 작업을 완료할 수 있는 정지 기간으로 timeoutSecs를 사용합니다. 새 작업은 다른 노드로 mongos 전송됩니다. 5 이전의 MongoDB 버전에서.0, mongos 는 즉시 종료되며 timeoutSecs를 사용하지 않습니다.
경고
프라이머리 계정을 강제 종료하면 아직 세컨더리 계정으로 복제되지 않은 모든 쓰기가 롤백될 수 있습니다.
액세스 제어
자체 관리 배포서버에서 인증을 shutdown mongod 시행하는 에서 를 실행 하려면 인증된 사용자에게 shutdown 권한 있어야 합니다. 예시 를 들어 내장 역할 을 가진 사용자에게는 hostManager 적절한 권한이 있습니다.
예시
종료 mongod
db.adminCommand({ "shutdown" : 1 })
[mongod] 강제 종료 mongod
db.adminCommand({ "shutdown" : 1, "force" : true })
더 긴 시간 초과로 프라이머리 mongod 종료
db.adminCommand({ "shutdown" : 1, timeoutSecs: 60 })