RHEL/CentOS 에 tomcat 을 service 로 등록하여 booting 시 자동으로 구동되게 하기

Owned by 정광섭
Last updated: 2014-Jun-09
4 min read

Redhat 계열 (CentOS)에 tomcat 을 init.d의 서비스로 등록해서 부팅시 자동으로 시작되게 하는 방법을 정리해 본다.

java 와 tomcat 은 제대로 설치되고 설정되어 있다고 가정한다.

 

init.d 폴더에 등록

run-level utility 인 chkconfig 에 등록하려면 먼저 booting/shutdown 시 참조하는 폴더인 /etc/init.d 에 스크립트가 등록되어 있어야 한다.

 

  1. 구동 스크립트(최종 버전은 gist 에서 찾을 수 있다.)를 /etc/init.d/tomcat-webapp1 으로 저장한다. 하나의 서버에서 여러 개의 tomcat 을 띄울 수 있으므로 식별을 위해 서비스명을 구동 스크립트에 적어주는게 좋고 여기에서는 서비스명이 webapp1 이다.

     Click here to expand...
    /etc/init.d/tomcat-webapp1
    #!/bin/bash
#
# tomcat
#
# chkconfig: 345 96 30
# description:  Start up the Tomcat servlet engine.
#
# processname: java
# pidfile: /var/run/tomcat.pid
#
### BEGIN INIT INFO
# Provides: tomcat
# Required-Start: $network $syslog
# Required-Stop: $network $syslog
# Should-Start: distcache
# Short-Description: start and stop Apache HTTP Server
# Description: implementation for Servlet 2.5 and JSP 2.1
## END INIT INFO

# Source function library.
. /etc/init.d/functions

## tomcat installation directory
PROCESS_NAME=tomcat-servicename

CATALINA_HOME="/home/lesstif/apache-tomcat-7.0.54/"

## run as a diffent user
TOMCAT_USER=lesstif

##  Path to the pid, runnning info file
pidfile=${PIDFILE-/var/run/${PROCESS_NAME}.pid};
lockfile=${LOCKFILE-/var/lock/subsys/${PROCESS_NAME}};

RETVAL=0

case "$1" in
 start)
        PID=`pidofproc -p ${pidfile} ${PROCESS_NAME}`
        if [[ (-n ${PID}) && ($PID -gt 0) ]]; then
                logger -s "${PROCESS_NAME}(pid ${PID}) is  already running."
                exit;
        fi
        if [ -f $CATALINA_HOME/bin/startup.sh ];
          then
            logger -s "Starting Tomcat"
            /bin/su -l ${TOMCAT_USER} -c "$CATALINA_HOME/bin/startup.sh -Dprocessname=${PROCESS_NAME}"
            PID=`ps -eaf|grep processname=${PROCESS_NAME}|grep -v grep|awk '{print $2}'`
            RETVAL=$?
            [ $RETVAL = 0 ] && touch ${lockfile}
            [ $RETVAL = 0 ] && echo "${PID}" > ${pidfile}
        fi
        ;;
 stop)
        PID=`pidofproc -p ${pidfile} ${PROCESS_NAME}`
        ## if PID valid run shutdown.sh
        if [[ -z ${PID} ]];then
            logger -s "${PROCESS_NAME} is not running."
            exit;
        fi

        if [[ (${PID} -gt 0) && (-f $CATALINA_HOME/bin/shutdown.sh) ]];
          then
            logger -s "Stopping Tomcat"
            /bin/su -l ${TOMCAT_USER} -c "$CATALINA_HOME/bin/shutdown.sh"
            RETVAL=$?
            [ $RETVAL = 0 ] && rm -f ${lockfile}
            [ $RETVAL = 0 ] && rm -f ${pidfile}
        fi
        ;;
 status)
        status -p ${pidfile} ${PROCESS_NAME}
        RETVAL=$?
        ;;
 restart)
         $0 stop
         $0 start
         ;;
version)
        if [ -f $CATALINA_HOME/bin/version.sh ];
          then
            logger -s "Display Tomcat Version"
            /bin/su -l ${TOMCAT_USER} -c "$CATALINA_HOME/bin/version.sh"
            RETVAL=$?
        fi
        ;;
 *)
         echo $"Usage: $0 {start|stop|restart|status|version}"
        exit 1
        ;;
esac
exit $RETVAL
  2. tomcat 은 /opt/apache-tomcat-7.0.54 로 설정되어 있으므로 다른 경로에 설치했을 경우 CATALINA_HOME 부분을 수정한다.
  3. 보안 문제때문에 tomcat 프로세스는 tomcat 이라는 계정명으로 구동된다.  다른 계정일 경우TOMCAT_USER 부분을 수정한다.

  4. 실행 속성을 부여한다.

    chmod +x /etc/init.d/tomcat-webapp1

 

run-level 에 등록

부팅과 동시에 실행하려면 run-level 에 등록하면 된다.

  1. 다음 명령어로 run level 에 등록한다.

    chkconfig --add tomcat-webapp1

  2. 제대로 등록되었는지 확인한다. (run level이 3,4,5 일때 구동된다)

    $ chkconfig --list tomcat-webapp1 
tomcat          0:off   1:off   2:off   3:on    4:on    5:on    6:off
  3. 이제 부팅 및 shutdown 시에 자동으로 실행/종료될 것 이다.

cmd 에서 실행

  1. 다른 service 명령과 동일한 옵션을 제공하므로 shell 상에서도 사용할 수 있다.
  2. 시작
    service tomcat-webapp1  start
    재시작
    $ service tomcat-webapp1  restart
 
lesstif: Stopping Tomcat
Using CATALINA_BASE:   /opt/apache-tomcat-7.0.54
Using CATALINA_HOME:   /opt/apache-tomcat-7.0.54
Using CATALINA_TMPDIR: /opt/apache-tomcat-7.0.54/temp
Using JRE_HOME:        /usr
Using CLASSPATH:       /opt/apache-tomcat-7.0.54/bin/bootstrap.jar:/opt/apache-tomcat-7.0.54/bin/tomcat-juli.jar
lesstif: Starting Tomcat
Using CATALINA_BASE:   /opt/apache-tomcat-7.0.54
Using CATALINA_HOME:   /opt/apache-tomcat-7.0.54
Using CATALINA_TMPDIR: /opt/apache-tomcat-7.0.54/temp
Using JRE_HOME:        /usr
Using CLASSPATH:       /opt/apache-tomcat-7.0.54/bin/bootstrap.jar:/opt/apache-tomcat-7.0.54/bin/tomcat-juli.jar
Tomcat started.
    종료
    service tomcat-webapp1  stop
    상태 보기
    $ service tomcat-webapp1  status
 
tomcat (pid  12162)를 실행하고 있습니다..

run-level 에서 삭제

tomcat 은 1024 이상의 포트에서 구동되므로  root 로 실행할 필요가 없고 해당 서비스 계정으로 실행하는게 보안상 더 안전하다. tomcat 구동을 service 명령을 통해서 일반 사용자가 하고 싶을 경우 다음 명령어로 자동 실행을 끈다

 chkconfig tomcat-webapp1 off

 

일반 사용자로 구동은 위와 마찬가지로 service 명령을 통해 수행하면 되고 이 경우 실행 정보는 tomcat 설치 경로에 .${PROCESS_NAME}.pid 형식으로 남게 스크립트가 작성되어 있다.