$Id: RUNNING.txt,v 1.5 2002/04/24 08:06:14 remm Exp $ The Tomcat 4.0 Servlet/JSP 컨테이너 운영하기 ============================================ 이 서브프로젝트는 Java Software에서 나온 Setvlet 2.3 과 JSP 1.2 스펙을 구현한 Tomcat 4.0 을 포함합니다. 이 컨테이너를 설치 운영하기 위해서는 다음과 같이 해 야 합니다: (0) Java Development Kit 를 다운받아 설치합니다. * Java Development Kit (JDK) release (버전 1.2 이상) 를 여기에서 다운받습니다: http://java.sun.com/j2se/ * JDK 를 설명서에 따라 설치합니다. * 환경변수 JAVA_HOME 에 JDK가 설치된 경로를 설정해 줍니다. (1) Tomcat 4.0 Binary 배포판을 다운받아 설치합니다. NOTE: binary 배포판을 다운받는 대신에, "BUILDING.txt" 에 설명된대로, Tomcat 소스로부터 만들수 있습니다. 이렇게 하게되면, "${catalina.home}" 으로 사용하기 위한 값은, 소스가 설치된 디렉토리의 서브디렉토리"dist" 가 될 것입니다. * 아래 주소에서 Tomcat의 binary 배포판을 다운받습니다: http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/ Windows 사용자의 경우: jakarta-tomcat-4.0-YYYYMMDD.zip Unix 경우: jakarta-tomcat-4.0-YYYYMMDD.zip * 편한 위치에 binary 배포판 압축을 풀고 디렉토리명을 갖게 합니다. (관례적으로 "jakarta-tomcat-4.0" 이라 불립니다.) 이문서의 이후로는 이 디렉토리에 대한 심볼명으로 "${catalina.home}" 을 사용합니다. 이것의 의미는 배포판이 있는 디 렉토리까지의 전체경로입니다. (2) Tomcat 4.0 시작하기 Tomcat 4.0 시작하기위해서는 2가지 테크닉이 있습니다: * 환경변수를 통해: - 환경변수 CATALINA_HOME 을 만들어 Tomcat 4.0 이 설치된 디렉토리 경로 를 설정합니다. - shell 명령을 실행합니다: %CATALINA_HOME%\bin\startup (Windows) $CATALINA_HOME/bin/startup.sh (Unix) * 현재 작업디렉토리를 수정함으로: - 다음 shell 명령을 실행합니다: cd %CATALINA_HOME%\bin (Windows) startup (Windows) cd $CATALINA_HOME/bin (Unix) ./startup.sh (Unix) 시작한 후에, Tomcat 4.0 에 포함된 기본 웹어플리케이션들을 다음 주소를 통해 볼 수 있습니다: http://localhost:8080/ 환경설정과 Tomcat 4.0 운영에 관한 더 자세한 정보는 위 주소로 나온 문서들과 Tomcat 웹 사이트에서 모두 볼 수 있습니다: http://jakarta.apache.org/tomcat/ (3) Tomcat 4.0 종료 Tomcat 4.0 을 정지하는 두가지 방법: * 환경변수 이용: - 환경변수 CATALINA_HOME 을 만들어 Tomcat 4.0 이 설치된 디렉토리 경로 를 설정합니다. - shell 명령을 실행합니다: %CATALINA_HOME%\bin\shutdown (Windows) $CATALINA_HOME/bin/shutdown.sh (Unix) * 현재 작업디렉토리를 수정함으로: - 다음 shell 명령을 실행합니다: cd %CATALINA_HOME%\bin (Windows) shutdown (Windows) cd $CATALINA_HOME/bin (Unix) ./shutdown.sh (Unix) (4) 고급 설정 - 멀티 Tomcat 4 인스턴스 많은 환경에서, Tomcat 4 binary 배포판 싱글 카피를 한 서버에서 여러 사용자들이 공유해야 되는 일이 필요할 때가 있습니다. 이렇게 하기 위해서는, CATALINA_BASE 환경변수를 설정해야 합니다.(위에 설명한 CATALINA_HOME에 추가되는 부분입니다.) 이 CATALINA_BASE 디렉토리는 당신의 인스턴스에 유일한 디렉토리를 지정해야합니다. 이때, Tomcat 4 는 CATALINA_HOME 대신 CATALINA_BASE값에 근거한 아래 디렉토리에 있는 파일들에 대한 모든 상대적 레퍼런스를 계산합니다: * conf - 서버 환경설정 파일들(server.xml 포함) * logs - Log 와 출력파일들 * webapps - 자동으로 로드된 웹 어플리케이션들 * work - 웹 어플리케이션의 임시 작업 디렉토리 * temp - JVM 이 사용하는 임시 파일 디렉토리 (java.io.tmpdir) CATALINA_BASE 를 명확하게 설정하지 않으면, CATALINA_HOME 의 값으로 초기화됩니 다.(즉 모든 상대 경로로 같은 디렉토리가 사용됩니다). $CATALINA_BASE/webapps/admin.xml 와 $CATALINA_BASE/webapps/manager.xml 디렉토리에 있는 admin 과 manager 웹 어플리케이션은 기본 환경설정에서는 동작하지 않습니다. 다음의 처리가 필요합니다: - 컨텍스트의 docBase 속성에 지정된 경로는 절대 경로입니다. 각각을 $CATALINA_HOME/server/webapps/admin 와 $CATALINA_HOME/server/webapps/manager 위치로 바꿔야됩니다. - 두 개의 웹 어플리케이션을 $CATALINA_BASE 에 복사하고, 컨텍스트의 docBase 속성에 지정된 경로대로 수정합니다. - 두 개의 웹 어플리케이션을 사용하지 않으려면 $CATALINA_BASE/webapps/admin.xml 과 $CATALINA_BASE/webapps/manager.xml 디렉토리를 제거하면 됩니다. (5) 문제해결(트러블슈팅): stand-alone Tomcat 4.0 설치하는 동안 안 될 수 있는 3가지 요인이 있습니다: 1) 가장 일반적으로 일어나는 딸꾹질은 다른 웹서버(또는 그와 같은 기능을 하는 어느 프로세스) 가 8080포트를 점유할 때입니다. 이것은 Tomcat 시작할 때 Bind 하는 기본 HTTP 포트입니다. 이것을 변경하려면, 파일을 엽니다: $CATALINA_HOME/conf/server.xml ...그리고, '8080' 을 검색합니다. 사용하지 않는 포트로 바꾸고, 1024 보다 큰 숫자 이어야 합니다. 1024 이하의 포트는 superuser 접근권한을 갖고 있어야 하 기 때문입니다. Tomcat 을 다시 시작하면 됩니다. Tomcat 에 접속할 때 주소에 8080이 제대로 바 뀌었는지 확인하십시오. 예를 들어, 포트를 1977로 바꾸었다면 주소줄에는 http://localhost:1977/ 과 같이 됩니다. 2) Win9X/ME OS 에서 batch 파일을 실행시킬 때 "환경변수 저장공간이 부족합니다" 에러 STARTUP.BAT 와 SHUTDOWN.BAT 파일을 마우스 오른버튼으로 클릭합니다. "등록정보" 에 서 "메모리" 탭을 클릭합니다. "초기환경" 값을 4096 으로 바꿔줍니다. 적용 버튼을 클릭하고 나면 윈도우가 디렉토리 안에 컨테이너를 시작하고 정지시킬 때 사용할 단축아이콘을 만듭니다. 3) 'localhost' 기계를 찾을 수 없습니다. proxy 뒤에 있을 경우 생깁니다. 그런 경우, 브라우저의 proxy 설정을 확인해 보십시오. "localhost" 에 접근하기위해서는 proxy 를 통과할 필요가 없습니다. Netscape는, Edit/preferences -> Advanced/proxies 에서 변경할 수 있고, Internet Explorer는, 도구 -> 인터넷 옵션... -> 연결 -> LAN 설정 에서 변경할 수 있습니다.. ------------------------------------------------------------------ 원본: http://jakarta.apache.org/tomcat/tomcat-4.1-doc/RUNNING.txt 번역자: 허광남 kenu@okjsp.pe.kr 연락처: http://jakarta.apache-korea.org