MongoDB Ops Manager

📌 MongoDB Ops Manager
Ops Manager라는 용어는 보통 IT 인프라나 데이터센터 운영하기 위해 또는 현장/업무 운영을 최적화하기 위해 관리나 운영을 자동화하는 도구로 통상적으로 지칭합니다. MongoDB Ops Manager는 자체 인프라(온프레미스 또는 프라이빗 클라우드)에 MongoDB 데이터베이스를 배포, 모니터링, 백업, 자동화, 확장할 수 있는 관리 플랫폼입니다

  . 주요기능
   . 자동화 : MongoDB 노드 및 클러스터의 배포, 업그레이드, 유지보수, 확장 작업을 자동화하고, 호스트에 설치된 MongoDB Agent가 이를 지원합니다
   . 모니터링 : 데이터베이스 및 하드웨어 지표를 실시간으로 수집·시각화하고, 경고(알람)를 설정할 수 있고, 이를 통해 문제를 사전에 감지하고 운영 효율성을 높입니다
   . 백업 : 복제본 세트 및 샤딩된 클러스터의 스냅샷 백업과 특정 시점 복구(Point-in-Time Recovery)를 지원하고, 전체 백업과 증분 백업 방식을 모두 제공해 네트워크 및 저장소 비용을 절감할 수 있습니다
   . 통합 : Kubernetes, 다양한 모니터링 대시보드와 연동되며, 클라우드 서비스로의 마이그레이션도 지원합니다
 . 사용목적
   . MongoDB를 대규모로 운영하는 조직에서 데이터베이스의 안정성과 가용성, 운영 자동화, 데이터 보호를 위해 활용됩니다

※ MongoDB Ops Manager에서 Atlas에 있는 MongoDB 클러스터를 직접 모니터링하는 기능은 지원하지 않음
 . 온프레미스 또는 자체 클라우드에 배포된 MongoDB 인스턴스의 관리와 모니터링을 위한 도구이고, Atlas는 MongoDB가 직접 제공하는 완전 관리형 클라우드 서비스이기 때문입니다

✅ MongoDB Ops Manager 구성하기

🧩 구성 환경
 . Ops Manager 설치 서버 : Windows11 64bit (Ubuntu WSL)
 . 모니터링 대상 : docker container로 replicaset 구성 (Primary 1ea, Secondary 2ea)
. 작업terminal : WSL

1. WSL 환경 설정 및 Ops Manager 다운로드

--WSL 업데이트
$ apt update && sudo apt upgrade -y

--의존성 설치
$ apt install openjdk-17-jdk -y

--Ops Manager 다운로드
$ mkdir mongotest; cd mongotest  ## Ops Manager가 설치될 임의의 디렉토리 생성
$ wget https://downloads.mongodb.com/on-prem-mms/tar/mongodb-mms-8.0.7.500.20250505T1426Z.tar.gz
  ※ mongodb-mms-8.0.7.500.20250505T1426Z.tar.gz 파일 확인 
    . URL : https://www.mongodb.com/try/download/ops-manager
    . FILE : version : 8.0.7 (stable), platform : debian11 / ubuntu 22.04, 24.04, package : tar.gz
$ tar -xzvf mongodb-mms-*.tar.gz

--레파지토리용 몽고DB 디렉토리 이동 및 구성
$ cd mongodb-mms
$ mkdir -p data/{logs,db}  # 로그/데이터 디렉토리 생성

--설정파일 하단에 추가
$ cd mongodb-mms/conf
$ vi conf-mms.properties
...
mongo.mongoUri=mongodb://localhost:27099  # Ops Manager 애플리케이션 DB 연결
  ※ 기본은 27017이고, 모니터링을 위한 별도 port인 27099로 설정
mms.centralUrl=http://localhost:8080

2. Ops Manager 애플리케이션 DB 구성

--별도 MongoDB 설치 및 실행
$ apt install mongodb-org -y
  ※ "E: Unable to locate package mongodb-org" 오류 발생 시
    --MongoDB GPG 키 가져오기
    $ curl -fsSL https://pgp.mongodb.com/server-8.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor
    --MongoDB 공식 저장소 등록
    $ echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu $(lsb_release -cs)/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
  deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse
    --패키지 목록 갱신
    $ apt update

--MongoDB설치 확인
$ mongod --version
db version v8.0.9
Build Info: {
    "version": "8.0.9",
    "gitVersion": "f882ef816d531ecfbb593843e4c554fda90ca416",
    "openSSLVersion": "OpenSSL 3.0.13 30 Jan 2024",
    "modules": [],
    "allocator": "tcmalloc-google",
    "environment": {
        "distmod": "ubuntu2404",
        "distarch": "x86_64",
        "target_arch": "x86_64"
    }
}

--MongoDB 실행
$ systemctl start mongod

--MongoDB 상태 확인 
$ systemctl status mongod
  ※ 오류 : port 사용 중복
  × mongod.service - MongoDB Database Server
     Loaded: loaded (/usr/lib/systemd/system/mongod.service; disabled; preset: enabled)
     Active: failed (Result: exit-code) since Wed 2025-05-14 10:45:09 KST; 4min 40s ago  ## 몽고DB가 정상적으로 실행되지 않음
   Duration: 184ms
       Docs: https://docs.mongodb.org/manual
    Process: 6149 ExecStart=/usr/bin/mongod --config /etc/mongod.conf (code=exited, status=48)
   Main PID: 6149 (code=exited, status=48)  ## 48 : 이미 포트 27017 사용 중
   ...
   --ops manager에서 사용하는 mongodb port변경
   $ vi /etc/mongod.conf 
   ...
   # network interfaces
   net:
   #  port: 27017
     port: 27099  ## 다른 port로 몽고DB 시작, 이미 모니터링할 대상의 replicaset으로 27017~27019포트를 사용하고 있음
     bindIp: 127.0.0.1
   ...  확인
   --신규port로 mongodb 접속 확인
   $ mongosh --port 27099

--Replica Set과의 통신 설정
$ echo "127.0.0.1  mongo1 mongo2 mongo3" | sudo tee -a /etc/hosts  # 호스트 실제 IP(127.0.0.1) 사용

3. Ops Manager 실행 및 접속

--서비스 시작
$ cd mongodb-mms
$ ./bin/mongodb-mms start
  ※ config파일수정이 필요한 경우 : mongodb-mms/conf/conf-mms.properties
--웹 인터페이스 접속
http://localhost:8080
. 최초 접속 시 Sign up
. Configure Ops Manager 페이지
  . Email 
    . "From" Email Address : test@cudo.co.kr
    . "Reply To" Email Address : test@cudo.co.kr
    . Admin Email Address : test@cudo.co.kr
    . Admin Email Address : test@cudo.co.kr
    . SMTP Server Hostname : mail.cudo.co.kr
    . SMTP Server Port : 465
  . Versions Directory : Ops Manager가 MongoDB 바이너리(설치 파일)를 저장하는 서버 내의 디렉토리 경로를 지정하는 설정
    . 기본값인 "/opt/mongodb/mms/mongodb-releases/가 있으면 수정하지 않고 이 값 그대로 사용 
	. 없으면 쓰기 권한이 있는 임의의 디렉토리를 생성
      . $ mkdir -p /home/ubuntu/mongodb-releases/
 ※ "사이트에 연결할 수 없음" 오류 발생 시
   --Ops Manager 상태 확인
   $ ./bin/mongodb-mms status
   Check Ops Manager status
   Probing instance 0...                                   [FAILED]
     PID file not found: /root/mongotest/mongodb-mms/tmp/mms-0.pid
   Check Backup Daemon status                                 [FAILED]
      Backup Daemon is not running.
   --Ops Manager 재기동 
   $ ./bin/mongodb-mms start
   Migrate Ops Manager data
   Running migrations...                                   [  OK  ]
   Starting Ops Manager server
      Instance 0 starting........                             [  OK  ]
   Starting pre-flight checks
   Successfully finished pre-flight checks

   Start Backup Daemon...                                     [  OK  ]

      

4. agent 설치 및 구성 (in Window)

--다운로드 및 설치
. "64-bit" 텍스트 클릭 
  . mongodb-mms-automation-agent-108.0.7.8810-1.windows_x86_64.msi 
    . Base URL : http://localhost:8080
	. Project ID : 68241***
    . Key Generated > API Key : 68242***

5. Deployment (in Ops Manager UI)

--Deployment 생성
. Build New Deployment > New Replica Set > Create Relica Set
. 오류 
  . Invalid config: Two or more processes have their Data Directory or Log File (dbPath/logPath) set to /data/db on Hostname arky
    . MongoDB Replica Set의 각 노드(서버)별로 로그 파일을 분리하려면 각 노드의 mongod.conf 설정 파일에서 systemLog.path를 고유한 경로로 지정해야 합니다. 도커 환경에서는 각 컨테이너에 별도의 설정 파일을 마운트해야함
    . docker-compose.yml 수정 
	  . ./data/mongo1:/data/db → ./data/mongo1:/data/db1
	  . ./data/mongo2:/data/db → ./data/mongo2:/data/db2
	  . ./data/mongo3:/data/db → ./data/mongo3:/data/db3
    . mongod.conf 수정 
	  . mongod.conf → mongod1.conf
	    . path: /var/log/mongodb/mongod.log → path: /var/log/mongodb/mongod1.log
	  . mongod.conf → mongod2.conf
	    . path: /var/log/mongodb/mongod.log → path: /var/log/mongodb/mongod2.log
	  . mongod.conf → mongod3.conf
	    . path: /var/log/mongodb/mongod.log → path: /var/log/mongodb/mongod3.log
    . docker재기동
      # cd /drives/c/mongodata ## docker-compose.yml파일이 있는 곳으로 이동
      # docker compose up -d --no-deps --force-recreate mongo1 mongo2 mongo3 ## docker-compose.yml파일이 있는 곳에서 실행 
  . Invalid config: Two or more processes have their Port set to 27017 on Hostname arky
    . Member Configuration > MongoD Settings > Port 
	  . 1 : 27017, 2: 27018, 3 : 27019
      

6. 기타

--ops manager 모니터링 로그 위치
. Deployment > Agents > Downloads & Settings
  . "Monitoring Log Settings" section 
    . C:\MMSAutomation\log\mongodb-mms-automation\monitoring-agent.log
  . "Backup Log Settings" section
    . C:\MMSAutomation\log\mongodb-mms-automation\backup-agent.log

🧾 출처
https://www.mongodb.com/ko-kr/docs/ops-manager/current/