Tomcat 초기 오류 해결 설정 수정 - Vi 편집기 사용법 포함 상세 가이드

Tomcat 설정 수정 단계별 가이드

Tomcat이 초기 오류가 있어서 이를 해결하는 설정이 헷갈리는 점이 많더라고요. 저도 정리하고 여러분들께 알려드리고자 Tomcat 설정을 수정하는 단계별 방법을 안내해드리겠습니다.

1. Tomcat Docker 컨테이너 실행

docker run -d -p 8888:8080 --name tomcat tomcat:9.0.102-jdk21-corretto

2. 웹 애플리케이션 디렉토리 활성화 (필요한 경우)

docker exec -it tomcat bash
cd /usr/local/tomcat
rm -rf webapps
mv webapps.dist/ webapps/

3. context.xml 파일 수정 (manager 애플리케이션)

3.1 컨테이너 접속

docker exec -it tomcat bash

3.2 manager 애플리케이션의 context.xml 열기

vi /usr/local/tomcat/webapps/manager/META-INF/context.xml

3.3 Vi 편집기 사용법 (manager context.xml 수정)

1. 열기: 위 명령어를 실행하면 파일이 열립니다 (처음에는 명령 모드)
2. 편집 시작:
   • 키보드에서 i 키를 누릅니다 (화면 하단에 'INSERT' 표시가 나타남)
   • 이제 텍스트를 편집할 수 있습니다
3. Valve 태그 주석 처리:
   • 화살표 키를 사용해 <Valve 줄로 이동
   • 줄 맨 앞에 <!--를 입력
   • /> 뒤로 이동하여 --> 입력
4. 편집 모드 종료:
   • Esc 키를 누릅니다 (INSERT 표시 사라짐)
5. 저장하고 종료:
   • :wq 입력 후 Enter 키 누름 (w: write, q: quit)

3.4 host-manager 애플리케이션의 context.xml 수정

vi /usr/local/tomcat/webapps/host-manager/META-INF/context.xml

같은 방법으로:

1. i 키를 눌러 편집 모드로 전환
2. Valve 태그를 <!-- 와 --> 로 주석 처리
3. Esc 키를 눌러 명령 모드로 돌아감
4. :wq 입력 후 Enter로 저장 종료

4. 사용자 권한 추가

4.1 tomcat-users.xml 파일 열기

vi /usr/local/tomcat/conf/tomcat-users.xml

4.2 Vi 편집기로 사용자 권한 추가

1. 파일 열기 후 위치 이동:

   • Esc 키 (명령 모드 확인)
   • G 키를 눌러 파일 맨 끝으로 이동
   • 화살표 키를 사용해 </tomcat-users> 태그 바로 앞으로 이동

2. 편집 시작:

   • i 키를 눌러 입력 모드로 전환

3. 다음 내용 추가 (줄바꿈 주의):

<!-- 파일 하단의 </tomcat-users> 태그 바로 앞에 추가 -->
<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="admin" password="admin" roles="admin-gui,manager-gui,manager-script,manager-jmx,manager-status"/>

4. 편집 완료:

   • Esc 키를 눌러 명령 모드로 전환
   • :wq 입력 후 Enter로 저장 종료

5. 컨테이너 터미널 종료

exit

6. Tomcat 컨테이너 재시작

docker restart tomcat

Vi 편집기 추가 팁:

• 실수로 잘못 편집했다면: Esc 누른 후 :q! 입력 (저장하지 않고 종료)
• 현재 줄 삭제: Esc 누른 후 dd 입력
• 특정 텍스트 찾기: Esc 누른 후 /찾을텍스트 입력

이렇게 하면 Vi 편집기를 사용하여 Tomcat 설정을 수정할 수 있습니다.