macOS 설치 가이드

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

  1. 자바를 설치합니다.

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

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

  4. 터미널에서 매뉴얼웍스를 시작합니다.

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

자바 설치

자바 설치 여부와 버전 확인

자바 설치 여부와 버전 확인을 위해 터미널에서 다음 명령어를 실행합니다.

java -version

버전이 자바 11 이상이 아니면 자바를 설치해야 합니다.

자바 설치

Homebrew를 이용해서 Eclipse Temurin 25를 설치합니다. Homebrew가 설치되어 있지 않다면 먼저 Homebrew를 설치해야 합니다.

brew install --cask temurin@25

Adoptium 웹사이트에서 macOS용 설치 파일을 내려받아 설치할 수도 있습니다.

매뉴얼웍스 설치

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

  1. 매뉴얼웍스 다운로드 페이지에서 리눅스용 설치 파일(tar.gz)을 내려받습니다. macOS용 설치 파일은 따로 없으며 리눅스용 설치 파일을 그대로 사용합니다.

설치하려는 디렉터리 전체 경로에 공백 문자와 특수문자(~!@#$%^&*()_+|"<>':`)가 없어야 합니다.

  1. tar 명령어로 압축 파일을 풉니다.

tar -xvf 3rabbitz-2025-0845.tar.gz

설치 파일 이름은 3rabbitz-2025-빌드번호.tar.gz 형식입니다. 예시의 0845 자리에 내려받은 파일의 빌드 번호를 넣습니다.

사파리는 “다운로드 후 ‘안전한’ 파일 열기” 설정이 켜져 있으면 내려받은 압축 파일을 자동으로 풉니다. 이때는 .tar.gz 파일 대신 .tar 파일이나 3rabbitz 디렉터리가 남습니다. .tar 파일이 남았다면 tar -xvf 3rabbitz-2025-0845.tar 명령어로 풀고, 3rabbitz 디렉터리가 이미 있다면 이 단계를 건너뜁니다.

  1. 압축을 푼 3rabbitz 디렉터리의 macOS 격리 속성을 제거합니다. 인터넷에서 내려받은 파일에는 격리 속성(com.apple.quarantine)이 붙어 있어 실행이 막힐 수 있습니다.

xattr -dr com.apple.quarantine 3rabbitz

  1. macOS 사용자 설정 파일(.zshrc 또는 .bash_profile) 또는 쓰리래빗츠 실행 파일(3RABBITZ_HOME/bin/startup.sh과 3RABBITZ_HOME/bin/shutdown.sh)에 JAVA_HOME을 설정합니다.

JAVA_HOME=$(/usr/libexec/java_home -v 25)
export JAVA_HOME

경로는 자바 버전과 디렉터리 위치에 따라서 다릅니다.

매뉴얼웍스 시작

3RABBITZ_HOME은 매뉴얼웍스를 설치한 디렉터리를 지칭합니다.

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

  1. 3RABBITZ_HOME/bin 디렉터리로 이동합니다.

  2. 다음 명령어를 실행합니다.

./startup.sh

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

매뉴얼웍스는 백그라운드에서 실행됩니다. 실행 로그는 3RABBITZ_HOME/logs/catalina.out 파일에 남습니다. 설치 마법사가 나타나지 않으면 이 파일을 확인합니다.

매뉴얼웍스 종료

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

  1. 3RABBITZ_HOME/bin 디렉터리로 이동합니다.

  2. 다음 명령어를 실행합니다.

./shutdown.sh