MongoDB 설정 변경하기

ServBay는 강력한 로컬 웹 개발 환경으로 다양한 데이터베이스 서비스를 통합 제공하며, 그중에는 MongoDB도 포함되어 있습니다. ServBay는 개발자들이 데이터베이스를 편리하게 관리 및 설정할 수 있는 기능을 제공합니다. 본 문서에서는 ServBay에서 MongoDB 설정을 변경하는 방법을 단계별로 안내하며, 그래픽 인터페이스를 이용한 권장 설정 방식과 관련 구성 파일, 자주 사용하는 설정 항목에 대해 설명합니다.

ServBay에 설치된 MongoDB의 구성 파일은 일반적으로 /Applications/ServBay/etc/mongodb/<version> 디렉토리에 위치하며, <version>은 설치된 MongoDB의 버전을 나타냅니다. 예를 들어, MongoDB 8.0의 설정 파일은 /Applications/ServBay/etc/mongodb/8.0 경로에 있습니다.

중요 안내

ServBay는 소프트웨어 패키지(예: MongoDB)의 구성 파일을 자동으로 생성 및 관리합니다. 구성 변경은 ServBay가 제공하는 그래픽 사용자 인터페이스(UI)를 통해 진행할 것을 강력히 권장합니다. 구성 파일을 직접 수동으로 수정할 경우, ServBay의 자동화 프로세스에 의해 변경사항이 덮어써지거나 설정이 유실, 서비스에 문제가 발생할 수 있습니다.

ServBay 그래픽 인터페이스를 통한 MongoDB 설정

ServBay는 사용하기 쉬운 그래픽 UI를 제공하여 개발자가 복잡한 설정 파일을 별도로 편집하지 않고도 MongoDB의 다양한 옵션을 손쉽게 변경할 수 있습니다. 이는 ServBay에서 MongoDB를 설정하는 가장 추천되는 방법입니다.

ServBay 관리 화면 열기: ServBay 애플리케이션을 실행합니다.
데이터베이스 설정 메뉴 이동: ServBay 왼쪽 내비게이션에서 데이터베이스를 클릭한 후, MongoDB를 선택합니다.
MongoDB 버전 선택: 여러 버전의 MongoDB를 설치한 경우, 설정할 특정 버전을 선택합니다.
설정 파라미터 변경: 그래픽 설정 화면에서 MongoDB의 주요 파라미터를 쉽게 수정할 수 있습니다. 예를 들면:
- 리스닝 주소(bindIp): MongoDB가 바인딩할 네트워크 인터페이스를 설정합니다. 기본값 127.0.0.1, ::1은 로컬 접속만 허용합니다. 필요에 따라 이 항목을 수정, 예를 들어 0.0.0.0으로 설정하면 외부 기기 접속도 허용됩니다(잠재적 보안 위험 주의).
- 포트(port): MongoDB 서비스가 리스닝할 포트 번호를 지정합니다. 기본 포트는 27017입니다.
- 기타 설정: 추가적인 일반 설정 항목도 화면에서 확인할 수 있습니다.
추가 파라미터 입력: 고급 설정이 필요한 경우, UI의 Additional Parameters(추가 파라미터) 영역에 YAML 형식으로 직접 입력할 수 있습니다. 입력한 값은 최종 mongod.conf 파일에 병합됩니다.
저장 및 적용: 설정 변경을 완료했다면 하단의 저장 버튼을 클릭하세요. ServBay가 변경사항을 자동으로 구성 파일에 반영하고, 필요 시 MongoDB 서비스를 재시작하여 실시간으로 적용합니다.

ServBay UI를 이용한 설정 변경은, 수동 편집에서 발생할 수 있는 문제를 예방하고 변경사항이 올바르게 반영‧유지되도록 도와줍니다.

MongoDB 구성 파일 이해하기 (참고 또는 임시수정용)

수동 편집은 권장하지 않지만, ServBay 내 MongoDB 구성 파일의 위치와 구조를 이해하면 서비스 동작을 파악하거나 임시 디버깅에 도움이 될 수 있습니다.

구성 파일 위치

MongoDB의 기본 구성 파일은 mongod.conf입니다. MongoDB 버전에 따라 해당 파일은 ServBay 설치 디렉토리 내 특정 위치에 있습니다:

mongod.conf: /Applications/ServBay/etc/mongodb/<version>/mongod.conf

예시로, MongoDB 8.0의 경우 경로는 /Applications/ServBay/etc/mongodb/8.0/mongod.conf입니다.

주요 설정 항목 및 설명

mongod.conf 파일은 YAML 형식으로 작성되며, MongoDB 서버의 런타임 옵션을 정의합니다. 자주 쓰이는 주요 설정과 용도는 아래와 같습니다:

`mongod.conf` 내 주요 설정 항목

네트워크 설정(net):
- bindIp: MongoDB가 리스닝할 IP 주소 지정
  yaml
```
net:
  bindIp: 0.0.0.0 # 모든 네트워크 인터페이스에서 접속 허용 (신중히 사용)
```
  1
  2
  기본값 127.0.0.1, ::1은 로컬 IPv4 및 IPv6 접속만 가능하게 설정합니다. 0.0.0.0으로 변경 시, 모든 IP의 접속이 가능해지므로, 로컬 개발 환경에서 여러 기기 테스트용으로 유용할 수 있지만, 실서비스나 신뢰할 수 없는 네트워크에서는 심각한 보안 위험이 있습니다.
- port: MongoDB가 바인딩할 TCP 포트 번호
  yaml
```
net:
  port: 27017 # 기본 포트
```
  1
  2
  기본 포트가 이미 사용 중이거나 MongoDB 인스턴스별로 다른 포트를 지정하고 싶을 때 해당 값을 변경하면 됩니다.
스토리지 엔진 설정(storage):
- wiredTiger: WiredTiger 스토리지 엔진 파라미터 설정. WiredTiger는 MongoDB 3.2 이상 버전 기본 엔진입니다.
  - engineConfig.cacheSizeGB: WiredTiger 엔진이 사용할 최대 캐시 크기(GB 단위) 지정. 캐시는 WiredTiger의 내부 데이터, 인덱스, 작업 집합 데이터 저장에 활용되며, 캐시 크기를 늘리면 성능이 향상될 수 있지만 시스템 메모리도 더 사용합니다.
    yaml
```
storage:
  wiredTiger:
    engineConfig:
      cacheSizeGB: 1 # 캐시 크기를 1GB로 지정
```
    1
    2
    3
    4
운영 프로파일링 설정(operationProfiling):
- slowOpThresholdMs: '느린 쿼리'로 간주할 임계값(ms 단위) 지정. 해당 시간 이상이 소요된 쿼리는(프로파일러가 켜져 있으면) 느린 쿼리 로그에 기록됩니다. 성능 진단 시 유용합니다.
  yaml
```
operationProfiling:
  slowOpThresholdMs: 100 # 느린 쿼리 임계값을 100ms로 설정
  mode: slowOp # 프로파일링 모드를 slowOp로, 느린 작업만 기록
```
  1
  2
  3

주의: 이런 파일을 수동으로 수정하면, ServBay UI나 기타 관리 작업에서 변경내용이 덮어써질 수 있습니다. 이러한 고급 설정은 ServBay UI의 Additional Parameters 영역에서 추가/수정하는 것이 강력히 추천됩니다.

설정 변경 적용하기 (MongoDB 재시작)

ServBay UI에서 설정을 변경하고 '저장'을 클릭하면, ServBay가 대부분의 경우 자동으로 변경사항을 반영합니다. 단, 어떤 경우에는, 또는 디버깅 목적으로 직접 파일을 수정했다면(재차 비권장), MongoDB 서비스를 직접 재시작해야 할 수 있습니다.

MongoDB를 재시작하는 방법은 두 가지가 있습니다:

ServBay 관리화면에서 재시작

ServBay 관리 인터페이스를 엽니다.
왼쪽의 소프트웨어 패키지 목록으로 이동합니다.
해당 버전의 MongoDB 패키지를 목록에서 찾습니다.
패키지 옆의 재시작 버튼을 클릭합니다.

servbayctl 명령어로 재시작

ServBay는 터미널에서 서비스를 관리할 수 있는 servbayctl 명령어 도구도 제공합니다.

터미널을 열고, 특정 버전의 MongoDB 서비스를 재시작하려면(예: MongoDB 8.0) 아래 명령을 실행하세요:

bash

servbayctl restart mongodb 8.0

이렇게 하면 ServBay가 안전하게 해당 MongoDB 버전을 중지하고 다시 시작합니다.

자주 사용하는 설정 시나리오

MongoDB 설정 변경 방법을 익힌 후, 개발자가 자주 접할 수 있는 대표 시나리오는 다음과 같습니다:

로컬 네트워크 내 타 기기 접속 허용: 신뢰할 수 있는 네트워크에서만, bindIp를 0.0.0.0으로 변경
포트 충돌 해결: 기본 포트를 사용할 수 없을 때, 다른 사용 가능한 포트로 port 번호 변경
성능 향상: 서버 자원에 맞게 cacheSizeGB 파라미터 조정
느린 쿼리 진단: operationProfiling 파라미터로 느린 쿼리 로깅 활성화

주의사항

항상 ServBay 그래픽 UI로 설정을 우선 변경하세요.
/Applications/ServBay/etc/mongodb/<version>/mongod.conf 파일을 직접 변경한 내용은 영구적으로 저장되지 않으며, ServBay의 업데이트나 관리 작업 시 유실될 수 있습니다.
bindIp를 비로컬 접속 허용으로 수정할 때는 네트워크 보안을 반드시 고려해야 하며, MongoDB 인스턴스가 신뢰할 수 없는 네트워크에 노출되지 않도록 주의하세요.

자주 묻는 질문(FAQ)

Q: mongod.conf 파일을 직접 수정했는데 적용이 안 되거나 나중에 다시 원래대로 돌아갔어요. 왜 그런가요?

A: ServBay는 패키지의 설정 파일을 직접 관리합니다. ServBay가 서비스를 재시작하거나 기타 관리 작업을 진행하면 구성 파일이 재생성 또는 덮어써질 수 있습니다. 영구적인 설정 변경은 반드시 ServBay UI를 통해 진행하세요.

Q: ServBay에서 내 MongoDB 설정 파일은 어디서 찾을 수 있나요?

A: 기본 설정 파일 경로는 /Applications/ServBay/etc/mongodb/<version>/mongod.conf이며, 여기서 <version>은 설치한 MongoDB의 버전 번호입니다.

요약

ServBay는 개발자에게 로컬 MongoDB 데이터베이스 설정을 손쉽게 관리할 수 있는 편리한 방법을 제공합니다. ServBay의 그래픽 UI를 사용하면 리스닝 주소와 포트 등 주요 옵션을 안전하고 지속적으로 변경할 수 있습니다. 구성 파일을 직접 확인할 수는 있지만, 잠재적 위험을 예방하려면 UI를 통해 관리하는 것이 강력히 추천됩니다. 대표적 설정 항목과 ServBay를 통한 서비스 재시작 방법을 숙지하면, ServBay의 MongoDB로 더욱 효율적인 개발 작업을 진행할 수 있습니다.

MongoDB 설정 변경하기 ​

ServBay 그래픽 인터페이스를 통한 MongoDB 설정 ​

MongoDB 구성 파일 이해하기 (참고 또는 임시수정용) ​

구성 파일 위치 ​

주요 설정 항목 및 설명 ​

mongod.conf 내 주요 설정 항목 ​

설정 변경 적용하기 (MongoDB 재시작) ​

ServBay 관리화면에서 재시작 ​

servbayctl 명령어로 재시작 ​

자주 사용하는 설정 시나리오 ​

주의사항 ​

자주 묻는 질문(FAQ) ​

요약 ​