서버

바른은 서버로 실행됩니다. 사용자가 문장을 분석하거나 교정된 결과를 얻으려면 클라이언트를 통해서 서버에 접속하여 요청을 전달한 다음에 응답을 받아야 합니다. 바른은 사용자가 사용하지 않는 동안에도 늘 서버로 동작하고 있습니다.

서버로 실행하면, 빠른 실행 결과를 가져옵니다.

실제로 바른이 실행하고 관련 초기화를 수행하는 속도는 1초 정도로 눈 깜짝할 사이에 마무리됩니다. 어떤 엔진들은 초기화하는 데만 40초가 넘는 것들도 있습니다. 그 형태소 분석기는 다양한 데이터베이스를 로딩하는 것으로 보입니다. 이 경우, 매번 실행할 때마다 초기화 과정을 거치게 되므로 40초 동안은 아무런 결과를 줄 수 없는 상황이 벌어질 수 있습니다.

바른은 꽤 큰 딥러닝 모델을 로딩해서 사용하기 때문에 하나만 떠 있으면 여러 개의 클라이언트가 접속해도 자원을 효율적으로 쓸 수 있게 됩니다. 바른이 서버로 동작하지 않는다면, 실행할 때마다 딥러닝 모델을 로딩하고, 기본 사전을 읽어 들인 다음에 자연어 분석을 수행하고 바로 종료하게 될 것입니다. 형태소 분석기를 한번만 실행하고 끝내는 경우가 아니라면, 매우 비효율적이게 됩니다.

서버로 동작하는 것은 자원의 낭비를 줄이는 효과를 얻게 됩니다.

업그레이드 편의성

서버로 동작하는 또 다른 장점은 무엇이 있을까요?

미세한 업그레이드가 있다고 하더라도 클라이언트 프로그램은 정확한 인터페이스만 유지하면 되므로 한군데, 즉 서버만 다시 실행하게 되면 모델, 말뭉치, 사용자 사전 등의 변경사항이 바로 적용됩니다.

API를 통한 접근

또한 다양한 API 형식으로 지원을 할 수 있기 때문에 다양한 언어를 사용할 수 있게 됩니다. 만일 C++로 개발된 경우에는, 자바만 쉽게 지원이 가능하게 됩니다. 다른 언어로 사용 방법을 늘리는 것은 매우 버거운 일이 됩니다.

하지만, 바른은 다양한 API 방식을 지원하기 때문에 손쉽게 사용할 수 있습니다.

• 일반적인 HTTP/1.1을 지원하는 모든 브라우저에서 쉽게 사용이 가능합니다.
• 파이썬, 자바, 자바스크립트 언어는 별도의 클라이언트 라이브러리를 통해서 접근할 수 있습니다.
• R 언어의 경우, 공식적으로 지원하고 있습니다.
• 기타 다른 언어의 경우에도 지원 요청이 있으면 매우 빠르게 개발이 가능합니다.

지원이 필요하다면, 지원요청하기를 참고해 주세요.

서버 실행하기

도커를 사용하거나, 윈도우용 설치본이나 리눅스 데비안 패키지는 기본적으로 서버로 실행합니다. 만일 수동 설치본을 사용한 경우라면, 아래와 같이 실행합니다.

export BAREUN_ROOT=$HOME/bareun-v3.0.0
nohup $BAREUN_ROOT/bin/bareun &

이렇게 실행하면 프로그램을 백그라운드에서 실행됩니다.

로그 보기

서버의 실행 로그는 BAREUN_ROOT/var/logs 디렉터리에 만들어집니다. 제품을 개선하거나 문제점을 파악하는 데, 도움이 될 만한 정보를 로그로 남깁니다. 이 로그 파일에서 그 결과를 확인할 수도 있습니다.

나중에 결함을 보고할 때, 사용할 수도 있습니다.

tail -f $BAREUN_ROOT/var/logs/bareun.log

도커의 경우에는 아래 명령어를 사용하세요.

docker logs -f bareun

모니터링

리눅스 환경에서 서버 실행 또는 모니터링 하기

리눅스 환경에서는 systemctl 명령어를 사용해서 서비스를 재기동하거나 모니터링 할 수 있습니다. 아래 명령어로 서비스 상태를 확인할 수 있습니다.

sudo systemctl status bareun

bareun 서비스가 실행 중이지 않은 경우에는 아래와 같은 결과물이 나올 수 있습니다. 이 경우에는 서비스를 새롭게 시작할 수 있습니다.

sudo systemctl start bareun

또는 필요해 의해서 서비스를 재기동해야 하는 경우에는 재시작 명령어를 사용할 수도 있습니다.

sudo systemctl restart bareun

또한 서비스의 모니터링을 하기 위해서 로그를 볼 수도 있습니다.

sudo journalctl -u bareun

윈도우즈 환경에서 서버 실행 또는 모니터링 하기

++win+r++ 키를 누른 다음, 실행 창이 뜨면 위의 services.msc를 입력하면 아래와 같이 서비스 창이 열리며, 서비스의 목록, 상태 설명 등을 볼 수 있고, 서비스에 대한 여러 작업을 할 수 있습니다. 여기에서 바른 한국어 형태소분석기를 볼 수 있습니다.

• 서비스 속성을 확인하기 위해서 바른 한국어 형태소분석기를 선택하고 오른쪽 마우스 버튼을 클릭해서 속성 메뉴를 선택합니다.

• 서비스 속성은 다음과 같이 등록되어 있습니다.

• 이 화면에서 필요에 따라서 서비스를 중지하거나 다시 시작할 수 있습니다. 아래 그림은 서비스를 시작하는 그림입니다.

net 명령

• 서비스를 시작하려면 net start를 사용합니다.

net start bareunsvc

• 서비스를 중지하려면 net stop를 사용합니다.

net stop bareunsvc

맥OS에서 환경에서 서버 실행 또는 모니터링 하기

• 맥OS에서 패키지 인스톨러(.pkg)로 설치하면 서버는 자동 실행됩니다.

서비스 모니터링

• 맥OS의 Spotlight(단축키 Command+Space) 활성 상태 보기 검색 후 열기 클릭
• 우측 상단에 bareun을 검색하면 아래 그림과 같이 서버가 정상적으로 실행된 것을 볼 수 있습니다.

서비스 중지

• 이후 서버를 중지하려면 터미널에서 다음 명령어를 입력합니다.

sudo launchctl bootout system/ai.baikal.bareun

서비스 재실행

• 서버를 재실행하려면 관리자 권한으로 다음 명령어를 입력합니다.

sudo launchctl bootstrap system /Library/LaunchDaemons/ai.baikal.bareun.plist