[ Tomcat ] catalina.sh - Tomcat 시작하고 종료하기

Apache Tomcat에서 catalina.sh는 Tomcat 서버를 시작, 중지, 재시작하는 등의 관리 작업을 수행하는 메인 스크립트입니다. 이 스크립트는 Unix/Linux 및 macOS 환경에서 사용되며, Tomcat이 설치된 bin 디렉터리에 위치합니다.

catalina.sh의 주요 용도

catalina.sh는 다양한 실행 옵션을 제공하며, 일반적으로 다음과 같이 사용됩니다.

 

1. Tomcat 서버 실행

./catalina.sh start

• 백그라운드에서 Tomcat 서버를 실행합니다.

 

2. Tomcat 서버 종료

./catalina.sh stop

• 실행 중인 Tomcat 서버를 종료합니다.

 

3. 포그라운드 모드 실행 (콘솔에 로그 출력)

./catalina.sh run

• Tomcat을 백그라운드가 아닌 포그라운드 모드로 실행하며, 서버 로그를 터미널에서 직접 확인할 수 있습니다.
• 개발 중 오류 확인 등에 유용합니다.

 

4. 디버그 모드 실행

./catalina.sh jpda start

• Java Debugging을 위한 포트를 열어 디버그 모드로 Tomcat을 실행합니다.
• 기본적으로 8000번 포트를 사용하며, JPDA_ADDRESS 환경 변수를 변경하여 포트 지정 가능.

 

5. 강제 종료 (kill 방식)

./catalina.sh stop -force

• 일반적인 stop 명령이 정상적으로 서버를 종료하지 못할 경우 강제로 종료합니다.

 

6. 환경 변수 확인

./catalina.sh configtest

• Tomcat의 환경 변수 설정이 올바른지 확인합니다.

---

환경 변수 설정

catalina.sh는 실행 시 다양한 환경 변수를 사용할 수 있습니다.

• CATALINA_HOME: Tomcat이 설치된 기본 디렉터리
• CATALINA_BASE: 여러 개의 Tomcat 인스턴스를 실행할 경우 사용되는 개별 인스턴스 디렉터리
• JAVA_HOME: 사용될 JDK의 경로
• CATALINA_OPTS: 서버 실행 시 JVM 옵션 설정 (예: 메모리 설정)
• JPDA_OPTS: 디버그 모드 실행 시 적용할 옵션

---

예제: 메모리 설정 후 실행

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
export CATALINA_OPTS="-Xms512m -Xmx1024m"
./catalina.sh start

• Java 11을 사용하도록 설정
• 최소 힙 메모리 512MB, 최대 1024MB로 설정 후 Tomcat 실행

---

정리

• catalina.sh는 Tomcat 서버를 제어하는 핵심 스크립트.
• start, stop, run, jpda start 등의 다양한 옵션을 제공.
• 환경 변수 설정을 통해 JVM 옵션을 조정 가능.
• Linux/macOS에서 사용되며, Windows에서는 catalina.bat을 사용.

필요한 옵션에 따라 catalina.sh를 활용하면 효율적으로 Tomcat을 관리할 수 있습니다. 😊