들어가며

마이크로소프트 윈도우에 설치하는 경우에도 바른은 서버로 설치됩니다. 바른은 서버로 운영되기 때문에 사용자가 화면에서 눈으로 볼 수 있는 도구를 제공하지는 않습니다. 대신에 웹 페이지를 통해서 간단하게 서버의 상태를 볼 수 있습니다. 아래에서 설명합니다.

바른은 윈도우 서비스로 실행됩니다.

인스톨러 설치

다운로드

• bareun.ai 다운로드 합니다.
• 다운로드 받은 파일을 바로 실행합니다.

설치 시작

1. 설치 시작 다운로드 받은 MSI vm

2. 사용권 동의

   최종 사용자 사용권 계약 내용을 확인하고 동의함에 체크한 후 다음을 클릭합니다.

   

3. 설치 폴더 선택

   바른이 설치될 폴더를 선택합니다. 기본 경로는 C:\Program Files\bareun 입니다.

   

4. 설치 준비 및 시작

   설치 준비가 완료되었습니다. 설치 버튼을 눌러 설치를 진행합니다.

   

5. 설치 완료

   설치가 완료되었습니다. 마침을 눌러 설치 마법사를 종료합니다.

   

6. 설치 결과 확인

   설치가 완료되면 지정한 폴더(예: c:\Program Files\bareun)에 파일들이 생성된 것을 확인할 수 있습니다.

   

   또한, 시스템 환경 변수 BAREUN_ROOT가 자동으로 설정됩니다.

   

바른 관리하기

서비스를 설치하고 나면, 이제 API키를 등록할 차례입니다. 시작메뉴에서 바른 도움말을 클릭해서 시작메뉴로 이동할 수 있습니다.

• 여기에서 서비스가 설치된 화면을 보실 수 있습니다. 바른의 API키를 등록할 수 있습니다.
• 이 URL의 주소는 http://localhost:5656 입니다.

명령으로 API키 등록하기

웹에서 진행하지 않고, 명령어로도 API키를 등록할 수 있습니다. ++win+r++ 키를 누른 다음, cmd를 입력해서 명령창을 실행합니다.

cd "c:\Program Files\bareun"
bareun -reg YOUR-API-KEY

윈도우 서비스 관리하기

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

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

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

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

바른 삭제하기

바른을 삭제하는 방법은 크게 2가지입니다.

제거한 뒤 남는 데이터 정리와 zip 설치본 삭제는 바른 삭제하기에서 설명합니다.

• 설치된 메뉴에서 바른 삭제 버튼을 클릭하면 됩니다.
• 또는 시스템 설정에서 앱을 찾아서 삭제할 수 있습니다.

1. 설치된 바른 찾기

2. 삭제하기

주의 바른이 서비스로 실행 중일 때에는 삭제 후에 재시작을 하도록 요구합니다. 만일 서비스를 미리 중지시킨 상태에서는 바로 삭제할 수 있습니다.

zip 설치

zip은 압축을 풀어서 직접 설치하는 방법입니다. 아래 순서를 따라하면 됩니다.

• 다운로드하기
• 압축풀기
• 환경변수 설정하기
• API키 등록하기
• 실행하기
• 웹 도움알 보기

다운로드하기

++win+r++ 키를 누른 다음, 실행 창이 뜨면 위의 cmd를 입력해서 다음 명령을 입력합니다.

curl -OLJs -H "uname: windows, %PROCESSOR_ARCHITECTURE%" https://bareun.ai/api/get

압축해제

이때 bareun-v3.4.0-windows-x86_64.zip 파일이 있습니다. 이 파일을 적당한 위치에 압축해제합니다. bareun-v3.4.0 폴더가 생성됩니다. 여기서는 c:\Users\me\bareun-v3.4.0에 설치했다고 가정합니다.

환경변수 등록하기

++win+r++ 키를 누른 다음, 실행 창이 뜨면 위의 cmd를 입력해서 다음 명령을 입력합니다.

setx BAREUN_ROOT c:\Users\me\bareun-v3.4.0 

또는 PATH에 추가해주는 것도 좋습니다.

setx PATH "%PATH%;c:\Users\me\bareun-v3.4.0\bin"

API키 등록하기

위에서 PATH에 추가했다면, 다음과 같이 명령을 실행하면 됩니다.

bareun -reg YOUR-API-KEY

실행하기

아래와 같이 빠르게 실행하면 됩니다.

start /b "c:\Users\me\bareun-v3.4.0\bin\bareun"

이 창을 닫으면 bareun은 실행이 중지됩니다.

실행이 잘 되었는지를 확인하려면 다음 명령을 실행하세요.

netstat -ano | grep 5656

웹 도움말 보기

브라우저를 실행하고, http://localhost:5656에 접속하세요.

윈도우 설치 문제

vcruntime_1401.dll 문제

• 윈도우10에서 vcruntime_140_1.dll이 설치되지 않아 문제가 발생할 수 있습니다.
• 이 문제는 모든 윈도우10 시스템에서 발생하는 것은 아니며, 다른 설치 프로그램에 의해 해당 DLL이 이미 설치된 경우에는 문제가 나타나지 않을 수 있습니다.
  • 자세한 설명은 여기를 참조 부탁드립니다.

문제해결:

1. 이 링크(vc_redist.x64.exe)를 클릭하여 다운로드한 후 실행하여 설치

2. 바른이 설치되어 있는 폴더(c:\Program Files\bareun\bin)로 이동하여 명령 프롬프트(cmd) 창에서 아래 명령어 실행 - 아래 명령어는 "관리자 권한"으로 실행되어야 합니다.(명령 프롬프트 실행 파일 마우스 우클릭-"관리자 권한"으로 실행)

   복사

    ```cmd
    "c:\Program Files\bareun\bin\bareun.exe" -svc=install
    "c:\Program Files\bareun\bin\bareun.exe" -svc=start
    ```
   

3. 바른 서비스가 실행되고 브라우저에서 http://localhost:5656 접속이 되는지 확인

참고사항:

• 바른 v3.0.0 윈도우 버전에서는 이 설치 문제가 해결되었습니다.

Port 바인딩 문제

• 설치 시점에 바른 서비스가 자동 실행중 오류로 5656 port는 차지하고 정상 실행이 안된 경우입니다. (혹은 다른 서비스가 해당 포트를 사용 중인 경우, 확인 후 종료 필요)

C:\Program Files\bareun\bin>bareun.exe
2024-06-13 09:29:36.923738: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library 'cudart64_110.dll'; dlerror: cudart64_110.dll not found
2024-06-13 09:29:36.924276: I tensorflow/stream_executor/cuda/cudart_stub.cc:29] Ignore above cudart dlerror if you do not have a GPU set up on your machine.
bareun starting with non-service mode for DESKTOP-TR3U2PB\admin
Use config file: C:\Program Files\bareun/config/bareun.json
To know how to use it, open http://0.0.0.0:5656/
failed to listen: listen tcp 0.0.0.0:5656: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.

문제해결:

• 5656 port를 사용하는지 확인한 후 정지시키고, 다시 바른을 실행해야 합니다.

  • 아래 명령어는 현재 5656 포트가 실행중인지 확인합니다.

    복사

    netstat -ano | findstr :5656
    

  • 만약 아래처럼 port가 실행중이라면 맨 끝에 있는 PID(예시:9028)를 종료시켜야 합니다.

    복사

     TCP    0.0.0.0:5656           0.0.0.0:0              LISTENING       9028
     TCP    [::]:5656              [::]:0                 LISTENING       9028
    

  • 아래 명령어로 PID(예시:9028) 프로세스를 종료 시킵니다.

    복사

    taskkill /PID 9028 /F 
    

  • 그리고 다시 윈도우의 서비스 앱에서 바른 한국어 형태소 분석 서비스를 찾아 '시작(S)'을 눌러서 서버를 실행시킵니다.

    

  • 브라우저를 실행하고, http://localhost:5656로 접속하여 정상적으로 도움말이 보이는지 확인합니다.