WASPreUpgrade 명령
WebSphere® Application Server 버전 9.0의 WASPreUpgrade 명령은 이전에 설치된 WebSphere Application Server 버전의 구성을 마이그레이션별 백업 디렉토리에 저장합니다.
위치
명령 파일은 버전 9.0 app_server_root/bin 디렉토리에 있으며 이 위치에서 실행해야 합니다.
구문
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPreUpgrade.sh backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-machineChange true | false]
[-oldProfile profile_name]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name >]
[-password < password >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ] [-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
![[Windows]](../images/windows.gif)
WASPreUpgrade.bat backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-machineChange true | false]
[-oldProfile profile_name]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name >]
[-password < password >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ] [-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
매개변수
명령 매개변수는 다음과 같습니다.
- 필수 매개변수이며 첫 번째로
지정해야 합니다.
backupDirectory 값은 명령 스크립트가 저장된 구성을
저장하는 디렉토리의 이름을
지정합니다.
문제점 방지: WAS_INSTALL 및 USER_INSTALL 루트 디렉토리는 WebSphere Application Server 백업 디렉토리의 위치에 올바르지 않은 디렉토리입니다. gotcha
WASPostUpgrade 명령이 구성을 읽는 디렉토리이기도 합니다.
디렉토리가 없으면 WASPreUpgrade 명령 스크립트가 디렉토리를 작성합니다.
- 필수 매개변수이며 두 번째로
지정해야 합니다. 이는 마이그레이션이 지원되는
WebSphere Application Server
버전 7.0 이상의 에디션일 수 있습니다.
값 currentWebSphereDirectory는 소스 WebSphere Application Server 설치의 설치 루트 디렉토리 이름을 지정합니다.
- 선택적 매개변수입니다. 값 properties_file_name은
WASPreUpgrade와 같은 마이그레이션 도구가 작동하는 방법을 정의하는
매개변수 특성이 포함된 특성 파일에 대한 경로를 지정합니다.
명령행에서 대부분의 선택적 매개변수를 지정하지 않고 마이그레이션 특성 파일에서 매개변수 특성을 정의할 수 있습니다. 매개변수가 특성 파일에서 정의되고 명령행에서 지정되는 경우 명령행에서 지정된 매개변수에 우선순위가 부여됩니다.
참고: 특정 매개변수는 특성 파일에서 지정할 수 없습니다(예: -properties 매개변수 자체 및 -username, -password). 특성으로 정의할 수 없는 매개변수의 목록은 app_server_root/bin 디렉토리의 템플리트 migration.properties 파일을 참조하십시오. - 선택적 매개변수입니다. trace_spec 값은 수집하려는
추적 정보를 지정합니다.
모든 추적 정보를 수집하려면 "*=all=enabled"(따옴표 포함)를 지정하십시오.
-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 둡니다.
- 선택적 매개변수입니다. file_name 값은
추적 정보의 출력 파일 이름을 지정합니다.
-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 둡니다.
- 마이그레이션(운영 체제 및 시스템 경계를 넘어가는 것을 포함하여)에
사용되는 선택적 매개변수입니다. 이 매개변수는
true로 지정되면 WebSphere Application Server 설치나
프로파일 폴더 계층 구조 외부에 저장된 항목을 백업하여
마이그레이션할 때 물리적 하드웨어 변경을
지원합니다. false로 지정된 경우에는
마이그레이션 중 WebSphere Application Server 설치 폴더나
프로파일 폴더에 저장된 파일만 백업 디렉토리로
복사됩니다.
기본값은 false입니다.
이 값이 false이면 마이그레이션은 신규 및 이전 WebSphere Application Server 설치가 파일 시스템에 대한 액세스를 공유하는 동일한 물리적 시스템에 있다고 가정합니다. 따라서 WebSphere 디렉토리 외부에 있는 파일은 공용이며 공유할 수 있습니다. -machineChange가 false일 때에는 마이그레이션 시 WebSphere Application Server 트리 외부의 파일을 백업 디렉토리에 복사하지 않습니다. False는 마이그레이션 마법사를 사용할 때의 유일한 옵션입니다. -machineChange=false를 선택하는 경우 동일한 물리적 하드웨어에서 WASPostUpgrade 명령을 실행해야 합니다.
WASPostUpgrade 명령을 다른 머신이나 파일 시스템에서 실행하려면 WASPreUpgrade 명령을 -machineChange=true와 함께 실행해야 합니다. -machineChange=true를 선택하면 마이그레이션 시 제품이나 프로파일 디렉토리 외부에 상주하는 WebSphere Application Server 구성에 참조되는 파일을 포함한 마이그레이션 백업 디렉토리에 추가 서브디렉토리(/migrated/)가 작성됩니다. WASPostUpgrade 명령을 실행하면 이 파일이 새 머신에서 원래 경로로 돌아갑니다.
성능 고려사항:파일 시스템 파일 스토어 저장소로 구성된 SIB(Service Integration Bus) 버스를 사용하여 마이그레이션하는 경우 마이그레이션 힙과 마이그레이션 백업 디렉토리에 추가 공간이 필요할 수 있습니다. 각 버스에는 세 가지 파일 저장소 값인 로그, 시간소인, 저장소가 있습니다. 이 세 파일은 100 - 500MB 정도의 크기로 크기가 각기 다릅니다. 마이그레이션이 실행되면 사전 업그레이드 프로세스 중 WebSphere Application Server 트리에 있는 파일 저장소가 백업됩니다. 파일 시스템에는 이를 위한 충분한 공간이 있어야 합니다. 사후 업그레이드 프로세스를 수행하는 동안 대상 위치에 이미 파일 저장소가 있는 경우 마이그레이션이 롤백을 지원하기 위해 메모리에 파일 저장소를 백업합니다.
WASPreUpgrade 명령을 -machineChange=true와 함께 실행하는 경우(백업 디렉토리에 공유 파일 저장소 오브젝트가 포함됨) 롤백을 지원하는 파일 저장소 백업을 포함하기에는 기본 최대 힙이 너무 작아서 사후 업그레이드 프로세스에 메모리 부족 예외가 발생할 수 있습니다. 이 문제를 해결하려면 다음 세 개의 태스크 중 하나를 수행하십시오. - 특정 인스턴스나 프로파일을 WebSphere Application Server의 이전 버전으로부터 마이그레이션하는 데 사용되는 선택적 매개변수입니다.
- 선택적 매개변수입니다. user_workspace_folder_name_x 값은 하나 이상의 프로파일에 대한 관리 콘솔 사용자 정의 "내 태스크" 설정의 위치를 지정합니다.
- 선택적 매개변수입니다. user name 값은 현재 WebSphere Application Server 설치의 관리 사용자
이름을 지정합니다. 다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
- 배치 관리자를 마이그레이션 중입니다.
- 소스 설치에 관리 또는 글로벌 보안이 사용됩니다.
- WebSphere Application Server 버전 8.0 이상 설치로부터 마이그레이션 중입니다.
- 선택적 매개변수입니다. password 값은 현재 WebSphere Application Server 설치의
관리 비밀번호를 지정합니다. 다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
- 배치 관리자를 마이그레이션 중입니다.
- 소스 설치에 관리 또는 글로벌 보안이 사용됩니다.
- WebSphere Application Server 버전 8.0 이상 설치로부터 마이그레이션 중입니다.
- 선택적 매개변수입니다. WASPreUpgrade 명령에서 사용하는
Java™ 힙의 메모리 크기를 지정하려면
이 매개변수를 사용하십시오.
"-Xms...m" 값은 시작 힙 크기를 표시하기 위해 지정된 매개변수입니다. "..."를 사용하려는 메가바이트 크기로 바꾸십시오. 예를 들어, 시작 힙 크기가 128MB이면 매개변수를 -javaoption -Xms128m으로 지정하십시오.
"-Xmx...m" 값은 최대 힙 크기를 표시하기 위해 지정된 매개변수입니다. "..."를 사용하려는 메가바이트 크기로 바꾸십시오. 예를 들어, 최대 힙 크기가 1024MB이면 매개변수를 -javaoption -Xmx1024m으로 지정하십시오.
- 임베디드 데이터베이스를 마이그레이션하기 위한 선택적 매개변수입니다.
값이 true로 지정되면 임베디드 데이터베이스를 마이그레이션할 때 발생하는 모든 예외가 WASPreUpgrade 명령을 실패하게 합니다. 값이 false로 지정되면 임베디드 데이터베이스를 마이그레이션할 때 발생하는 모든 예외가 추적 파일에 로그되며 WASPreUpgrade 명령이 계속됩니다.
기본값은 true입니다.
- 버전 8.0 배치 관리자 프로파일을 마이그레이션하기 위해 사용되는
선택적 매개변수입니다.
WASPreUpgrade를 실행하면 버전 8.0 배치 관리자 프로파일은 중지됩니다. 기본적으로 배치 관리자는 중지된 상태로 유지됩니다. 값이 true로 지정되면 WASPreUpgrade는 실행 중인 명령이 완료하기 전에 배치 관리자를 시작합니다.
기본값은 false입니다.
로깅
WASPreUpgrade 도구는 실행하는 화면에 상태를 표시합니다. backupDirectory 디렉토리(backupDirectory는 backupDirectory 매개변수에 지정된 값임)에 쓴 WASPreUpgrade.time_stamp.log 파일에 보다 광범위한 로깅 정보 세트를 저장하기도 합니다. 문서 편집기로 WASPreUpgrade.time_stamp.log 파일을 볼 수 있습니다.
마이그레이션된 자원
WASPreUpgrade는 모든 자원을 저장하지만 classes 디렉토리의 엔티티는 마이그레이션하지 않습니다.