리눅스 설치 가이드

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

  1. 자바를 설치합니다.

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

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

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

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

자바 설치

자바 설치 여부와 버전 확인

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

java -version

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

기본적으로 오라클 자바 라이선스에 맞춰 LTS(Long Term Support) 버전인 8, 11, 17, 21, 25 버전을 지원합니다. 하지만 안정성과 성능 등의 이유로 자바 25 버전을 사용하는 것을 권장합니다.

자바 설치

리눅스 배포판과 버전에 따라 자바를 설치하는 방법이 다릅니다. 자바 설치는 리눅스 배포판과 버전에 맞게 진행합니다. 오픈 JDK를 설치하려면 오픈 JDK 사용을 참고합니다.

매뉴얼웍스 설치

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

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

  2. 리눅스 서버로 FTP 등을 이용해서 내려받은 파일을 전송합니다.

리눅스 서버가 인터넷에 연결되어 있다면 다음 명령어로 리눅스 서버로 설치 파일을 내려받을 수 있습니다.

wget https://www.3rabbitz.com/r/home/download/linux --content-disposition

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

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

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

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

제품 디렉터리 구성

제품 디렉터리 구성

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

JAVA_HOME=/usr/lib/jvm/jdk-25.0.1
export JAVA_HOME

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

데이터베이스 설정

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

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

아파치 더비를 쓰던 이전 버전의 데이터를 H2나 다른 데이터베이스로 옮기려면 데이터베이스 옮기기 기능을 사용합니다. 3RABBITZ_HOME 디렉터리에 migrate라는 이름의 빈 파일을 두고 시작하면 이 기능이 켜집니다. H2로 옮기려면 자바 11 이상이 필요합니다. 자세한 방법은 데이터베이스 옮기기를 참고합니다.

매뉴얼웍스 시작

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

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

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

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

./startup.sh

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

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

매뉴얼웍스 종료

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

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

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

./shutdown.sh

root가 아닌 계정으로 실행

보안을 위해 root가 아닌 전용 계정으로 매뉴얼웍스를 실행하는 것을 권장합니다. 다음은 /opt/3rabbitz 디렉터리에 설치한 매뉴얼웍스를 rabbitz 계정으로 실행하는 예입니다.

  1. 매뉴얼웍스를 실행할 계정을 만듭니다.

sudo useradd -m rabbitz

  1. 설치 디렉터리의 소유자를 바꿉니다. 데이터 디렉터리와 백업 디렉터리를 설치 디렉터리 밖에 둔다면 그 디렉터리의 소유자도 바꿉니다.

sudo chown -R rabbitz:rabbitz /opt/3rabbitz

  1. 만든 계정으로 로그인해서 매뉴얼웍스를 시작합니다.

sudo -iu rabbitz /opt/3rabbitz/bin/startup.sh

root가 아닌 계정은 1024 미만의 포트를 열 수 없습니다. 기본 포트인 1975는 상관없습니다. 80 포트로 서비스하려면 iptables로 80 포트 사용하기를 참고합니다.

systemd 서비스로 등록

서버가 시작할 때 매뉴얼웍스를 자동으로 시작하려면 systemd 서비스로 등록합니다. 다음 내용으로 /etc/systemd/system/3rabbitz.service 파일을 만듭니다. 설치 디렉터리, 계정, JAVA_HOME은 실제 값으로 바꿉니다.

[Unit]
Description=ManualWorks
After=network.target

[Service]
Type=forking
User=rabbitz
Group=rabbitz
Environment=JAVA_HOME=/usr/lib/jvm/jdk-25.0.1
PIDFile=/opt/3rabbitz/logs/catalina.pid
ExecStart=/opt/3rabbitz/bin/startup.sh
ExecStop=/opt/3rabbitz/bin/shutdown.sh
SuccessExitStatus=143
TimeoutStopSec=330

[Install]
WantedBy=multi-user.target

다음 명령어로 서비스를 등록하고 시작합니다.

sudo systemctl daemon-reload
sudo systemctl enable --now 3rabbitz

shutdown.sh는 매뉴얼웍스가 멈출 때까지 최대 300초를 기다립니다. 그래서 TimeoutStopSec를 이보다 길게 설정합니다.