war 파일 배포는 어떻게 하나요?

💡 요약 정리

이용 중인 서비스에 따라 war 배포 방법이 다릅니다.
Tomcat JSP 광호스팅: tomcat/webapps/에 업로드하면 자동 배포됩니다. 루트 경로는 ROOT.war를 사용합니다.
JSP 호스팅: 홈 디렉터리(appBase=/home/hosting_users/아이디), docBase=www. FTP 업로드 → Tomcat 중지 및 www 백업 → 재시작 → www/ 자동 전개.
JSP 호스팅에서 루트 경로로 서비스하려면 파일명을 www.war로 업로드하세요.
배포 후 war 파일은 반드시 삭제하세요. 재시작 시 재배포될 수 있습니다.

1. 안내

"이용하시는 서비스 별로 배포 방법이 상이합니다."

2. Tomcat JSP 광호스팅에서 배포하기

자동 배포
- autoDeploy=true 이므로 tomcat/webapps/ 아래에 war 파일을 FTP로 업로드하면 자동 배포됩니다.
- 루트 경로가 기본 애플리케이션 위치입니다. 루트로 서비스하려면 war 파일을 ROOT.war로 패키징해야 합니다.
별도 appBase(서브도메인)로 배포
- 별도로 구성한 서브도메인 appBase(예: tomcat/webapps_sub)에 배포하려면 해당 디렉터리에 war를 업로드하세요.
- 예: tomcat/webapps_sub/ROOT.war 업로드 시 1)과 동일하게 자동 처리됩니다.

참고:

Tomcat Deployer HOW-TO

3. JSP 호스팅(64비트 JSP광호스팅/멀티호스팅/오라클호스팅 등)에서 배포하기

카페24 JSP 호스팅의 기본 경로는 다음과 같습니다.

appBase="/home/hosting_users/아이디"
docBase="www"

아래 단계에 따라 진행하세요. FTP는 “파일을 서버에 올리고 내려받는 방법(프로그램)”을 의미합니다.

루트 경로로 서비스하려면 파일명을 www.war로 업로드하세요.

3.1 배포 파일 업로드(FTP)

FTP로 접속한 뒤 아래 경로에 배포 파일(filename.war)을 업로드합니다.
업로드 후 파일 유형을 확인할 수 있습니다.

[techcsjsp@uj64-005 ~]$ pwd
/home/hosting_users/techcsjsp
[techcsjsp@uj64-005 ~]$ file www.war
www.war: Zip archive data, at least v1.0 to extra

3.2 Tomcat 중지 및 기존 www 폴더 백업

Tomcat이 구동 중이라면 중지한 다음, 기존 www 폴더명을 변경(백업)합니다.

[techcsjsp@uj64-005 ~]$ ./tomcat/bin/catalina.sh stop
Using CATALINA_BASE:   /home/hosting_users/techcsjsp/tomcat
Using CATALINA_HOME:   /home/hosting_users/techcsjsp/tomcat
Using CATALINA_TMPDIR: /home/hosting_users/techcsjsp/tomcat/temp
Using JRE_HOME:        /usr/local/jdk7
Using CLASSPATH:       /home/hosting_users/techcsjsp/tomcat/bin/bootstrap.jar:/home/hosting_users/techcsjsp/tomcat/bin/tomcat-juli.jar
[techcsjsp@uj64-005 ~]$ mv www www_org
[techcsjsp@uj64-005 ~]$ ls -ald www_org/
drwxr-x--- 3 techcsjsp techcsjsp 4096  9월 27 14:08 www_org

3.3 Tomcat 재시작 및 배포 확인

Tomcat을 재시작하면 업로드한 war 파일이 자동으로 풀려(www/) 배포됩니다.
www/ 디렉터리를 확인하면 war가 전개된 파일과 디렉터리를 확인할 수 있습니다.

[techcsjsp@uj64-005 ~]$ ./tomcat/bin/catalina.sh start
Using CATALINA_BASE:   /home/hosting_users/techcsjsp/tomcat
Using CATALINA_HOME:   /home/hosting_users/techcsjsp/tomcat
Using CATALINA_TMPDIR: /home/hosting_users/techcsjsp/tomcat/temp
Using JRE_HOME:        /usr/local/jdk7
Using CLASSPATH:       /home/hosting_users/techcsjsp/tomcat/bin/bootstrap.jar:/home/hosting_users/techcsjsp/tomcat/bin/tomcat-juli.jar
Tomcat started.
[techcsjsp@uj64-005 ~]$ ls -ald www/
drwxr-xr-x 5 techcsjsp techcsjsp 4096  9월 27 14:14 www/
[techcsjsp@uj64-005 ~]$ cd www
[techcsjsp@uj64-005 www]$ ll
합계 20
drwxr-xr-x 2 techcsjsp techcsjsp 4096  9월 27 14:14 META-INF
drwxr-xr-x 4 techcsjsp techcsjsp 4096  9월 27 14:14 WEB-INF
-rw-r--r-- 1 techcsjsp techcsjsp  376  7월 30  2007 hello.jsp
drwxr-xr-x 2 techcsjsp techcsjsp 4096  9월 27 14:14 images
-rw-r--r-- 1 techcsjsp techcsjsp  636  7월 30  2007 index.html

3.4 배포 후 파일 정리

배포 확인 후 war 파일을 삭제하세요.
war 파일을 삭제하지 않으면 Tomcat 재시작 시 재배포가 진행될 수 있습니다.

[techcsjsp@uj64-005 ~]$ rm -f www.war
[techcsjsp@uj64-005 ~]$

3.5 ROOT.war가 아닌 파일명으로 배포하는 경우(컨텍스트 매핑)

예를 들어 sample.war로 배포하고 http://도메인/sample 으로 접속하려면,
- 나의 서비스 관리 > 호스팅 관리 > 톰캣 매핑 메뉴에서 매핑 규칙을 “sample”로 설정하세요.
- 설정 후 접속을 확인합니다.

예시 화면: 톰캣 매핑 규칙 추가/수정 영역

3.6 URL 패턴과 기본 매핑

서블릿 및 .jsp, .do, .jnlp 확장자는 기본적으로 매핑되어 있습니다.
고객님이 web.xml에 정의한 추가 url-pattern이 있다면, 필요한 경우 톰캣 매핑 메뉴에서 규칙을 추가해 적용할 수 있습니다.