Docs Menu
Docs Home
/
MongoDB Cloud Manager
/ /

배포서버 관리를 위한 MongoDB Agent 설치

MongoDB Agent 를 설치하여 MongoDB 배포를 관리, 모니터 및 백업합니다.

참고

필수 요구 사항 먼저 검토

MongoDB Agent를 설치하기 전에 MongoDB Agent 필수 요구 사항를 검토합니다.

Microsoft Windows를 실행하는 x86_64 아키텍처에 MongoDB Agent를 설치하려면 다음 절차를 따르세요.

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포서버 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 Windows - MSI를 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 Windows - MSI를 클릭합니다.

3

MongoDB Agent Installation Instructions 상자에는 다음 정보가 표시됩니다.

  • Project ID (프로젝트에 바인딩하는 데 필요)

  • API Key

    API 키가 없는 경우 키 생성을 클릭합니다.

이러한 값의 일부 또는 전부는 이후 단계에서 필요합니다. 이러한 값을 복사한 다음 나중에 액세스할 수 있는 곳에 저장합니다.

4
  1. MSI 가 다운로드되면 다음을 두 번 클릭합니다.

    mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi

  2. 보안 경고가 표시되면 Run을(를) 클릭합니다.

  3. Configuration/Log Folder 단계

    이러한 파일이 저장되는 디렉토리를 제공합니다.

  4. Key Type 단계에서 Agent API Key 을 선택하여 특정 프로젝트에 바인딩합니다.

  5. 적절한 에이전트 키를 입력합니다.

    참고

    이러한 키는 이전 단계에서 설명한 MongoDB Agent Installation Instructions 모달에 제공됩니다.

    • Project ID 필드에 프로젝트 ID를 입력합니다.

    • Agent API Key 필드에 에이전트 API 키를 입력합니다.

  6. MongoDB Paths 단계에서 로그 및 백업 디렉토리를 지정합니다.

  7. Windows Firewall Configuration 단계에서 원하는 방화벽 구성을 클릭합니다.

    Configure firewall rules allowing access from only the specified |ipaddr| addresses. 을 클릭하는 경우 제공된 상자에 필요한 IPv4 주소를 입력합니다.

  8. (조건부) Windows 에서 은폐 모드 활성화 기본값 Windows 방화벽의 경우 . MongoDB Agent 를 설치하려는 MongoDB 호스팅하다 에서 비활성화하지 않은 경우 비활성화하라는 메시지가 표시됩니다. 은폐 모드는 MongoDB Agent 의 성능과 역량 을 크게 저하시킵니다. Disable Stealth Mode 을(를) 클릭합니다.

  9. (조건부) Windows 에서 디스크 성능 카운터 를 활성화 하지 않음 기본값. MongoDB 호스팅하다 에 대해 디스크 성능 카운터를 활성화하지 않은 경우 Enable Disk Performance Counters 를 클릭합니다. MongoDB Agent 는 hardware 모니터링 활동 중 일부에 이러한 카운터를 사용합니다.

  10. Install를 클릭합니다.

  11. 설정이 완료되면 Finish을(를) 클릭합니다.

MSI 다운로드 후 자동 설치를 실행할 수 있습니다. 명령 인터프리터 또는 PowerShell의 명령줄에서 자동 설치를 실행합니다. 자동 설치에 대해 자세히 알아보려면 표준 설치 프로그램 명령줄 옵션 에 대한 Microsoft 설명서를 참조하세요.

명령줄에서 MSI 설치 프로그램을 자동으로 실행하려면 /q/i 플래그와 필수 및 선택적 매개변수의 조합을 사용하여 msiexec.exe 를 호출합니다.

Parameter
필요성
MMSAPIKEY
필수 사항
Cloud Manager 프로젝트 의 에이전트 API 키입니다.
MMSGROUPID
필수 사항
Cloud Manager 프로젝트 의 고유 식별자입니다.
CONFIGLOGDIR
옵션
Cloud Manager 가 MongoDB Agent 구성 파일 을 쓰기 (write) 해야 하는 절대 파일 경로입니다.
LOGFILE
옵션
Cloud Manager 가 MongoDB Agent 로그 를 쓰기 (write) 해야 하는 절대 파일 경로입니다.
MMSCONFIGBACKUP
옵션
Cloud Manager 자동화 구성 백업 JSON 파일 의 절대 파일 경로입니다.

예시

MongoDB Agent를 자동으로 설치하려면 다음 옵션을 사용하여 msiexec.exe 를 호출합니다.

msiexec.exe /q /i "C:\PATH\TO\mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi" MMSGROUPID=<GROUP.ID> MMSAPIKEY=<AGENT.API.ID> MMSBASEURL="<http://opsmanager.example.com:8080>" LOGFILE="C:\MMSData\Server\Log\automation-agent.log" MMSCONFIGBACKUP="C:\MMSData\MongoDB\mms-cluster-config-backup.json"
5

MongoDB Agent 설치를 완료합니다. Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

6

기본적으로 MongoDB 바이너리 및 Cloud Manager 구성 백업 파일은 %SystemDrive%\MMSMongoDB\versions 에 있습니다.

참고

Windows 는 %SystemDrive% 환경 변수를 Windows 를 설치한 드라이브로 설정합니다. 기본값 C: 드라이브에 Windows 를 설치하라는 메시지가 표시됩니다. 을(를)찾으려면 PowerShell %SystemDrive% 에서 다음 명령을 실행합니다.

get-childitem env:SystemDrive

이러한 파일을 다른 디렉토리에 저장하려면 다음 절차를 따르세요.

MongoDB Agent 바이너리의 위치를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. Downloads & Settings 탭을 클릭합니다.

  4. Download Directory 제목 아래에서 Download Directory (Windows)에 표시된 경로 오른쪽에 있는 을(를) 클릭합니다.

  5. 경로를 원하는 새 경로로 변경합니다.

  6. Save를 클릭합니다.

  7. MongoDB Agent 를 실행하는 각 호스팅하다 에서 지정한 새 디렉토리 를 만듭니다. Windows 탐색기를 사용하여 파일 을 이동하거나 명령 프롬프트 또는 PowerShell 에서 다음 명령을 실행합니다.

    md \<newPath>

    중요

    MongoDB Agent를 실행하는 시스템 사용자가 이 새 디렉토리에 쓸 수 있어야 합니다. 이는 일반적으로 SYSTEM 사용자이며 사용자를 변경하지 않는 한 추가 구성이 필요하지 않습니다.

MongoDB Agent 구성 백업의 위치를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 MongoDB Agent 구성 파일을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다. X을(를) 백업이 저장된 드라이브 문자로 바꿉니다.

    mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json
  3. MongoDB Agent 구성 파일을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다. Windows 탐색기를 사용하여 파일을 이동하거나 명령 프롬프트 또는 PowerShell 에서 다음 명령을 실행합니다.

    move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
7

MongoDB Agent를 설치하려면 다음 절차를 따르세요.

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

Debian 8/9/10/11 또는 Ubuntu 18.04/20.04/22.04를 실행하는 x86_64 아키텍처에서:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 Debian 8/9, Ubuntu 16.X/18.X - DEB를 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 Debian 8/9, Ubuntu 16.X/18.X - DEB를 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell 에 복사합니다.

를 실행 호스팅하다 의 시스템 에서 shell MongoDB Agent 다음 curl 명령을 실행하여 Ubuntu 18.04 { 다운로드 }/20.04/22.04 또는 Debian 8/9/10/11 for 64-bit x86:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager_latest_amd64.ubuntu1604.deb
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리는 MongoDB 데이터를 저장합니다. 기존 MongoDB 배포의 경우 디렉토리를 mongodb 사용자가 소유하고 있어야 합니다. MongoDB 배포가 없는 경우 디렉토리를 만들고 소유자를 설정합니다.

데이터 디렉토리를 만들고 소유자를 mongodb 사용자로 설정합니다.

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

다음 명령을 실행합니다.

sudo systemctl start mongodb-mms-automation-agent.service
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

MongoDB Agent를 설치하려면 다음 절차를 따르세요.

x86_64 아키텍처에서:

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

rpm 패키지를 사용하여 Amazon Linux 실행:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 Amazon Linux - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 Amazon Linux - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행할 호스트의 시스템 에서 shell MongoDB Agent 다음 curl 명령을 실행하여 64비트 x 용 설치 프로그램을86 다운로드합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

RHEL/ CentOS 7.x 실행, SUSE12, SUSE15 또는 Amazon Linux 2:

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

rpm 패키지 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux2 - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux2 - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행할 호스트의 시스템 shell MongoDB Agent curl 에서 다음 명령을 7 실행하여 64비트 x 용 RHEL 설치 프로그램을86 다운로드합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel7.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

tar 아카이브 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux 2 - TAR을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux 2 - TAR을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행 호스팅하다 의 시스템 shell MongoDB Agent curl 에서 다음 명령을 실행하여 64비트 x 용 RHEL 설치 프로그램을 다운로드86 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

PowerPC 아키텍처의 RHEL/ CentOS (7.x)( MongoDB 3.4 이상 배포 관리):

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

rpm 패키지 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 MongoDB Agent curl 실행 호스팅하다 의 시스템 에서 다음 명령을 실행하여 7 PowerPC용 RHEL 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel7.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

tar 아카이브 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - TAR을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - TAR을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 MongoDB Agent curl 실행 호스팅하다 의 시스템 에서 다음 명령을 실행하여 7 PowerPC용 RHEL 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

zSeries 아키텍처( MongoDB 4.0 이상 배포 관리):

RHEL/ CentOS 7.x/8.x 실행:

RHEL/ CentOS 7.x/8.x 실행 rpm 패키지 관리자를 사용합니다.

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL 7.X/8X Z-Series (s390x) - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL 7.X/8X Z-Series (s390x) - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 실행 호스팅하다 MongoDB Agent 의 curl 시스템 7 에서 다음 명령을8 실행하여 IBM zSeries용 RHEL.X/.X의 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel7.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

RHEL 8.x/9.x 실행 ARM64 아키텍처에서 또는 Amazon Linux 2:

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

RHEL 8.x/9.x 실행 중 또는 rpm 패키지 관리자를 사용하는 Amazon Linux 2 :

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM)을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM)을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행 호스팅하다 의 시스템 shell MongoDB Agent curl 에서 다음 명령을 실행하여 RHEL.x/.x의 설치 프로그램을 다운로드 8 9합니다. 또는 ARM64용 Amazon Linux 2:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

tar 아카이브 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM)을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM)을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행 호스팅하다 의 시스템 shell MongoDB Agent curl 에서 다음 명령을 실행하여 RHEL.x/.x의 설치 프로그램을 다운로드 8 9합니다. 또는 ARM64용 Amazon Linux 2:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

이 절차를 사용하여 deb 또는 rpm 패키지를 사용하지 않는 Linux 시스템을 설치합니다.

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 기타 Linux - TAR을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 기타 Linux - TAR을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 MongoDB Agent curl 실행 호스팅하다 의 시스템 에서 64 Linux다음 명령을 실행하여 일반 비트 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.linux_x86_64.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.linux_x86_64
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongodb \
-d /var/lib/mongo -s /bin/false \
-c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

Microsoft Windows를 실행하는 x86_64 아키텍처에 MongoDB Agent를 설치하려면 다음 절차를 따르세요.

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 Windows - MSI를 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 Windows - MSI를 클릭합니다.

3

MongoDB Agent Installation Instructions 상자에는 다음 정보가 표시됩니다.

  • Project ID (프로젝트에 바인딩하는 데 필요)

  • API Key

    API 키가 없는 경우 키 생성을 클릭합니다.

이러한 값의 일부 또는 전부는 이후 단계에서 필요합니다. 이러한 값을 복사한 다음 나중에 액세스할 수 있는 곳에 저장합니다.

4
  1. MSI 다운로드가 완료되면 다음을 두 번 클릭합니다.

    mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi

  2. 보안 경고가 표시되면 Run을(를) 클릭합니다.

  3. Configuration/Log Folder 단계

    이러한 파일이 저장되는 디렉토리를 제공합니다.

  4. Key Type 단계에서 Agent API Key 을 선택하여 특정 프로젝트에 바인딩합니다.

  5. 적절한 에이전트 키를 입력합니다.

    참고

    이러한 키는 이전 단계에서 설명한 MongoDB Agent Installation Instructions 모달에 제공됩니다.

    • Project ID 필드에 프로젝트 ID를 입력합니다.

    • Agent API Key 필드에 에이전트 API 키를 입력합니다.

  6. MongoDB Paths 단계에서 로그 및 백업 디렉토리를 지정합니다.

  7. Windows Firewall Configuration 단계에서 원하는 방화벽 구성을 클릭합니다.

    Configure firewall rules allowing access from only the specified |ipaddr| addresses. 을(를) 클릭하는 경우 제공된 상자에 필요한 IPv4 주소를 입력합니다.

  8. (조건부) Windows 에서 은폐 모드 활성화 기본적으로 Windows 방화벽의 경우. MongoDB Agent를 설치하려는 MongoDB 호스트에서 비활성화하지 않은 경우 비활성화하라는 메시지가 표시됩니다. 은폐 모드는 MongoDB Agent의 성능과 기능을 크게 저하시킵니다. Disable Stealth Mode 를 클릭합니다.

  9. (조건부) Windows 에서 디스크 성능 카운터 를 활성화 하지 않음 기본값. MongoDB 호스팅하다 에 대해 디스크 성능 카운터를 활성화하지 않은 경우 Enable Disk Performance Counters 를 클릭합니다. MongoDB Agent 는 hardware 모니터링 활동 중 일부에 이러한 카운터를 사용합니다.

  10. Install를 클릭합니다.

  11. 설정이 완료되면 Finish을(를) 클릭합니다.

MSI 다운로드 후 자동 설치를 실행할 수 있습니다. 명령 인터프리터 또는 PowerShell의 명령줄에서 자동 설치를 실행합니다. 자동 설치에 대해 자세히 알아보려면 표준 설치 프로그램 명령줄 옵션 에 대한 Microsoft 설명서를 참조하세요.

명령줄에서 MSI 설치 프로그램을 자동으로 실행하려면 /q/i 플래그와 필수 및 선택적 매개변수의 조합을 사용하여 msiexec.exe 를 호출합니다.

Parameter
필요성
MMSAPIKEY
필수 사항
Cloud Manager 프로젝트 의 에이전트 API 키입니다.
MMSGROUPID
필수 사항
Cloud Manager 프로젝트 의 고유 식별자입니다.
CONFIGLOGDIR
옵션
Cloud Manager 가 MongoDB Agent 구성 파일 을 쓰기 (write) 해야 하는 절대 파일 경로입니다.
LOGFILE
옵션
Cloud Manager 가 MongoDB Agent 로그 를 쓰기 (write) 해야 하는 절대 파일 경로입니다.
MMSCONFIGBACKUP
옵션
Cloud Manager 자동화 구성 백업 JSON 파일 의 절대 파일 경로입니다.

예시

MongoDB Agent를 자동으로 설치하려면 다음 옵션을 사용하여 msiexec.exe 를 호출합니다.

msiexec.exe /q /i "C:\PATH\TO\mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi" MMSGROUPID=<GROUP.ID> MMSAPIKEY=<AGENT.API.ID> MMSBASEURL="<http://opsmanager.example.com:8080>" LOGFILE="C:\MMSData\Server\Log\automation-agent.log" MMSCONFIGBACKUP="C:\MMSData\MongoDB\mms-cluster-config-backup.json"
5

MongoDB Agent 설치를 완료합니다. Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

6

기본적으로 MongoDB 바이너리 및 Cloud Manager 구성 백업 파일은 %SystemDrive%\MMSMongoDB\versions 에 있습니다.

참고

Windows 는 %SystemDrive% 환경 변수를 Windows 를 설치한 드라이브로 설정합니다. 기본값 C: 드라이브에 Windows 를 설치하라는 메시지가 표시됩니다. 을(를)찾으려면 PowerShell %SystemDrive% 에서 다음 명령을 실행합니다.

get-childitem env:SystemDrive

이러한 파일을 다른 디렉토리에 저장하려면 다음 절차를 따르세요.

MongoDB Agent 바이너리의 위치를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. Downloads & Settings 탭을 클릭합니다.

  4. Download Directory 제목 아래에서 Download Directory (Windows)에 표시된 경로 오른쪽에 있는 을(를) 클릭합니다.

  5. 경로를 원하는 새 경로로 변경합니다.

  6. Save를 클릭합니다.

  7. MongoDB Agent 를 실행하는 각 호스팅하다 에서 지정한 새 디렉토리 를 만듭니다. Windows 탐색기를 사용하여 파일 을 이동하거나 명령 프롬프트 또는 PowerShell 에서 다음 명령을 실행합니다.

    md \<newPath>

    중요

    MongoDB Agent를 실행하는 시스템 사용자가 이 새 디렉토리에 쓸 수 있어야 합니다. 이는 일반적으로 SYSTEM 사용자이며 사용자를 변경하지 않는 한 추가 구성이 필요하지 않습니다.

MongoDB Agent 구성 백업의 위치를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 MongoDB Agent 구성 파일을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다. X을(를) 백업이 저장된 드라이브 문자로 바꿉니다.

    mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json
  3. MongoDB Agent 구성 파일을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다. Windows 탐색기를 사용하여 파일을 이동하거나 명령 프롬프트 또는 PowerShell 에서 다음 명령을 실행합니다.

    move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
7

MongoDB Agent를 설치하려면 다음 절차를 따르세요.

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

Debian 8/9/10/11 또는 Ubuntu 18.04/20.04/22.04를 실행하는 x86_64 아키텍처에서:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 Debian 8/9, Ubuntu 16.X/18.X - DEB를 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 Debian 8/9, Ubuntu 16.X/18.X - DEB를 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell 에 복사합니다.

를 실행 호스팅하다 의 시스템 에서 shell MongoDB Agent 다음 curl 명령을 실행하여 Ubuntu 18.04 { 다운로드 }/20.04/22.04 또는 Debian 8/9/10/11 for 64-bit x86:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager_latest_amd64.ubuntu1604.deb
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리는 MongoDB 데이터를 저장합니다. 기존 MongoDB 배포의 경우 디렉토리를 mongodb 사용자가 소유하고 있어야 합니다. MongoDB 배포가 없는 경우 디렉토리를 만들고 소유자를 설정합니다.

데이터 디렉토리를 만들고 소유자를 mongodb 사용자로 설정합니다.

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

다음 명령을 실행합니다.

sudo systemctl start mongodb-mms-automation-agent.service
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

MongoDB Agent를 설치하려면 다음 절차를 따르세요.

x86_64 아키텍처에서:

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

rpm 패키지를 사용하여 Amazon Linux 실행:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 Amazon Linux - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 Amazon Linux - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행할 호스트의 시스템 에서 shell MongoDB Agent 다음 curl 명령을 실행하여 64비트 x 용 설치 프로그램을86 다운로드합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

RHEL/ CentOS 7.x 실행, SUSE12, SUSE15 또는 Amazon Linux 2:

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

rpm 패키지 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux2 - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux2 - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행할 호스트의 시스템 shell MongoDB Agent curl 에서 다음 명령을 7 실행하여 64비트 x 용 RHEL 설치 프로그램을86 다운로드합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel7.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

tar 아카이브 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux 2 - TAR을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X), SUSE12, Amazon Linux 2 - TAR을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행 호스팅하다 의 시스템 shell MongoDB Agent curl 에서 다음 명령을 실행하여 64비트 x 용 RHEL 설치 프로그램을 다운로드86 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

PowerPC 아키텍처의 RHEL/ CentOS (7.x)( MongoDB 3.4 이상 배포 관리):

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

rpm 패키지 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 MongoDB Agent curl 실행 호스팅하다 의 시스템 에서 다음 명령을 실행하여 7 PowerPC용 RHEL 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel7.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

tar 아카이브 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - TAR을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X) 전원 (ppc64파일) - TAR을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 MongoDB Agent curl 실행 호스팅하다 의 시스템 에서 다음 명령을 실행하여 7 PowerPC용 RHEL 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

zSeries 아키텍처( MongoDB 4.0 이상 배포 관리):

RHEL/ CentOS 7.x/8.x 실행:

RHEL/ CentOS 7.x/8.x 실행 rpm 패키지 관리자를 사용합니다.

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL 7.X/8X Z-Series (s390x) - RPM을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL 7.X/8X Z-Series (s390x) - RPM을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 실행 호스팅하다 MongoDB Agent 의 curl 시스템 7 에서 다음 명령을8 실행하여 IBM zSeries용 RHEL.X/.X의 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel7.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

RHEL 8.x/9.x 실행 ARM64 아키텍처에서 또는 Amazon Linux 2:

중요

10.24.0.6714-1버전 부터 deb 또는 rpm 패키지를 사용하여 MongoDB Agent 를 설치하면 패키지 가 PATH 환경 변수에 MongoDB 바이너리를 추가하지 않습니다.

배포가 PATH에 있는 MongoDB 바이너리의 존재 여부에 따라 달라지는 경우, PATH에 MongoDB 바이너리 경로를 수동으로 추가해야 합니다. 환경 변수를 업데이트하는 방법을 알아보려면 운영 체제 문서를 참조하세요.

RHEL 8.x/9.x 실행 중 또는 rpm 패키지 관리자를 사용하는 Amazon Linux 2 :

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM)을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM)을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행 호스팅하다 의 시스템 shell MongoDB Agent curl 에서 다음 명령을 실행하여 RHEL.x/.x의 설치 프로그램을 다운로드 8 9합니다. 또는 ARM64용 Amazon Linux 2:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm
4

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
5

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent를 설치한 디렉토리에서 원하는 텍스트 편집기로 Automation-agent.config 파일을 엽니다.

sudo vi /etc/mongodb-mms/automation-agent.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
6

데이터 디렉토리 는 MongoDB 데이터를 저장하며 mongod 사용자가 소유해야 합니다. 기존 MongoDB deployment 의 경우 디렉토리 에 mongod 사용자가 소유자로 포함되어 있는지 확인합니다. MongoDB deployment 가 없는 경우 디렉토리 를 만들고 소유자를 설정하다 합니다.

다음 명령은 데이터 디렉토리 를 만들고 소유자를 mongod 사용자로 설정하다 합니다.

sudo mkdir /data; sudo chown mongod:mongod /data
7

다음 명령을 실행합니다.

sudo service mongodb-mms-automation-agent start
8

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

9

tar 아카이브 사용:

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 RHEL/ CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM)을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 RHEL/ CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM)을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

를 실행 호스팅하다 의 시스템 shell MongoDB Agent curl 에서 다음 명령을 실행하여 RHEL.x/.x의 설치 프로그램을 다운로드 8 9합니다. 또는 ARM64용 Amazon Linux 2:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongod \
-d /var/lib/mongo -s /bin/false \
-c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

이 절차를 사용하여 deb 또는 rpm 패키지를 사용하지 않는 Linux 시스템을 설치합니다.

1
2

프로젝트에 배포가 없으며 시작하라는 메시지가 표시됩니다.

  1. Build New Deployment 메뉴에서 추가하려는 배포 유형을 선택합니다.

  2. Cloud Manager가 Create New Deployment 페이지에서 MongoDB Agent가 설치된 호스트를 감지할 수 없는 경우 Create New Deployment 페이지 상단에 배너가 표시됩니다.

    see instructions 링크를 클릭합니다.

  3. Select Your Server's Operating System 메뉴에서 기타 Linux - TAR을 클릭합니다.

  4. Next를 클릭합니다.

  1. Manage your existing 배포서버(기존 배포 관리)를 클릭합니다.

  2. Install Agent 메뉴에서 기타 Linux - TAR을 클릭합니다.

3

참고

이 단계부터 시작하여 MongoDB Agent 설치 모달에 따라 제공된 명령을 Linux shell에 복사합니다.

shell 를 MongoDB Agent curl 실행 호스팅하다 의 시스템 에서 64 Linux다음 명령을 실행하여 일반 비트 설치 프로그램을 다운로드 합니다.

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz
4

모든 디렉토리 에 MongoDB Agent 를 설치할 수 있습니다. 추출하기 전에 아카이브를 다른 디렉토리 로 이동하려는 경우 그렇게 할 수 있습니다.

MongoDB Agent 를 설치하려면 아카이브를 추출합니다.

tar -xvzf mongodb-mms-automation-agent-<VERSION>.linux_x86_64.tar.gz
5

MongoDB Agent 바이너리를 추출한 후 생성된 디렉토리 로 변경합니다.

cd mongodb-mms-automation-agent-<VERSION>.linux_x86_64
6

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 옵션을 업데이트합니다.

ProjectID 프로젝트.
프로젝트의 에이전트 API 키 입니다.
7

프록시 서버를 통해 Cloud Manager에 연결하도록 MongoDB Agent를 구성하려면 httpProxy 환경 변수에 서버를 지정해야 합니다.

MongoDB Agent 를 설치한 디렉토리 에서 원하는 텍스트 편집기로 local.config 파일 을 엽니다.

vi <install-path>/local.config

다음 구성 키를 추가합니다.

프록시 서버의 URL(호스트 이름 및 포트)입니다.
8

MongoDB Agent 에 필요한 파일을 저장 다음 디렉토리를 생성합니다.

참고

파일 경로에 mongodb-mms-automation 을 사용하는 것은 레거시 아티팩트이며, 자동화가 구성된 상태로 MongoDB Agent 가 설치되고 있음을 MEAN 하지는 않습니다.

구성 요소
기본 디렉토리
설명
바이너리
/var/lib/mongodb-mms-automation
MongoDB Agent 가 관리하는 바이너리입니다. 여기에는 MongoDB Agent, BI Connector 및 MongoDB 바이너리가 포함됩니다.
MongoDB 에이전트 로그
/var/log/mongodb-mms-automation
다음은 MongoDB Agent가 생성하는 로그 파일입니다.
MongoDB 데이터베이스
/data
MongoDB Agent 가 생성하고 관리하는 데이터베이스입니다.

다음 명령을 실행하여 디렉토리를 생성합니다.

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

기본값 에이전트 바이너리 및 Cloud Manager 구성 백업 파일 은 /var/lib/mongodb-mms-automation 에 있습니다. 이러한 파일을 다른 디렉토리 에 저장 하려면 다음 절차를 따르세요.

에이전트 바이너리의 위치 를 변경하려면 다음을 수행합니다.

  1. MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.

    1. 이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.

      배포 페이지가 표시됩니다.

  2. 배포서버 의 Agents 탭 을 클릭합니다.

    Agents (에이전트) 페이지가 표시됩니다.

  3. 경로를 변경합니다.

    1. Downloads & Settings를 클릭합니다.

    2. Download Directory 제목 아래에서 Download Directory (Linux) 에 표시된 경로 오른쪽에 있는 연필 아이콘을 클릭합니다.

    3. 경로를 원하는 새 경로로 변경합니다.

    4. Save를 클릭합니다.

    5. 에이전트를 실행하는 각 호스트에서 지정한 새 디렉토리를 생성합니다.

      sudo mkdir -m 755 -p /<newPath>

에이전트 구성 백업 의 위치 를 변경하려면 다음을 수행합니다.

  1. 원하는 텍스트 편집기에서 에이전트 구성 파일 을 엽니다.

  2. mmsConfigBackup 설정을 구성 백업 파일의 새 경로로 변경합니다.

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
  3. Agent 구성 파일 을 저장합니다.

  4. 구성 백업 파일을 새 디렉토리로 이동합니다.

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

다음 명령을 실행합니다.

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
sudo /usr/sbin/useradd -M -r -g mongodb \
-d /var/lib/mongo -s /bin/false \
-c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data
10

MongoDB Agent 를 설치한 디렉토리 에서 마지막 단계에서 생성한 시스템 사용자 로 다음 명령을 실행합니다.

nohup ./mongodb-mms-automation-agent \
--config=local.config \
>> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

Install Agent Instructions 모달에서:

  1. Verify Agent 을 클릭하여 MongoDB Agent가 Cloud Manager에 연결할 수 있는지 확인합니다.

  2. Done를 클릭합니다.

12

돌아가기

설치