개요


이번 글에서는 Apache HTTPD와 Tomcat 간의 세션 클러스터링 방법에 대해서 설명한다.

 

세션 클러스터링은 Web과 연동된 여러대의 Tomcat을 클러스터링하여 세션을 공유하는 기법이다. 

세션 클러스터링 시, Tomcat A의 사용자가 Tomcat B로 연결되어도 A에서 생성한 세션을 그대로 이어받을 수 있다.

 

L4 장비가 없는 로컬 환경에서 진행되므로 이번 글에서는 하나의 Apache에 2대의 톰캣을 연결한다.

 

연동 환경은 다음과 같다.

 

- OS : CentOS 6.7

- Apache Version : Apache 2.4.41

- Tomcat Version : Apache Tomcat 9.0.30

- Connector Version : JK 1.2.48

 

 

연동 전 준비사항


설정 방법은 이전 로드밸런싱 글에 나온 세팅을 그대로 사용한다.

 

https://itwarehouses.tistory.com/12?category=727632

 

Apache HTTPD to Tomcat, 로드 밸런싱(Load Balancing)

개요 이번 글에서는 Apache HTTPD와 Tomcat 간의 로드밸런싱 방법에 대해서 설명한다. 로드밸런싱은 고가용성을 위해 Apache와 Tomcat을 1:N 또는 N:N 방식으로 연결하여 Request를 분산 처리하며, 하나의 톰�

itwarehouses.tistory.com

 

 

Tomcat 설정 전 준비사항


1. Tomcat Session Clustering 간 Multicast를 위한 라우팅 설정이 필요하다.

 

위와 같이 라우팅 설정이 되어있지 않으면 해당 명령어로 주소를 추가하자.

route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0(디바이스명)

 

 

 

2. Session Clustering에 사용되는 포트를 방화벽에서 허가해줘야 한다.

 

CentOS 6의 경우에는 vi /etc/sysconfig/iptables 로 아래의 내용을 추가하고 service iptables restart 실행

-A INPUT -m state --state NEW -m tcp -p tcp --dport 45564 -j ACCEPT
-A INPUT -m state --state NEW -m udp -p udp --dport 45564 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 4000:4100 -j ACCEPT

 

CentOS 7의 경우에는 아래의 명령어를 실행한다.

firewall-cmd --permanent --zone=public --add-port=45564/tcp
firewall-cmd --permanent --zone=public --add-port=45564/udp
firewall-cmd --permanent --zone=public --add-port=4000-4100/tcp
firewall-cmd --reload

 

 

 

3. Apache workers.properties 파일에서 Sticky Session이 활성 되어있는지 확인한다.

 

기본값이 TRUE이기 때문에 아래와 같이 반드시 명시할 필요는 없다. 

 

false 또는 0 으로 되어있을 경우 true 또는 1로 변경한다.

 

 

 

 

Tomcat 관련 설정


Tomcat에서 설정해야할 부분은 총 3곳이다.

 

1. server.xml <Engine> 내 jvmRoute 요소 설정

 

위의 workers.properties 파일에서 로드밸런싱할 톰캣의 이름을 각각 worker1, worker2로 설정했었다.

 

각각의 Tomcat 서버에 jvmRoute 값을 worker1, worker2로 설정한다.

 

jvmRoute 값은 각 Tomcat 인스턴스의 라우팅 식별자로 사용되며, 설정 시 아래와 같이 세션 ID 값에 xxxxxx.${jvmRoute} 로 추가되어 표시된다.

 

 

2. server.xml <Host> 하위에 <Cluster> 설정

 

<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"
                 channelSendOptions="8">

          <Manager className="org.apache.catalina.ha.session.DeltaManager"
                   expireSessionsOnShutdown="false"
                   notifyListenersOnReplication="true"/>

          <Channel className="org.apache.catalina.tribes.group.GroupChannel">
            <Membership className="org.apache.catalina.tribes.membership.McastService"
                        address="228.0.0.4"
                        port="45564"
                        frequency="500"
                        dropTime="3000"/>
            <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"
                      address="auto"
                      port="4000"
                      autoBind="100"
                      selectorTimeout="5000"
                      maxThreads="6"/>

            <Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter">
              <Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender"/>
            </Sender>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatchInterceptor"/>
          </Channel>

          <Valve className="org.apache.catalina.ha.tcp.ReplicationValve"
                 filter=""/>
          <Valve className="org.apache.catalina.ha.session.JvmRouteBinderValve"/>

          <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer"
                    tempDir="/tmp/war-temp/"
                    deployDir="/tmp/war-deploy/"
                    watchDir="/tmp/war-listen/"
                    watchEnabled="false"/>

          <ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/>
        </Cluster>

 

<Receiver> 내의 address 값에 ip 값을 입력하고, 같은 서버에서 여러대의 Tomcat이 동작할 경우 port의 값도 각각 다르게 설정해야 한다.

 

 

 

3. 어플리케이션 디렉터리 WEB-INF/web.xml에 <distributable /> 태그를 삽입한다.

 

 

Tomcat Documentation에 따르면 <distrubutable />이 하는 역할은 다음과 같다.

 

The <Manager> element defined inside the <Cluster> element is the template defined for all web applications that are marked <distributable/> in their web.xml file. However, you can still override the manager implementation on a per web application basis, by putting the <Manager> inside the <Context> element either in the context.xml file or the server.xml file.

 

web.xml에 <distrubutable />이 설정된 모든 어플리케이션이 server.xml에 설정한 <Manager> 설정대로 관리되는 듯 하다.

 

 

 

테스트


정상적으로 세션 클러스터링이 설정되었을 경우 테스트 방법은 아래와 같다.

 

1. Tomcat A, B 기동

2. Tomcat A 또는 B에서 처음으로 세션이 생성됨

3. 세션이 생성된 서버를 Shutdown

4. 나머지 서버의 세션 값이 처음 생성된 세션 값과 동일하면 설정 완료

 

 

1. Tomcat A, B 기동

 

 

 

2. Tomcat A 또는 B에서 세션 생성 확인 (Tomcat A에서 세션이 생성)

 

세션 값을 확인하는 방법은 여러가지가 있으나 여기서는 Chrome 브라우저의 개발자도구를 사용하였음.

 

 

3. 세션이 생성된 서버를 Shutdown(Tomcat A)

 

 

 

4. 나머지 서버(Tomcat B)의 세션 값이 처음 생성된 세션 값과 동일한지 확인

 

세션 값이 1EF398C1540F9380C4163C2F6062171F.worker1 으로 동일한 것을 확인할 수 있다.

 

만약 Session Clustering이 설정되지 않았다면 xxxxxxxx.worker2로 세션 값이 설정되었을 것이다.

 

 

 

개요


이번 글에서는 Apache HTTPD와 Tomcat 간의 로드밸런싱 방법에 대해서 설명한다.

 

로드밸런싱은 고가용성을 위해 Apache와 Tomcat을 1:N 또는 N:N 방식으로 연결하여 Request를 분산 처리하며,

하나의 톰캣이 서비스를 중단해도 다른 톰캣이 바로 연결을 이어받을 수 있다.

 

L4 장비가 없는 로컬 환경에서 진행되므로 이번 글에서는 하나의 Apache에 2대의 톰캣을 연결한다.

 

연동 환경은 다음과 같다.

 

- OS : CentOS 6.7

- Apache Version : Apache 2.4.41

- Tomcat Version : Apache Tomcat 9.0.30

- Connector Version : JK 1.2.48

 

 

 

연동 전 준비사항


설정 방법은 이전 글에 나온 세팅을 그대로 사용한다.

 

https://itwarehouses.tistory.com/11?category=727632

 

Apache HTTPD to Tomcat , WEB/WAS 연동

개요 이번 글에서는 오픈소스 WEB/WAS의 대표 주자인 Apache HTTPD와 Apache Tomcat을 연동하는 방법을 설명한다. Apache와 Tomcat이 설치되어있다는 전제 하에 진행되므로 미리 설치를 해놓자. 연동 환경은 �

itwarehouses.tistory.com

 

workers.properties 파일 수정


또다른 Tomcat의 정보를 추가해야 하므로 workers.properties 파일의 내용을 아래와 같이 수정한다.

 

 

worker.list=worker1,worker2,lb worker 목록에 worker2와 lb(로드 밸런서)를 추가
worker.worker1.lbfactor=1 각 worker가 처리할 부하량을 지정.
현재 설정으로는 1:1 이므로 반반씩 처리한다.
worker.lb.type=lb lb worker는 로드 밸런서이므로 lb로 지정.
worker.lb.balance_workers=worker1,worker2 로드 밸런싱할 worker 목록을 지정.

 

httpd.conf 파일 수정


요청을 workers.properties에서 설정한 로드 밸런서의 별칭으로 전송하기 위해 httpd.conf 파일의 아래 내용을 수정한다.

 

 

 

테스트


테스트를 위해 Tomcat1의 화면에는 This is Tomcat 1,

                   Tomcat2의 화면에는 This is Tomcat 2 가 표시되도록 설정하였다.

 

브라우저 창에 서버 IP를 입력하고 계속 새로고침을 눌러보자.

 

 

 

위와 같이 Tomcat1, Tomcat2의 인덱스 화면이 바뀌면서 출력되는 것을 확인할 수 있다.

 

httpd.conf 파일의 mod_jk 설정 부분에 아래의 설정을 추가하면 로그로도 확인할 수 있다.

 

JkRequestLogFormat "%w %R %V %T %U %q"

 

Apache logs 디렉터리의 mod_jk.log 파일 내용에 request 처리 내역이 추가된다.

이로써 Apache HTTPD와 Tomcat을 연동하고 로드 밸런싱 하는 방법에 대해서 알아보았다.

 

다음 글에는 Apache HTTPD - Tomcat 간의 세션 클러스터링 방법에 대해서 작성하겠다.

'WebServer | WAS > Apache' 카테고리의 다른 글

Apache HTTPD to Tomcat , WEB/WAS 연동  (0) 2020.06.04
Apache 메인 설정 파일 httpd.conf의 설정 요소  (0) 2019.09.20
httpd 옵션  (0) 2019.09.18
apachectl 옵션  (0) 2019.09.18
[CentOS 6] 아파치(Apache) 컴파일 설치  (0) 2019.09.18

개요


이번 글에서는 오픈소스 WEB/WAS의 대표 주자인 Apache HTTPD와 Apache Tomcat을 연동하는 방법을 설명한다.

 

Apache와 Tomcat이 설치되어있다는 전제 하에 진행되므로 미리 설치를 해놓자.

 

연동 환경은 다음과 같다.

 

- OS : CentOS 6.7

- Apache Version : Apache 2.4.41

- Tomcat Version : Apache Tomcat 9.0.30

- Connector Version : JK 1.2.48

 

연동 전 준비사항


Apache와 Tomcat을 연동하기 위해서는 전용 모듈인 mod_jk 모듈이 필요하다.

 

해당 모듈은 아래의 경로에서 받을 수 있다.

 

리눅스 기반에서 진행되므로 tar.gz로 압축된 파일을 받자.

 

https://tomcat.apache.org/download-connectors.cgi

 

Apache Tomcat® - Tomcat Connectors (mod_jk) Downloads

You must verify the integrity of the downloaded files. We provide OpenPGP signatures for every release file. This signature should be matched against the KEYS file which contains the OpenPGP keys of Tomcat's Release Managers. We also provide SHA512 checksu

tomcat.apache.org

 

 

mod_jk 컴파일


다운로드한 tomcat connector 1.2.48 파일의 압축을 해제하고 생성된 디렉터리안의 native 디렉터리로 이동한다.

 

해당 위치에서 아래의 명령을 실행한다.

 

./configure --with-apxs=아파치설치경로/bin/apxs

 

필자의 경우에는 ./configure --with-apxs=/apache24/bin/apxs 였다.

 

Configure 후 make && make install 명령을 통해 컴파일을 마무리한다.

 

컴파일 후 mod_jk.so 모듈이 생성되었는지 확인하려면 Apache 설치 경로의 modules 디렉터리를 확인한다.

 

 

workers.properties 파일 생성


httpd.conf를 설정하기 전에 먼저 workers.properties 파일을 생성해야 한다.

 

workers.properties는 Apache와 연동할 Tomcat의 정보 및 관련 파라미터 값을 설정하는 파일이다.

 

아파치설치경로/conf 디렉터리에 vi workers.properties 명령으로 파일을 생성하고 아래의 내용을 입력한다.

 

 

 

worker.list=worker1 연동할 Tomcat의 별칭
worker.worker1.type=ajp13 worker1에서 사용할 프로토콜 (ajp13 프로토콜이 기본값)
worker.worker1.host=localhost worker1의 IP 주소 또는 호스트명 (WEB/WAS가 같은 서버에 있으므로 loclahost)
worker.worker1.port=8009 worker1의 AJP 포트번호 (8009번 포트가 기본값)

 

httpd.conf 설정 추가


httpd.conf 파일 하단에 아래의 내용을 추가한다.

 

 

LoadModule jk_module modules/mod_jk.so

-> mod_jk.so 모듈을 사용하기위해 적재

 

<IfModule jk_module>

</IfModule>

->  jk_module이 적재되어 있는 동안에만 해당 설정을 적용

 

JkWorkersFile conf/workers.properties

위에서 생성한 workers.properties 파일의 경로를 설정

 

JkLogFile logs/mod_jk.log

연동에 관련된 로그파일이 생성될 경로를 설정

 

JkLogLevel info

로그 파일의 레벨을 설정

 

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

로그 내용의 각 라인 앞에 찍히는 스탬프의 형식을 설정

 

JkMount /* worker1

Apache HTTPD로 들어오는 요청을 worker1로 전송

 

 

연동 테스트


현재 Apache HTTPD는 80, Tomcat은 8080 포트를 사용 중이다.

 

정상적으로 연동되었다면 80번 포트로 접속 시 Apache가 8009번 포트를 통해 Tomcat으로 Request를 전달한다.

 

웹브라우저에 서버 IP를 입력하여 접속해보자.

 

 

IP에 :8080을 붙이지 않고 80번 포트로 접속했을 때 Tomcat의 기본 인덱스 화면이 표시되는 것을 볼 수 있다.

 

이로써 Apache HTTPD와 Apache Tomcat을 연동하는 방법에 대해서 알아보았다.

 

개요


이번 글에서는 Apache Tomcat의 디렉토리 구조와 각 디렉토리 안의 파일들이 어떤 기능을 수행하는지 알아보고자 한다.

본 글은 Apache Tomcat 9 버전을 기준으로 작성되었다.

 

 

Tomcat 디렉토리 구조


/bin

startup, shutdown, 기타 스크립트가 존재한다. sh 파일(유닉스 시스템) bat 파일(윈도우 시스템) 기능적으로 동일하다.

/conf

설정 파일과 DTD 연관된 파일이 존재한다. 가장 중요한 파일인 server.xml 있으며 파일은 컨테이너의 주요 설정 파일이다.

/logs

기본적으로 디렉토리에 로그 파일이 생성된다.

/webapps

기본 webapps 위치하는 디렉토리이다.

/lib

classpath 추가되는 리소스가 위치한 디렉토리이다.

/work

Jsp 파일을 서블릿 형태로 변환한 java 파일과 class 파일이 저장되는 디렉토리이다.

/temp

JVM 사용되는 임시 디렉토리이다.

 

bin 디렉토리 파일


bat 파일은 윈도우에서 실행하는 batch 파일, sh 파일은 유닉스 계열에서 실행하는 shell script 파일이다.

 

bootstrap.jar

Tomcat 서버가 구동될 때 사용되는 main() 메소드가 포함되어 있으며 클래스 로더가 클래스를 구현하는데에 필수적이다.

tomcat-juil.jar

로깅을 구현하는 java.util.logging API를 포함하고 있는 클래스이다.

common-daemon.jar

Apache Commons Daemon 프로젝트에 필요한 클래스이다.

Catalina.sh 파일에 의해 빌드되지 않으며 bootstrap.jar 파일에 의해 참조된다.

catalina.sh

CATALINA 서버의 제어 스크립트이다.

ciphers.sh

지정된 알고리즘을 사용하는 다이제스트 암호를 설정하는 스크립트이다.

configtest.sh

CATALINA 서버의 설정 스크립트이다.

daemon.sh

Common Daemon에 사용되는 스크립트이다.

digest.sh

지정된 알고리즘을 사용하는 다이제스트 암호를 설정하는 스크립트이다.

makebase.sh

Tomcat 실행에 필요한 분산 디렉토리 구조를 생성하는 스크립트이다.

setclasspath.sh

JAVA_HOME 또는 JRE_HOME이 세팅되지 않았을 경우 세팅한다.

shutdown.sh

CATALINA 서버를 중지하는 스크립트이다.

startup.sh

CATALINA 서버를 시작하는 스크립트이다.

tool-wrapper.sh

커맨드 라인 도구에서 사용되는 Wrapper 스크립트이다.

version.sh

Tomcat의 정보를 표시해주는 스크립트이다.

 

conf 디렉토리 파일


catalina.policy

Tomcat의 보안 정책을 설정하는 파일이다.

Catlinasecurity 옵션으로 실행될 때 시행되는 보안 정책을 설정할 수 있다.

catalina.properties

서버를 시작할 때 검색하는 서버, 공유 로더, JAR 등의 정보를 포함한다.

context.xml

세션, 쿠키 저장 경로등을 지정하는 설정 파일이다.

jaspic-providers.xml

사용자 인증 제공 방법에 대해 정의한 파일

logging.properties

Tomcat 인스턴스의 로깅 설정 파일이다.

tomcat-juli.jar 라이브러리를 활용하여 로깅 서비스를 제공한다.

server.xml

Tomcat 설정에서 가장 중요한 파일이다.

Service, Connector, Host 등과 같은 주요 기능을 설정할 수 있다.

tomcat-users.xml

Tomcat manager 기능을 사용하기 위해 사용자 권한을 설청하는 파일이다.

web.xml

Tomcat의 환경설정 파일이며 서블릿, 필터, 인코딩 등을 설정할 수 있다.

lib 디렉토리 파일


annotations-api.jar

자바EE 어노테이션 클래스 파일

catalina.jar

Tomcat Catalina 서블릿 컨테이너를 구현하는 파일

catalina-ant.jar

Tomcat Catalina Ant 작업 파일

catalina-ha.jar

고가용성 패키지 파일

catalina-storeconfig.jar

서버 상태의 흐름을 XML 설정파일로 생성한다.

catalina-tribes.jar

그룹 커뮤니케이션 패키지 파일

ecj-*.jar

이클립스 JDT 자바 컴파일러 파일

el-api.jar

EL 3.0 API 파일

jasper.jar

Tomcat Jasper JSP 컴파일러와 런타임 파일

jasper-el.jar

Tomcat Jasper EL 구현 파일

jsp-api.jap

JSP 2.3 API 파일

servlet-api.jar

Servlet 4.0 API 파일

tomcat-api.jar

Tomcat에 의해 정의되는 몇몇 인터페이스 파일

tomcat-coyote.jar

Tomcat connector와 유틸리티 클래스 파일

tomcat-dpcp.jar

데이터베이스 커넥션 풀을 구현하는 파일

tomcat-i18n-**.jar

Tomcat 언어 패키지 파일

tomcat-jdbc.jar

Tomcat JDBC pool로 알려진 대체 데이터베이스 커넥션 풀을 구현하는 파일

tomcat-util.jar

Apache Tomcat의 다양한 컴포넌트에서 사용되는 일반 클래스 파일

tomcat-websocket.jar

WebSocket 1.1 구현 파일

websocket-api.jar

Websocket 1.1 API 파일

 

 

참조


Apache Tomcat 9 Docs : https://tomcat.apache.org/tomcat-9.0-doc/index.html

 

개요


Apache Tomcat은 자바 서블릿 및 JSP 기술의 오픈 소스 소프트웨어를 구현한 것이다.

Apache Tomcat은 현재 여러 버전이 사용되고 있으며 각 버전마다 요구하는 사양이 다르기 때문에 잘 살펴보고 버전을 선택해야 한다.

 

Apache Tomcat Version


Servlet Spec JSP Spec EL Spec WebSocket Spec JASPIC Spec Apache Tomcat Version Lastest Realeased Version Supported java Version
4.0 2.3 3.0 1.1 1.1 9.0.x 9.0.26 8 and later
3.1 2.3 3.0 1.1 1.1 8.5.x 8.5.46 7 and later
3.1 2.3 3.0 1.1 N/A 8.0.x (superseded) 8.0.53 (superseded) 7 and later
3.0 2.2 2.2 1.1 N/A 7.0.x 7.0.96 6 and later
(7 and later for WebSocket)
2.5 2.1 2.1 N/A N/A 6.0.x (archived) 6.0.53 (archived) 5 and later
2.4 2.0 N/A N/A N/A 5.5.x (archived) 5.5.36 (archived) 1.4 and later
2.3 1.2 N/A N/A N/A 4.1.x (archived) 4.1.40 (archived) 1.3 and later
2.2 1.1 N/A N/A N/A 3.3.x (archived) 3.3.2 (archived) 1.1 and later

현재 톰캣은 9버전까지 출시되었으며 2019-09-23 기준으로 최신 마이너 버전은 9.0.26이다.

 

Apache Tomcat 공식 홈페이지에서 7 이하의 버전에 대한 다운로드와 문서도 제공하고 있지만 최신의 버전일수록 성능이 좋고 커뮤니티의 지원이 활발하므로 최신 버전을 사용할 것을 권장한다.

 

Apache Tomcat 9


Apache Tomcat 9 버전은 현재 개발에 집중하고 있다.

Tomcat 8.0, 8.5를 기반으로 하며 Servlet 4.0, JSP 2.3, EL 3.0, WebSocket 1.1 및 JASPIC 1.1 사양 (JAVA EE 8 플랫폼에서 요구하는 버전)을 구현한다.

주요 개선사항은 다음과 같다.

 

  • HTTP/2에 대한 지원 추가(Apache Tomcat 9.0.0 이후 Java 9에서 실행해야 함) 또는 설치 중인 Tomcat Native 라이브러리)
  • JSSE 커넥터(NIO 및 NIO2)에서 TLS 지원을 위한 OpenSSL 사용 지원 추가
  • TLS 가상 호스팅(SNI) 지원 추가

Apache Tomcat 8


Apache Tomcat 8.0은 Tomcat 7.0.x를 기반으로 하며 Servlet 3.1, JSP 2.3, EL 3.0 및 WebSocket 1.1 사양을 구현한다. 

주요 개선사항은 다음과 같다.

 

  • 이전 버전에서 제공되는 여러 리소스 확장 기능을 대체하기 위한 단일 공통 리소스 구현

Apache Tomcat 8.5는 Apache Tomcat 8.0.x와 동일한 Servlet, JSP, EL 및 WebSocket 사양 버전을 지원한다.

그 외에도 JASPIC 1.1 규격을 구현한다.

현재 Tomcat 8.0은 8.5로 대체되어 사용되지않는다.

Tomcat 8.5의 주요 개선사항은 다음과 같다.

 

  • HTTP/2에 대한 지원 추가(Tomcat Native 라이브러리 필요)
  • JSSE 커넥터(NIO 및 NIO2)에서 TLS 지원을 위한 OpenSSL 사용 지원 추가
  • TLS 가상 호스팅(SNI) 지원 추가

Apache Tomcat 8.5에서 다음 기술이 제거되었다.

 

  • HTTP 및 AJP 커넥터의 BIO 구현
  • Comet API 지원

Apache Tomcat 7


Apache Tomcat 7.x는 Tomcat 6.0.x의 개선 사항을 기반으로 하며 Servlet 3.0, JSP 2.2, EL 2.2 및 WebSocket 1.1 사양을 구현한다.

주요 개선사항은 다음과 같다.

 

  • 웹 애플리케이션 메모리 누수 감지 및 방지
  • Manager 및 Host Manager 애플리케이션의 보안 향상
  • 일반 CSRF 보호
  • 웹 응용 프로그램에 외부 콘텐츠 직접 포함 지원
  • 리팩터링(커넥터, 라이프사이클) 및 많은 내부 코드 정리

참조


Apache Tomcat Which Version : https://tomcat.apache.org/whichversion.html

 

 

개요


이번 글에서는 Apache의 메인 설정 파일인 httpd.conf의 설정 요소에 대해서 알아보고자 한다.

Apache docs에 따르면 httpd.conf에 설정할수 있는 요소는 수백가지가 있지만 모두 정리할 수는 없으므로 기본적인 요소만 정리하도록 하겠다.

처음 보는 사용자의 이해를 돕기 위해 파일의 위에서 아래쪽 순으로 요소를 정리하였다.

httpd.conf 파일은 #을 주석으로 사용한다.

아래의 경우에는 #이 붙은 /apache 를 무시하고 /home/apache를 ServerRoot로 사용한다.

 

 

 

구성 요소


directive라는 공식 문서의 표현에 맞게 구성 요소를 지시자라고 명명하겠다.

 

ServerRoot

  • Apache 서버가 존재하는 디렉토리를 설정한다.
  • 일반적으로 하위 디렉토리 conf와 logs를 포함한다.
  • 다른 지시자의 상대 경로는 ServerRoot를 기준으로 지정된다.
  • 초기값은 Apache를 컴파일하여 설치할 때 prefix로 지정한 경로이다.

 

Listen

  • Apache와 통신하는 특정한 포트를 설정한다.
  • Listen 지시자가 설정되어있지 않으면 Apache가 시작되지 않는다.

 

LoadModule

  • ${ServerRoot}/modules 디렉토리 안에 있는 모듈을(so 파일)을 읽어들이고, 사용 가능한 모듈 목록에 추가한다.

 

<IfModule>

  • 특정 모듈이 존재하는 경우에만 작동하는 지시자를 설정하기 위해 사용된다.
  • 해당 모듈이 존재하지 않는다면 IfModule 태그 안의 모든 설정 무효화된다.

 

ServerAdmin

  • 서버에서 오류가 발생했을때 클라이언트로 전송하는 오류 메세지에 들어갈 이메일 주소를 설정한다.

 

ServerName

  • 서버가 자신을 식별하기 위해서 사용하는 호스트 이름 및 포트를 설정한다.
  • 등록된 DNS 이름을 가지고 있지 않다면 IP 주소로 설정해야 한다.
  • ServerName을 서버가 확인할 수 없는 IP 주소로 설정하면 Apache 구동 시 경고 메세지를 표시하고, 시스템에서 사용할 수 있는 모든 호스트 이름을 사용한다.

 

DocumentRoot

Apache가 제공하는 웹 어플리케이션 디렉토리를 설정한다.

DocumentRoot 마지막에 슬래시(/)를 지정해서는 안된다.

 

<Directory>

  • 해당 디렉토리 경로 또는 와일드카드, 정규 표현식으로 설정된 디렉토리 또는 파일에 적용되는 옵션을 설정한다.
  • 경로를 "/" 로 설정하면 모든 디렉토리에 적용되는 옵션을 설정한다.

다음은 <Directory> 태그 안에서 설정할 수 있는 지시자들이다.

 

  • Options : 특정 디렉토리에서 사용할 수 있는 서버 기능을 제어한다.
  • AllowOverride : .htaccess 파일의 사용 여부를 결정한다. (All | None)
  • Require : 해당 디렉토리의 접근 허용 여부를 설정한다.
Options All 모든 Options가 MultiViews에 허용된다.
ExecCGI mod_cgi를 사용하는 CGI 스크립트 실행을 허용한다.
FollowSymLinks 설정한 디렉토리에서 심볼릭 링크를 허용한다.
Includes mod_include를 사용하는 SSI(Server Side Includes)를 허용한다.
IncludesNOEXEC SSI를 허용하지만, #exec cmd와 #exec cgi는 사용하지 못한다. 
Indexes 클라이언트가 요청한 디렉토리 경로에 DirectoryIndex 지시자에 설정한 파일이 없을 경우, 디렉토리 목록을 화면에 표시한다. (디렉토리 리스팅)
MultiViews mod_negotiation에서 제공하는 다중 확장자를 지원하기 위해 사용하는  MultiViews 기능을 사용한다.
SymLinksIfOwnerMatch 대상 파일이나 디렉토리가 동일한 사용자가 소유하고 있는 심볼릭 링크만 사용한다.
Require all denied 모든 접근을 거부
all granted 모든 접근을 허용
ip xxx.xxx.xxx.xxx 특정 IP의 접근을 허용
not ip xxx.xxx.xxx.xxx 특정 IP의 접근을 거부
host example.com 특정 호스트의 접근을 허용
not host example.com 특정 호스트의 접근을 거부

 

DirectoryIndex

  • 클라이언트가 파일이 아닌 디렉토리 경로를 요청했을 경우 제공할 파일 목록을 설정한다.
  • 예) DirectoryIndex가 index.html로 설정되었으면, 클라이언트가 example.com/abc 를 요청했을 때 abc 디렉토리의 index.html를 찾아서 반환한다.

 

<Files>

  • 해당 파일 경로, 와일드카드 또는 정규 표현식으로 설정된 파일에 대한 옵션을 설정한다.
  • 주로 접근 권한이 설정된다.

 

ErrorLog

  • Apache 에러 로그가 생성될 경로를 지정한다.

 

LogLevel

  • ErrorLog의 로그 수준을 설정한다.
emerg 서버를 동작할 수 없는 긴급상황이 발생했을 경우
alert 반드시 조치해야 할 상황이 발생했을 경우
crit 매우 치명적인 상황이 발생했을 경우
error 에러가 발생했을 경우
warn 경고 수준의 상황이 발생했을 경우
notice 오류가 아닌 정상적인 상황이지만 중요하여 사용자에게 알려야 할 경우
info 일반적인 서버 운용 로그
debug 매우 자세한 디버그 수준의 로그

 

LogFormat

 

  • 커스텀 로그에 사용되는 로그 형식을 설정할 수 있다.
  • 설정한 로그 포맷에 이름을 설정하여 간단하게 저장하고 사용할 수 있다.
%% 퍼센트 기호(%)를 로그에 표시
%a 원격 IP 주소
%A 서버 IP 주소
%B HTTP 헤더를 제외한 전송 바이트 수
%b

HTTP 헤더를 제외한 전송 바이트 수

전송한 내용이 업슨ㄴ 경우 0 대신 "-" 로 표시

%{Foobar}C Foobar 쿠키의 내용
%D 요청을 처리하는데 걸린 시간 (마이크로초 단위)
%{FOOBAR}e 환경변수 FOOBAR의 내용
%f 파일명
%h 원격 호스트명
%H 요청 프로토콜
%{foobar}i foobar: 요청 헤더의 내용
%l 원격 로그인명
%m 요청 메소드
%{foobar}n 다른 모듈이 기록한 foobar 노트 내용
%{foobar}o foobar: 응답 헤더의 내용
%p 서버의 정규 포트
%P 서버의 자식 프로세스 ID
%{format}P

서버의 자식 프로세스 ID 혹은 스레드 ID

format에는 pid , tid 설정 가능

%q 쿼리 문자열
%r 요청의 첫번째 줄
%s 요청의 상태코드
%t Common Log Format 시간 형식의 시간
%{foobar}t strftime 형식의 시간 (지역 시간)
%T 요청을 처리하는데 걸린 시간 (초 단위)
%u 원격 사용자
%U 쿼리 문자열을 제외한 요청 URL 경로
%v 요청을 서비스한 서버의 정규 ServerName
%V UseCanonicalName에 따른 서버명
%X

응답을 마쳤을 때 연결 상태

X = 응답을 마치기 전에 연결이 끊어짐

+ = 응답을 보낸 후에도 연결이 살아있음 (KeepAlive)

- = 응답을 보낸 후 연결이 끊어짐

%I 요청과 헤더를 포함한 수신 바이트 수
%O 헤더를 포함한 송신 바이트 수

 

CustomLog 

  • Access 로그 파일이 저장되는 위치와 포맷을 설정한다.
  • LogFormat에서 지정한 포맷을 이름으로 불러와서 사용할 수 있다.

 

Alias

  • DocumentRoot 하위에 존재하지 않는 디렉토리나 파일에 접근해야하는 경우에 사용한다.

 

AddType

  • Apache에서 사용할 media-type과 확장자를 매핑하여 추가한다.

 

AddEncoding

  • Apache에서 사용할 인코딩과 확장자를 매핑하여 추가한다.

 

ErrorDocument

  • 에러가 발생했을 때 서버가 클라이언트에게 반환할 것을 설정한다.
  • 서버는 클라이언트에게 1. 에러 메세지 내역 2. 간단한 텍스트 3. 내부 에러 페이지 4. 외부 에러 페이지를 반환할 수 있다.
  • 각 HTTP 상태 코드 별로 반환할 수 있다.

 

Include

  • httpd.conf가 아닌 다른 설정 파일(httpd-mpm.conf, httpd-vhost.conf 등)을 포함하여 적용한다.

 

 

참조


Apache Docs Directives : https://httpd.apache.org/docs/2.4/mod/core.html

'WebServer | WAS > Apache' 카테고리의 다른 글

Apache HTTPD to Tomcat, 로드 밸런싱(Load Balancing)  (0) 2020.06.09
Apache HTTPD to Tomcat , WEB/WAS 연동  (0) 2020.06.04
httpd 옵션  (0) 2019.09.18
apachectl 옵션  (0) 2019.09.18
[CentOS 6] 아파치(Apache) 컴파일 설치  (0) 2019.09.18

 

개요


 

httpd는 Apache를 실질적으로 실행하는 파일이다.

일반적으로 httpd를 직접 실행하기보다는 Unix 기반에서는 apachectl, Windows 기반에서는 명령 프롬프트(CMD)를 통해 실행한다.

 

옵션


-d serverroot

ServerRoot 지시어의 기본값을 serverroot로 설정한다.

설정파일에서 ServerRoot 지시어를 사용하여 이 값을 수정할 수 있다.

Apache 설치경로를 지정한다.

 

-f config

시작할때 config 파일에 있는 지시어를 사용한다.

config가 /로 시작하지 않으면 ServerRoot에 상대경로로 지정된다.

 

-k start | restart | graceful | stop

Apache를 시작 | 재시작 | 중단한다.

 

-C directive

설정파일을 읽기전에 directive 지시어를 처리한다.

 

-c directive

설정파일을 읽기전에 directive 지시어를 처리한다.

 

-D parameter

서버 시작 혹은 재시작시 선택적으로 명령어를 처리하기위해 설정파일의 <IfDefine> 섹션에 사용할 parameter를 설정한다.

 

-e level

서버가 시작하는동안 LogLevel을 level로 설정한다.

 

-E file

서버가 시작하는동안 file로 오류문을 보낸다.

 

-R directory

서버를 SHARED_CORE 규칙을 사용하여 컴파일한 경우 공유오브젝트파일 directory를 지정한다.

 

-h

사용할 수 있는 명령행 옵션들의 짧은 요약을 출력한다.

 

-l

서버에 같이 컴파일한 모듈 목록을 출력한다.

LoadModule 지시어를 사용하여 동적으로 읽어들이는 모듈은 출력하지 않는다.

 

-L

지시어 목록을 지시어가 받는 아규먼트와 지시어 사용장소와 같이 출력한다.

 

-M

읽어들인 정적 모듈과 공유 모듈 목록을 출력한다.

 

-S

설정파일에서 읽어들인 설정을 보여준다 (현재는 가상호스트 설정만을 보여준다).

 

-t

설정파일의 문법검사만 한다.

프로그램은 문법을 검사한 후 (문법이 올바른 경우) 0이나 (문법에 문제가 있는 경우) 0이 아닌 종료코드로 즉시 종료한다.

-D DUMP_VHOSTS을 사용하면 가상호스트 설정을 자세히 출력한다.

-D DUMP_MODULES를 사용하면 읽어들인 모듈 목록을 출력한다.

 

-v

httpd의 버전을 출력하고 종료한다.

 

-V

httpd의 버전과 컴파일 파라미터를 출력하고 종료한다.

 

-X

디버그 상태로 웹서버를 실행한다.

오직 한 프로세스나 쓰레드로만 서비스하고, 서버는 콘솔에서 떨어지지 않는다.

 

다음 옵션은 Windows에서만 사용할 수 있다.

 

-k install | config | uninstall

Apache를 Windows 서비스로 설치한다.

Apache 서비스의 시작 옵션을 수정한다.

Apache 서비스 설치를 지운다.

 

-n name

Apache 서비스의 이름을 설정한다.

 

-w

오류가 발생하면 콘솔창을 열어서 오류문을 보여준다.

 

 

참조


Apache docs : https://httpd.apache.org/docs/2.4/programs/httpd.html

 

 

개요


Apache를 실행하기 위한 스크립트 파일인 apachectl 관련 옵션을 기재한 문서이다.

apachectl과 httpd는 비슷한 기능을 수행하지만 엄연히 다른 파일이다. httpd 관련 옵션은 따로 문서를 작성하여 게시하겠다.

apachectl command  형식으로 실행할 수 있다.

 

옵션


start

Apache httpd 데몬을 실행한다.

 

stop

Apache httpd 데몬을 중단한다.

 

restart

Apache httpd 데몬을 재시작한다.

재시작 할때 자동으로 configtest 명령을 실행하여 설정 파일을 검사한다.

 

fullstatus

mod_status의 모든 상태 정보를 출력한다.

이 옵션을 사용하기 위해서는 Apache가 mod_status 모듈을 사용하고 리눅스에 lynx와 같은 문자기반 브라우저가 필요하다.

 

status

간단한 상태 정보를 출력한다.

fullstatus와 비슷하지만 현재 서비스중인 요청 목록을 출력하지 않는다.

 

graceful

Apache httpd 데몬을 재시작한다.

restart와는 달리 기동중인 Apache의 연결을 종료하지 않고 설정 파일의 변경 정보를 적용한다.

 

configtest

설정파일의 문법을 검사한다.

설정파일을 읽고 Syntax Ok 혹은 특정 설정오류에 대한 자세한 정보를 알려준다.

 

startssl

Apache 2.2 이상 버전에서는 더이상 지원하지 않는다.

httpd.conf 파일에 ssl 관련 설정 후 apachectl start 명령으로 실행하도록 하자.

 

 

 

참조


Apache docs : https://httpd.apache.org/docs/2.4/programs/apachectl.html

+ Recent posts