[AIX Solaris HP-UX Linux Windows][IBM i]

WASPreUpgrade 명령

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

위치

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

[IBM i]

권한

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

구문

[AIX][HP-UX][Linux][Solaris]
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]
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]
[IBM i]
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 이상의 에디션일 수 있습니다.

[AIX Solaris HP-UX Linux Windows]currentWebSphereDirectory는 소스 WebSphere Application Server 설치의 설치 루트 디렉토리 이름을 지정합니다.

[IBM i]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
[AIX Solaris HP-UX Linux Windows][IBM i]-properties
[AIX Solaris HP-UX Linux Windows][IBM i]선택적 매개변수입니다. 값 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 디렉토리에 둡니다.

[AIX Solaris HP-UX Linux Windows]-machineChange
[AIX Solaris HP-UX Linux Windows]마이그레이션(운영 체제 및 시스템 경계를 넘어가는 것을 포함하여)에 사용되는 선택적 매개변수입니다. 이 매개변수는 true로 지정되면 WebSphere Application Server 설치나 프로파일 폴더 계층 구조 외부에 저장된 항목을 백업하여 마이그레이션할 때 물리적 하드웨어 변경을 지원합니다. false로 지정된 경우에는 마이그레이션 중 WebSphere Application Server 설치 폴더나 프로파일 폴더에 저장된 파일만 백업 디렉토리로 복사됩니다.

기본값은 false입니다.

이 값이 false이면 마이그레이션은 신규 및 이전 WebSphere Application Server 설치가 파일 시스템에 대한 액세스를 공유하는 동일한 물리적 시스템에 있다고 가정합니다. 따라서 WebSphere 디렉토리 외부에 있는 파일은 공용이며 공유할 수 있습니다. -machineChange가 false일 때에는 마이그레이션 시 WebSphere Application Server 트리 외부의 파일을 백업 디렉토리에 복사하지 않습니다. [AIX Solaris HP-UX Linux Windows]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와 함께 실행하는 경우(백업 디렉토리에 공유 파일 저장소 오브젝트가 포함됨) 롤백을 지원하는 파일 저장소 백업을 포함하기에는 기본 최대 힙이 너무 작아서 사후 업그레이드 프로세스에 메모리 부족 예외가 발생할 수 있습니다. 이 문제를 해결하려면 다음 세 개의 태스크 중 하나를 수행하십시오.
  • 시스템 위치의 파일 저장소가 유효한 경우 WASPostUpgrade 명령을 실행하기 전에 백업 디렉토리에서 사본을 삭제하십시오.

    WASPostUpgrade 명령을 실행하기 전에 전체 /migrated/ 서브디렉토리를 마이그레이션 백업 디렉토리에서 삭제하여 근본적으로 사전 업그레이드 백업을 -machineChange=true에서 -machineChange=false로 변환합니다.

  • 백업 디렉토리의 파일 저장소 사본이 올바르지 않은 경우 대상 위치에서 버전을 삭제하십시오.

    그러면 대상 파일이 존재하지 않게 되어 마이그레이션 중에 메모리 공간을 차지하지 않도록 롤백 지원이 변경됩니다.

  • 롤백 지원이 필요하며 파일 시스템의 파일뿐 아니라 백업 디렉토리의 파일이 모두 필요한 경우에는 사후 업그레이드 프로세스의 최대 힙 크기를 충돌하는 모든 SIB 파일을 지원할 수 있을 정도의 큰 값으로 늘리십시오.
[AIX Solaris HP-UX Linux Windows]-oldProfile
[AIX Solaris HP-UX Linux Windows]특정 인스턴스나 프로파일을 WebSphere Application Server의 이전 버전으로부터 마이그레이션하는 데 사용되는 선택적 매개변수입니다.
-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 디렉토리에 저장합니다.
  • [AIX Solaris HP-UX Linux Windows]classes
  • config
  • properties

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



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