윈도우 설치 가이드

다음 순서로 윈도우에 매뉴얼웍스를 설치합니다.

윈도우 10을 기준으로 설명합니다.

  1. 자바를 설치합니다.

  2. 매뉴얼웍스 설치 파일을 내려받습니다.

  3. 매뉴얼웍스 설치 파일 압축을 풉니다.

  4. 매뉴얼웍스를 시작합니다.

  5. 설치 마법사를 실행합니다.

자바 설치

자바 설치 여부와 버전 확인

다음 순서로 자바 설치 여부와 버전을 확인합니다.

  1. 윈도우 + X 단축키를 누르면 나타나는 콘텍스트 메뉴에서 <1Windows PowerShell> 메뉴를 선택합니다.

Windows PowerShell 실행

  1. Windows PowerShell에서 다음 명령어를 실행합니다.

java -version

다음과 같은 결과가 나타나지 않거나 버전이 오라클 자바 8.0 이상이 아니거나 오픈 JDK 15.0.1 GA 버전이 아니면 자바를 설치해야 합니다.

자바 버전 확인

자바 설치

다음 순서로 윈도우에 자바를 설치합니다. 오픈 JDK를 설치하려면 오픈 JDK 사용을 참고합니다.

  1. 오라클 자바 사이트에서 자바 설치 파일을 내려받습니다.

    • 자바 8 이상을 내려받아야 합니다..

    • 32비트 윈도우를 사용하면 Windows x86 Offline을, 64비트 윈도우를 사용하면 Windows x64를 선택합니다.

JRE를 내려받을 것인가? JDK를 내려받을 것인가?


JRE(Java Runtime Environment)는 자바로 만든 소프트웨어(쓰리래빗츠와 같은)를 실행시키기 위한 것이고, JDK(Java Development Kit)는 자바 소프트웨어 개발에 필요한 도구와 JRE의 묶음입니다. JRE는 자동 업데이트로 인한 불편함이 있습니다. JRE를 자동 업데이트하면 JRE_HOME 경로를 일일이 바꿔야 합니다. 따라서 JDK를 사용합니다.

  1. 내려받은 파일을 클릭하여 자바를 설치합니다.

JAVA_HOME 환경 변수 설정

다음 순서로 JAVA_HOME 환경 변수를 설정합니다. 시작(startup.bat)과 종료(shutdown.bat) 스크립트 파일에 JAVA_HOME을 설정하려면 다음 내용은 건너 뜁니다.

  1. 파일 탐색기를 열고, 1내 PC(또는 내 컴퓨터)를 선택한 후 마우스 오른쪽을 클릭하면 콘텍스트 메뉴가 나타납니다.

  2. 콘텍스트 메뉴에서 <2속성> 메뉴를 클릭합니다.

컴퓨터 속성 메뉴 열기

  1. 좌측 메뉴에서 <3고급 시스템 설정> 메뉴를 클릭합니다.

컴퓨터에 대한 기본 정보 보기

  1. 시스템 속성 창에서 <4고급> 탭을 선택한 후 탭 아래에 있는 <5환경 변수> 버튼을 클릭합니다.

시스템 속성 창

  1. 환경 변수 창에서 “시스템 변수” 패널 아래에 있는 <6새로 만들기> 버튼을 클릭합니다.

환경 변수 창

  1. 새 시스템 변수 창에서 변수 이름과 값을 입력하고 <7확인> 버튼을 클릭합니다.

새 시스템 변수

변수 값에는 JDK를 설치한 폴더 경로를 입력해야 하는데 자세한 경로는 C:\Program Files\Java 폴더에서 확인합니다.

환경 변수


변수 이름

변수 값1

JDK를 설치

JAVA_HOME

C:\Program Files\Java\jdk1.8.0_271

만약 JRE_HOME을 설정했다면 JAVA_HOME보다 JRE_HOME이 우선합니다.

매뉴얼웍스 설치

설치 파일을 내려받아 압축을 풀면 매뉴얼웍스 설치가 끝납니다.

  1. 매뉴얼웍스 다운로드 페이지에서 윈도우용 설치 파일을 내려받습니다.

  2. 압축을 푼 후 3rabbitz 폴더를 설치하고자 하는 폴더로 옮깁니다.

설치하려는 폴더 전체 경로에 공백 문자와 특수문자(~!@#$%^&*()_+|"<>':`)가 없어야 합니다. C:\Program Files 폴더에는 설치하지 않습니다.

제품 폴더 구성

  1. 위에서 JAVA_HOME을 설정하지 않았다면 매뉴얼웍스 실행 파일(3RABBITZ_HOME/bin/startup.bat과 3RABBITZ_HOME/bin/shutdown.bat)을 에디터(윈도우 메모장과 같은)로 열고 다음을 추가합니다.

set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_271

데이터베이스 설정

다른 데이터베이스를 사용하려면 매뉴얼웍스를 시작하기 전에 데이터베이스 연결 정보를 설정합니다. 다음 문서를 참고합니다.

매뉴얼웍스 설치 파일에 들어 있는 기본 데이터베이스를 사용한다면 다음 단계로 넘어갑니다.

매뉴얼웍스 시작

3RABBITZ_HOME은 매뉴얼웍스를 설치한 폴더를 지칭합니다.

다음 순서로 매뉴얼웍스를 시작합니다.

  1. 파일 탐색기에서 3RABBITZ_HOME\bin 폴더로 이동합니다.

  2. startup.bat 파일을 실행합니다.

  3. 설치 마법사로 초기 설정 작업을 수행합니다.

매뉴얼웍스 종료

다음 순서로 매뉴얼웍스를 종료합니다.

  1. 파일 탐색기에서 3RABBITZ_HOME\bin 폴더로 이동합니다.

  2. shutdown.bat 파일을 실행합니다.

  1. 변수 값은 자바 버전과 폴더 위치에 따라서 다릅니다.