Apache on Joonlog

Apache 버전 업그레이드

Thu, 27 Nov 2025 09:00:00 +0900

기존 Apache가 설치된 환경에서 버전 업그레이드

Apache 2.4.63 신규 버전을 소스 컴파일로 설치하고 심볼릭 링크 기반 전환으로 서비스 다운타임 최소화

1
2
3


httpd -t: 설정 문법을 테스트
httpd -S: 가상호스트 등 서버 설정을 확인
httpd -V: 컴파일 옵션과 버전을 조회

기존 apache 경로: /etc/httpd

신규 apache 경로: /usr/local/apache

0. 고려사항

기존 Apache 패키지 경로: /etc/httpd
- 새 버전은 /usr/local/apache 아래에 설치해 충돌 방지
심볼릭 링크 기반 버전 관리

/usr/sbin/httpd → /usr/local/apache/bin/httpd 로 링크하여 서비스 파일 수정 최소화
conf, modules, workers.properties 등 핵심 설정만 이관
logs 경로는 기존 경로를 그대로 사용

/usr/local/apache/logs → /etc/httpd/logs 로 링크
업그레이드 중 필수 검증:
- httpd -t 설정 문법 체크
- httpd -S 가상호스트 및 include 파일 존재 여부 확인
- 없는 파일은 cp -arup 로 보완

1. 신규 버전 다운로드 및 배포 준비

/usr/local에 신규 파일 배치

1
2
3
4


cd /usr/local
tar -zxvf apache.2.4.63.tar.gz
mv apache apache-2.4.63
ln -sfn /usr/local/apache-2.4.63 /usr/local/apache

2. 기존 설정 및 모듈 이관

conf / conf.d / conf.modules.d 파일 복사

신규 버전에 기본 제공되지 않는 파일(proxy-html.conf 등)은 httpd -S에서 오류가 나는지 확인하고 불필요하면 삭제

1
2
3
4
5
6
7
8


# httpd.conf
cp -arup /etc/httpd/conf/httpd.conf /usr/local/apache/conf/

# conf.d → extra/ 로 이관
cp -arup /etc/httpd/conf.d/* /usr/local/apache/conf/extra/

# conf.modules.d
cp -arup /etc/httpd/conf.modules.d/ /usr/local/apache/conf.modules.d

모듈 복사

1
2
3
4
5
6
7


cp -arup /etc/httpd/modules/mod_jk.so /usr/local/apache/modules/
cp -arup /etc/httpd/modules/mod_ssl.so /usr/local/apache/modules/
cp -arup /etc/httpd/modules/mod_rpaf.so /usr/local/apache/modules/
cp -arup /etc/httpd/modules/mod_proxy_http2.so /usr/local/apache/modules/
cp -arup /etc/httpd/modules/mod_brotli.so /usr/local/apache/modules/
cp -arup /etc/httpd/modules/mod_suexec.so /usr/local/apache/modules/
cp -arup /etc/httpd/modules/mod_systemd.so /usr/local/apache/modules/

workers.properties

1

cp -arup /etc/httpd/conf/workers.properties /usr/local/apache/conf/

3. 로그 경로 유지

기존 경로 재사용

1
2


rm -rf /usr/local/apache/logs
ln -s /etc/httpd/logs /usr/local/apache/logs

4. httpd.conf 설정 변경

ServerRoot 경로 수정 및 모듈 적용

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


vim /usr/local/apache/conf/httpd.conf

ServerRoot "/usr/local/apache"

ServerSignature Off
ServerTokens Prod

LoadModule jk_module modules/mod_jk.so
LoadModule rpaf_module modules/mod_rpaf.so

Include conf.modules.d/*.conf

5. 설정 검증

Missing file 오류가 나오면 해당 파일을 /etc/httpd/ 기준으로 찾아 복사

syntax 오류가 나면 conf 파일 수정 후 재검증

1
2


/usr/local/apache/bin/httpd -t # 설정 문법 검증
/usr/local/apache/bin/httpd -S # 가상호스트 및 include 파일 확인

6. systemd 서비스 연결

기존 서비스 파일(/usr/lib/systemd/system/httpd.service)은 수정하지 않고, 바이너리만 신규 httpd 로 연결

1
2
3
4
5
6
7


service httpd stop

cd /usr/sbin
mv httpd httpd.bak
ln -s /usr/local/apache/bin/httpd httpd

service httpd start

7. 확인 필요 사항

httpd -t 정상
httpd -S 에 missing 파일 없음
mod_jk, mod_ssl, mod_rpaf 등 필수 모듈 로딩 정상
서비스 기동 후
- /etc/httpd/logs/error_log
- 애플리케이션 로그
- SSL 인증서 로드 정상 여부
- 가상호스트 매핑 정상 작동 여부
원복 필요 시 /usr/sbin/httpd.bak 로 즉시 롤백

Apache AJP Localhost 연결 에러 TroubleShooting

Sat, 07 Jun 2025 09:00:00 +0900

증상

웹 접속 시 503 오류 발생

mod_jk.log에 AJP 연결 실패 로그 다수 출력

1
2
3


[error] ajp_connect_to_endpoint::jk_ajp_common.c (127.0.0.1:8009) (errno=111)
[error] jk_open_socket::jk_connect.c Failed socket to (127.0.0.1:8009)
[error] ajp_send_request::jk_ajp_common.c (worker1) Connecting to backend failed

netstat 기준으로 Tomcat은 AJP 포트(8009)를 정상적으로 Listen 중
1

tcp 0 0 127.0.0.1:8009 ::1 LISTEN [java 프로세스]

workers.properties 설정

기존 설정
1 2

worker.worker1.type=ajp13 worker.worker1.host=localhost
- host가 정상적으로 localhost로 되어 있는데, mod_jk.log에서는 ajp 연동 오류가 나오고, netstat은 IPv6에서만 LISTEN중
- /etc/hosts에도 정상적으로 localhost와 127.0.0.1이 명시된 것으로 확인
  - localhost를 127.0.0.1로 변경
이후 설정
1 2

worker.worker1.type=ajp13 worker.worker1.host=127.0.0.1
- host 값 변경 후 httpd 재기동 시 503 에러 해결

결론

로그를 종합했을 때, Tomcat은 127.0.0.1:8009에서 AJP를 수신하고 있었지만, workers.properties에 설정된 localhost가 내부적으로 ::1(IPv6)로 해석되어 연결이 실패한 것으로 추정

Apache OPTIONS * 루프백 요청으로 인한 CPU 과부하 TroubleShooting

Fri, 25 Apr 2025 09:00:00 +0900

문제 상황

운영 중인 CentOS 서버에서 너무 많은 수의 httpd 프로세스가 CPU를 과점유하고, Load Average가 30 이상까지 치솟는 현상이 발생

원인 분석

access_log 확인 결과, 루프백 주소(::1)에서 OPTIONS * HTTP/1.0 요청이 수 초 간격으로 다수 발생
User-Agent는 "Apache/... (internal dummy connection)"으로, Apache 자체가 생성하는 dummy connection임을 확인
- 이 요청은 Apache의 internal dummy connection이며, 일반적으로는 MPM이 유휴 프로세스를 관리하기 위해 보내는 내부 테스트용 요청
- 하지만 일정 이상 발생하게 되면, 해당 요청을 처리하기 위한 httpd 프로세스가 과도하게 생성되고 정리되지 않아, 리소스를 점유

1
2
3
4
5
6
7
8


# tail -n 1000 /var/log/httpd/access_log | grep "::1"

::1 - - [22/Apr/2025:07:01:55 +0000] "OPTIONS * HTTP/1.0" 200 - "-" "Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (internal dummy connection)"
::1 - - [22/Apr/2025:07:02:34 +0000] "OPTIONS * HTTP/1.0" 200 - "-" "Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (internal dummy connection)"
::1 - - [22/Apr/2025:07:02:35 +0000] "OPTIONS * HTTP/1.0" 200 - "-" "Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (internal dummy connection)"
::1 - - [22/Apr/2025:07:02:36 +0000] "OPTIONS * HTTP/1.0" 200 - "-" "Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (internal dummy connection)"
::1 - - [22/Apr/2025:07:02:42 +0000] "OPTIONS * HTTP/1.0" 200 - "-" "Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (internal dummy connection)"
::1 - - [22/Apr/2025:07:02:56 +0000] "OPTIONS * HTTP/1.0" 200 - "-" "Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips (internal dummy connection)"

1
2
3
4


# httpd -V | grep MPM

[Fri Apr 25 04:35:44.665826 2025] [so:warn] [pid 31382] AH01574: module rewrite_module is already loaded, skipping
Server MPM: prefork

MPM 관련 설정(StartServers, MaxRequestWorkers)이 명시되지 않은 상태
- Apache 기본값(최대 256개 프로세스)이 적용된 것으로 추정

조치 내용

하기 내용은 Apache 설정을 수정하지 않고 즉시 대응 가능한 임시 조치

IPv6 루프백 dummy connection 차단을 위한 ip6tables 규칙 추가

루프백(::1)에서 들어오는 OPTIONS * 요청만 차단
외부 요청이나 정상적인 HTTP 트래픽에는 영향 없음

1

ip6tables -I INPUT -s ::1 -p tcp --dport 80 -m string --algo bm --string "OPTIONS *" -j DROP

Apache 재기동

이미 생성되어 남아 있는 과도한 httpd 프로세스를 정리하고 초기화
신규 요청부터는 차단 규칙이 적용된 상태로 운영

1

systemctl restart httpd

CPU 사용률 및 Load Average 수 분 내로 정상화

결론

httpd 프로세스 수 안정화, 더 이상 루프백 OPTIONS * 요청 발생하지 않음

추가 조치 방안

문제의 근본 원인을 해결하기 위해서는 Apache 설정 최적화 필요
특히, 현재 서버는 prefork MPM을 사용하고 있으며, 기본 설정값으로 운영중
이로 인해 부하 상황에서 과도한 프로세스 생성 및 dummy connection 폭주 현상이 발생한 것으로 분석됨
mpm 설정 추가
- MaxRequestWorkers를 서버 사양에 맞게 제한

1
2
3
4
5
6
7
8
9


# /etc/httpd/conf.modules.d/00-mpm.conf

<IfModule mpm_prefork_module>
 StartServers 5
 MinSpareServers 5
 MaxSpareServers 10
 MaxRequestWorkers 150
 ServerLimit 150
</IfModule>

Apache SSL HTTPS Redirection

Wed, 11 Dec 2024 18:00:00 +0900

목표

Let’s encrypt에서 ssl 인증서 발급해 전송 보안 강화
apache virtual host로 http -> https 리디렉션 설정
- 웹사이트의 모든 트래픽이 안전한 프로토콜을 사용하도록 강제
인증서의 자동 갱신을 설정하여 만료되지 않도록 유지

환경 설정

OS: Rocky 8.10
WEB: Apache 2.4.6
SSL: Let’s encrypt certbot

개념 및 설정

Let’s encrypt

HTTPS Everywhere 를 추구하는 비영리 프로젝트
IdenTrust cross-sign 됨
SSL 인증서 100% 무료화
인증기관 연장 및 인증서 재발급 무료
콘솔상에서 인증서 발급/갱신/설치/자동화
멀티도메인 지원, SAN 기능(여러 도메인을 한 인증서로 묶어주는 기능) 지원

SSL 인증서 인증 방식

Webroot

certbot이 지정된 웹 서버의 루트 디렉토리에 인증 파일을 생성
Let’s Encrypt가 도메인에 HTTP 요청을 보내서 인증 파일을 확인
기존 웹 서버가 실행 중이어야 함
무중단 설정 가능

Webserver

Certbot이 Apache/Nginx 서버 플러그인을 사용해 직접 인증 파일 관리, HTTP 요청 처리
인증 요청을 처리하는 동안 certbot이 웹 서버를 재구성하거나 중단할 수 있음
설정/리다이렉션 자동화

Standalone

certbot이 자체적으로 HTTP 서버를 실행하여 인증 요청을 처리.
주로 웹서버 없이 테스트 용도로 사용
웹서버가 실행중이면 중단해야 함

DNS

DNS에 TXT 레코드 추가로 소유권 확인
와일드카드 인증서 사용 가능
Private 네트워크에서도 사용 가능

해당 과제에서는 webserver 방식 사용

Bind

/etc/httpd/conf.d/<Domain>.conf

도메인용의 VirtualHost 파일
VirtualHost 태그에서 Apache가 수신할 트래픽의 IP/Domain, Port 를 설정
HTTP 설정만 있는 파일에 발급받은 SSL 인증서를 사용해 HTTPS 리다이렉션 설정

/etc/cron.d/certbot-renew

cron을 사용해 인증서 발급 자동화

작업 과정

1. HTTP 실행

사용자 생성

1
2


useradd -m -G wheel sslhttps
echo "sslhttps" | passwd --stdin sslhttps

apache 설치

1
2
3


sudo dnf update --exclude=kernel* -y
sudo dnf install httpd -y
sudo systemctl enable --now httpd

방화벽 설정

1
2
3
4


sudo systemctl enable --now firewalld
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

httpd-vhosts.conf 설정

1

sudo vi /etc/httpd/conf.d/<Domain>.conf

1
2
3
4


<VirtualHost *:80>
 ServerName <Domain>
 DocumentRoot /var/www/html
</VirtualHost>

http 동작 테스트

1

sudo systemctl restart httpd

2. SSL 실행

certbot 설치

1
2


sudo dnf install epel-release -y
sudo dnf install certbot python3-certbot-apache -y

SSL 인증서 생성
- webserver 방식

1

sudo certbot --apache -d <Domain>

3. HTTPS 실행

httpd-vhosts.conf 설정

1

sudo vi /etc/httpd/conf.d/<Domain>.conf

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


<VirtualHost *:80>
 ServerName <Domain>
 DocumentRoot /var/www/html

 # http를 https로 리다이렉션
 Redirect permanent / https://<Domain>/
</VirtualHost>

<VirtualHost *:443>
 ServerName <Domain>
 DocumentRoot /var/www/html

 # SSL 인증서 적용
 SSLEngine on
 SSLCertificateFile /etc/letsencrypt/live/<Domain>/fullchain.pem
 SSLCertificateKeyFile /etc/letsencrypt/live/<Domain>/privkey.pem

 <Directory /var/www/html>
 AllowOverride All
 Require all granted
 </Directory>
</VirtualHost>

Apache 서버 재시작

1
2


sudo apachectl configtest
sudo systemctl restart httpd

4. SSL 인증서 갱신 자동화

만료 기간 3개월
crontab으로 자동 갱신 설정
만료일 30일 이내일 때 인증서 갱신 가능
갱신 테스트

1

sudo certbot renew --dry-run

갱신 스크립트 작성

1
2
3
4


sudo vi /etc/cron.d/certbot-renew

# 매일 새벽 3시 갱신 시도
0 3 * * * root /usr/bin/certbot renew --quiet --deploy-hook "systemctl reload httpd"

트러블슈팅

Let’s Encrypt를 사용한 HTTP1.1 방식의 인증서 발급은 도메인에 80포트로 접근 가능해야 한다.

공인 ip에 8080→80으로 포워딩해서 진행했었는데, ssl 인증서 발급에 오류가 발생
알아보니 Let’s Encrypt 인증 기관에서 HTTP1.1(webserver) 방식을 사용한 인증서 발급에는 80포트로 고정됨
- 80 외에 다른 포트를 사용하려면 아래 세 방법 뿐
  - DNS TXT 레코드를 사용한 인증 사용
  - 이미 HTTPS가 적용되어 있다면 HTTPS를 사용하는 ALPN-01 인증 방식을 사용
  - 다른 인증 기관을 사용
이후에 포워딩을 80→80으로 수정해서 해결

참고

https://www.owl-dev.me/blog/42#

Apache-Tomcat 설치 및 연동

Mon, 09 Dec 2024 18:08:00 +0900

목표

Apache-Tomcat을 사용한 WEB-WAS 연동
Proxy / AJP 방식 둘 모두 수행
AJP는 mod_jk 사용

환경 설정

OS: Rocky 8.10
WEB: Apache 2.4.6
WAS: Tomcat 9.0.97

개념 및 설정

Proxy / AJP 비교

연동 방식	Proxy	AJP (Apache JServ Protocol)
프로토콜 유형	HTTP (텍스트 기반), HTTPS 가능	AJP (바이너리 프로토콜)
성능	HTTP 오버헤드로 인해 상대적으로 느림	바이너리 프로토콜로 더 빠르고 효율적임
보안 설정	HTTPS로 SSL/TLS 암호화 가능	AJP 자체 암호화 미지원, `secret` 옵션으로 보안 강화
주 사용 목적	간단한 설정, 외부 요청 처리	내부 네트워크에서의 고성능 요청 처리
호환성	Tomcat 외 서버와도 연동 가능	Tomcat 전용 프로토콜

Apache

/etc/httpd/conf/httpd.conf

Apache 메인 설정 파일
proxy-vhosts.conf, ajp-vhosts.conf, httpd-modjk.conf 등 하위 파일 Include
mod_jk 와 같은 모듈 로드

/etc/httpd/conf/extra/proxy-vhosts.conf /etc/httpd/conf/extra/ajp-vhosts.conf

Proxy / AJP 용으로 생성한 VirtualHost 파일
VirtualHost 태그에서 Apache가 수신할 트래픽의 IP/Domain, Port 를 설정
- 여기서 도메인 / 경로 / 포트 기반 라우팅을 설정 이 실습에선 포트 기반 라우팅 사용
ProxyPass에서 트래픽을 전달할 WAS 경로, IP/Domain 등을 설정
AJP는 JkMount에서 WAS 경로, 워커를 설정

Apache-Tomcat 연동에 필요한 proxy_module, proxy_http_module 모듈은 기본 설치

AJP는 mod_jk, mod_proxy_ajp 두 모듈 중 하나만 있으면 연동 가능

모듈	mod_jk	mod_proxy_ajp
설치	별도 설치 필요	Apache 기본 모듈로 제공
설정	복잡 (별도 설정 파일 필요)	간단 (Apache 설정 파일에서 구성)
로드 밸런싱	강력 (다양한 알고리즘 지원)	제한적 (별도 모듈 필요)
클러스터링	세션 스티키니스 및 고급 기능 지원	제한적
성능	고성능 (대규모 환경에 적합)	단순 연동 시 적합
사용 사례	대규모 클러스터, 고급 로드 밸런싱이 필요한 경우	간단한 AJP 연동 및 소규모 환경

/etc/httpd/conf/extra/httpd-modjk.conf\\

mod_jk 모듈 설정 파일
태그로 Apache에 mod_jk가 로드된 경우에만 적용
workers.properties 파일 경로 지정
로그 경로, 로그 레벨 지정

/etc/httpd/conf/extra/workers.properties

mod_jk 워커(worker1 포함)의 IP, Port 등을 설정하는 파일
여러 워커 설정 가능

Tomcat

/etc/systemd/system/tomcat.service

rocky 8.1에서는 Tomcat이 systemd에 등록된 패키지가 없음
Tomcat을 systemd 서비스로 관리하기 위한 설정

/usr/local/apache-tomcat-9.0.97/conf/server.xml

Proxy Connector은 기본 설정 사용
AJP Connector 포트, 허용 IP, Secret 설정
- 이 실습에서 Secret은 false로 설정
  - Secret을 사용 한다면 Apache에도 Secret 설정 필수

작업 과정

1. Proxy 방식

1) Apache 서버 설정

Apache 설치/실행

1
2
3


sudo dnf update --exclude=kernel*
sudo dnf install httpd -y
sudo systemctl enable --now httpd

모듈 활성화 확인 (proxy_module, proxy_http_module)

1

httpd -M | grep proxy

Apache 서버에서 HTTP 트래픽을 허용하도록 방화벽 설정 추가

1
2
3


sudo systemctl enable --now firewalld
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

proxy-vhosts.conf 설정 파일 추가

1

sudo vi /etc/httpd/conf/httpd.conf

1
2


# 별도의 파일에서 Virtual Host 설정 관리
Include conf/extra/proxy-vhosts.conf

Apache가 Tomcat 서버로 프록시 역할을 수행하도록 설정

1
2


sudo mkdir -p /etc/httpd/conf/extra
sudo vi /etc/httpd/conf/extra/proxy-vhosts.conf

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Apache가 8080 포트에서 수신된 요청 처리
<VirtualHost *:8080>
 # Apache 서버의 IP 또는 도메인 지정
 ServerName <WEB IP>

 # Apache가 수신한 요청을 WAS 8080 포트로 프록시 처리
 ProxyRequests Off
 ProxyPass / http://<WAS IP>:8080/
 ProxyPassReverse / http://<WAS IP>:8080/
</VirtualHost>

Apache 서버 재시작

1

sudo systemctl restart httpd

2) Tomcat 서버 설정

Java 설치

1
2
3
4


sudo dnf update --exclude=kernel*
sudo dnf install java-11-openjdk -y

java -version

~/.bashrc 환경 변수 추가

1
2


export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))
export PATH=$PATH:$JAVA_HOME/bin

Tomcat 설치

1
2
3


wget <https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.97/bin/apache-tomcat-9.0.97.tar.gz>
tar xvzf apache-tomcat-9.0.97.tar.gz apache-tomcat-9.0.97
sudo mv apache-tomcat-9.0.97 /usr/local

tomcat 사용자 설정

1
2
3


sudo groupadd tomcat
sudo useradd -g tomcat -d /usr/local/apache-tomcat-9.0.97 -s /bin/false tomcat
sudo chown -R tomcat:tomcat /usr/local/apache-tomcat-9.0.97

Tomcat 서비스 등록

1

vi /etc/systemd/system/tomcat.service

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


[Unit]
Description=tomcat 9
After=network.target syslog.target

[Service]
Type=forking
# JDK와 Tomcat 설치 경로 지정
Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.25.0.9-2.el8.x86_64"
Environment="CATALINA_HOME=/usr/local/apache-tomcat-9.0.97"
User=tomcat
Group=tomcat
ExecStart=/usr/local/apache-tomcat-9.0.97/bin/startup.sh
ExecStop=/usr/local/apache-tomcat-9.0.97/bin/shutdown.sh

[Install]
WantedBy=multi-user.target

Tomcat 실행

1
2
3


sudo systemctl daemon-reload
sudo systemctl enable --now tomcat
sudo systemctl status tomcat

방화벽 HTTP 8080 포트 허용

1
2
3


sudo systemctl enable --now firewalld
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

3) 설정 확인

브라우저에서 Apache 서버의 IP 주소로 접근하여 Tomcat의 기본 페이지가 나타나는지 확인

http://<공인 ip>:8080

2. AJP 방식

1) Apache 서버 설정

Apache 설치/실행

1
2
3


sudo dnf update --exclude=kernel*
sudo dnf install httpd -y
sudo systemctl enable --now httpd

tomcat-connectors 설치(mod_jk)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


sudo yum install autoconf libtool httpd-devel -y

wget <https://dlcdn.apache.org/tomcat/tomcat-connectors/jk/tomcat-connectors-1.2.50-src.tar.gz>
tar -zxvf tomcat-connectors-1.2.50-src.tar.gz
cd tomcat-connectors-1.2.50-src/native
./configure --with-apxs=/usr/bin/apxs

sudo dnf install make -y
sudo dnf install redhat-rpm-config -y

make
sudo make install

모듈 활성화 확인

1
2


sudo systemctl restart httpd
httpd -M | grep jk

Apache 서버에서 HTTP 트래픽을 허용하도록 방화벽 설정 추가

1
2
3


sudo systemctl enable --now firewalld
sudo firewall-cmd --permanent --add-port=8090/tcp
sudo firewall-cmd --reload

httpd.conf에 mod_jk 모듈 추가
httpd.conf에 httpd-modjk.conf 설정 파일 추가

1

sudo vi /etc/httpd/conf/httpd.conf

1
2
3
4
5


# 설치한 mod_jk 모듈 로드
LoadModule jk_module modules/mod_jk.so

# ajp 설정 파일 포함
Include conf/extra/httpd-modjk.conf

vhosts.conf 에 jkmount 추가

1
2


sudo mkdir -p /etc/httpd/conf/extra
sudo vi /etc/httpd/conf/extra/ajp-vhosts.conf

1
2
3
4
5
6
7
8


# Apache가 8090 포트에서 수신된 요청 처리
<VirtualHost *:8090>
 # AJP 요청을 수신할 Apache 서버 IP 지정
 ServerName <WEB IP>

 # 모든 요청(/*)을 worker1으로 라우팅
 JkMount /* worker1
</VirtualHost>

httpd-modjk.conf 파일 설정
- 로그 레벨 debug로 변경 후 mod_jk.log에서 로그 확인 가능

1

sudo vi /etc/httpd/conf/extra/httpd-modjk.conf

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


<IfModule jk_module>
 # ajp worker 설정 파일 지정
 JkWorkersFile conf/extra/workers.properties
 # 상태 정보 파일 경로 지정
 JkShmFile logs/mod_jk.shm
 # 로그 파일 경로 지정
 JkLogFile logs/mod_jk.log
 # 로그 레벨 지정
 JkLogLevel debug
 JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"
</IfModule>

workers.properties 파일 설정

1

sudo vi /etc/httpd/conf/extra/workers.properties

1
2
3
4
5
6
7
8
9


# 워커 목록
worker.list=worker1

# AJP 포트 
worker.worker1.port=8009
# Tomcat 서버 IP
worker.worker1.host=<WAS IP>
# 프로토콜 버전 지정
worker.worker1.type=ajp13

workers.properties, httpd-modjk.conf 권한 설정

1
2


sudo chmod 755 /etc/httpd/conf/extra/workers.properties
sudo chmod 755 /etc/httpd/conf/extra/httpd-modjk.conf

Apache 서버 재시작

1

sudo systemctl restart httpd

2) Tomcat 서버 설정

Java 설치

1
2
3
4


sudo dnf update --exclude=kernel*
sudo dnf install java-11-openjdk -y

java -version

~/.bashrc 환경 변수 추가

1
2


export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))
export PATH=$PATH:$JAVA_HOME/bin

Tomcat 설치

1
2
3


wget <https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.97/bin/apache-tomcat-9.0.97.tar.gz>
tar xvzf apache-tomcat-9.0.97.tar.gz apache-tomcat-9.0.97
sudo mv apache-tomcat-9.0.97 /usr/local

tomcat 사용자 설정

1
2
3


sudo groupadd tomcat
sudo useradd -g tomcat -d /usr/local/apache-tomcat-9.0.97 -s /bin/false tomcat
sudo chown -R tomcat:tomcat /usr/local/apache-tomcat-9.0.97

Tomcat 서비스 등록

1

vi /etc/systemd/system/tomcat.service

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


[Unit]
Description=tomcat 9
After=network.target syslog.target

[Service]
Type=forking
# JDK와 Tomcat 설치 경로 지정
Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.25.0.9-2.el8.x86_64"
Environment="CATALINA_HOME=/usr/local/apache-tomcat-9.0.97"
User=tomcat
Group=tomcat
ExecStart=/usr/local/apache-tomcat-9.0.97/bin/startup.sh
ExecStop=/usr/local/apache-tomcat-9.0.97/bin/shutdown.sh

[Install]
WantedBy=multi-user.target

Tomcat AJP 커넥터 설정
Tomcat의 server.xml 파일을 열어 AJP 커넥터 활성화

1

sudo vi /usr/local/apache-tomcat-9.0.97/conf/server.xml

1
2
3


# AJP를 수신을 허용할 Source IP 지정
# AJP 키 인증 비활성화
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" address="<WAS IP>" secretRequired="false"/>

Tomcat 실행

1
2
3


sudo systemctl daemon-reload
sudo systemctl enable --now tomcat
sudo systemctl status tomcat

방화벽 AJP 8080 포트 허용

1
2
3


sudo systemctl enable --now firewalld
sudo firewall-cmd --permanent --add-port=8009/tcp
sudo firewall-cmd --reload

3) 설정 확인

브라우저에서 Apache 서버의 IP 주소로 접근하여 Tomcat의 기본 페이지가 나타나는지 확인

http://<공인ip>:8090

로그 확인

연동 시의 오류도 tomcat에 찍히기 때문에 catalina 로그를 가장 많이 확인

Apache 로그 확인

1
2
3
4
5
6


# 에러 로그
tail -f /var/log/httpd/error_log
# 액세스 로그
tail -f /var/log/httpd/access_log
# mod_jk 로그
tail -f /var/log/httpd/mod_jk.log

Tomcat 로그 확인

1
2
3
4


# tomcat 로그
tail -f /usr/local/apache-tomcat-9.0.97/logs/catalina.out
# localhost 로그
tail -f /usr/local/apache-tomcat-9.0.97/logs/localhost.log

트러블슈팅

VirtualHost에서 / 경로는 webapps/ROOT를 가리킨다.

/ajp/* 와 같이 경로를 지정하면 apache-tomcat-9.0.97/webapps/ajp 폴더에 페이지가 존재해야 함

Apache의 httpd.conf는 모듈이 앞에 있지 않으면 해당 모듈을 사용하는 설정은 무시된다.

httpd.conf에서 LoadModule이 Include보다 앞에 위치해야 함

JkMount는 VirtualHost 내부에 위치해야 한다.

*https://ineastdev.tistory.com/entry/apache-tomcat-을-modjk-로-연동시-주의사항*

VirtualHost를 설정한 적이 없다면 httpd.conf에 Include된 파일 중에 VirtualHost가 있는지 확인 필수
이 실습에서는 proxy 연동을 동시에 진행했기 때문에 proxy_vhosts.conf파일에 VirtualHost가 존재했고, AJP 연동에서 VirtualHost 없이 JkMount만 작성했기 때문에 오류가 발생

Apache는 /ajp 를 입력받으면 내부적으로 /ajp/ 경로로 리다이렉션 한다.

경로 끝에 / 가 없는 URL을 입력할 경우, Apache에서는 DirectorySlash Off 설정으로 인해, 이 경로를 디렉토리로 간주하여 / 을 추가하여 리다이렉션 한 후에 내부에서 처리
만약 실제 디렉토리가 존재한다면 / 을 추가한 상태로 리다이렉션을 응답하고, 존재하지 않는다면 다른 리소스로 처리(기존 경로 응답)
DirectorySlash Off 설정으로 수정할 수 있지만, 대부분의 WEB의 기본값이기 때문에 수정을 권장하지 않음
따라서 JkMount의 경로에 /ajp 대신 /ajp/* 로 기입해 해결
만약 실제 디렉토리가 존재한다면 / 을 추가한 상태로 리다이렉션을 응답하고, 존재하지 않는다면 다른 리소스로 처리(기존 경로 응답)
DirectorySlash Off 설정으로 수정할 수 있지만, 대부분의 WEB의 기본값이기 때문에 수정을 권장하지 않음
따라서 JkMount의 경로에 /ajp 대신 /ajp/* 로 기입해 해결

참고

proxy 방식:

https://velog.io/@ela__gin/리눅스-서버에서-ApacheTomcat-mod-proxy-방식-연동-웹소켓-푸시-알림-연동-포함

ajp 방식:

https://nahosung.tistory.com/121

https://lilo.tistory.com/83

https://ineastdev.tistory.com/entry/apache-tomcat-을-modjk-로-연동시-주의사항

tomcat 서비스 등록: https://getchu.tistory.com/14