페이지 트리

AUDPlatform 7.0.610

핫픽스 릴리즈 적용 가이드

순서대로 따라가는 작업자용 체크리스트

■ 문서 개요

본 문서는 AUDPlatform 7.0.610 핫픽스를 운영 환경에 안전하게 적용하기 위한 작업 절차를 정리한 가이드입니다. 작업자는 본 문서의 순서를 따라 단계별로 체크하며 진행해야 하며, 각 단계마다 제공되는 체크박스(☐)에 완료 여부를 표시하십시오.

대상 버전

7.0.610.20260327-01 ~

■ 릴리즈 파일 구성

배포된 ZIP/TAR.GZ 파일의 용도와 적용 여부를 아래 표에서 확인하십시오. (XXXXXX-XX 는 핫픽스 빌드 번호)

파일명

구분

플랫폼

AUDPlatform_7.0.610.20XXXXXX-XX_patch(필수).zip

필수

Windows / Linux 겸용

AUDPlatform_7.0.610.20XXXXXX-XX_reports(필수).zip

필수

Windows / Linux 겸용

AUDPlatform_7.0.610.20XXXXXX-XX_patch(필수_리눅스).tar.gz

필수

Linux 전용

AUDPlatform_7.0.610.20XXXXXX-XX_reports(필수_리눅스).tar.gz

필수

Linux 전용

AUDPlatform_7.0.610.20XXXXXX-XX_extention(참고).zip

참고용

-

AUDPlatform_7.0.610.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.610.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.610.20XXXXXX-XX_patch(필수).zip

▶ 적용 경로:

{CONTEXTPATH}/ 하위

 

3-2. reports 파일 적용

확인

No

작업 항목

비고 / 경로

3-2-1

reports(필수) 파일을 {REPORTPATH} 하위에 덮어쓰기

-

▶ 파일명:

AUDPlatform_7.0.610.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

 


■ 작업 완료 확인

작업 시작 시각

 

작업 완료 시각

 

작업자 서명

 

검토자 서명

 

특이사항