WASPostUpgrade 명령
WebSphere® Application Server의 WASPostUpgrade 명령은 지정한 backupDirectory에서 WASPreUpgrade 명령으로 작성한 저장된 구성을 검색합니다. WebSphere Application Server의 WASPostUpgrade 스크립트는 이 디렉토리에서 WebSphere Application Server 버전 9.0로 마이그레이션할 구성을 읽고 마이그레이션된 모든 애플리케이션을 버전 9.0 설치의 app_server_root/installedApps 디렉토리에 추가합니다.
위치

이 기사는 프로파일 구성 마이그레이션에 대한 기사입니다. 애플리케이션을 최신 버전으로 마이그레이션하려면 WebSphere Application Server 마이그레이션 툴킷을 사용하십시오. 자세한 정보는 WASdev의 마이그레이션 툴킷을 참조하십시오.
sptcfg명령 파일은 app_server_root/bin 디렉토리에 있으며 이 위치에서 실행해야 합니다.
권한
이 명령 스크립트를 실행하려면 사용자 프로파일에 *ALLOBJ 권한이 있어야 합니다.
구문
WASPostUpgrade backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
WASPostUpgrade backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
매개변수
명령 매개변수는 다음과 같습니다.
- 필수 매개변수입니다. backupDirectory 값은 WASPreUpgrade 도구가 저장된 구성 및 파일을 저장하고 WASPostUpgrade 도구가 구성과 파일을 읽는 디렉토리의 이름을 지정합니다.
- 선택적 매개변수입니다. 값 properties_file_name은
WASPostUpgrade와 같은 마이그레이션 도구가 작동하는 방법을 정의하는
매개변수 특성이 포함된 특성 파일에 대한 경로를 지정합니다.
명령행에서 대부분의 선택적 매개변수를 지정하지 않고 마이그레이션 특성 파일에서 매개변수 특성을 정의할 수 있습니다. 매개변수가 특성 파일에서 정의되고 명령행에서 지정되는 경우 명령행에서 지정된 매개변수에 우선순위가 부여됩니다.
참고: 특정 매개변수는 특성 파일에서 지정할 수 없습니다(예: -properties 매개변수 자체 및 -username, -password). 특성으로 정의할 수 없는 매개변수의 목록은 app_server_root/bin 디렉토리의 템플리트 migration.properties 파일을 참조하십시오. - 선택적 매개변수입니다. userID 값은 현재 WebSphere Application Server 버전 7.0 이상 설치의
관리자 이름을 지정합니다. 다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
- 선택적 매개변수입니다. password 값은 현재 WebSphere Application Server 버전 7.0 이상 설치의
관리자 이름에 대한 비밀번호를 지정합니다. 다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
- WebSphere Application Server 버전 9.0의 특정 프로파일로
마이그레이션하기 위한 선택적 매개변수입니다.
profile_name 값은
스크립트가 구성을 마이그레이션하는 버전 9.0
프로파일의 이름을 지정합니다. WASPostUpgrade
명령을 호출하기 전에 이 프로파일을 먼저
작성해야 합니다. -profileName 매개변수를 지정하지 않으면 기본 프로파일이 사용됩니다. 기본 프로파일이 없으면 시스템이 오류를 보고합니다.
문제점 방지: -profileName에 특정 프로파일 이름을 지정하지 않으면 "default"으로 지정된 프로파일이 마이그레이션됩니다. 클라이언트가 새 환경에서 원하는 모든 프로파일마다 -oldProfile 및 -profileName 매개변수를 지정하여 WASPostUpgrade 사후 마이그레이션 명령을 사용해서 사전 마이그레이션에서 수행한 백업의 각 프로파일을 마이그레이션해야 할 수 있습니다. 샘플 애플리케이션과 시스템 애플리케이션 외에 설치된 애플리케이션(installedApps)이 이전 프로파일에 포함되어 있으면 마이그레이션 프로세스가 이 애플리케이션을 자동으로 마이그레이션합니다. gotcha
참고: 독립형 애플리케이션 서버를 버전 9.0에서 마이그레이션할 때 마이그레이션 대상으로 관리 에이전트에 이미 등록된 독립형 애플리케이션 서버 노드를 선택할 수 있습니다. - WASPostUpgrade 도구가 변경하기 전에 기존 WebSphere Application Server 버전 9.0 구성이 저장되는지 여부를
지정하는 데 사용되는 선택적 매개변수입니다.
기본값은 true—즉,
backupConfig 명령을 사용하여 현재 구성 사본을
profile_name/temp 디렉토리에
저장하는 것입니다.
필요에 따라 restoreConfig 명령을 사용하여 구성을 복원하십시오. 자세한 정보는 restoreConfig 명령을 참조하십시오.
- 새 프로파일에 대한 포트 설정 방법을 지정하는 선택적 매개변수입니다.
이 매개변수는 다음 값을 사용합니다.
이 매개변수의 값이 지정되면 할당되는 새 포트가 이 값에 기초하여 설정됩니다. 새 포트 값이 필요할 때마다 이 값에 기초하여 포트가 작성되고 시드(seed) 값은 다음 사용을 위해 증가합니다. 중복 포트는 지정되지 않습니다.
- 이 선택적 매개변수는 포트 값을 맵핑하는 방법을 지정하는 데 사용됩니다. 포트를 사용할 수 없는 경우
사용 가능한 포트를 발견할 때까지 시작 값에서부터 포트 값을 증분합니다.
- 마이그레이션의 일부로 비즈니스 레벨 애플리케이션, 자산, 컴포지션
단위를 포함할 수 있습니다. WASPostUpgrade
명령에 -IncludeApps 매개변수를 사용하여 선택적으로 이 항목을
마이그레이션할 수 있습니다.
다음 방식으로 지정할 수 있는 선택적
매개변수입니다.
WebSphere Application Server 시스템 애플리케이션은 이 매개변수에 설정된 값과 상관없이 마이그레이션합니다.
- 기존 WebSphere Application Server
버전 7.0 이상 배치 관리자를
사용 안함으로 설정할지 여부를 지정하는 데 사용되는 선택적 매개변수입니다. 기본값은 false입니다.
이 매개변수가 true로 지정된 경우 마이그레이션이 완료되는 동안 기존 버전 7.0 이상 배치 관리자를 사용할 수 있습니다. 이는 배치 관리자를 마이그레이션할 때에만 유효하며 다른 마이그레이션에서는 무시됩니다.
주의: 이 매개변수는 주의해서 사용하십시오. - 모든 애플리케이션을 현재 위치한 동일한 디렉토리에 설치할지
여부를 지정하는 데 사용되는 선택적
매개변수입니다. 기본값은 false입니다.
이 매개변수를 true로 지정하면 각각의 개별 애플리케이션이 자신의 위치를 유지합니다.
이 매개변수를 지정하는 경우 -appInstallDirectory 매개변수를 지정할 수 없습니다.
제한사항: 이 매개변수를 true로 지정하면 기존 WebSphere Application Server 버전 7.0 이상 설치와 버전 9.0 설치 간에 위치가 공유됩니다. 이전 버전과 동일한 위치에 마이그레이션된 애플리케이션을 두는 경우 다음과 같은 제한사항이 적용됩니다. - 마이그레이션 중 모든 애플리케이션을 설치할 때 사용할
디렉토리 이름을 전달하는 데 사용되는 선택적 매개변수입니다.
이 매개변수를 지정하지 않으면
profile_name\installedApps의 기본값이
사용됩니다.
이 매개변수를 지정하는 경우에는 -keepAppDirectory 매개변수를 지정할 수 없습니다.
이름에 하나 이상의 공백이 포함된 경우 디렉토리 이름을 따옴표로 묶어야 합니다.
이 매개변수를 사용하면 마이그레이션 도구는 백업 디렉토리(이전 릴리스에 대한 변수)와 대상 프로파일(새 릴리스의 변수) 모두의 마이그레이션 중인 노드에 대한 노드 레벨 변수를 조사합니다. 경로가 이 릴리스 중 하나에서 다음 변수의 일부일 경우 도구는 경로 정보를 축약하여 관련 변수를 사용합니다.
예를 들면, 다음과 같습니다.MIGR0341W: Application install directory has been updated to {0}.
또는MIGR0341W: Application install directory has been updated to ${USER_INSTALL_ROOT}\customAppDirectory.
MIGR0341W: Application install directory has been updated to ${APP_INSTALL_ROOT}\ cellName\customAppDirectory\.
- 선택적 매개변수입니다. trace_spec 값은
수집하려는 추적 정보를 지정합니다.
모든 추적 정보를 수집하려면 "*=all=enabled"(따옴표 포함)를 지정하십시오.
-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 둡니다.
- 선택적 매개변수입니다. file_name 값은 추적 정보의
출력 파일 이름을 지정합니다.
-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 둡니다.
- 선택적 매개변수입니다. seconds 값은
마이그레이션이 wsadmin 연결 시도에 실패하기 전에 대기할 시간(초)을
나타냅니다.
이 값은 애플리케이션 마이그레이션 중 제한시간 매개변수로도 사용됩니다.
- 선택적 매개변수입니다. path to old
admin agent 값은 원래 관리 에이전트의 프로파일 디렉토리에 대한
파일 시스템 경로를 나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. soap port of
old admin agent 값은 관리 연결을 위해 원래 관리 에이전트에
사용되는 SOAP 포트를 나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. hostname of
old admin agent 값은 원래 관리 에이전트의 호스트 이름 위치를
나타냅니다. 이 매개변수를 지정하지 않는 경우
값은 기본적으로 "localhost"로 설정됩니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. login username
for old admin agent 값은 원래 관리 에이전트의 사용자 이름을
나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 보안이 사용되는 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. path to new
admin agent 값은 새로 마이그레이션된 관리 에이전트에 대한
프로파일 디렉토리의 파일 시스템 경로를 나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. soap port of
old admin agent 값은 관리 연결을 위해 새로 마이그레이션된
관리 에이전트에 사용되는 SOAP 포트를 나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. hostname of old admin agent
값은 새 관리 에이전트의 호스트 이름 위치를
나타냅니다. 이 매개변수를 지정하지 않는 경우
값은 기본적으로 "localhost"로 설정됩니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. login username for old admin
agent 값은 새 관리 에이전트의 사용자 이름을
나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 보안이 사용되는 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. login password for old admin
agent 값은 새 관리 에이전트의 사용자 이름을
나타냅니다.
이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 보안이 사용되는 관리 에이전트에서 관리되는 경우에만 필수입니다.
- 선택적 매개변수입니다. WASPostUpgrade에 사용되는 Java
힙의 메모리 크기를 지정하려면 이 매개변수를 사용하십시오.
"-Xms...m" 값은 시작 힙 크기를 지정합니다. "..."를 필요한 메가바이트 크기로 바꾸십시오. 예를 들어, 시작 힙 크기가 128MB이면 매개변수를 -javaoption -Xms128m으로 지정하십시오.
"-Xmx...m"은 최대 힙 크기를 지정합니다. "..."를 필요한 메가바이트 크기로 바꾸십시오. 예를 들어, 최대 힙 크기가 1024MB이면 매개변수를 -javaoption -Xmx1024m으로 지정하십시오.
보안 고려사항
대상 시스템은 마이그레이션 전에 보안을 사용 안함으로 설정해야 합니다. 보안이 사용된 소스 구성으로부터 마이그레이션하는 경우 WASPostUpgrade 명령은 마이그레이션 중 버전 9.0 대상 구성의 보안을 자동으로 사용 가능하게 합니다.