목차
이 FAQ에서는 고객이 Linux 시스템에서 MongoDB를 최신 버전으로 업그레이드하는 데 사용할 수 있는 명령어를 소개합니다.
- Ubuntu 20.04, Ubuntu 22.04
- Omada 소프트웨어 컨트롤러
- MongoDB
Linux 시스템에서는 MongoDB에 필요한 종속성을 고객이 수동으로 설치해야 합니다. MongoDB는 버전 간 데이터 호환성에 대한 요구 사항이 엄격합니다. 따라서 Linux 시스템에서 MongoDB를 바로 최신 버전으로 업그레이드할 수는 없고, 한 단계씩 업그레이드를 거쳐야 합니다. 이 FAQ에서는 Ubuntu 20.04를 예로 들어 MongoDB를 v4.4에서 v5로, v5에서 v6으로, v6에서 v7로 업그레이드하는 명령어를 소개합니다. 필요에 따라 해당하는 명령어를 사용하시면 됩니다.
1단계. 데이터베이스 백업 후 컨트롤러 제거
다음 명령어를 사용하여 컨트롤러를 제거할 수 있습니다:
sudo dpkg -r omadac
팝업창이 나타나면 Yes를 선택합니다.

Yes를 선택합니다.

참고: 백업 DB 파일은 /opt/tplink/omada_db_backup에 저장됩니다.
![]()
장애 발생 시 복원할 수 있도록 db.tar.gz 파일을 다른 폴더에도 백업합니다. 여기서는 /Document/dbbackupv4 폴더에 복사합니다.

2단계. MongoDB v4.4 제거
다음 명령어를 사용하여 MongoDB v4.4를 제거합니다:
sudo apt remove mongodb-*
y를 누릅니다.

다음 명령어를 사용하여 mongodb-org-4.4.list 파일을 삭제합니다.
sudo rm /etc/apt/sources.list.d/mongodb-org-4.4.list
3단계. MongoDB v5 설치
다음 명령어를 사용하여 MongoDB v5를 설치합니다:
curl -fsSL https://www.mongodb.org/static/pgp/server-5.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-5.0.gpg \
--dearmor

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list

sudo apt-get update

sudo apt-get install -y mongodb-org

4단계. Omada 소프트웨어 컨트롤러 재설치
Omada 소프트웨어 컨트롤러 deb 파일이 저장된 위치로 이동합니다. 여기서는 omada_v5.14.26.1_linux_x64_20240621095737.deb를 예로 들어보겠습니다.
sudo dpkg -i omada_v5.14.26.1_linux_x64_20240621095737.deb

Yes를 선택하면 컨트롤러가 /opt/tplink/omada_db_backup에 있는 백업 DB 파일을 가져옵니다.

설치가 완료되면 컨트롤러가 자동으로 시작됩니다.
5단계. FeatureCompatibilityVersion 변경
컨트롤러가 정상적으로 시작되면 다음 명령어를 사용하여 Mongo Shell을 시작합니다:
mongosh -port 27217

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
![]()
1단계. 데이터베이스 백업 후 컨트롤러 제거
다음 명령어를 사용하여 컨트롤러를 제거합니다:
sudo dpkg -r omadac
팝업창이 나타나면 Yes를 선택합니다.

Yes를 선택합니다.

참고: 백업 DB 파일은 /opt/tplink/omada_db_backup에 저장됩니다.
![]()
장애 발생 시 복원할 수 있도록 db.tar.gz 파일을 다른 폴더에도 백업합니다. 여기서는 /Document/dbbackupv5 폴더에 복사합니다.

2단계. MongoDB v5 제거
다음 명령어를 사용하여 MongoDB v5를 제거합니다:
sudo apt remove mongodb-*
y를 누릅니다.

sudo rm /etc/apt/sources.list.d/mongodb-org-5.0.list
3단계. MongoDB v6 설치
다음 명령어를 사용하여 MongoDB v6를 설치합니다:
curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
--dearmor

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

sudo apt-get update

sudo apt-get install -y mongodb-org

4단계. Omada 소프트웨어 컨트롤러 재설치
Omada 소프트웨어 컨트롤러 deb 파일이 저장된 위치로 이동합니다. 여기서는 omada_v5.14.26.1_linux_x64_20240621095737.deb를 예로 들어보겠습니다.
sudo dpkg -i omada_v5.14.26.1_linux_x64_20240621095737.deb

Yes를 선택하면 컨트롤러가 /opt/tplink/omada_db_backup에 있는 백업 DB 파일을 가져옵니다.

설치가 완료되면 컨트롤러가 자동으로 시작됩니다.
5단계. FeatureCompatibilityVersion 변경
컨트롤러가 정상적으로 시작되면 다음 명령어를 사용하여 Mongo Shell을 시작합니다:
mongosh -port 27217

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )
![]()
1단계. 데이터베이스 백업 후 컨트롤러 제거
다음 명령어를 사용하여 컨트롤러를 제거합니다:
sudo dpkg -r omadac
팝업창이 나타나면 Yes를 선택합니다.

Yes를 선택합니다.

참고: 백업 DB 파일은 /opt/tplink/omada_db_backup에 저장됩니다.
![]()
장애 발생 시 복원할 수 있도록 db.tar.gz 파일을 다른 폴더에도 백업합니다. 여기서는 /Document/dbbackupv6 폴더에 복사합니다.

2단계. MongoDB v6 제거
다음 명령어를 사용하여 MongoDB v6를 제거합니다:
sudo apt remove mongodb-*
y를 누릅니다.

sudo rm /etc/apt/sources.list.d/mongodb-org-6.0.list
![]()
3단계. MongoDB v7 설치
다음 명령어를 사용하여 MongoDB v7를 설치합니다:
curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

sudo apt-get update

sudo apt-get install -y mongodb-org

4단계. Omada 소프트웨어 컨트롤러 재설치
Omada 소프트웨어 컨트롤러 deb 파일이 저장된 위치로 이동합니다. 여기서는 omada_v5.14.26.1_linux_x64_20240621095737.deb를 예로 들어보겠습니다.
sudo dpkg -i omada_v5.14.26.1_linux_x64_20240621095737.deb

Yes를 선택하면 컨트롤러가 /opt/tplink/omada_db_backup에 있는 백업 DB 파일을 가져옵니다.

설치가 완료되면 컨트롤러가 자동으로 시작됩니다.
5단계. FeatureCompatibilityVersion 변경
컨트롤러가 정상적으로 시작되면 다음 명령어를 사용하여 Mongo Shell을 시작합니다:
mongosh -port 27217

db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true } )

FeatureCompatibilityVersion을 변경한 후 다음 명령어를 사용하여 결과를 확인할 수 있습니다:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
- FeatureCompatibilityVersion을 5.0으로 변경하면 결과가 다음과 같아야 합니다:
![]()
- FeatureCompatibilityVersion을 6.0으로 변경하면 결과가 다음과 같아야 합니다:
![]()
- FeatureCompatibilityVersion을 7.0으로 변경하면 결과가 다음과 같아야 합니다:
![]()
지금까지 Linux 시스템에서 MongoDB를 v4.4에서 v7로 업그레이드하는 방법을 소개했습니다.
해당 제품의 설명서를 다운로드 센터에서 다운로드하여 각 기능 및 설정에 대한 자세한 내용을 확인할 수 있습니다.