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 디렉토리에 있으며 이 위치에서 실행해야 합니다.
구문
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname host_name]
[[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname host_name]
[[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh 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 ]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat 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 이상 설치의
관리자 이름에 대한 비밀번호를 지정합니다. 다음 조건에 해당되는 경우 이는 필수 매개변수입니다.팁: 마이그레이션 마법사에서 비밀번호를 지정해야 하거나 명령행에 -password 매개변수와 함께 WASPostUpgrade 명령을 사용할 때 일반 텍스트로 비밀번호를 입력하거나 xor-ciphered 값을 사용할 수 있습니다. xor-ciphered 값을 사용하려면 매개변수의 값으로 {xor} 접두부를 포함하여 전체 비밀번호를 입력하십시오. 이 xor-ciphered 값은 soap.client.props, ssl.client.props, security.xml 파일을 포함하여 이전 구성의 여러 WebSphere Application Server 구성 파일 중 하나에 지정할 수 있습니다.팁: 명령행에 -password 매개변수와 함께 WASPostUpgrade 명령을 사용할 때 일반 텍스트로 비밀번호를 입력하거나 xor-ciphered 값을 사용할 수 있습니다. xor-ciphered 값을 사용하려면 매개변수의 값으로 {xor} 접두부를 포함하여 전체 비밀번호를 입력하십시오. 이 xor-ciphered 값은 soap.client.props, ssl.client.props, security.xml 파일을 포함하여 이전 구성의 여러 WebSphere Application Server 구성 파일 중 하나에 지정할 수 있습니다.
- 이전 WebSphere Application Server 버전에서
인스턴스나 프로파일을 마이그레이션하기 위한 선택적 매개변수입니다.
이 명령을 실행하기 전에 인스턴스나 프로파일이
마이그레이션 백업 디렉토리에 있어야 합니다. -oldProfile 매개변수를 지정하지 않으면 기본 프로파일이 사용됩니다. 기본 프로파일이 없으면 시스템이 오류를 보고합니다.
문제점 방지: -oldProfile에 특정 프로파일 이름을 지정하지 않으면 "default"으로 지정된 프로파일이 마이그레이션됩니다. 클라이언트가 새 버전 9.0 환경에서 원하는 모든 프로파일마다 -oldProfile 및 -profileName 매개변수를 지정하여 WASPostUpgrade 사후 마이그레이션 명령을 사용해서 사전 마이그레이션에서 수행한 백업의 각 프로파일을 마이그레이션해야 할 수 있습니다. 샘플 애플리케이션과 시스템 애플리케이션 외에 설치된 애플리케이션(installedApps)이 이전 프로파일에 포함되어 있으면 마이그레이션 프로세스가 이 애플리케이션을 자동으로 마이그레이션합니다. gotcha
- 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 시스템 애플리케이션은 이 매개변수에 설정된 값과 상관없이 마이그레이션합니다.
- 이 선택적 매개변수는 버전 9.0 환경으로 마이그레이션한 후 소스 프로파일을 계속 사용할 수 있음을 의미하는
복제 마이그레이션을 수행할지 여부를 표시합니다. 기본값은 false입니다.
-clone 매개변수가 true인 경우 -setPorts useold를 지정할 수 없습니다. 이제 공존하는 새 구성 및 이전 구성에 포트 충돌이 없도록 새 프로파일 구성이 고유한 포트 번호를 사용해야 합니다.
배치 관리자를 복제하는 경우 해당 연합 노드도 복제해야 하며 배치 관리자를 복제하지 않고 연합 노드를 복제할 수 없습니다. 연합 노드의 복제 마이그레이션에서는 다음 매개변수에서 새 호스트 이름과 노드 SOAP 포트 또는 RMI 포트 중 하나를 설정해야 합니다.- -newDmgrHostname
- 버전 9.0 배치 관리자의 호스트 이름입니다.
- -newDmgrSoapPort
- 버전 9.0 배치 관리자의 SOAP(Simple Object Access Protocol) 포트입니다.
- -newDmgrRmiPort
- 버전 9.0 배치 관리자의 원격 메소드 호출(RMI) 포트입니다.
- 기존 WebSphere Application Server
버전 7.0 이상 배치 관리자를
사용 안함으로 설정할지 여부를 지정하는 데 사용되는 선택적 매개변수입니다. -clone 매개변수가
true이고 -keepDmgrEnabled 역시
true로 설정되는 상황이 아닌 경우, 기본값은 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 도구는 실행 중 화면에 상태를 표시합니다. 이 도구는 backupDirectory/logs 디렉토리에 있는 WASPostUpgrade.time_stamp.log 파일에 보다 광범위한 로깅 정보 세트를 저장하기도 합니다. 문서 편집기로 WASPostUpgrade.time_stamp.log 파일을 볼 수 있습니다.
보안 고려사항
대상 시스템은 마이그레이션 전에 보안을 사용 안함으로 설정해야 합니다. 보안이 사용된 소스 구성으로부터 마이그레이션하는 경우 WASPostUpgrade 명령은 마이그레이션 중 버전 9.0 대상 구성의 보안을 자동으로 사용 가능하게 합니다.