Jira / Confluence 톰캣 버전 업그레이드 방법

Jira, Confluence를 운영하면서 솔루션 업그레이드 없이 Tomcat 톰캣 버전만 업그레이드 필요한 경우가 있다.

대부분 톰캣 버전의 보안 취약점을 해결하기 위한 사유가 많다.

 

아틀란시안 Support 페이지에서는 톰캣만 업그레이드 하는 방법을 제시한다.

https://confluence.atlassian.com/jirakb/how-to-upgrade-apache-tomcat-version-used-by-jira-879957866.html

How to upgrade Apache Tomcat version used by Jira | Jira | Atlassian Documentation

 

최신 버전의 Jira를 사용하면서 Tomcat 보안 취약점을 해결해야 하는 사용자를 위한 가이드이다.

이미 업데이트된 버전의 Tomcat으로 제공되는 Jira가 있는 경우 권장하지 않는다.

 

솔루션 버전과 호환이 검증되지 않은 톰캣을 임의로 업그레이드한다면 문제가 생길 수도 있으므로 아틀란시안 입장에서 당연한 가이드일 수 있다.

 

가이드에 따라 톰캣을 업그레이드해보자.

 

1. 먼저, 톰캣 아카이브 페이지에서 원하는 버전의 .zip 파일을 다운로드한다.

http://archive.apache.org/dist/tomcat/tomcat-8/

Index of /dist/tomcat/tomcat-8

2. 운영 중인 Jira 또는 Confluence 설치 디렉터리를 백업받는다.

가이드대로 전체를 백업할 필요는 없고 변경이 필요한 디렉토리만 백업하면 된다.

리눅스 환경이라면, cp -r 옵션으로 하위 파일 모두 다른 폴더명으로 백업(복사)한다.

cp -r bin bin_20230324
cp -r lib lib_20230324

3. Jira 또는 Confluence 서비스를 정지한다.

 

4. 톰캣 lib 폴더의 모든 파일을 설치경로/lib 폴더로 복사한다.

5. 톰캣 bin 폴더에서 .bat와 .sh파일을 제외하고 나머지를 설치경로/bin 폴더로 복사한다.

6. Jira 또는 Confluence 서비스를 시작한다.

 

위와 같은 순서로 진행하면, 큰 문제없이 업그레이드를 할 수 있다.

지라 또는 컨플루언스 업그레이드를 통한 자연스러운 Tomcat 버전업이 정석이지만 보안 위협이 있는 어쩔 수 없는 상황에서 최선의 방법이다.

 

기동에 성공하면 Admin 화면 System info 페이지 Application Server Container 항목에 "Apache Tomcat/8.5.85" 와 같이 버전 정보가 변경된 것을 확인할 수 있다.