Docs Menu
Docs Home
/
MongoDB Ops Manager
/

Ops Manager 업그레이드

이 페이지의 내용

  • 경로 업그레이드
  • 고려 사항
  • 전제 조건
  • 절차
  • 문제 해결

이 튜토리얼에서는 기존 Ops Manager 설치를 업그레이드하는 방법에 대해 설명합니다.

경고

관리형 데이터베이스를 MongoDB 3.6 이상으로 업그레이드

Ops Manager 6.0은 MongoDB 3.4를 지원하지 않습니다. 사용 중인 버전 3.4 이하의 MongoDB를 Ops Manager 6.0으로 업그레이드하려면 최소한 MongoDB 3.6으로 업그레이드해야 합니다. 그러나 Ops Manager 6.0으로 업그레이드하기 전에 MongoDB 4.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 버전 4.2.x 이상에 대한 모든 업그레이드 는 동일한 절차를 사용합니다. 상위 버전으로 업그레이드하려면 먼저 이 절차를 통해 초기 버전의 사용 가능한 최신 패치로 업그레이드한 다음, 다시 이 절차를 통해 다음 버전으로 업그레이드해야 합니다. 다음 표에 특정 버전의 업그레이드 절차와 관련된 추가 정보가 있는 경우 먼저 검토하세요.

중요

라이브 마이그레이션(푸시) Ops Manager에서 관리 또는 모니터링하는 소스 배포에 대해 더 이상 사용되지 않거나 지원되지 않습니다.

  • MongoDB 6.0.+를 실행하는 소스 배포의 경우 Ops Manager에서 배포를 관리하거나 모니터링하는 버전에서는 실시간 마이그레이션 (푸시) 이 지원되지 않습니다.

  • Ops Manager에서 배포를 관리하거나 모니터링하는 MongoDB 5.0 및 이전 버전을 실행하는 소스 배포의 경우 실시간 마이그레이션 (푸시) 은 더 이상 사용되지 않습니다.

  • Cloud Manager에서 배포를 모니터링하는 MongoDB 6.0+를 실행하는 소스 배포의 경우, 실시간 마이그레이션(푸시)이 지원됩니다. 자세한 내용은 Cloud Manager에서 모니터링하는 MongoDB 클러스터를 Atlas로 실시간 마이그레이션을 참조하세요.

다음 표에는 모든 버전에 대한 업그레이드 경로가 나와 있습니다.

기존 버전
경로 업그레이드
7.0.x

이 절차를 사용하여 MongoDB Ops Manager 7.0.x에서 사용 가능한 최신 패치 버전인 7.0 으로 업그레이드 합니다.

학습 내용은 Ops Manager 7.0 출시하다 노트를 참조하세요.

6.0.x

MongoDB Ops Manager 6.0.x에서 사용 가능한 최신 패치 버전인 6.0으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 7.0 로 업그레이드합니다. 두 업그레이드 모두 이 절차 를 사용합니다.

학습 내용은 Ops Manager 6.0 출시하다 노트를 참조하세요.

5.0.x

MongoDB Ops Manager 5.0.x에서 사용 가능한 최신 패치 버전인 5.0으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 6.0 로 업그레이드합니다. 두 프로세스 모두에 이 절차 를 사용합니다.

학습 내용은 Ops Manager 5.0 출시하다 노트를 참조하세요.

4.4.x

MongoDB Ops Manager 4.4.x에서 사용 가능한 최신 패치 버전인 4.4으로 업그레이드합니다. 그런 다음 사용 가능한 최신 버전의 5.0 로 업그레이드합니다. 두 프로세스 모두에 이 절차 를 사용합니다.

중요: Ops Manager 버전 4.4.13 은 업그레이드 중에 API 쓰기에 대해 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.propertiesgen.key 파일을 안전한 위치에 저장합니다. conf-mms.properties 는 Ops Manager 인스턴스에 대한 설정을 저장합니다. gen.key 는 Ops Manager 백업 데이터베이스와 사용자 자격 증명을 암호화하고 해독하기 위한 세부 정보를 제공합니다. Ops Manager는 업그레이드 프로세스의 일부로 이러한 파일을 삭제할 수 있습니다.

추가 예방 조치로 mongodump 를 사용하여 애플리케이션 데이터베이스 의 바이너리 내보내기를 만들 수 있습니다. 애플리케이션 데이터베이스에 대해 공식적으로 지원되는 백업 방법은 없습니다. 업그레이드에 실패하면 MongoDB 지원팀 에 문의하여 Ops Manager 버전 관련 문제를 해결하는 데 도움을 받으세요.

Ops Manager를 6.0에서 7.0으로 업그레이드하기 전에 다음 고려 사항을 검토하세요.

Ops Manager 7.0.0 은 Ops Manager 백업 데이터베이스에 최소 MongoDB 5.0.0이 필요합니다.

참고

Ops Manager 백업 데이터베이스의 MongoDB 버전은 Ops Manager보다 이후 버전이어서는 안 됩니다.

Ops Manager가 MongoDB 도구를 관리하는 경우 Ops Manager를 업그레이드하면 도구 버전이 업그레이드됩니다.

Ops Manager 7 을(를) 실행하는 경우.0.x가 로컬 모드 인 경우, versions 디렉토리 에 호환되는 버전의 MongoDB 도구 TGZ 패키지를 다운로드하여 설치 해야 합니다.

Ops Manager 서버 버전
호환되는 MongoDB 데이터베이스 도구 버전

이전 버전의 MongoDB 도구에 액세스하려면 다운로드 페이지에서 아카이브된 릴리스를 클릭하세요.

  • Debian 10에 대한 Ops Manager 및 MongoDB Agent 지원을 제거합니다.

  • Ubuntu 18.04 LTS에 대한 Ops Manager 및 MongoDB Agent 지원을 제거합니다.

중요

Ops Manager 7.0은 RedHat Enterprise Linux 7, SUSE Linux Enterprise Server 12 및 Ubuntu 20.04 LTS에 대한 지원을 중단합니다.

  • MongoDB 버전 4.0 이하의 자동화, 모니터링 및 백업에 대한 지원을 제거합니다. Ops Manager는 MongoDB 4.2 이상을 실행하는 데이터베이스만 관리할 수 있습니다.

  • SNMP 경고에 대한 지원을 제거합니다.

    • 대신 Ops Manager로 클러스터를 모니터링할 수 있습니다. 다른 경고 옵션에 대해 알아보려면 타사 서비스 통합을 참조하세요.

  • 샤딩된 컬렉션 관리 UI에 대한 지원을 제거합니다.

    • UI를 통해 컬렉션을 샤딩하고, 샤딩된 클러스터 밸런서를 관리하고, 샤드 구역을 관리하는 기능을 제거합니다. mongosh를 사용하면 명령줄을 통해 가용 샤딩된 클러스터를 계속해서 완전히 제어할 수 있습니다.

  • Ops Manager에서 MongoDB 클라우드 마이그레이션 서비스에 대한 지원을 제거합니다. 푸시 기반 마이그레이션을 사용하여 배포를 MongoDB Atlas로 마이그레이션해야 하는 경우 MongoDB Cloud Manager에서 클라우드 마이그레이션 서비스를 사용할 수 있습니다.

  • Internet Explorer 11에 대한 지원을 제거합니다.

  • mms.userSvcClass 설정에 대한 애플리케이션 데이터베이스 인증 방법을 나타내는 허용 값을 com.xgen.svc.mms.svc.user.UserSvcDb에서 com.xgen.cloud.user._private.svc.UserSvcDb로 업데이트합니다.

    중요

    이전에 허용된 값인 com.xgen.svc.mms.svc.user.UserSvcDb을 사용하면 실행 전 검사 도중에 Ops Manager 인스턴스가 시작되지 않습니다.

서버가 Ops Manager 시스템 요구 사항을 충족해야 합니다.

경고

생산 실패 가능성

다음을 구성하지 못하면 Ops Manager 인스턴스가 프로덕션에서 실패할 수 있습니다.

백업 데이터베이스가 MMAPv1 storage engine 을 실행하는 경우 업그레이드 프로세스가 실패합니다. MongoDB Ops Manager는 백업 데이터베이스의 storage engine 을 WiredTiger 로 업그레이드하라는 메시지를 표시합니다.

업그레이드를 수행하는 서버에 대한 관리자 권한이 있어야 합니다.

소프트웨어를 다운로드하려면 고객 다운로드 페이지에 있는 다운로드 링크를 클릭하세요. MongoDB는 고객에게 해당 페이지의 URL을 제공합니다.

로컬 모드에서 Ops Manager를 실행하려는 경우, 버전 라이브러리 디렉토리에 MongoDB 소프트웨어를 다운로드하세요. 필수 소프트웨어에는 다음이 포함됩니다.

Ops Manager를 업그레이드하기 전에 다음을 확인하세요.

  • Ops Manager를 제공하는 호스트의 플랫폼이 5.0과 호환되는지 여부

  • MongoDB 배포를 관리하는 MongoDB Agent가 Ops Manager 5.0과 호환되는지 여부

  • Ops Manager 에이전트에 서비스를 제공하는 호스트의 플랫폼이 Agent와 호환되는지 여부

  • BI Connector를 사용하는 경우 MongoDB를 4.0 이상으로 업그레이드하세요.

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 인스턴스를 다시 시작합니다.

  • 백업 디먼을 수동으로 중지합니다.

백업 디먼을 수동으로 중지하려면 다음을 수행합니다.

  1. 백업 디먼을 제공하는 첫 번째 호스트에 로그인합니다.

  2. 다음 명령을 실행합니다.

    sudo service mongodb-mms-backup-daemon stop
  3. 다음과 같이 백업 디먼을 종료했는지 확인합니다.

    ps -ef | grep mongodb-mms-backup-daemon

    백업 디먼이 계속 실행 중이면 다음 명령을 실행합니다.

    sudo /etc/init.d/mongodb-mms-backup-daemon stop
  4. 다른 모든 백업 디먼 호스트에 2~3단계를 반복합니다.

  1. 백업 데몬을 제공하는 첫 번째 호스트에 로그인합니다.

  2. 다음 명령을 실행합니다.

    sudo service mongodb-mms-backup-daemon stop
  3. 다음과 같이 백업 디먼을 종료했는지 확인합니다.

    ps -ef | grep mongodb-mms-backup-daemon

    백업 디먼이 계속 실행 중이면 다음 명령을 실행합니다.

    sudo /etc/init.d/mongodb-mms-backup-daemon stop
  4. 다른 모든 백업 디먼 호스트에 2~3단계를 반복합니다.

  1. 백업 디먼을 제공하는 첫 번째 호스트에 로그인합니다.

  2. 다음 명령을 실행합니다.

    <install_dir>/bin/mongodb-mms-backup-daemon stop
  3. 다음과 같이 백업 디먼을 종료했는지 확인합니다.

    ps -ef | grep mongodb-mms-backup-daemon

    백업 디먼이 계속 실행 중이면 다음 명령을 실행합니다.

    sudo /etc/init.d/mongodb-mms-backup-daemon stop
  4. 다른 모든 백업 디먼 호스트에 2~3단계를 반복합니다.

고가용성 구성 에서 Ops Manager 애플리케이션을 실행하는 경우 한 번에 하나의 Ops Manager 호스트에서 이 절차를 완료하세요.

deb 패키지를 사용하여 설치된 호스트에서 Ops Manager 애플리케이션을 업그레이드하려면 다음 절차를 사용하세요.

1
  1. 선호하는 브라우저를 열어 MongoDB.comMongoDB Download Center 를 방문합니다.

    MongoDB.com에서 시작하는 경우 Products Ops Manager Try it now 를 클릭하십시오.

  2. Platforms 드롭다운 메뉴에서 Ubuntu 22.04을 클릭합니다.

  3. Packages 드롭다운 메뉴에서 x86_64 아키텍처를 위해 DEB 을 클릭합니다.

  4. Download를 클릭합니다.

    다운로드한 패키지의 이름은 mongodb-mms-<version>.x86_64.deb이며, 여기서 <version> 은 버전 번호입니다.

2

Ops Manager 애플리케이션을 중지하려면 다음 명령을 실행하세요.

sudo service mongodb-mms stop
3

참고

고가용성 Ops Manager 애플리케이션을 위한 업그레이드 모드

동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 이 Ops Manager 배포가 고가용성으로 실행됩니다. 고가용성 Ops Manager 배포의 Ops Manager 호스트 하나를 업그레이드하면 해당 배포는 업그레이드 모드로 전환됩니다.

  1. 각 Ops Manager 애플리케이션 및 백업 데몬 호스트에 .deb 패키지를 설치합니다. 다음 명령을 실행합니다. 여기서 <version>.deb 패키지의 버전입니다.

    sudo dpkg -i mongodb-mms_<version>_x86_64.deb
  2. 현재 설치된 mms.conf 버전을 덮어쓸지 묻는 메시지가 표시되면 Y를 입력하여 기존 파일을 바꿔야 합니다.

  3. Ops Manager가 사용하는 포트 또는 JVM 설정을 수정한 경우, 운영 관리자가 업그레이드된 후 mms.conf 파일에 해당 변경 사항을 다시 적용해야 합니다.

    경고

    mms.conf 파일의 JVM 인수에 비밀번호나 시크릿을 추가하지 마세요. Ops Manager는 이를 진단 아카이브에 일반 텍스트로 노출합니다.

    Ops Manager가 4.1 및 4.2로 업그레이드되면서 JAVA_MMS_UI_OPTS 매개 변수에서 -d64 플래그가 제거되었습니다.

  4. Ops Manager 4.4.11로 업그레이드할 때 Ops Manager가 사용할 /opt/mongodb/mms/conf/conf-mms.properties 파일 버전을 선택하라는 메시지가 표시됩니다. Ops Manager를 수동으로 재구성하지 않으려면 현재 파일을 선택합니다. 자세한 내용은 4.4.11 릴리스 노트를 참조하세요.

4
sudo service mongodb-mms start

참고

고가용성 Ops Manager 인스턴스에서 백업 데몬은 시작하기 전에 모든 노드가 업그레이드될 때까지 대기합니다.

업그레이드된 Ops Manager 호스트가 다시 시작된 후 로그인합니다. 로그인에 성공하면 업그레이드가 완료된 것입니다.

5

참고

MongoDB Ops Manager가 시작 시 생성하는 로그가 MongoDB Ops Manager가 모든 서버를 동일한 버전으로 업그레이드하는 동안 Starting pre-flight checks 에서 일시적으로 일시 중지될 수 있습니다.

업그레이드가 성공하면 고가용성 Ops Manager 배포의 다음 호스트에서 1~4단계를 반복합니다.

6

업그레이드가 완료되면 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 애플리케이션을 업그레이드하려면 다음 절차를 사용하세요.

1

systemd 를 사용하는 RHEL, CentOS, SUSE 호스트에서12 다음 명령을 실행하여 Ops Manager 애플리케이션을 중지합니다.

sudo service mongodb-mms stop

SysVInit 을(를) 사용하는 플랫폼의 경우 다음 명령을 실행합니다.

sudo /etc/init.d/mongodb-mms stop
2
  1. 선호하는 브라우저를 열어 MongoDB.com에서 MongoDB Download Center를 방문합니다.

    MongoDB.com에서 시작하는 경우 Products Ops Manager Try it now 를 클릭하십시오.

  2. Platforms 드롭다운 메뉴에서 다음 옵션 중 하나를 클릭합니다.

    • Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023

  3. Packages드롭다운 메뉴에서 RPM을 클릭합니다.

  4. Download를 클릭합니다.

    다운로드한 패키지의 이름은 mongodb-mms-<version>.x86_64.rpm이며, 여기서 <version> 은 버전 번호입니다.

3

참고

고가용성 Ops Manager 애플리케이션을 위한 업그레이드 모드

동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 이 Ops Manager 배포가 고가용성으로 실행됩니다. 고가용성 Ops Manager 배포의 Ops Manager 호스트 하나를 업그레이드하면 해당 배포는 업그레이드 모드로 전환됩니다.

업그레이드된 Ops Manager 호스트에 .rpm 패키지를 설치하려면 다음 명령을 실행합니다(여기서 <version> 은 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

Ops Manager 5 로 업그레이드하는 경우.0.x, Ops Manager는 현재 /opt/mongodb/mms/conf/conf-mms.properties 파일을 유지합니다. Ops Manager는 이 버전으로 설치된 conf-mms.properties 을(를) /opt/mongodb/mms/conf/conf-mms.properties.rpmnew 으)로 저장합니다.

경고

mms.conf 파일의 JVM 인수에 비밀번호나 시크릿을 추가하지 마세요. Ops Manager는 이를 진단 아카이브에 일반 텍스트로 노출합니다.

4

다음 기존 파일이 Ops Manager 4 업그레이드를 차단합니다. RPM을 사용한 2 설치:

  • /etc/init.d/mongodb-mms

  • /etc/init.d/mongodb-mms-backup-daemon

업그레이드를 완료하려면 다음을 수행합니다.

  1. 다음 명령을 실행하여 이전 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
  2. 다음 명령을 실행하여 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
5

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 에서 일시적으로 일시 중지될 수 있습니다.

6

다시 시작한 후 업그레이드한 Ops Manager 호스트에 로그인합니다. 로그인에 성공하면 업그레이드가 성공한 것입니다.

로그인에 성공하면 고가용성 Ops Manager 배포의 다음 호스트에서 이 단계를 반복합니다.

7

업그레이드가 완료되면 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 시스템을 업그레이드할 수 있습니다.

1

Ops Manager 애플리케이션을 중지하려면 다음 명령을 실행하세요.

<install_dir>/bin/mongodb-mms stop
2

업그레이드하려는 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

또한 Ops Manager가 Ops Manager의 백업 데이터베이스 및 사용자 자격 증명을 암호화하고 해독하는 데 사용하는 gen.key 파일을 백업해야 합니다. Ops Manager를 사용하려면 고가용성 Ops Manager 배포의 일부인 모든 서버에 동일한 gen.key 파일이 필요합니다.

3
  1. 선호하는 브라우저를 열어 MongoDB.com에서 MongoDB Download Center를 방문합니다.

    MongoDB.com에서 시작하는 경우 Products Ops Manager Try it now 를 클릭하십시오.

  2. Version 드롭다운 메뉴에서 제공된 안정적인 버전 중 하나를 클릭합니다.

  3. Platform 드롭다운 메뉴에서 다음 옵션 중 하나를 클릭합니다.

    • Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023

    • Debian 9, 10, 11 / Ubuntu 18.04

  4. Package드롭다운 메뉴에서 tar.gz을 클릭합니다.

  5. Download를 클릭합니다.

    다운로드한 패키지의 이름은 mongodb-mms-<version>.x86_64.tar.gz이며, 여기서 <version> 은 버전 번호입니다.

4

참고

고가용성 Ops Manager 애플리케이션을 위한 업그레이드 모드

동일한 애플리케이션 데이터베이스를 가리키는 둘 이상의 Ops Manager 호스트가 있는 Ops Manager 4.2 이상 버전이 설치되어 있는 경우 이 Ops Manager 배포가 고가용성으로 실행됩니다. 고가용성 Ops Manager 배포의 Ops Manager 호스트 하나를 업그레이드하면 해당 배포는 업그레이드 모드로 전환됩니다.

Ops Manager를 설치하려는 디렉토리로 이동합니다. 아카이브를 해당 디렉토리에 추출합니다.

tar -zxf mongodb-mms-<version>.x86_64.tar.gz

중요

이전 버전과 동일한 디렉토리에 새 버전을 설치하려면 다음 단계를 따르세요.

  1. 현재 설치 디렉토리의 이름을 변경합니다.

    mv <install_dir> <install_dir_old>
  2. 이전 디렉토리의 원래 이름으로 새 디렉토리를 만듭니다.

    mkdir <install_dir>

이렇게 하면 빈 설치 디렉토리 및 코드 라이브러리 충돌을 방지할 수 있습니다.

5

모든 로그 파일을 복원해야 합니다. 전부는 아니지만 대부분의 구성 파일을 복원해야 합니다. 복원:

conf-mms.properties
이 Ops Manager 배포에 대한 설정 입니다.
gen.key
이 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 인스턴스에서 백업 데몬은 시작하기 전에 모든 노드가 업그레이드될 때까지 대기합니다.

6

mms.conf 파일은 포트 및 JVM 구성 설정을 포함하고 있으므로 거의 사용자 지정되지 않습니다. Ops Manager가 사용 하는 포트 또는 JVM 설정을 수정한 경우, Ops Manager를 업그레이드한 후 백업 사본의 변경 사항을 mms.conf 파일에 다시 적용해야 합니다.

경고

mms.conf 파일의 JVM 인수에 비밀번호나 시크릿을 추가하지 마세요. Ops Manager는 이를 진단 아카이브에 일반 텍스트로 노출합니다.

Ops Manager가 4.1 및 4.2로 업그레이드되면서 JAVA_MMS_UI_OPTS 매개 변수에서 -d64 플래그가 제거되었습니다.

7

다음 명령을 실행합니다.

<install_dir>/bin/mongodb-mms start
8

다시 시작한 후 업그레이드한 Ops Manager 호스트에 로그인합니다. 로그인에 성공하면 업그레이드가 성공한 것입니다.

로그인에 성공하면 고가용성 Ops Manager 배포의 다음 호스트에서 이 단계를 반복합니다.

9

업그레이드가 완료되면 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 버전은 에이전트와 함께 업그레이드됩니다.

이동 전 검사 출력 또는 스타트업 로그에 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

이동 전 검사 출력 또는 스타트업 로그에 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 버전의 구성 파일에 새 속성이 필요한 경우 업그레이드 시 해당 속성을 파일에 추가해야 합니다.

이동 전 검사 출력 또는 스타트업 로그에 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 라이브러리의 버전으로 인해 표시된 것입니다. 이 경고는 무시해도 됩니다.

돌아가기

HTTP 프록시를 통한 발신 트래픽 전달