WASPreUpgrade 명령

WebSphere® Application Server 버전 9.0WASPreUpgrade 명령은 이전에 설치된 WebSphere Application Server 버전의 구성을 마이그레이션별 백업 디렉토리에 저장합니다.

위치

명령 파일은 버전 9.0 app_server_root/bin 디렉토리에 있으며 이 위치에서 실행해야 합니다.

권한

이 명령 스크립트를 실행하려면 사용자 프로파일에 *ALLOBJ 권한이 있어야 합니다.

구문

WASPreUpgrade backupDirectory 
              currentWebSphereDirectory
              [-properties properties_file_name]
              [-traceString trace_spec [-traceFile file_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
필수 매개변수이며 첫 번째로 지정해야 합니다. backupDirectory 값은 명령 스크립트가 저장된 구성을 저장하는 디렉토리의 이름을 지정합니다.
문제점 방지 문제점 방지: WAS_INSTALLUSER_INSTALL 루트 디렉토리는 WebSphere Application Server 백업 디렉토리의 위치에 올바르지 않은 디렉토리입니다. gotcha

WASPostUpgrade 명령이 구성을 읽는 디렉토리이기도 합니다.

디렉토리가 없으면 WASPreUpgrade 명령 스크립트가 디렉토리를 작성합니다.

currentWebSphereDirectory
필수 매개변수이며 두 번째로 지정해야 합니다. 이는 마이그레이션이 지원되는 WebSphere Application Server 버전 7.0 이상의 에디션일 수 있습니다.
currentWebSphereDirectory는 마이그레이션하려는 소스 WebSphere Application Server 인스턴스 버전 7.0 이상 프로파일의 인스턴스 또는 프로파일 루트 디렉토리 이름을 지정합니다.
  • 프로파일 루트는 프로파일 작성 중에 선택한 고유한 값일 수 있지만 기본값은 다음 디렉토리입니다.
    • 버전 7.0(기본): /QIBM/UserData/WebSphere/AppServer/V7/Base/profiles/profile
    • 버전 7.0 WebSphere Application Server, Network Deployment: /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/profile
-properties
선택적 매개변수입니다. 값 properties_file_nameWASPreUpgrade와 같은 마이그레이션 도구가 작동하는 방법을 정의하는 매개변수 특성이 포함된 특성 파일에 대한 경로를 지정합니다.

명령행에서 대부분의 선택적 매개변수를 지정하지 않고 마이그레이션 특성 파일에서 매개변수 특성을 정의할 수 있습니다. 매개변수가 특성 파일에서 정의되고 명령행에서 지정되는 경우 명령행에서 지정된 매개변수에 우선순위가 부여됩니다.

참고: 특정 매개변수는 특성 파일에서 지정할 수 없습니다(예: -properties 매개변수 자체 및 -username, -password). 특성으로 정의할 수 없는 매개변수의 목록은 app_server_root/bin 디렉토리의 템플리트 migration.properties 파일을 참조하십시오.
-traceString
선택적 매개변수입니다. trace_spec 값은 수집하려는 추적 정보를 지정합니다.

모든 추적 정보를 수집하려면 "*=all=enabled"(따옴표 포함)를 지정하십시오.

-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 둡니다.

-traceFile
선택적 매개변수입니다. file_name 값은 추적 정보의 출력 파일 이름을 지정합니다.

-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 둡니다.

-workspaceRoot
선택적 매개변수입니다. user_workspace_folder_name_x 값은 하나 이상의 프로파일에 대한 관리 콘솔 사용자 정의 "내 태스크" 설정의 위치를 지정합니다.
-username
선택적 매개변수입니다. user name 값은 현재 WebSphere Application Server 설치의 관리 사용자 이름을 지정합니다.
다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
  • 배치 관리자를 마이그레이션 중입니다.
  • 소스 설치에 관리 또는 글로벌 보안이 사용됩니다.
  • WebSphere Application Server 버전 8.0 이상 설치로부터 마이그레이션 중입니다.
-password
선택적 매개변수입니다. password 값은 현재 WebSphere Application Server 설치의 관리 비밀번호를 지정합니다.
다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
  • 배치 관리자를 마이그레이션 중입니다.
  • 소스 설치에 관리 또는 글로벌 보안이 사용됩니다.
  • WebSphere Application Server 버전 8.0 이상 설치로부터 마이그레이션 중입니다.
-javaoption
선택적 매개변수입니다. WASPreUpgrade 명령에서 사용하는 Java™ 힙의 메모리 크기를 지정하려면 이 매개변수를 사용하십시오.

"-Xms...m" 값은 시작 힙 크기를 표시하기 위해 지정된 매개변수입니다. "..."를 사용하려는 메가바이트 크기로 바꾸십시오. 예를 들어, 시작 힙 크기가 128MB이면 매개변수를 -javaoption -Xms128m으로 지정하십시오.

"-Xmx...m" 값은 최대 힙 크기를 표시하기 위해 지정된 매개변수입니다. "..."를 사용하려는 메가바이트 크기로 바꾸십시오. 예를 들어, 최대 힙 크기가 1024MB이면 매개변수를 -javaoption -Xmx1024m으로 지정하십시오.

-requireEmbeddedDBMigration
임베디드 데이터베이스를 마이그레이션하기 위한 선택적 매개변수입니다.

값이 true로 지정되면 임베디드 데이터베이스를 마이그레이션할 때 발생하는 모든 예외가 WASPreUpgrade 명령을 실패하게 합니다. 값이 false로 지정되면 임베디드 데이터베이스를 마이그레이션할 때 발생하는 모든 예외가 추적 파일에 로그되며 WASPreUpgrade 명령이 계속됩니다.

기본값은 true입니다.

-keepDmgrEnabled
버전 8.0 배치 관리자 프로파일을 마이그레이션하기 위해 사용되는 선택적 매개변수입니다.

WASPreUpgrade를 실행하면 버전 8.0 배치 관리자 프로파일은 중지됩니다. 기본적으로 배치 관리자는 중지된 상태로 유지됩니다. 값이 true로 지정되면 WASPreUpgrade는 실행 중인 명령이 완료하기 전에 배치 관리자를 시작합니다.

기본값은 false입니다.

로깅

WASPreUpgrade 도구는 실행하는 화면에 상태를 표시합니다. backupDirectory 디렉토리(backupDirectory는 backupDirectory 매개변수에 지정된 값임)에 쓴 WASPreUpgrade.time_stamp.log 파일에 보다 광범위한 로깅 정보 세트를 저장하기도 합니다. 문서 편집기로 WASPreUpgrade.time_stamp.log 파일을 볼 수 있습니다.

마이그레이션된 자원

WASPreUpgrade는 모든 자원을 저장하지만 classes 디렉토리의 엔티티는 마이그레이션하지 않습니다.

마이그레이션은 다음 파일을 backupDirectory 디렉토리에 저장합니다.
  • config
  • properties

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-iseries&topic=rmig_WASPreUpgrade
파일 이름:rmig_WASPreUpgrade.html