리눅스에서 자바 서블릿과 JSP 사용하기 황 성준 donquabi@netian.com Id: jserv_jsp.html,v 0.2.2 1999/12/07 ______________________________________________________________________ 목차 1. 이 문서에 대하여 2. 운용 환경 3. 준비 사항 4. JDK 설치 5. JSDK 선택 6. ApacheJServ RPM 6.1 패키지 구성 내용 6.2 패키지 설치 7. GNUJSP RPM 8. 구성 파일 8.1 jserv.properties 구성 파일 9. 서블릿 시험 9.1 서버 기동 9.2 서버 상태 보기 9.3 서블릿 실행 9.4 JSP 실행 10. 에필로그 11. 참고 사항 ______________________________________________________________________ 1. 이 문서에 대하여 필자는 올해 6월 초에 아파치 서버에 ApacheJServ 서블릿 엔진과 GNUJSP를 성공적으로 설치하였고, 그 때의 경험을 문서로 남겼다. 그 이후로, 리눅스도, 아파치도, 서블릿 엔진도, JSP도 모두 업그레이드 되었다. 새로워진 리눅스에 새 아파치와 새로운 서블릿 엔진과 GNUJSP를 설치하였는데 낯설지만 즐거운 경험이었다. 당연하겠지만, 이들을 사용 하는 필자의 경험도 업그레이드 되었다. 이 문서 역시 필자의 경험을 토대로 작성하였다. 이 문서는 필자의 경험을 토대로, 리눅스 상에서 아파치 웹 서버와 자바 서블릿과 GNUJSP를 사용하기 위해서 필요한 소프트웨어를 설치하고 조율하 는 과정을 기술한다. 이 문서를 다른 곳에 옮길 경우에 반드시 필자에게 메일을 주시고, 내용을 변경하지 마시고 전문 그대로를 인용하여야 합니다. 이 문서는 필자의 홈페이지에서도 볼 수 있다. http://my.netian.com/ donquabi/linux/jserv/jserv_jsp.html 2. 운용 환경 우선, 필자의 리눅스 운용 환경은 다음과 같다. o Pentium Pro 200MHz (RAM: 64MB) o 알짜 리눅스 6.1 o 커널 2.2.12 o 웹 서버: apache-1.3.9 필자는 오랜 인연 때문에 알짜 리눅스를 즐겨 사용하지만, 여기의 내용은 알짜 리눅스가 아니더라도 래드햇 리눅스 6.1을 기반으로 하는 배포판에도 큰 문제없이 적용 가능할 것이라고 본다. (혹시 필자에게는 없었던 문제가 여러분한테서 생길 수도 있을 것이다. 어떤 것들이 문제가 될 지를 필자는 예상치 못하겠다. 만일 예상치 못한 문제가 발생한다고 하더라도 필자를 탓하지 말기를 당부한다.) 3. 준비 사항 우선, 여기서는 레드햇 리눅스 6.0 이상과, 함께 배포하는 아파치 웹 서버 1.3.6 이상을 설치하였다고 가정하겠다. 아파치 서버에서 자바 서블릿을 사용하기 위해서 다음과 같은 소프트웨어 를 준비하여야 한다. +--------------+--------+------------------------------------------+ | 구 분 | 버 전 | 파 일 (위 치) | +--------------+--------+------------------------------------------+ | JDK | 1.1.8 | ibm-jdk-l118-linux-x86.tgz | | | | | | | ->Java 1.1.8 IBM Developer Kit for Linux | +--------------+--------+------------------------------------------+ | JSDK | 2.0 | jsdk20-solaris2-sparc.tar.Z | | || | | | -> Java Servlet API - Downloads | +--------------+--------+------------------------------------------+ | Apache JServ | 1.1b3 | ApacheJServ-1.1-b3.i386.rpm | | | || +--------------+--------+------------------------------------------+ | GNUJSP | 1.0.0 | gnujsp-1.0.0-1sj.i386.rpm | | | || +--------------+--------+------------------------------------------+ 4. JDK 설치 필자는 IBM 사에서 제공하는 리눅스용 JDK 1.1.8을 선택했고, 여러분들 한테도 권장하고 싶다. IBM 사의 리눅스용 JVM이 성능이 가장 좋다고 한다. 자세한 정보는 'IBM announces Java 1.1.8 for Linux' 를 참고하라. 설치 디렉토리를 /usr/local로 정하고, 압축 파일을 푼다. 오류가 없다면, 현재 디렉토리에 jdk118 디렉토리가 생긴다. 결과를 확인한다. 설치 과정을 다음에 보인다. $ su Password: # cd /usr/local # tar zxvf ibm-jdk-l118-linux-x86.tgz # ls # 그리고, 필자는 /usr/local/java도 /usr/local/jdk118과 동일하게 되도록 링크를 만들었다. ApacheJServ 패키지는 자바 홈 디렉토리를 /usr/local/java로 설정하여 만들어졌다. 만일 자바 디렉토리가 다른 곳 에 위치한다면 필자처럼 링크를 만들어 해결할 수 있다. 5. JSDK 선택 ApacheJServ 서블릿 엔진은 서블릿 API 2.0 규격에 따라 구현되었다. 따라서 아파치에서 사용하는 서블릿은 서블릿 2.0 규격을 지켜야 하고, 또한 이를 지원하는 JSDK를 사용하여 개발해야 한다. JSDK는 서블릿을 컴파일 하고, 시험하는 데 필수적인 개발 도구이다. JSDK는 리눅스를 위한 버전이 별도로 제공되지 않는다. 서블릿 API 규격을 만든 선(Sun) 사에서 제공하는 솔라리스(Solaris)의 것을 리눅스에서도 사용 가능하다. 또한, Paul Siegmann이 제작하여 LGPL로 공개한 무료 JSDK를 사용할 수도 있다. 서블릿 API 2.0 규격대로 구현되어 선 사의 것과 완전하게 호환성을 갖는다. ApacheJServ 패키지에 이를 포함시켰고, 우선적으로 이것을 사용 토록 설정하였다. 만일 여러분이 선의 JSDK를 사용하려면, 먼저 Java Servlet API - Download & Specification에서 솔라리스용 JSDK 2.0을 내려 받는다. 설치 디렉토리를 정하고, ``tar.Z'' 파일을 압축을 풀어 설치한다. ApacheJServ 패키지를 설치한 후 jserv.properties 구성 파일에서 wrapper.classpath를 변경할 수 있다. 6. ApacheJServ RPM ApacheJServ는 소스 파일 형태로 배포된다. 이를 컴파일 하여 실행 파일을 만들고, 함께 배포되는 샘플을 참고하여 실행에 필요한 구성 파일들을 직접 구성하여 만들어야 한다. 이 과정은 INSTALL 파일에 상세하게 설명 되어 있지만, 초보자에게는 여전히 어렵고, 또한 여간 번거로운 게 아니다. ApacheJServ는 아직 베타 꼬리표를 떼지 못했다. 머지 않아 다음 베타 버전이 나오거나 정식 버전이 발표될 것이다. 이에 대비하지 않는다면, 매번 아파치를 다시 컴파일하는 등의 수고에 인내심을 키워야 할 지 모른다. 그런 일을, 가능하다면, 하지 않을 수는 없을까? 그래서, 간편한 설치와 제거를 위하여, 재설치하는 경우 아파치를 컴파일 하는 일에서 자유로워지기 위하여 RPM 파일을 만들었다. 6.1. 패키지 구성 내용 ApacheJServ 패키지를 만들기 위해 사용한 구성 내용은 다음과 같다. ./configure \ -prefix=/usr \ -disable-debugging \ -with-apxs=/usr/sbin/apxs \ -with-logdir=/var/log/httpd \ -with-servlets=/home/httpd/servlets \ -with-jdk-home=/usr/local/java \ -with-JSDK=$RPM_BUILD_DIR/classpathx_servlet-19991120/servlet-2.0.jar 6.2. 패키지 설치 아파치와 JDK가 설치되어 있다면, 다음과 같이 ApacheJServ 패키지를 설치 한다. # rpm -i ApacheJServ-1.1-b3.i386.rpm 설치 과정에 오류가 없다면, 지정된 디렉토리에 파일이 복사되고, /etc/httpd/conf/httpd.conf 파일에 ApacheJServ를 위한 구성 내용을 추가 한다. 패키지 설치로 인해 생성되는 디렉토리와 추가되는 파일은 다음의 표와 같다. +---------------------------+-------------------+------------------+ | 디렉토리 | 파 일 | 설 명 | +---------------------------+-------------------+------------------+ | /etc/httpd/conf/jserv/ | jserv.conf | | | | jserv.properties | 구성 파일 | | | zone.properties | | +---------------------------+-------------------+------------------+ | /etc/httpd/modules/ | ApacheJServ.jar | 서블릿 엔진을 | | | |구현한 클래스 파일| +---------------------------+-------------------+------------------+ | /home/httpd/classes/ | servlet-2.0.jar | JSDK | +---------------------------+-------------------+------------------+ | /home/httpd/servlets/ | Hello.class | 서블릿 예제 | | | IsItWorking.class | | +---------------------------+-------------------+------------------+ | /usr/doc/ApacheJServ-1.1/ | |문서 파일들 | +---------------------------+-------------------+------------------+ 7. GNUJSP RPM GNUJSP는 선 사의 자바 서버 페이지(Java Server Pages)를 구현한 것이다. GNUJSP 서블릿을 설치하면, .jsp 확장자를 가지는 파일을자바 소스 파일로 번역하여 컴파일 하고, 실행하게 된다. GNUJSP 1.0은 JSP 1.0 규격을 지원 한다. GNUJSP는 자바 소스와 클래스 파일 형태로, 무료로 배포된다. 아파치를 포함하여 광범위한 플랫폼, 웹 서버, 서블릿 엔진을 지원한다. 아파치 서버에 설치하는 경우는 함께 배포되는 INSTALL.apache 문서를 참고한다. GNUJSP도, ApacheJServ 패키지와 마찬가지로, 간편한 설치와 구성을 위하여 RPM 패키지로 만들었다. 다음과 같이 GNUJSP 패키지를 설치한다. # rpm -i gnujsp-1.0.0-1sj.i386.rpm 설치 과정에 오류가 없다면, /usr/lib/gnujsp 디렉토리를 생성하고, 클래스 파일이 복사된다. ApacheJServ 구성 파일에 GNUJSP를 위한 구성 내용을 추가하고, GNUJSP 서블릿 존 구성 파일을 추가한다. 패키지 설치로 인해 생성되는 디렉토리와 추가되는 파일은 다음의 표와 같다. +------------------------+-------------------+---------------------+ | /etc/httpd/conf/jserv/ | gnujsp.properties | GNUJSP 존 서블릿 | | | | 구성 파일 | +------------------------+-------------------+---------------------+ | /usr/lib/gnujsp/ | gnujsp.jar | JSP를 구현한 | | | | 클래스 파일 | +------------------------+------------------++---------------------+ | /usr/doc/gnujsp-1.0.0/ | |문서 파일과 JSP 예제들| +------------------------+------------------++---------------------+ 8. 구성 파일 ApacheJServ 사용하려면 다음과 같은 구성 파일들이 필요하다. o jserv.conf (jserv.conf.txt ) o jserv.properties (jserv.properties.txt ) o 서블릿 존[servlet zone] 구성 파일 (zone.properties.txt ) o GNUJSP 서블릿 존[servlet zone] 구성 파일 (gnujsp.properties.txt ) 8.1. jserv.properties 구성 파일 jserv.properties 구성 파일은 ApacheJServ 서블릿 엔진을 위한 실행 환경 을 설정한다. 눈여겨 보아야 할 부분은 다음과 같다. +------------------------------------------------------------------+ | # CLASSPATH environment value passed to the JVM | | wrapper.classpath=/usr/local/java/lib/classes.zip | | wrapper.classpath=/etc/httpd/modules/ApacheJServ.jar | | wrapper.classpath=/home/httpd/classes/servlet-2.0.jar | | : =================================== | | | +------------------------------------------------------------------+ 만일, 선의 JSDK를 /usr/local/JSDK20 디렉토리에 설치하고, 사용하고자 하면, 위의 밑줄 친 부분을 /usr/local/JSDK20/lib/jsdk.jar로 변경한다. 결과는 다음과 같다. +------------------------------------------------------------------+ | # CLASSPATH environment value passed to the JVM | | wrapper.classpath=/usr/local/java/lib/classes.zip | | wrapper.classpath=/etc/httpd/modules/ApacheJServ.jar | | wrapper.classpath=/usr/local/JSDK20/lib/jsdk.jar | | : ============================== | | | +------------------------------------------------------------------+ 9. 서블릿 시험 ApacheJServ 패키지는 아파치를 위한 구성 내용을 httpd.conf 에 추가하기 때문에 서버가 실행 중인 경우에 서버를 재기동하여야 한다. 9.1. 서버 기동 먼저, 웹 서버를 기동해야 한다. 만일, 현재 웹 서버가 실행 중이라면 재기동을 해야 한다. # /etc/rc.d/init.d/httpd stop # /etc/rc.d/init.d/httpd start 9.2. 서버 상태 보기 아파치 서버의 error_log 파일을 열어 파일의 끝 부분을 들여다 보자. 다음과 같은 내용이 있다면, 아파치 서버 데몬과 서블릿 엔진이 정상적 으로 동작 중임을 알 수 있다. +------------------------------------------------------------------+ | ...... | | ... [notice] Apache/1.3.9 (Unix) (ALZZA/Linux) PHP/4.0b3 | | ApacheJServ/1.1b3 configured -- resuming normal operations | | ...... | +------------------------------------------------------------------+ 9.3. 서블릿 실행 패키지를 설치하면, /home/httpd/servlets 디렉토리에 Hello, IsItWorking 서블릿 파일들이 생성된다. 웹 브라우저를 띄워 이 중 하나를 실행해 보자. IsItWorking 서블릿을 실행하기 위한 URL은 다음과 같다. http://localhost/servlets/IsItWorking [IsItWorking 서블릿 실행 결과: 웹 브라우저 화면 ] 9.4. JSP 실행 서블릿 실행이 성공적이면 JSP 파일을 시험한다. 만일 오류가 있다면, JSP 파일에 대해서도 오류를 만날 수 밖에 없다. GNUJSP 패키지를 설치하면, JSP 예제도 함께 설치된다. 위치는 /usr/doc/gnujsp-1.0.0/examples 이다. 이 중 hello.jsp 파일을 /home/httpd/html 디렉토리에 복사하고, 웹 브라우저를 통해 접근해 본다. hello.jsp 파일에 접근하기 위한 URL은 다음과 같다. http://localhost/hello.jsp [hello.jsp 웹 브라우저 화면 ] 10. 에필로그 드디어 ApacheJServ 서블릿 엔진과 GNUJSP 설치가 끝났다. 지금까지의 과정에서 별다른 문제가 없었다면, 서블릿을 실행하여 정상적 인 결과를 보았을 것이다. 또한 JSP도 정상적으로 작동할 것이다. 작은 감동이 느껴지지 않는가? 이제부터 웹과 서블릿을 조화롭게 만끽하는 일만이 남았다. 즐기자! 11. 참고 사항 o The Apache JServ Project o GNUJS o Servlet Central: Using Apache JServ 1.0b1 o Java Servlet API o Alternative Servlet implementation o Servlet FAQ o Java 1.1.8 IBM Developer Kit for Linux 위 내용 중 잘못된 부분을 지적해 주거나 조언을 주시면 감사하겠습니다. 저작권 ⓒ 1999 황 성준 donquabi@netian.com .