mongodb 3.x on Armbian

여기서는 Arm을 사용하는 SBC1 컴퓨터에 mongodb 3.x 버전을 설치하는 과정이다.

MongoDB Community edition

mongodb 3.x community 버전을 리눅스 기반 시스템에 설치하도록 지원하고 있다. 다만 mongodb-org 를 Odroid-C2에서 설치하면 systemd 스크립트, 설정 파일등이 제대로 설치 안된다.

사전준비

여기서는 Odroid C2 를 사용하고 Armbian 배포본에서 Ubuntu Xeniel 버전을 사용했다.

레포지토리 등록

아래 같이 키 서버를 등록하고 apt source list에 mongodb 를 등록한다.

여러분 시스템이 적용되는 지는 2에 잘 설명되어 있다.

키서버 등록

$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 0C49F3730359A14518585931BC711F9BA15703C6

우분투 계열은 파일 생셩 /etc/apt/sources.list.d/mongodb-org-3.5.list 파일 생성하고 아래 같이 해당 리눅스 버전에 맞는 소스 목록을 추가한다.

Ubuntu 16.04

echo "deb [ arch=amd64,arm64 ] http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.5 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.5.list

Mongodb 3.4 는 /etc/apt/sources.list.d/mongodb-org-3.4.list 파일 생성하고 아래 같이 해당 리눅스 버전에 맞는 소스 목록을 추가한다.

Ubuntu 16.04

echo "deb [ arch=amd64,arm64 ] http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list

Ubuntu 14.04

echo "deb [ arch=amd64 ] http://repo.mongodb.org/apt/ubuntu trusty/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list

remove key & ppa

설치 후 필요 없어서 키 서버, 저장소 목록을 지우려면,

삭제할 키 해시 코드 확인: 다음 같이 8자리 코드로 나오거나

sudo apt-key list

pub   4096R/A15703C6 2016-01-11 [expires: 2018-01-10]
uid                  MongoDB 3.4 Release Signing Key <packaging@mongodb.com>

다음 같이 긴 해시 코드로 나온다.

--------------------
pub   rsa4096 2016-01-11 [SC] [expires: 2018-01-10]
      0C49 F373 0359 A145 1858  5931 BC71 1F9B A157 03C6
uid           [ unknown] MongoDB 3.4 Release Signing Key <packaging@mongodb.com>

/etc/apt/trusted.gpg.d/debian-archive-jessie-automatic.gpg```

이 키를

sudo apt-key del A15703C6

설치

그리고 apt 명령으로 소스 캐시를 갱신하고 mongodb-org 커뮤니티 버전의 mongodb를 설치한다.

sudo apt update
sudo apt install mongodb-org

설치전 mongodb 3.x 버전은 데이터 저장 파일 시스템으로 xfs 를 권장하고 있다.



create systemd / service entry

mongodb-org 설치후 systemctl 스크립트가 /etc/init.d에 복사되지 않았다.

여기서는 odroid-c2 armbian 설치 상태, 일반 리눅스 배포본은 잘 된다.

아래 명령을 실행해 mongodb.service 가 없으면 새로 생성해야 한다.

$ sudo systemctl list-unit-files --type=service |grep mongodb

만약 mongodb.service 가 없다면, /lib/systemd/system/mongod.service 파일을 다음 같이 활성화 시켜준다.

$ cd /lib/systemd/system
$ sudo systemctl enable mongodb.service

mongodb.service 가 있고,

$ sudo systemctl list-unit-files --type=service |grep mongodb
mongodb.service             disabled

disable 상태면 systemctl 명령으로 enable 시킨다.

$ sudo systemctl enable mongodb.service

그리고 서비스를 시작한다.

$ sudo systemctl start mongod.service
$ sudo systemctl status mongod.service
● mongod.service - High-performance, schema-free document-oriented database
   Loaded: loaded (/lib/systemd/system/mongod.service; enabled; vendor preset: enabled)
   Active: active (running) since Tue 2017-07-18 09:17:53 UTC; 1s ago
     Docs: https://docs.mongodb.org/manual
 Main PID: 7234 (mongod)
   CGroup: /system.slice/mongod.service
           └─7234 /usr/bin/mongod --config /etc/mongod.conf

Jul 18 09:17:53 odroidc2 systemd[1]: Started High-performance, schema-free document-oriented database.

mongod 서비스가 제대로 실행됐으면 mongo 클라이언트로 테스트해 볼 수 있으면 접속해 볼 수 있다.



Mongodb 설정

시스템에 사용자 mongodb 가 없으면 새로 만든다.

$ sudo adduser --disabled-password --gecos "" --no-create-home --disabled-password --disabled-login mongodb


mongod.conf

/etc/mongod.conf 파일에 인증을 제외데이터 디렉토리, bindIp, 로그 부분만 설정한다.

storage:
  dbPath: /data/mongodata/
  journal:
    enabled: true

systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log

processManagement:
   fork: true

net:
  port: 27017
  bindIp: 127.0.0.1,192.168.0.20


Directory permissions

로그 디렉토리 /var/log/mongo 그리고 데이터 디렉토리 /data/mongodata 라면 해당 디렉토리에 몽고디비 사용자가 쓸 수 있는 퍼미션을 준다.

$ sudo chown mongo.daemon /var/log/mongodb
$ sudo chown mongodb.mongodb /data/mongodata



시작

명령으로 mongodb를 시작해 설정 파일 등이 제대로 동작하는지 확인하다. 다음 같이 mongod 를 시작해 동작을 확인한다.

$ sudo mongod --port 27017 --dbpath /data/mongodata
...
>

접속에 성공하면 > 프롬프트가 나온다.

현재는 mongo.conf 설정 파일에 접근 제어가 없는 상태에서 mongo 클라이언트로 접속한다 admin 데이터베이스로 전환한다.

$mongo
>
> use admin
switched to db admin
>

admin 데이터베이스에서 관리자 role을 가진 사용자를 추가하고, 사용할 데이터베이스의 사용자와 접근 제어를 추가해서 사용하기 위해서 작업한다.

user administrator

userAdmin role 혹은 userAdminAnyDatabase role을 가진 사용자 만든다. 다음은 admin 데이터베이스에서 사용자를 관리하는 admin 계정을 생성하고 있다.

>db.createUser(
  {
    user:'admin', 
    pwd:'****', 
    roles:['userAdminAnyDatabase']
  }
)
Successfully added user: { "user" : "admin", "roles" : [ "userAdminAnyDatabase" ] }
>
> db.getUsers()

admin 사용자 패스워드 변경

> db.changeUserPassword("accountUser", "SOh3TbYhx8ypJPxmt1oOfL")

사용자의 role 을 변경,

> db.grantRolesToUser( 'admin', [{role: 'userAdmin', db:'admin'}])
> db.getUsers()
[
  {
    "_id" : "admin.admin",
    "user" : "admin",
    "db" : "admin",
    "roles" : [
      {
        "role" : "userAdmin",
        "db" : "admin"
      },
      {
        "role" : "userAdminAnyDatabase",
        "db" : "admin"
      }
    ]
  }
]

혹은 updateUser 를 사용할 수 있다:

db.updateUser( "appClient01", ...



Start with Access Control

앞서 시작한 명령행 mongodb를 종료하고 명령라인에서 재시작 --auth 옵션을 붙여 시작한다.

$ mongod --auth --port 27017 --dbpath /data/mongodata

접근제어 --auth 옵션으로 데이터베이스를 시작하면 로그인시 -u <username>, -p <password>--authenticationDatabase <database> 를 지정해 주어야 한다.

$ mongo --port 27017 -u "admin" -p "****" --authenticationDatabase "admin"
MongoDB shell version v3.4.0
connecting to: mongodb://127.0.0.1:27017
MongoDB server version: 3.4.0
>


명령행으로 시작한 mongod 는 종료하고 설정 파일에 인증을 넣자.


mongod.conf 파일

mongodb.conf 파일에 security.authorization 을 활성화 한다

security:
  authorization: enabled

systemd 로 서비스를 재시작 한다.

$ sudo systemctl restart mongod.service
$ sudo systemctl status mongod.service



기타

WiredTiger library panic

ext4 파일시스템에서 wiredTiger engine으로 실행중 아래 같은 에러가 발생, 여기3 에서 --repair 로 재구성 해보라 햇다.

2017-07-21T23:26:57.991+0900 E STORAGE  [conn31] WiredTiger error (-31804) [1500647217:991504][803:0x7f
5794fc20], file:collection-0--8962566541221692692.wt, WT_CURSOR.next: the process must exit and restart
: WT_PANIC: WiredTiger library panic
2017-07-21T23:26:57.992+0900 I -        [conn31] Fatal Assertion 28558 at src/mongo/db/storage/wiredtig
er/wiredtiger_util.cpp 361

–repair` 로 재구성

$ sudo mongod --storageEngine wiredTiger --repair --dbpath /data/dbdata/

repaire를 sudo로 진행해서 /data/dbdata 안의 index 파일들이 root 소유권으로 바뀐다. 그래서 /data/dbdata 저장소를 chown으로 mongodb 사용자로 다시 설정

$ sudo chown -R mongodb.mongodb /data/dbdata

이제 재시작 하면 된다.

XFS warning

I STORAGE  [initandlisten] ** WARNING: Using the XFS filesystem is strong$y recommended with the WiredTiger storage engine

USB Memory 디스크 사용시

Odroid C2에 64GB USB Memory를 외부 저장장치로 구성. 아래 같이 에러를 발생하며 diagnostic.data 폴더 에러, mongodb 가 다운된다. 아마 ext3 파일 시스템을 사용해서 그런 것 같다.

FTDC     [ftdc] Uncaught exception in 'FileNotOpen: Failed to open interim file /data/mongodata/diagnostic.data/metrics.interim.temp' in full-time diagnostic data capture subsys
tem. Shutting down the full-time diagnostic data capture subsystem.
2017-04-03T15:00:01.659+0900 E STORAGE  [WTJournalFlusher] WiredTiger error (30) [1491199201:659123][877:0x7f7ccfec90], WT_SESSION.log_flush: /data/mongodata/journal/WiredTigerLog.0000000048: handle-write: pw
rite: failed to write 128 bytes at offset 19456: Read-only file system
2017-04-03T15:00:01.662+0900 E STORAGE  [WTJournalFlusher] WiredTiger error (30) [1491199201:662709][877:0x7f7ccfec90], WT_SESSION.log_flush: journal/WiredTigerLog.0000000048: fatal log failure: Read-only fil
e system

stackoverflow 에 diagnostic-data 폴더를 지우고 다시 시작하도록 제시되고 있다:

$ sudo rm -f  /var/lib/mongo/diagnostic.data/*

그리고 /etc/mongod.conf에 full time diagnostic을 비활성화 했다.

setParameter:
    diagnosticDataCollectionEnabled: false

참고

  1. SBC Sigle Board Computer. Raspberry Pi, Odroid 등등… 

  2. Install mongodb on Ubuntu 

  3. UnsupportedFormat fatal assertion in wiredTiger following