WEB WAS OS APM
#Migration#WebSphere

[WebSphere] WAS V5/V6 to V7 마이그레이션 가이드 (WASPreUpgrade, WASPostUpgrade)

기존 WebSphere Application Server(V5.1.x, V6.x) 환경의 구성을 신규 버전(V7.x)으로 이관하는 마이그레이션 절차를 정리합니다. 구성 백업(WASPreUpgrade)과 복구(WASPostUpgrade), 그리고 WebSphere Virtual Enterprise(XD) 환경의 이관 방법을 포함합니다.

1. 사전 준비 및 프로세스 확인

마이그레이션 도구를 실행하기 전, 원본 서버와 대상 서버의 상태를 확인해야 합니다.

  • Source WAS (V5/V6): 구성 정보를 읽어야 하므로 구동 상태 확인 (또는 구성 파일 접근 가능 상태).
  • Target WAS (V7): 프로파일을 덮어쓰거나 설정을 변경해야 하므로 정지(Stop) 상태여야 함.

2. 구성 백업 (WASPreUpgrade)

구 버전 WAS의 구성 정보를 백업 디렉토리로 추출합니다.

구문 (Syntax)

WASPreUpgrade [백업저장경로] [구버전WAS경로] [-oldProfile 프로파일멍] [-machineChange true|false]

실행 예시

Windows 환경

:: V6.1 Dmgr 프로파일을 C:\mybackup 경로로 백업
C:\IBM\WebSphere70\AppServer\bin\WASPreUpgrade.bat C:\mybackup\v61tov7dmgr01 C:\IBM\WebSphere61\AppServer -oldProfile Dmgr01

Linux/Unix 환경

# Dmgr01 프로파일 백업 (머신 변경 옵션 포함)
cd /app/was/AppServer/bin
./WASPreUpgrade.sh /app/was/backup_config /app/was/WebSphere6/AppServer -oldProfile Dmgr01 -machineChange true

3. 구성 복구 (WASPostUpgrade)

백업된 구성 정보를 신규 버전(V7)의 프로파일에 적용합니다. 대용량 구성의 경우 타임아웃이 발생할 수 있으므로 사전 조치가 필요합니다.

사전 조치: SOAP Timeout 설정

복구 시간이 오래 걸릴 경우를 대비해 SOAP 요청 타임아웃을 늘려줍니다.

  • 파일 위치: [Target_Profile_Root]/properties/soap.client.props
  • 설정 변경: com.ibm.SOAP.requestTimeout=1800 (또는 0으로 설정하여 무제한)

구문 (Syntax)

WASPostUpgrade [백업저장경로] [-profileName 대상프로파일] [-oldProfile 구프로파일] [-includeApps true|false] [-keepDmgrEnabled true|false]

실행 예시

Windows 환경

C:\IBM\WebSphere70\AppServer\bin\WASPostUpgrade.bat C:\mybackup\v61tov7dmgr01 ^
 -profileName v61tov7dmgr01 ^
 -oldProfile Dmgr01 ^
 -replacePorts TRUE ^
 -keepDmgrEnabled TRUE

Linux/Unix 환경

cd /app/was/AppServer/profiles/Dmgr01/bin
./WASPostUpgrade.sh /app/was/backup_config \
 -profileName Dmgr01 \
 -oldProfile Dmgr01 \
 -replacePorts true \
 -backupConfig true \
 -scriptCompatibility true \
 -keepDmgrEnabled true \
 -includeApps true \
 -username wasadmin \
 -password wasadmin

주요 옵션 설명

  • -replacePorts true: 구 버전에서 사용하던 포트를 신규 버전에서도 그대로 사용합니다. (포트 충돌 주의)
  • -includeApps true: 애플리케이션(EAR/WAR) 파일도 함께 마이그레이션합니다.
  • -keepDmgrEnabled true: Dmgr이 마이그레이션 중에도 관리 기능을 유지하도록 설정합니다.

4. WebSphere Virtual Enterprise (XD/VE) 마이그레이션

WAS ND(Network Deployment) 위에 VE(Virtual Enterprise) 기능이 설치된 경우, 추가적인 단계가 필요합니다.

Step 1: 프로파일 기능 보강 (Augment)

신규 생성된 V7 프로파일에 VE 기능을 사용할 수 있도록 템플릿을 추가(Augment)합니다.

# manageprofiles 명령어로 xd_augment 템플릿 적용
./manageprofiles.sh -augment \
 -profileName profile01 \
 -templatePath [WAS_INSTALL_ROOT]/profileTemplates/xd_augment/dmgr

Step 2: VE 구성 마이그레이션 (VEUpgrade)

기존 VE 셀의 구성을 신규 V7 VE 셀로 이관합니다.

# VEUpgrade 실행 예시
./VEUpgrade.sh \
 -userid wasadmin \
 -password [PASSWORD] \
 -sourcewashome /app/was/WebSphere6/AppServer \
 -sourceprofilepath /app/was/WebSphere6/AppServer/profiles/Dmgr01 \
 -targetprofilepath /app/was/WebSphere/AppServer/profiles/Dmgr01

5. 완료 및 확인

  1. 구 버전 중지: 포트 충돌 방지를 위해 Source WAS(V5/V6)를 완전히 중지합니다.
  2. 신규 버전 기동: Target WAS(V7)의 Dmgr 및 NodeAgent를 기동합니다. 
    [WAS7_HOME]/profiles/Dmgr01/bin/startManager.sh
  3. 로그 확인: WASPostUpgrade.log 및 SystemOut.log를 확인하여 에러 여부를 점검합니다.

Next Step:
마이그레이션이 완료된 후, JDK 버전 차이(JDK 1.4/5 -> JDK 6)로 인한 애플리케이션 호환성 문제가 없는지 검증하는 테스트 계획을 수립하십시오.

Comments