AUDPlatform 7.0.500
핫픽스 릴리즈 적용 가이드
순서대로 따라가는 작업자용 체크리스트
■ 문서 개요
본 문서는 AUDPlatform 7.0.500 핫픽스를 운영 환경에 안전하게 적용하기 위한 작업 절차를 정리한 가이드입니다. 작업자는 본 문서의 순서를 따라 단계별로 체크하며 진행해야 하며, 각 단계마다 제공되는 체크박스(☐)에 완료 여부를 표시하십시오.
■ 대상 버전
7.0.500.202 51120-11 ~
■ 반드시 먼저 확인할 사항 (중요)
|
⚠ 라이브러리 파일 삭제 고지 • AUDPlatform_7.0.500.20251120-11 핫픽스부터 DB2 라이브러리 파일이 삭제되었습니다. • AUDPlatform_7.0.500.20260416-21 핫픽스부터 SQream DB 라이브러리 파일이 삭제되었습니다. • DB2 또는 SQream DB를 사용하는 고객사는 해당 라이브러리 파일을 별도로 백업·관리해야 합니다. |
|
⚠ Tomcat 버전 요구사항 • AUDPlatform_7.0.500.20250821-11 핫픽스 및 이후 모든 핫픽스는 보안 취약점 조치로 인해 Tomcat 7 이하 버전에서는 사용할 수 없습니다. • 적용 전 반드시 WAS의 Tomcat 버전을 확인하십시오. |
■ 릴리즈 파일 구성
배포된 ZIP/TAR.GZ 파일의 용도와 적용 여부를 아래 표에서 확인하십시오. (XXXXXX-XX 는 핫픽스 빌드 번호)
|
파일명 |
구분 |
플랫폼 |
|
AUDPlatform_7.0.500.20XXXXXX-XX_patch(필수).zip |
필수 |
Windows / Linux 겸용 |
|
AUDPlatform_7.0.500.20XXXXXX-XX_reports(필수).zip |
필수 |
Windows / Linux 겸용 |
|
AUDPlatform_7.0.500.20XXXXXX-XX_patch(필수_리눅스).tar.gz |
필수 |
Linux 전용 |
|
AUDPlatform_7.0.500.20XXXXXX-XX_reports(필수_리눅스).tar.gz |
필수 |
Linux 전용 |
|
AUDPlatform_7.0.500.20XXXXXX-XX_extention(참고).zip |
참고용 |
- |
|
AUDPlatform_7.0.500.20XXXXXX-XX_SYSTEM_TEMPLATE(참고).zip |
참고용 |
- |
|
ℹ 필수 파일 페어 규칙 • patch(필수) 파일과 reports(필수) 파일은 반드시 함께 적용해야 합니다. • Windows 환경은 .zip 페어, Linux 환경은 .tar.gz 페어를 사용합니다. • extention 및 SYSTEM_TEMPLATE 파일은 참고용으로, 고객사 상황에 맞추어 활용합니다. |
사전 준비 사항
1. 환경 변수 확인
본 가이드에서 사용되는 경로 변수는 다음과 같습니다. 작업 시작 전 실제 값을 확인하여 기록해 두십시오.
|
{CONTEXTPATH} |
시스템 설치 위치 · Admin > 시스템 정보조회 > Context Root 에서 확인 |
|
{REPORTPATH} |
보고서 파일 위치 · Admin > 시스템 옵션 > REPORTPATH 에서 확인 |
▷ 작업 시작 전 실제 경로를 아래 빈칸에 기입하십시오.
|
{CONTEXTPATH} 실제 경로 |
|
|
{REPORTPATH} 실제 경로 |
|
|
WAS 종류 (Tomcat/JEUS 등) |
|
|
WAS 버전 |
|
|
작업 일시 |
|
|
작업자 |
|
|
※ 주의사항 • 고객사 커스터마이징 파일은 본 절차와 별도로 사전 백업 및 별도 관리가 필요합니다. • DB2, SQream DB 라이브러리 등 별도 관리 중인 파일도 동일하게 별도 보관해야 합니다. |
릴리즈 적용 순서 (체크리스트)
아래 체크리스트는 반드시 순서대로 진행해야 합니다. 각 단계를 완료할 때마다 ☐ 박스에 체크하십시오.
STEP 1. 기존 파일 백업
릴리즈 적용 전, 롤백을 위한 백업을 반드시 수행합니다.
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
1-1 |
{CONTEXTPATH} 하위 전체 백업 |
전체 시스템 백업 |
|
☐ |
1-2 |
{REPORTPATH} 하위 전체 백업 |
보고서 파일 백업 |
|
☐ |
1-3 |
고객사 커스터마이징 파일 별도 백업 |
별도 관리 |
|
☐ |
1-4 |
DB2 / SQream DB 라이브러리 별도 백업 (해당 시) |
사용 고객사만 |
STEP 2. 서버 종료 및 lib 폴더 정리
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
2-1 |
WAS 서버 정상 종료 |
- |
|
☐ |
2-2 |
patch_delete_list.txt 파일 확인 |
patch.zip 내부 참조 |
|
☐ |
2-3 |
삭제 대상 파일을 lib 폴더에서 제거 |
아래 경로 참조 |
|
☐ |
2-4 |
고객사 별도 관리 파일이 삭제 목록에 포함되지 않았는지 확인 |
중요 |
▶ 정리 대상 경로:
{CONTEXTPATH}/WEB-INF/lib/*
▶ 삭제 목록 파일 위치:
AUDPlatform_7.0.500.20XXXXXX-XX_patch(필수).zip/matrix/WEB-INF/patch_delete_list.txt
|
⚠ 파일 삭제 시 주의 • patch_delete_list.txt 에 명시된 파일만 삭제합니다. • 고객사 별도 관리 파일(DB2 라이브러리 등)이 목록에 포함되어 있는 경우, 해당 파일은 별도로 보관 후 처리하십시오. |
STEP 3. 릴리즈 적용 (덮어쓰기)
3-1. patch 파일 적용
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
3-1-1 |
patch(필수) 파일을 {CONTEXTPATH} 하위에 덮어쓰기 |
Windows: .zip / Linux: .tar.gz |
▶ 파일명:
AUDPlatform_7.0.500.20XXXXXX-XX_patch(필수).zip
▶ 적용 경로:
{CONTEXTPATH}/ 하위
3-2. reports 파일 적용
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
3-2-1 |
reports(필수) 파일을 {REPORTPATH} 하위에 덮어쓰기 |
- |
▶ 파일명:
AUDPlatform_7.0.500.20XXXXXX-XX_reports(필수).zip
▶ 적용 경로:
{REPORTPATH}/ 하위
3-3. 고객사 커스터마이징 적용
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
3-3-1 |
STEP 1에서 백업해 둔 고객사 커스터마이징 파일 재적용 |
별도 관리 항목 |
|
☐ |
3-3-2 |
DB2 / SQream DB 라이브러리 재배치 (해당 시) |
사용 고객사만 |
STEP 4. WAS 특성 체크
4-1. JEUS 사용 시 옵션 추가
JEUS를 WAS로 사용하는 경우, 아래 설정을 확인하고 필요 시 추가 또는 수정합니다. Tomcat 사용 시에는 본 단계를 건너뜁니다.
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
4-1-1 |
service_api.properties 파일 열기 |
아래 경로 참조 |
|
☐ |
4-1-2 |
matrix.was.jeus = true 속성 추가 또는 수정 |
JEUS 환경만 |
|
☐ |
4-1-3 |
파일 저장 |
- |
▶ 설정 파일 경로:
{CONTEXTPATH}/WEB-INF/classes/framework/service/service_api.properties
※ 위 파일 또는 해당 파일의 연결 path를 확인하십시오.
▶ 추가할 설정:
# was jeus matrix.was.jeus = true
STEP 5. 캐시 삭제
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
5-1 |
개별 PC의 인터넷 브라우저 캐시 삭제 |
모든 사용자 |
|
☐ |
5-2 |
서버 캐시 삭제 |
- |
|
☐ |
5-3 |
관련 가이드 URL 확인 (필요 시) |
아래 링크 |
▶ 참고 URL:
https://audp.bimatrix.co.kr/pages/viewpage.action?pageId=112033858
STEP 6. WAS 서버 재기동
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
6-1 |
(Linux만) {CONTEXTPATH} 권한 및 소유 계정 확인 |
Linux 환경 필수 |
|
☐ |
6-2 |
(Linux만) {REPORTPATH} 권한 및 소유 계정 확인 |
Linux 환경 필수 |
|
☐ |
6-3 |
WAS 서버 기동 |
- |
|
☐ |
6-4 |
WAS 로그에서 기동 오류 여부 확인 |
에러 로그 점검 |
|
ℹ Linux 환경 체크 포인트 Linux 환경에서는 파일 덮어쓰기 후 권한/소유자가 변경될 수 있습니다. WAS 실행 계정이 {CONTEXTPATH} 및 {REPORTPATH} 하위 파일에 접근 가능한지 반드시 확인하십시오. |
STEP 7. 로그인 후 점검
WAS 재기동 후 정상 기동이 확인되면 시스템에 로그인하여 아래 항목을 점검합니다.
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
7-1 |
Web-PORTAL 접속 후 버전 확인 |
신규 빌드 번호 표시 여부 |
|
☐ |
7-2 |
Admin > 시스템 정보 조회 실행 |
정상 조회 여부 |
|
☐ |
7-3 |
Admin > Repository 테이블 점검 실행 |
- |
|
☐ |
7-4 |
테이블 추가가 필요한 경우 [Repository Script 내려받기] 실행 후 테이블 추가 |
필요 시만 |
|
☐ |
7-5 |
Admin > 모듈 관리자 > 초기 설정 실행 |
- |
|
☐ |
7-6 |
주요 화면 및 기능 샘플 점검 |
업무 영향도 확인 |
|
ℹ 타 제품 연동 사용 시 본 배포 제품 외의 제품(i-STREAM, i-BIG 등)을 함께 사용하는 경우, 해당 제품에 대한 별도의 설정 변경이 필요할 수 있습니다. 연동 제품별 릴리즈 노트 및 설정 가이드를 추가로 확인하십시오. |
종합 요약 체크리스트
한 장으로 전체 작업 순서를 확인할 수 있는 요약표입니다. 현장에서는 본 페이지만 출력하여 활용해도 무방합니다.
|
확인 |
No |
작업 항목 |
비고 / 경로 |
|
☐ |
1 |
{CONTEXTPATH} 전체 백업 |
STEP 1-1 |
|
☐ |
2 |
{REPORTPATH} 전체 백업 |
STEP 1-2 |
|
☐ |
3 |
고객사 커스터마이징 / 별도 관리 라이브러리 백업 |
STEP 1-3, 1-4 |
|
☐ |
4 |
WAS 서버 종료 |
STEP 2-1 |
|
☐ |
5 |
lib 폴더 정리 (patch_delete_list.txt 기준) |
STEP 2-2~2-4 |
|
☐ |
6 |
patch 파일 {CONTEXTPATH} 덮어쓰기 |
STEP 3-1 |
|
☐ |
7 |
reports 파일 {REPORTPATH} 덮어쓰기 |
STEP 3-2 |
|
☐ |
8 |
고객사 커스터마이징 / 별도 라이브러리 재적용 |
STEP 3-3 |
|
☐ |
9 |
(JEUS만) matrix.was.jeus=true 설정 |
STEP 4-1 |
|
☐ |
10 |
브라우저 캐시 및 서버 캐시 삭제 |
STEP 5 |
|
☐ |
11 |
(Linux만) 권한/소유자 점검 |
STEP 6-1, 6-2 |
|
☐ |
12 |
WAS 서버 기동 및 로그 확인 |
STEP 6-3, 6-4 |
|
☐ |
13 |
버전 확인 (Web-PORTAL) |
STEP 7-1 |
|
☐ |
14 |
시스템 정보 조회 |
STEP 7-2 |
|
☐ |
15 |
Repository 테이블 점검 및 스크립트 적용 |
STEP 7-3, 7-4 |
|
☐ |
16 |
모듈 관리자 초기 설정 |
STEP 7-5 |
|
☐ |
17 |
주요 기능 샘플 점검 및 업무 영향도 확인 |
STEP 7-6 |
■ 작업 완료 확인
|
작업 시작 시각 |
|
|
작업 완료 시각 |
|
|
작업자 서명 |
|
|
검토자 서명 |
|
|
특이사항 |
|