Ops Manager 업그레이드
이 튜토리얼에서는 기존 Ops Manager 설치를 업그레이드하는 방법에 대해 설명합니다.
경로 업그레이드
경고
관리형 데이터베이스를 MongoDB 4.4 이상으로 업그레이드하기
Ops Manager 8.0 4.2 은(는)4.2 8.0 4.4MongoDB 4 4 이하 버전을 지원 하지않습니다. 4 4MongoDB 이하 버전을 사용 6 중이고 Ops Manager 으로 업그레이드 하려면 최소한 MongoDB 로0 업그레이드 해야 합니다. MongoDB 이상으로 업그레이드 하지 않는 경우., Ops Manager 가 실행 전 검사에 실패하여 시작되지 않습니다. MongoDB 이상으로 업그레이드한 후. , 여전히 최소한 MongoDB 로 업그레이드 하는 것이 8 좋습니다. Ops Manager 로 업그레이드하기0 전 . .
기존 Ops Manager 설치 버전에 따라 Ops Manager 4.4 이상으로 업그레이드하기 위해 수행해야 하는 업그레이드 경로가 결정됩니다.
중요
동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 MongoDB Ops Manager 호스트가 있는 MongoDB Ops Manager 4.2 이상 버전이 설치되어 있는 경우 모니터링 다운타임 없이 MongoDB Ops Manager 를 업그레이드할 수 있습니다. 이 업그레이드 중에 MongoDB Ops Manager 는 업그레이드 모드 상태로 전환됩니다. 자세한 내용은 업그레이드 모드 를 참조하세요.
성공적으로 업그레이드하려면 기존 버전에 대한 업그레이드 경로를 따라 필요한 데이터베이스 마이그레이션을 수행해야 합니다.
데이터를 보호하기 위해 Ops Manager는 버전 1.8.x 및 2.0.x에서 버전 3.4 이상으로 직접 업그레이드를 시작하지 않습니다.
Ops Manager에서는 다운그레이드 경로를 지원하지 않습니다.
참고
MongoDB Ops Manager 버전 6.0.x 이상에 대한 모든 업그레이드 는 동일한 절차를 사용합니다. 상위 버전으로 업그레이드하려면 먼저 이 절차를 통해 초기 버전의 사용 가능한 최신 패치로 업그레이드한 다음, 다시 이 절차를 통해 다음 버전으로 업그레이드해야 합니다. 다음 표에 특정 버전의 업그레이드 절차와 관련된 추가 정보가 있는 경우 먼저 검토하세요.
중요
라이브 마이그레이션(푸시) Ops Manager에서 관리 또는 모니터링하는 소스 배포에 대해 더 이상 사용되지 않거나 지원되지 않습니다.
MongoDB 6.0.+를 실행하는 소스 배포의 경우 Ops Manager에서 배포를 관리하거나 모니터링하는 버전에서는 실시간 마이그레이션 (푸시) 이 지원되지 않습니다.
Ops Manager에서 배포를 관리하거나 모니터링하는 MongoDB 5.0 및 이전 버전을 실행하는 소스 배포의 경우 실시간 마이그레이션 (푸시) 은 더 이상 사용되지 않습니다.
Cloud Manager에서 배포를 모니터링하는 MongoDB 6.0+를 실행하는 소스 배포의 경우, 실시간 마이그레이션(푸시)이 지원됩니다. 자세한 내용은 Cloud Manager에서 모니터링하는 MongoDB 클러스터를 Atlas로 실시간 마이그레이션을 참조하세요.
다음 표에는 모든 버전에 대한 업그레이드 경로가 나와 있습니다.
기존 버전 | 경로 업그레이드 |
---|---|
8.0.x | 이 절차를 사용하여 MongoDB Ops Manager 8.0.x에서 사용 가능한 최신 패치 버전인 8.0 으로 업그레이드 합니다. |
7.0.x | MongoDB Ops Manager 7.0.x에서 사용 가능한 최신 패치 버전인 7.0으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 8.0 로 업그레이드합니다. 두 업그레이드 모두 이 절차 를 사용합니다. |
6.0.x | MongoDB Ops Manager 6.0.x에서 사용 가능한 최신 패치 버전인 6.0으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 7.0 로 업그레이드합니다. 두 업그레이드 모두 이 절차 를 사용합니다. |
5.0.x | MongoDB Ops Manager 5.0.x에서 사용 가능한 최신 패치 버전인 5.0으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 6.0 로 업그레이드합니다. 두 프로세스 모두에 이 절차 를 사용합니다. |
4.4.x | MongoDB Ops Manager 4.4.x에서 사용 가능한 최신 패치 버전인 4.4으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 5.0 로 업그레이드합니다. 두 프로세스 모두에 이 절차 를 사용합니다. 중요: MongoDB Ops Manager 버전 4.4.13 업그레이드 중에 쓰기에API 인스턴스를 다시 활성화하는 MongoDB Ops Manager 버그를 수정합니다. 자세한 내용은 다음을 참조하세요. |
4.2.x | MongoDB Ops Manager 4.2.x에서 사용 가능한 최신 패치 버전인 4.2으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 4.4 로 업그레이드합니다. 두 프로세스 모두에 이 절차 를 사용합니다. 4.2.24 이전 버전으로 업그레이드할 때 의도하지 않은 일시적인 TLS 비활성화가 발생할 수 있습니다. 먼저 4.2.24 이상으로 업그레이드하면 이러한 결과가 발생하지 않습니다. 자세한 내용은 다음을 참조하세요. |
4.0.x | v4.2 업그레이드 튜토리얼 을 사용하여 MongoDB Ops Manager 4.0.x에서 버전 4.2.24 이상으로 업그레이드합니다. 그런 다음 이 절차 에 따라 사용 가능한 최신 버전의 4 로 업그레이드합니다.2. 4.2.24 이전 버전으로 업그레이드할 때 의도하지 않은 일시적인 TLS 비활성화가 발생할 수 있습니다. 먼저 4.2.24 이상으로 업그레이드하면 이러한 결과가 발생하지 않습니다. 자세한 내용은 다음을 참조하세요. |
3.6.x | v4.0 업그레이드 튜토리얼 을 사용하여 MongoDB Ops Manager 3.6.x에서 버전 4.0.x로 업그레이드합니다. |
3.4.x | v3.6 업그레이드 튜토리얼 을 사용하여 MongoDB Ops Manager 3.4.x에서 버전 3.6.x로 업그레이드합니다. |
2.x 이전 버전 | v3.4 업그레이드 튜토리얼 을 사용하여 MongoDB Ops Manager 2.x 이하에서 업그레이드합니다. |
경고
기존 설정 및 가용성을 유지하려면 현재 Ops Manager 인스턴스에서 다음을 백업하세요.
conf-mms.properties
및gen.key
파일을 안전한 위치 에 .conf-mms.properties
는 MongoDB Ops Manager 인스턴스 에 대한 설정을 저장합니다. gen.key 는 Ops Manager 데이터베이스 백업 와 사용자 자격 증명 을 암호화 및 해독하기 위한 세부 정보를 제공합니다. MongoDB Ops Manager 는 업그레이드 프로세스 의 일부로 이러한 파일을 삭제 수 있습니다.
예비 예방 조치로 mongodump
를 사용하여 애플리케이션 데이터베이스 의 바이너리 내보내기를 만들 수 있습니다. 애플리케이션 데이터베이스에 대해 공식적으로 지원되는 백업 방법은 없습니다. 업그레이드 가 실패하면 MongoDB 지원팀 에 문의하여 MongoDB Ops Manager 버전 관련 문제를 해결하는 데 도움을 받으세요.
고려 사항
MongoDB Ops Manager 를 7.0 에서 8.0으로 업그레이드하기 전에 다음 고려 사항을 검토하세요.
백업 데이터베이스
MongoDB Ops Manager 8.0.0 데이터베이스 MongoDB 6.0.0 MongoDB Ops Manager 백업 에는 최소 이(가) 필요합니다.
참고
Ops Manager 백업 데이터베이스의 MongoDB 버전은 Ops Manager보다 이후 버전이어서는 안 됩니다.
호환되는 MongoDB 도구
Ops Manager가 MongoDB 도구를 관리하는 경우 Ops Manager를 업그레이드하면 도구 버전이 업그레이드됩니다.
MongoDB Ops Manager 8.0 MongoDB 로컬 versions
모드 에서.x를 실행 하는 경우 디렉토리 에 호환되는 버전의 도구 TGZ 패키지 를 다운로드 하여 설치 해야 합니다.
이전 버전의 MongoDB 도구에 액세스하려면 다운로드 페이지에서 아카이브된 릴리스를 클릭하세요.
Ops Manager 플랫폼 지원
RedHat Enterprise Linux 7에 대한 Ops Manager 지원을 중단합니다.
SUSE Linux Enterprise Server 12에 대한 Ops Manager 지원을 제거합니다.
Ubuntu 20.04 LTS에 대한 Ops Manager 지원을 제거합니다.
중요
Amazon Linux v2 LTS에 대한 Ops Manager 지원을 중단합니다.
Debian 11에 대한 Ops Manager 지원을 중단합니다.
자동화 지원 변경 사항
MongoDB 버전 4.2 및 이전 버전의 자동화, 모니터링 및 백업에 대한 지원 을 제거합니다. MongoDB Ops Manager 는 MongoDB 4.4 이상을 실행 하는 데이터베이스만 관리 수 있습니다.
중요
MongoDB 버전 5.0 및 이전 버전의 자동화, 모니터링 및 백업에 대한 지원 을 중단합니다.
참고
구성 샤드 를 사용할 때는쿼리 가능 백업 이 지원되지 않습니다.
전제 조건
하드웨어 및 소프트웨어 요구 사항
서버가 Ops Manager 시스템 요구 사항을 충족해야 합니다.
경고
생산 실패 가능성
다음을 구성하지 못하면 Ops Manager 인스턴스가 프로덕션에서 실패할 수 있습니다.
Ops Manager 시스템 요구 사항에 따른 Ops Manager 호스트
MongoDB 매뉴얼의 프로덕션 노트에 따른 MongoDB 호스트입니다. Ops Manager의 MongoDB 인스턴스에는 다음이 포함됩니다.
Ops Manager Application Database,
각 블록 저장소
업그레이드 프로세스 를 시작하기 전에 모든 데이터 보유 멤버가 실행 확인합니다. 복제본 세트 멤버의 상태를 확인하려면 replSetGetStatus
를 실행 합니다.
백업 데이터베이스가 MMAPv1 storage engine 을 실행하는 경우 업그레이드 프로세스가 실패합니다. MongoDB Ops Manager는 백업 데이터베이스의 storage engine 을 WiredTiger 로 업그레이드하라는 메시지를 표시합니다.
관리자 권한
업그레이드를 수행하는 서버에 대한 관리자 권한이 있어야 합니다.
MongoDB에서 소프트웨어 다운로드
소프트웨어를 다운로드하려면 고객 다운로드 페이지에 있는 다운로드 링크를 클릭하세요. MongoDB는 고객에게 해당 페이지의 URL을 제공합니다.
이 링크에 액세스할 수 없는 경우 다운로드 페이지를 방문하여 Ops Manager 소프트웨어의 최신 평가판을 다운로드하세요.
이전 버전의 MongoDB Ops Manager 소프트웨어가 필요한 경우 릴리스 아카이브를 방문하세요.
로컬 모드에서 실행할 소프트웨어 다운로드
로컬 모드에서 Ops Manager를 실행하려는 경우, 버전 라이브러리 디렉토리에 MongoDB 소프트웨어를 다운로드하세요. 필수 소프트웨어에는 다음이 포함됩니다.
설치하려는 MongoDB Community 또는 Enterprise의 모든 버전
MongoDB 도구. MongoDB 도구의 버전은 Ops Manager 릴리스 노트에 나열된 버전 중 사용 중인 Ops Manager 버전과 호환되는 것과 일치해야 합니다.
플랫폼 호환성
Ops Manager를 업그레이드하기 전에 다음을 확인하세요.
Ops Manager를 제공하는 호스트의 플랫폼이 5.0과 호환되는지 여부
MongoDB 배포를 관리하는 MongoDB Agent가 Ops Manager 5.0과 호환되는지 여부
Ops Manager 에이전트에 서비스를 제공하는 호스트의 플랫폼이 Agent와 호환되는지 여부
BI Connector 를 사용하는 경우 MongoDB 를 4.4 이상으로 업그레이드 합니다.
MongoDB Agent 호스트용 플랫폼을 업그레이드한 경우 Ops Manager를 업그레이드하기 전에 MongoDB Agent를 업그레이드 하세요.
절차
참고
고가용성 애플리케이션의 업그레이드 모드
동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 모니터링 다운타임 없이 Ops Manager를 업그레이드할 수 있습니다. Ops Manager는 업그레이드 중 업그레이드 모드 상태로 전환됩니다. 이 모드를 사용하면 업그레이드 프로세스 전반에서 다음과 같은 이점이 있습니다.
경고 및 운영 모니터링
Ops Manager 인스턴스를 계속 활성 상태로 유지
Ops Manager 애플리케이션을 읽기 전용 모드로 액세스
데이터를 쓰거나 삭제하는 Ops Manager API가 비활성화됨
Ops Manager 인스턴스는 모든 Ops Manager 호스트가 업그레이드되고 다시 시작될 때까지 업그레이드 모드로 유지됩니다.
한 번에 두 개 이상의 Ops Manager 호스트를 업그레이드해서는 안 됩니다.
Ops Manager가 업그레이드 모드로 전환되면 백업 데몬이 자체 중지를 시도합니다. 데몬이 긴 백업 작업을 진행 중인 경우 이 프로세스가 실패할 수 있습니다. 이 경우 다음 중 하나를 수행하세요.
백업 데몬이 작업을 완료하면 첫 번째 Ops Manager 인스턴스를 다시 시작합니다.
백업 데몬을 수동으로 중지합니다.
백업 데몬을 수동으로 중지하려면 다음을 수행합니다.
백업 데몬을 제공하는 첫 번째 호스트에 로그인합니다.
다음 명령을 실행합니다.
sudo service mongodb-mms-backup-daemon stop 다음과 같이 백업 데몬을 종료했는지 확인합니다.
ps -ef | grep mongodb-mms-backup-daemon 백업 데몬이 계속 실행 중이면 다음 명령을 실행합니다.
sudo /etc/init.d/mongodb-mms-backup-daemon stop 다른 모든 백업 데몬 호스트에 2~3단계를 반복합니다.
백업 데몬을 제공하는 첫 번째 호스트에 로그인합니다.
다음 명령을 실행합니다.
sudo service mongodb-mms-backup-daemon stop 다음과 같이 백업 데몬을 종료했는지 확인합니다.
ps -ef | grep mongodb-mms-backup-daemon 백업 데몬이 계속 실행 중이면 다음 명령을 실행합니다.
sudo /etc/init.d/mongodb-mms-backup-daemon stop 다른 모든 백업 데몬 호스트에 2~3단계를 반복합니다.
백업 데몬을 제공하는 첫 번째 호스트에 로그인합니다.
다음 명령을 실행합니다.
<install_dir>/bin/mongodb-mms-backup-daemon stop 다음과 같이 백업 데몬을 종료했는지 확인합니다.
ps -ef | grep mongodb-mms-backup-daemon 백업 데몬이 계속 실행 중이면 다음 명령을 실행합니다.
sudo /etc/init.d/mongodb-mms-backup-daemon stop 다른 모든 백업 데몬 호스트에 2~3단계를 반복합니다.
고가용성 구성 에서 Ops Manager 애플리케이션을 실행하는 경우 한 번에 하나의 Ops Manager 호스트에서 이 절차를 완료하세요.
deb
패키지를 사용하여 설치된 호스트에서 Ops Manager 애플리케이션을 업그레이드하려면 다음 절차를 사용하세요.
최신 버전의 Ops Manager 패키지를 다운로드하세요.
선호하는 브라우저를 열어 MongoDB.com의 MongoDB Download Center 를 방문합니다.
MongoDB.com에서 시작하는 경우 Products Ops Manager Try it now 를 클릭하십시오.
Platforms 드롭다운 메뉴에서 Ubuntu 22.04을 클릭합니다.
Packages 드롭다운 메뉴에서 x86_64 아키텍처를 위해 DEB 을 클릭합니다.
Download를 클릭합니다.
다운로드한 패키지의 이름은
mongodb-mms-<version>.x86_64.deb
이며, 여기서<version>
은 버전 번호입니다.
업그레이드하려는 호스트에 Ops Manager 패키지를 설치합니다.
참고
고가용성 Ops Manager 애플리케이션을 위한 업그레이드 모드
동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 이 Ops Manager 배포가 고가용성으로 실행됩니다. 고가용성 Ops Manager 배포의 Ops Manager 호스트 하나를 업그레이드하면 해당 배포는 업그레이드 모드로 전환됩니다.
각 Ops Manager 애플리케이션 및 백업 데몬 호스트에
.deb
패키지를 설치합니다. 다음 명령을 실행합니다. 여기서<version>
은(는).deb
패키지의 버전입니다.sudo dpkg -i mongodb-mms_<version>_x86_64.deb 현재 설치된
mms.conf
버전을 덮어쓸지 묻는 메시지가 표시되면Y
를 입력하여 기존 파일을 바꿔야 합니다.Ops Manager가 사용하는 포트 또는 JVM 설정을 수정한 경우, 운영 관리자가 업그레이드된 후
mms.conf
파일에 해당 변경 사항을 다시 적용해야 합니다.경고
mms.conf
파일 의 JVM 인수에 비밀번호나 시크릿을 추가하지 마세요. MongoDB Ops Manager 는 이를 진단 아카이브에 일반 텍스트로 노출합니다.Ops Manager가 4.1 및 4.2로 업그레이드되면서
JAVA_MMS_UI_OPTS
매개 변수에서-d64
플래그가 제거되었습니다.Ops Manager 4.4.11로 업그레이드할 때 Ops Manager가 사용할
/opt/mongodb/mms/conf/conf-mms.properties
파일 버전을 선택하라는 메시지가 표시됩니다. Ops Manager를 수동으로 재구성하지 않으려면 현재 파일을 선택합니다. 자세한 내용은 4.4.11 릴리스 노트를 참조하세요.
업그레이드된 호스트에서 Ops Manager를 시작합니다.
sudo service mongodb-mms start
참고
고가용성 Ops Manager 인스턴스에서 백업 데몬은 시작하기 전에 모든 노드가 업그레이드될 때까지 대기합니다.
업그레이드된 Ops Manager 호스트가 다시 시작된 후 로그인합니다. 로그인에 성공하면 업그레이드가 완료된 것입니다.
모든 에이전트를 업데이트합니다.
업그레이드가 완료되면 Ops Manager 인스턴스에 로그인합니다. Ops Manager에 One or more agents are out of date라는 배너가 표시됩니다.
Update All Agents을(를) 클릭한 다음 변경 사항을 확인합니다.Update All Agents
중요
Ops Manager가 MongoDB 도구를 관리하는 경우, 도구 버전은 에이전트와 함께 업그레이드됩니다.
Ops Manager가 BI Connector를 관리하는 경우 BI Connector 버전은 에이전트와 함께 업그레이드됩니다.
rpm
패키지를 사용하여 설치된 호스트에서 Ops Manager 애플리케이션을 업그레이드하려면 다음 절차를 사용하세요.
실행 중인 첫 번째 Ops Manager 인스턴스를 중지합니다.
systemd 를 사용하는 RHEL, , 호스트에서CentOS SUSE12, 다음 명령을 실행하여 MongoDB Ops Manager 애플리케이션을 중지합니다.
sudo service mongodb-mms stop
SysVInit
을(를) 사용하는 플랫폼의 경우 다음 명령을 실행합니다.
sudo /etc/init.d/mongodb-mms stop
최신 버전의 Ops Manager 패키지를 다운로드하세요.
선호하는 브라우저를 열어 MongoDB.com에서 MongoDB Download Center를 방문합니다.
MongoDB.com에서 시작하는 경우 Products Ops Manager Try it now 를 클릭하십시오.
Platforms 드롭다운 메뉴에서 다음 옵션 중 하나를 클릭합니다.
Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023
Packages드롭다운 메뉴에서 RPM을 클릭합니다.
Download를 클릭합니다.
다운로드한 패키지의 이름은
mongodb-mms-<version>.x86_64.rpm
이며, 여기서<version>
은 버전 번호입니다.
업그레이드하려는 MongoDB Ops Manager 호스팅하다 에 MongoDB Ops Manager 패키지 를 설치합니다.
참고
고가용성 Ops Manager 애플리케이션을 위한 업그레이드 모드
동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 이 Ops Manager 배포가 고가용성으로 실행됩니다. 고가용성 Ops Manager 배포의 Ops Manager 호스트 하나를 업그레이드하면 해당 배포는 업그레이드 모드로 전환됩니다.
업그레이드된 MongoDB Ops Manager 호스팅하다 에 .rpm
패키지 를 설치하려면 다음 명령을 실행합니다(여기서 <version>
은 MongoDB Ops Manager 버전).
sudo rpm -Uvh mongodb-mms-<version>.x86_64.rpm
경고
rpm
Ops Manager 버전 6.0.0, 6.0.1 및 6.0.2용 패키지에는 표준 업그레이드가 실패할 수 있는 잘못된 버전 정보가 포함되어 있습니다. 이러한 버전 중 하나에서 버전 6.0.3 이상으로 업그레이드하는 경우 --force
플래그를 사용하여 패키지를 업그레이드합니다.
sudo rpm -Uvh --force mongodb-mms-<version>.x86_64.rpm
MongoDB Ops Manager 5.0.x로 업그레이드하는 경우, MongoDB Ops Manager 는 현재 /opt/mongodb/mms/conf/conf-mms.properties
파일 을 유지합니다. MongoDB Ops Manager 는 이 버전으로 설치된 conf-mms.properties
을(를) /opt/mongodb/mms/conf/conf-mms.properties.rpmnew
(으)로 저장합니다.
경고
mms.conf
파일 의 JVM 인수에 비밀번호나 시크릿을 추가하지 마세요. MongoDB Ops Manager 는 이를 진단 아카이브에 일반 텍스트로 노출합니다.
init
파일을 심볼릭 링크로 바꾸기
다음 기존 파일은 RPM을 사용한 MongoDB Ops Manager 4.2 설치의 업그레이드를 차단 합니다.
/etc/init.d/mongodb-mms
/etc/init.d/mongodb-mms-backup-daemon
업그레이드 를 완료하려면 다음을 수행합니다.
다음 명령을 실행하여 이전
init
파일을 이동합니다.sudo mv /etc/init.d/mongodb-mms /etc/init.d/mongodb-mms-5.0 sudo mv /etc/init.d/mongodb-mms-backup-daemon /etc/init.d/ mongodb-mms-backup-daemon-5.0 sudo mv /etc/init.d/mongodb-mms /etc/init.d/mongodb-mms-6.0 sudo mv /etc/init.d/mongodb-mms-backup-daemon /etc/init.d/ mongodb-mms-backup-daemon-6.0 다음 명령을 실행하여 MongoDB Ops Manager 파일을
init
파일에 기호로 연결합니다.sudo ln -s /opt/mongodb/mms/bin/mongodb-mms /etc/init.d/mongodb-mms sudo ln -s /opt/mongodb/mms/bin/mongodb-mms-backup-daemon /etc/init.d/mongodb-mms-backup-daemon
업그레이드된 호스트에서 Ops Manager를 시작합니다.
systemd 를 사용하는 RHEL, CentOS, SUSE 호스트에서12 , 다음 명령을 실행합니다.
sudo service mongodb-mms start
SysVInit
을(를) 사용하는 플랫폼의 경우 다음 명령을 실행합니다.
sudo /etc/init.d/mongodb-mms start
참고
MongoDB Ops Manager가 시작 시 생성하는 로그가 MongoDB Ops Manager가 모든 서버를 동일한 버전으로 업그레이드하는 동안 Starting pre-flight checks
에서 일시적으로 일시 중지될 수 있습니다.
모든 에이전트를 업데이트합니다.
업그레이드가 완료되면 Ops Manager 인스턴스에 로그인합니다. Ops Manager에 One or more agents are out of date라는 배너가 표시됩니다.
Update All Agents을(를) 클릭한 다음 변경 사항을 확인합니다.Update All Agents
중요
Ops Manager가 MongoDB 도구를 관리하는 경우, 도구 버전은 에이전트와 함께 업그레이드됩니다.
Ops Manager가 BI Connector를 관리하는 경우 BI Connector 버전은 에이전트와 함께 업그레이드됩니다.
이 절차에 따라 deb
또는 rpm
패키지를 사용하지 않는 Linux 시스템을 업그레이드 할 수 있습니다.
MongoDB Ops Manager 호스팅하다 에 구성 파일을 백업합니다.
업그레이드하려는 MongoDB Ops Manager 호스팅하다 에서 기존 구성 파일과 로그를 설치 디렉토리 이외의 디렉토리 에 백업합니다.
중요
이 절차의 뒷부분을 위해 백업된 <install_dir>/conf/conf-mms.properties
파일 이 필요합니다.
예시
다음 명령은 구성 파일과 로그를 홈 디렉토리 에 백업합니다.
cp -a <install_dir>/conf ~/mms_conf.backup cp -a <install_dir>/logs ~/mms_logs.backup
Versions Directory
가 <install_dir>
에 있으면 백업합니다.
cp -a <install_dir>/mongodb-releases ~/mms_versions.backup
또한 MongoDB Ops Manager 가 MongoDB Ops Manager 의 데이터베이스 백업 및 사용자 자격 증명 을 암호화하고 해독하는 데 사용하는 gen.key
파일 을 백업해야 합니다. MongoDB Ops Manager 를 사용하려면 고가용성 MongoDB Ops Manager 배포서버 의 일부인 모든 서버 에 동일한 gen.key
파일 이 필요합니다.
최신 버전의 Ops Manager 패키지를 다운로드하세요.
선호하는 브라우저를 열어 MongoDB.com에서 MongoDB Download Center를 방문합니다.
MongoDB.com에서 시작하는 경우 Products Ops Manager Try it now 를 클릭하십시오.
Version 드롭다운 메뉴에서 제공된 안정적인 버전 중 하나를 클릭합니다.
Platform 드롭다운 메뉴에서 다음 옵션 중 하나를 클릭합니다.
Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023
Debian 9, 10, 11 / Ubuntu 18.04
Package드롭다운 메뉴에서 tar.gz을 클릭합니다.
Download를 클릭합니다.
다운로드한 패키지의 이름은
mongodb-mms-<version>.x86_64.tar.gz
이며, 여기서<version>
은 버전 번호입니다.
업그레이드하려는 각 호스팅하다 에 MongoDB Ops Manager 패키지 를 설치합니다.
참고
고가용성 Ops Manager 애플리케이션을 위한 업그레이드 모드
동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 이 Ops Manager 배포가 고가용성으로 실행됩니다. 고가용성 Ops Manager 배포의 Ops Manager 호스트 하나를 업그레이드하면 해당 배포는 업그레이드 모드로 전환됩니다.
MongoDB Ops Manager 를 설치하려는 디렉토리 로 이동합니다. 해당 디렉토리 에 아카이브를 추출합니다.
tar -zxf mongodb-mms-<version>.x86_64.tar.gz
중요
이전 버전과 동일한 디렉토리 에 새 버전을 설치하려면 다음 단계를 따르세요.
현재 설치 디렉토리 의 이름을 변경합니다.
mv <install_dir> <install_dir_old> 이전 디렉토리 의 원래 이름으로 새 디렉토리 를 만듭니다.
mkdir <install_dir>
이렇게 하면 빈 설치 디렉토리 및 코드 라이브러리 충돌을 방지할 수 있습니다.
각 MongoDB Ops Manager 호스팅하다 에서 백업된 로그와 구성 파일을 MongoDB Ops Manager 설치 디렉토리 로 복원 합니다.
모든 로그 파일을 복원해야 합니다. 전부는 아니지만 대부분의 구성 파일 을 복원해야 합니다. 복원:
conf-mms.properties
- 이 배포서버 서버에 대한 설정 입니다.MongoDB Ops Manager
gen.key
- 이 MongoDB Ops Manager 배포서버 의 데이터베이스 백업 에 대한 암호화 키 입니다.
예시
이 명령은 홈 디렉토리 에서 구성 파일과 로그를 복원 합니다.
cp -a ~/mms_logs.backup <install_dir>/logs cp -a ~/mms_conf.backup/conf-mms.properties <install_dir>/conf/conf-mms.properties cp -a ~/mms_conf.backup/gen.key <install_dir>/conf/gen.key
이전에 Versions Directory
를 백업한 경우 <install_dir
>에 복원 합니다.
cp -a ~/mms_versions.backup <install_dir>/mongodb-releases.
참고
고가용성 Ops Manager 인스턴스에서 백업 데몬은 시작하기 전에 모든 노드가 업그레이드될 때까지 대기합니다.
선택 사항. 각 MongoDB Ops Manager MongoDB Ops Manager 서버 에서 필요한 변경 사항을 mms.conf
백업 의 파일 에 병합합니다.
mms.conf
파일 은 포트 및 JVM 구성 설정을 포함하고 있으므로 거의 사용자 지정되지 않습니다. 가 사용 하는 포트 또는 JVM 설정을 수정한 MongoDB Ops Manager 경우, 를 업그레이드한 후 백업 복사본의 변경 사항을 mms.conf
파일 에 다시 적용해야 MongoDB Ops Manager 합니다.
경고
mms.conf
파일 의 JVM 인수에 비밀번호나 시크릿을 추가하지 마세요. MongoDB Ops Manager 는 이를 진단 아카이브에 일반 텍스트로 노출합니다.
Ops Manager가 4.1 및 4.2로 업그레이드되면서 JAVA_MMS_UI_OPTS
매개 변수에서 -d64
플래그가 제거되었습니다.
모든 에이전트를 업데이트합니다.
업그레이드가 완료되면 Ops Manager 인스턴스에 로그인합니다. Ops Manager에 One or more agents are out of date라는 배너가 표시됩니다.
Update All Agents을(를) 클릭한 다음 변경 사항을 확인합니다.Update All Agents
중요
Ops Manager가 MongoDB 도구를 관리하는 경우, 도구 버전은 에이전트와 함께 업그레이드됩니다.
Ops Manager가 BI Connector를 관리하는 경우 BI Connector 버전은 에이전트와 함께 업그레이드됩니다.
문제 해결
인식할 수 없는 VM 옵션
이동 전 검사 출력 또는 스타트업 로그에 Unrecognized VM option 'UseParNewGC'
과 같은 오류가 포함되어야 합니다. 이 오류는 다음 파일 중 하나를 편집한 경우 발생할 수 있습니다.
/etc/rc.d/init.d/mongodb-mms
mms.conf
conf-mms.properties
이 문제를 해결하려면 구성 파일에서 -XX:+UseParNewGC
을 제거합니다.
구성 설정 변경
Ops Manager는 Linux 배포판 및 로컬 구성에 따라 업그레이드 시 구성 파일의 변경 사항을 대체할 수 있습니다. Ops Manager 5.0 이상에서 RPM 패키지를 사용하는 경우 업그레이드 시 Ops Manager가 더 이상 구성 파일을 업데이트하지 않습니다. 새 Ops Manager 버전의 구성 파일에 새 속성이 필요한 경우 업그레이드 시 해당 속성을 파일에 추가해야 합니다.
업그레이드할 때 mongo.mongoUri
값을 업데이트하여 MongoDB Java 드라이버를 통해 도입된 새 매개 변수를 포함시킵니다. 기본적으로 이 드라이버는 재시도 가능 읽기 및 재시도 가능 쓰기를 활성화합니다. 읽기 및 쓰기를 다시 시도하도록 사용자 지정 논리를 설정하면 시도 시간이 너무 오래 걸릴 수 있습니다. 이러한 기본값을 비활성화하려면 연결 문자열에 다음을 추가하세요.
예시
mongodb://SERVER:PORT/?maxPoolSize=150&retryWrites=false&retryReads=false
인식할 수 없는 VM 옵션
이동 전 검사 출력 또는 스타트업 로그에 Unrecognized VM option 'UseParNewGC'
과 같은 오류가 포함되어야 합니다. 이 오류는 다음 파일 중 하나를 편집한 경우 발생할 수 있습니다.
/etc/rc.d/init.d/mongodb-mms
mms.conf
conf-mms.properties
이 문제를 해결하려면 구성 파일에서 -XX:+UseParNewGC
을 제거합니다.
구성 설정 변경
Ops Manager는 Linux 배포판 및 로컬 구성에 따라 업그레이드 시 구성 파일의 변경 사항을 대체할 수 있습니다. Ops Manager 5.0 이상에서 RPM 패키지를 사용하는 경우 업그레이드 시 Ops Manager가 더 이상 구성 파일을 업데이트하지 않습니다. 새 Ops Manager 버전의 구성 파일에 새 속성이 필요한 경우 업그레이드 시 해당 속성을 파일에 추가해야 합니다.
인식할 수 없는 VM 옵션
이동 전 검사 출력 또는 스타트업 로그에 Unrecognized VM option 'UseParNewGC'
과 같은 오류가 포함되어야 합니다. 이 오류는 다음 파일 중 하나를 편집한 경우 발생할 수 있습니다.
/etc/rc.d/init.d/mongodb-mms
mms.conf
conf-mms.properties
이 문제를 해결하려면 구성 파일에서 -XX:+UseParNewGC
을 제거합니다.
구성 설정 변경
Ops Manager는 Linux 배포판 및 로컬 구성에 따라 업그레이드 시 구성 파일의 변경 사항을 대체할 수 있습니다. Ops Manager 5.0 이상에서 RPM 패키지를 사용하는 경우 업그레이드 시 Ops Manager가 더 이상 구성 파일을 업데이트하지 않습니다. 새 Ops Manager 버전의 구성 파일에 새 속성이 필요한 경우 업그레이드 시 해당 속성을 파일에 추가해야 합니다.
업그레이드할 때 mongo.mongoUri
값을 업데이트하여 MongoDB Java 드라이버를 통해 도입된 새 매개 변수를 포함시킵니다. 기본적으로 이 드라이버는 재시도 가능 읽기 및 재시도 가능 쓰기를 활성화합니다. 읽기 및 쓰기를 다시 시도하도록 사용자 지정 논리를 설정하면 시도 시간이 너무 오래 걸릴 수 있습니다. 이러한 기본값을 비활성화하려면 연결 문자열에 다음을 추가하세요.
예시
mongodb://SERVER:PORT/?maxPoolSize=150&retryWrites=false&retryReads=false
불법 반환 액세스
이 경고는 Ops Manager에서 사용하는 Guice 라이브러리의 버전으로 인해 표시된 것입니다. 이 경고는 무시해도 됩니다.