JSP 웹서버 셋팅 정리 문서

Ver.2007.09.11

- 작성자: 화랑천(정광선)

- 이메일: gsun2@nate.com (nate)

- 구축환경: Apache2.2 + Tomcat6.0 + JK1.2 + MySql5 on Linux

- 차례

1. Apache 2.2 Install

2. Tomcat 6.0 Install

3. JK 1.2 Install

4. Apache Configuration

5. Tomcat Configuration

6. MySql 5 Install and Configuration

7. Environment variable Configuration And TIP

8. PHP5 And ZendOptimizer Install

- 참고사항

l Linux 는 SULinux(Redhat EL4) 버전에서 테스트 되었다.

l 이 문서는 최신(작성일기준) 버전들의 연동 셋팅방법을 자세히 설명한다.

l 기초적인 것부터 자세히 기술하여 초보자에게 확실한 도움을 주고자 한다.

l 이 단계를 벗어난 로드밸런싱, 클러스터링등은 다루지 않는다

l 다운로드 받거나 보관될 소스 원본 위치: /usr/local/src

l 원칙적으로 RPM 버전은 사용하지 않는다.

l 다운로드 주소는 마우스 오른 클릭 팝메뉴의 [바로가기 복사]로 얻을 수 있다.

l 관리의 편의성을 위하여 프로그램 설치 시 디렉토리명에 버전까지 명시한다.

Ex) apache1.3 apache2.0 둘중 실제 사용하는 것을 apache로 심볼릭링크

1. Apache 2.2 Install

Apache 란? – 정적 파일의 웹 서비스를 담당하는 웹서버

Tomcat 자체적으로도 정적 파일 웹 서비스 기능이 있으나 속도가 느리기 때문에 정적 파일만을 전문으로 서비스하는 Apache 와 연동하여 역할을 분담하는 방식으로 주로 사용한다.

문서 작성 기준 버전: 2.2.6 (lastUpdate 2007.09.07)

"새 버전이 아파치 중 최선이라고 생각하며, 모든 사용자가 업그레이드하기를 권장한다. 아파치 2.2는 2.0 코드베이스와 비교할 때 수많은 개선점과 성능 향상을 이뤘다" // 아파치 재단 성명서

l Apache2 Reference Doc: http://httpd.apache.org/docs-2.2/

l Apache2 Download from httpd.apache.org (wget)

l ]# tar xzvf httpd-2.2.6.tar.gz

l ]# cd httpd-2.2.6

l ]# ./configure --prefix=/usr/local/apache-2.2.6 --enable-so --with-mpm=worker

l ]# make

l ]# make install

l ]# cd /usr/local/

l ]# ln -s apache-2.2.6 apache

l ]# ln -s /usr/local/apache/htdocs /home/webRoot

l ]# ln -s /usr/local/apache/logs /logs

인터넷에서 접할 수 있는 여러 apache 설치 문서에서 -–bindir, --sbindir, --enable-layout 등을 사용하여 리눅스 공용 bin, sbin dir로 옮기는 경우가 있는데, 관리상 불편을 초래하므로 절대 권장하지 않는다. --prefix 설치경로에 몰아 넣는 디폴트 설정에 따르도록 하자.

--enable-so 옵션은 동적공유객체(DSO) 사용 옵션으로 설치 당시의 공유객체들을 정적으로 사용하고 나중에 추가될 공유객체들의 httpd.conf 에서 추가할 수 있게 한다. (httpd –l 로 확인)

--with-mpm=worker 옵션은 다중처리모듈을 worker 로 설정한다. worker 방식은 쓰레드를 사용하여 많은 사용자수에 유연하게 대응할 수 있는 높은 확장성(scalability)이 특징이다. 리눅스에서 설치시 기본값은 prepork 인데, 쓰레드를 사용하지 않으며 MaxClient 256 제한이라는 단점이 있다. worker 옵션을 적용하면 더 적은 메모리를 사용하여 더 빠른 속도를 낼 수 있다.

$APACHE_HOME/htdocs 디렉토리를 /home/webRoot 로 심볼릭링크 한 이유는 이후 가상호스트로 여러 사이트를 운영시 모든 각 사이트들의 DocumentRoot를 /home/SITE_ID 처럼 만들어서 관리의 편의성을 통일하고 권한설정의 편의를 위해서 설정한다.

l 기타 유용한 Apache configure option

Apache 의 configure 설정은 언제든지 재컴파일을 쉽게 할수 있다.(httpd.conf설정유지됨)

]# ./configure --prefix=/usr/local/apache-2.2.4 --enable-so --with-mpm=worker --enable-rewrite --enable-headers

--enable-rewrite 는 정규표현식을 사용하여 URI를 포워딩 해주는 유용한 모듈로써 파라미터를 숨겨서 깔끔한 URI 처리가 가능하다.

사용되는 각 사이트의 DocumentRoot(./htaccess 있는 Dir) 설정

DOCUMENT_ROOT">

AllowOverride all

ex) http://domain.com/USER_ID/1234 -> http://domain.com/index.jsp?id=$1&no=$2

]# vi DOCUMENT_ROOT/.htaccess

RewriteEngine On

RewriteRule ^([a-zA-Z0-9_]+)/([[:digit:]]+)$ ./index.jsp?id=$1&no=$2

--enable-headers 는 IE6 버전에서 각각의 프레임에서 쿠키를 구울 수 없는것을 헤더를 직접 컨트롤함으로써 사용가능하게 하는 목적으로 쓰인다.

ex) Header set P3P "CP=\"ALL CURa ADMa DEVa TAIa OUR BUS IND PHY ONL UNI PUR FIN COM NAV INT DEM CNT STA POL HEA PRE LOC OTC\""

--enable-cache 는 튜닝관련하여 민감한 부분으로 확실한 정보가 부족하기 때문에 Reference Doc 링크를 참조하여 사용할 수 있다면 큰 성능향상을 기대할 수 있다.

http://httpd.apache.org/docs/2.2/mod/mod_cache.html

2. Tomcat 6.0 Install

Tomcat 이란? – 가장 유명한 JSP, Servlet Container

문서 작성 기준 버전: 6.0.14 (lastUpdate 2007.08.09)

Tomcat 을 설치하기 전에 반드시 먼저 JDK 가 설치되어 있어야 한다.

l JDK Download from java.sun.com (wget) *Linux self-extracting version (not RPM)

l wget으로 그냥 받을 경우 파일명이 너무 길기 때문에 -O 옵션을 써준다.

l ]# wget http://192.18.108.208/~~~/jdk-6u2-linux-i586.bin -O jdk-6u2-linux-i586.bin

l ]# chmod +x jdk-6u2-linux-i586.bin

l ]# ./ jdk-6u2-linux-i586.bin

l q (--more-- ,skip)

l yes (agree)

l ]# mv jdk1.6.0_02 /usr/local/

l ]# cd /usr/local/

l ]# ln –s jdk1.6.0_02 jdk

Tomcat 설치는 압축을 푸는 것 만으로 완료된다.

l Tomcat5.5 Reference Doc: http://jakarta.apache.org/tomcat/tomcat-6.0-doc/

l Tomcat5.5 Download from tomcat.apache.org (wget)

l ]# tar xzvf apache-tomcat-6.0.14.tar.gz –C /usr/local/

l ]# cd /usr/local

l ]# mv apache-tomcat-6.0.14 tomcat-6.0.14

l ]# ln -s apache-tomcat-6.0.14 tomcat

l ]# ln -s /usr/local/tomcat/logs/catalina.out /logs/catalina.out

3. JK 1.2 Install

JK Connector 란? - Apache + Tomcat 연동 프로그램

[참고1] JK2 Connector 는 2004.11. 이후 개발 및 지원 중단되어 더이상 사용되지 않으므로 JK2 가 최신버전인 것으로 오해하지 않도록 주의. (deprecated)

[참고2] JK1.2.21 버전과 JK1.2.23 버전에서 중요한 보안 업데이트가 이루어 졌으므로 반드시 1.2.24이상의 최신버전을 사용해야 한다. 최신버전을 사용하고 있지 않다면 반드시 업데이트 해야한다.

문서 작성기준 버전: 1.2.25 (lastUpdate 2007.08.07)

JK 설치에는 두 가지 방법이 있는데, 하나는 일반적인 컴파일로 jk_mod.so 생성 후 아파치 모듈 디렉토리에 복사하고 설정파일에도 추가하는 동적모듈방식이고, 다른 하나는 아파치를 설치하기 이전에 아파치 소스에 포함하여 아파치 설치 때 자동으로 설치되는 정적모듈방식이다. 이중 두번째 방식이 성능이 좋으나 Apache2.2 에서 아직 지원되지 않고 있기 때문에 동적모듈방식만 설명한다.

l JK Connector Reference Doc: http://tomcat.apache.org/connectors-doc/

l JK Connector Download from http://tomcat.apache.org/connectors-doc/ (wget)

l ]# tar xzvf tomcat-connectors-1.2.25-src.tar.gz

l ]# cd tomcat-connectors-1.2.25-src/native

l ]# ./configure --with-apxs=/usr/local/apache/bin/apxs

l ]# make

l ]# cp ./apache-2.0/mod_jk.so /usr/local/apache/modules/

4. Apache Configuration

l ]# vi /usr/local/apache/conf/httpd.conf

l 접근권한 디렉토리 변경 (웹서비스 디렉토리 : /home) (line:128)

/home”>

l 웹에서 디렉토리 파일리스트 정보 출력막기 (Indexes 삭제) (line:141)

Option Indexes FollowSymLinks

l 디렉토리 인덱스파일 리스트에 index.jsp 추가 (line:163)

DirectoryIndex index.html index.jsp

l 에러로그 파일 설정 - 10메가 초과시 새로운 로그파일 생성 (cronolog 대체추천) (line:183)

ErrorLog "|/usr/local/apache/bin/rotatelogs /logs/errorlog.%y%m 10M"

l 기본 엑세스로그 주석처리 (가상호스트 사이트마다 따로 로깅함) (line:212)

CustomLog logs/access_log common

l 로그 필터링 - 불필요한 이미지파일등의 로그는 하지않음 (line:205)

SetEnvIfNoCase Request_URI "\.(gif|jpg|png|css|js|java|swf|ico)$" do_not_log

l JK Connection 설정부분 추가 (line:마지막)

# JK Connection

LoadModule jk_module modules/mod_jk.so

JkWorkerProperty worker.list=ajp13

JkWorkerProperty worker.ajp13.type=ajp13

JkWorkerProperty worker.ajp13.host=localhost

JkWorkerProperty worker.ajp13.port=8009

JkLogFile "logs/mod_jk.log"

JkLogLevel info

JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"

JkMount /*.jsp ajp13

JkMount /*.XXX ajp13

마지막줄은 원하는 JSP 파일 확장자를 추가하는 부분으로 $CATALINA_HOME/conf/web.xml (line:368) 위치에 다음과 같이 같은 확장자를 설정해주면 된다. (필수 아닌 선택)

jsp

*.XXX

l 가상호스트 설정 방법

NameVirtualHost * (line:마지막) 추가

ServerAdmin admin@server.domain

DocumentRoot /home/webRoot

ServerName default.server.domain

CustomLog "|/usr/local/sbin/cronolog /logs/SITE_ID/%y%m%d.log" combined env=!do_not_log

- 처음설정은 디폴트 호스트(DocumentRoot)로써 주로 비워두거나 테스트용도로 설정한다.

- [주의] 가상호스트로 사용하기 위해선 반드시 위에서 설정한 을 확인해야한다. 이를 설정하지 않는다면 모든 가상호스트들 접속시 403에러(접근권한에러)가 난다.

- 이후 추가되는 가상호스트는 같은 형식으로 추가 후 DocumentRoot와 ServerName만 수정

l Cronolog - 위에서 설정한 날짜 별 로그기록 유틸

- http://cronolog.org/download/cronolog-1.6.2.tar.gz

- cronolog 설치 ( ./configure > make > make install )

l 아파치의 접속자수 제한 튜닝 (동시접속자수 수백명이상일경우)

#Include conf/extra/httpd-mpm.conf (line:367) 주석 제거

]# vi /usr/local/apache/conf/extra/httpd-mpm.conf (worker 부분만 수정)

MaxClient 값의 제한은 ServerLimit*ThreadsPerChild 이므로 기본값에 의한 최대치는 현재 400 이다.(16*25) 최대치를 1024 정도로 맞추자면 다음과 같이 설정한다.

StartServers 16

MaxClients 1024

MinSpareThreads 128

MaxSpareThreads 256

ThreadsPerChild 64

MaxRequestsPerChild 0

5. Tomcat Configuration

- server.xml

l Reference Doc: http://jakarta.apache.org/tomcat/tomcat-5.5-doc/config/

l 모두 주석처리 (아파치와의 커넥터(ajp13)만 사용)

l URIEncoding="UTF-8" 추가. (GET request 한글처리)

l 가상호스트 설정(아파치와 똑같이 설정)

virtual.host.domain" appBase="/home/virtualHomeDir" autoDeploy="true">

l DBCP JNDI 설정

- 내에 다음과 같은 형식으로 추가.

name="jdbc/name" auth="Container" type="javax.sql.DataSource"

driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://xxx.xxx.xxx.xxx:3306/dbname?autoReconnect=true&useUnicode=true&min-connections=2"

username="dbid" password="dbpasswd" maxActive="25" maxIdle="10" maxWait="-1" removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true"/>

- 사용할 내에 다음과 같이 ResourceLink 추가

name" global="jdbc/name" type="javax.sql.DataSource"/>

- web.xml

l “$CATALINA_HOME/conf/web.xml”과 “appBase/docBase/WEB-INF/web.xml”의 이해

모든 application에 두 설정 모두 적용되며, 해당 application에 따라 conf/web.xml이 WEB-INF/web.xml에 include 되는 개념이다. 따라서 두 파일에 중복 설정은 불가능하며, 기본적인 공용 설정부분을 conf/web.xml에 쓰고, 해당 application에서만 쓰이는 설정을 WEB-INF/web.xml에 설정하면 된다. 보통 WEB-INF/web.xml 다음과 같이 만들어주면 된다.

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"

version="2.4">

l POST request 한글처리

]# cd /usr/local/tomcat/webapps/examples/WEB-INF/classes

]# jar cvf filters.jar ./filters

]# mv filters.jar /usr/local/tomcat/lib/

]# vi conf/web.xml (맨하단 바로윗줄에 추가)

Set Character Encoding

filters.SetCharacterEncodingFilter

encoding

UTF-8

Set Character Encoding

/*

6. MySql Install and Configuration

문서 작성 기준 버전: 5.0.45 (last update 2007.07.04)

설치 전 mysql 계정이 있는지 반드시 확인하고, 없으면 생성한다. (useradd mysql)

l MySql5.0 Download from dev.mysql.com (wget)

l ]# tar xzvf mysql-5.0.45-linux-i686.tar.gz -C /usr/local/

l ]# cd /usr/local

l ]# ln -s mysql-5.0.45-linux-i686 mysql

l ]# cd mysql

l ]# ./scripts/mysql_install_db

l ]# chown –R mysql.mysql .

l ]# cp support-files/my-huge.cnf /etc/my.cnf

l ]# cp support-files/mysql.server /etc/rc.d/init.d/mysqld

l ]# ln –s ../init.d/mysqld /etc/rc0.d/K01mysqld

l ]# ln -s ../init.d/mysqld /etc/rc3.d/S99mysqld

l ]# service mysqld {start|stop}

l ]# vi /etc/my.cnf

[client]

default-character-set = utf8

[mysqld]

user = mysql

wait-timeout = 300

max-connections = 200

default-character-set = utf8

language = /usr/local/mysql/share/mysql/korean/

[mysqldump]

default-character-set = utf8

[mysql]

default-character-set = utf8

l Connector/J Install

Connector/J Download from dev.mysql.com (wget) (/usr/local/src)

]# tar zxvf mysql-connector-java-5.0.7.tar.gz

]# cd mysql-connector-java-5.0.7

]# mv mysql-connector-java-5.0.7-bin.jar /usr/local/jdk/jre/lib/ext/

l 계정생성 및 권한설정

grant select,insert,update,delete,create,drop on databasename.* to 'id'@'lo

calhost' identified by 'pass';

7. Environment variable Configuration And TIP

l 다음과 같이 /etc/profile 에 환경변수를 추가할때 alias 도 추가해주자.

]# vi /etc/profile (맨하단에 추가)

# user alias

alias tl='tail -f /usr/local/tomcat/logs/catalina.out'

alias ac='vi /usr/local/apache/conf/httpd.conf'

alias tc='vi /usr/local/tomcat/conf/server.xml'

# user environment

export APACHE_HOME=/usr/local/apache

export JAVA_HOME=/usr/local/jdk

export CATALINA_HOME=/usr/local/tomcat

export CATALINA_OPTS="-server"

export MYSQL_HOME=/usr/local/mysql

export PATH=$PATH:$JAVA_HOME/bin

export PATH=$PATH:$CATALINA_HOME/bin

export PATH=$PATH:$APACHE_HOME/bin

export PATH=$PATH:$MYSQL_HOME/bin

l 서버 부팅 후에 바로 서비스가 실행되게 하는 설정

리눅스도 윈도우와 마찬가지로 MYSQL 설치 부분 에서 설정 한것과 같은 서비스방식과 윈도우의 시작프로그램과 같은 방식이 있다. 이중 TOMCAT 과 APACHE 는 서비스방식보다 윈도우의 시작프로그램과 같은 방식이 더 편하기 때문에 이를 설명한다.

]# vi /etc/rc.d/rc.local (맨하단에 추가)

source /etc/profile

catalina.sh start

apachectl start

l UTF-8 환경

UTF-8 인코딩은 완벽하게 한글을 지원할 뿐만 아니라 유니코드로써 다국어 지원 코드이다. 따라서 현재까지 많이 사용되어왔던 EUC-KR 인코딩 방식의 미지원한글 깨짐 문제를 해결할수 있다. 하지만 UTF-8 을 사용하기 위해서는 서버환경설정 뿐만아니라 작성되는 문서도 UTF-8 인코딩 저장되어야 한다. 따라서 개발할 때 사용되는 에디터에서 반드시 저장옵션을 UTF-8 로 해야한다.

8. PHP5 And ZendOptimizer Install

PHP 란? - JSP와 같은 웹서버 스크립트 언어를 뜻함과 동시에 Tomcat같은 웹서버컨테이너 프로그램.

기본적인 JSP 셋팅이 완료된 시점에서 PHP 설치는 선택사항으로써 필요한 경우에만 설치한다. 이는 JSP와 PHP를 동시에 사용하고자 할 때 필요한 경우로써 매력적인 공개소스 중 하나인 ‘제로보드’ 가 PHP 환경에서 실행되기 때문이다.

[참고] Tomcat 의 경우 Apache 와의 연동이 필수가 아닌 선택이지만 PHP 는 반드시 Apache 설치가 필수이다.

l PHP5 Reference Doc: http://doc.php.net/php/dochowto/

l PHP5 Download from http://www.php.net/downloads.php (wget)

l ]# tar zxvf php-5.2.4.tar.gz

l ]# cd php-5.2.4

l ]# ./configure --prefix=/usr/local/php-5.2.4 --with-apxs2=/usr/local/apache/bin/apxs --with-mysql=/usr/local/mysql --with-zlib --with-gd --with-ttf --with-png-dir

l ]# make

l ]# make test

l ]# make install

l ]# cp php.ini-dist /usr/local/php-5.2.4/lib/php.ini

l ]# cd /usr/local/

l ]# ln -s php-5.2.4 php

Zend Optimizer 란? - PHP의 성능을 약40%가량 향상시켜 주는 최적화 유틸

l Zend Optimizer Download from : http://www.zend.com/free_download/optimizer

[참고] 가입필수이며, wget 사용이 불가함. 다운로드 후 ftp 등을 통하여 업로드.

l ]# tar zxvf ZendOptimizer-3.3.0a-linux-glibc21-i386.tar.gz

l ]# cd ZendOptimizer-3.3.0a-linux-glibc21-i386

l ]# ./install

l [TEXT GUI] 보통 OK YES EXIT 등의 단일선택으로 넘어가고 php.ini 경로만 적어주면 된다.

Apache httpd.conf 설정 (ac)

l DirectoryIndex index.htm index.jsp index.php - index.php 추가

l LoadModule php5_module modules/libphp5.so - 확인

l AddType application/x-httpd-php .php .phtml - 추가

l AddType application/x-httpd-php-source .phps - 추가