모델 업데이트
모델 업데이트
바른은 형태소 분석에 쓰는 모델과 사전을 처음 실행할 때 자동으로 내려받습니다.
그 뒤 새 모델이 나오면, 설치한 서버의 API키 등록 화면에서 직접 골라 적용할 수 있습니다.
서버를 다시 설치하거나 패키지를 다시 받을 필요가 없습니다.
누가 바꿀 수 있나요
모델을 조회하고 적용하는 일은 이 서버를 설치·등록한 API키(바른ID를 발급받은 키)로만 할 수 있습니다. 같은 서버를 함께 쓰는 다른 사용자의 API키로는 목록도 보이지 않습니다. 서버를 설치한 분이 모델을 관리하도록 하기 위한 것입니다.
모델 업데이트 화면 열기
- 설치한
바른의 첫 화면(내장 웹 서버)에 접속합니다. 기본 주소는http://<서버주소>:5656/입니다. - 시작하기 화면에서 API키를 등록합니다. 이미 등록되어 있으면
API키 상태가 보입니다. API키 상태아래의 모델 업데이트 표에서 사용할 수 있는 모델을 확인합니다.
화면이 보이지 않나요
모델 업데이트는 API키를 등록한 뒤에만 나타납니다. 아래 경우에는 보이지 않습니다.
- API키를 아직 등록하지 않은 경우 — 먼저 등록하세요.
- 이 서버를 등록한 API키가 아닌 다른 키로 보고 있는 경우(목록 조회 권한이 없습니다).
모델을 자동으로 내려받지 않도록 설치했거나 특정 모델을 고정해 둔 서버에서는, 표 대신 지금 쓰는 모델 칸만 보입니다. 이때는 여기서 모델을 바꿀 수 없습니다.
지금 쓰는 모델
표 위에 지금 쓰는 모델 칸이 있습니다. 이 서버가 실제로 쓰고 있는 모델의 이름과 설명 (무엇이 바뀐 모델인지), 내려받은 날짜, 호환되는 서버 버전 범위를 보여 줍니다.
목록이 없어도 보입니다
이 칸은 모델을 내려받을 때 서버가 함께 적어 둔 기록에서 읽습니다. 그래서 목록을 불러올 수 없는 환경(모델을 고정해 둔 서버, 바깥 인터넷이 막힌 망)에서도 지금 무엇을 쓰고 있는지 확인할 수 있습니다.
모델을 내려받은 적이 없는 설치본(설치 파일에 모델이 함께 들어 있는 경우)에서는 이름만 보이고 설명은 비어 있습니다.
표에 나오는 정보
| 항목 | 설명 |
|---|---|
| 모델 | 모델의 이름(식별자)입니다. 현재 적용 표시가 붙은 것이 지금 쓰고 있는 모델입니다. |
| 설명 | 그 모델의 특징입니다. 무엇이 좋아졌는지 적혀 있습니다. |
| 발행일 | 모델이 공개된 날짜입니다. |
| 호환 버전 | 그 모델을 쓸 수 있는 바른 서버 버전의 범위입니다. 지금 서버와 맞지 않으면 비호환으로 표시되고 적용할 수 없습니다. |
| 적용 | 그 모델로 바꿉니다. 이미 쓰고 있으면 적용됨으로 표시됩니다. |
모델 적용하기
적용을 누르면 확인 창이 뜨고, 확인하면 다음 순서로 진행됩니다.
- 고른 모델의 모델·사전 파일을 내려받습니다(네트워크 상태에 따라 시간이 걸릴 수 있습니다).
바른서버가 스스로 다시 시작하면서 새 모델을 올립니다.- 잠시 뒤 표의
현재 적용표시가 새 모델로 옮겨집니다. 바뀌지 않았으면새로고침을 눌러 확인하세요.
적용하면 잠시 끊깁니다
새 모델은 서버를 다시 시작해야 올라갑니다. 적용하는 동안 진행 중이던 요청은 끊길 수 있으니, 사용량이 적은 시간에 적용하시는 것이 좋습니다.
보기 전용으로 보일 때가 있어요
클라우드에 배포한 경우나 윈도우에 설치한 경우에는 서버가 스스로 다시 시작할 수 없어서 표가 보기 전용으로 나옵니다. 이때는 어떤 모델이 나와 있는지 확인만 할 수 있고, 실제 적용은 서버를 다시 배포하거나 다시 시작하는 방식으로 해야 합니다.
적용한 뒤 확인하기
- 시작하기 화면 위쪽의
상세보기를 열면모델ID가 보입니다. 이 값이 새 모델의 이름과 같으면 적용된 것입니다. - 분석 결과가 달라질 수 있습니다. 사용자 사전은 모델과 별개로 유지되므로 다시 등록할 필요는 없습니다.
인터넷이 닿지 않는 망에 설치할 때
바른은 첫 실행에서 모델을 내려받지만, 모델이 이미 놓여 있으면 그대로 사용합니다.
그래서 폐쇄망에서는 다음 순서로 준비합니다.
- 인터넷이 되는 곳에 같은 버전의
바른을 설치하고 한 번 실행해, 모델을 내려받게 합니다. - 그 서버의 데이터 영역에 있는 모델 폴더(설치 폴더의
var/models)를 그대로 복사합니다. - 폐쇄망 서버의 같은 위치에 붙여 넣고 서버를 켭니다. 모델이 갖춰져 있으므로 다운로드 없이 기동합니다.
서버 버전과 모델이 맞아야 합니다
모델은 바른 서버 버전과 호환 범위가 정해져 있습니다. 폐쇄망 서버와 같은 버전의
설치본에서 받은 모델을 옮기세요. 버전이 다른 모델을 넣으면 서버가 사용을 거부하거나
분석 품질이 떨어질 수 있습니다.
새 모델로 갱신할 때도 같습니다
폐쇄망에서는 이 화면으로 모델을 바꿀 수 없으므로, 새 모델도 같은 방식으로 옮겨 넣고 서버를 다시 시작합니다. 준비가 어려우면 helpdesk@bareun.ai 로 문의해 주세요.
자주 묻는 질문
Q. 모델을 바꾸면 사용자 사전이 사라지나요? A. 아니요. 사용자 사전은 모델과 따로 보관되므로 그대로 유지됩니다.
Q. 예전 모델로 되돌릴 수 있나요?
A. 표에 남아 있는 예전 모델을 다시 적용하면 됩니다. 목록에서 사라진 모델은 되돌릴 수 없습니다.
Q. 비호환으로 표시된 모델을 쓰고 싶습니다.
A. 그 모델이 요구하는 바른 서버 버전이 지금 설치본과 다릅니다. 서버를 그 범위에 맞는 버전으로
올리거나 내린 뒤에 적용하세요.
Q. 인터넷이 닿지 않는 곳에 설치했습니다. A. 모델 목록을 불러올 수 없으므로 표가 나타나지 않고 지금 쓰는 모델 칸만 보입니다. 모델을 미리 준비해 두는 방법은 아래 인터넷이 닿지 않는 망에 설치할 때를 참고하세요.
도움이 되었나요?