WASPostUpgrade 명령

WebSphere® Application ServerWASPostUpgrade 명령은 지정한 backupDirectory에서 WASPreUpgrade 명령으로 작성한 저장된 구성을 검색합니다. WebSphere Application ServerWASPostUpgrade 스크립트는 이 디렉토리에서 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
필수 매개변수입니다. backupDirectory 값은 WASPreUpgrade 도구가 저장된 구성 및 파일을 저장하고 WASPostUpgrade 도구가 구성과 파일을 읽는 디렉토리의 이름을 지정합니다.
-properties
선택적 매개변수입니다. 값 properties_file_nameWASPostUpgrade와 같은 마이그레이션 도구가 작동하는 방법을 정의하는 매개변수 특성이 포함된 특성 파일에 대한 경로를 지정합니다.

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

참고: 특정 매개변수는 특성 파일에서 지정할 수 없습니다(예: -properties 매개변수 자체 및 -username, -password). 특성으로 정의할 수 없는 매개변수의 목록은 app_server_root/bin 디렉토리의 템플리트 migration.properties 파일을 참조하십시오.
-username
선택적 매개변수입니다. userID 값은 현재 WebSphere Application Server 버전 7.0 이상 설치의 관리자 이름을 지정합니다.
다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
  • 배치 관리자나 연합 노드를 마이그레이션 중입니다.
  • 소스 설치에 관리 또는 글로벌 보안이 사용됩니다.
  • 관리 또는 글로벌 보안 사용자 ID가 security.xml 파일에 정의되어 있지 않습니다.
-password
선택적 매개변수입니다. password 값은 현재 WebSphere Application Server 버전 7.0 이상 설치의 관리자 이름에 대한 비밀번호를 지정합니다.
다음 조건에 해당되는 경우 이는 필수 매개변수입니다.
  • 배치 관리자나 연합 노드를 마이그레이션 중입니다.
  • 소스 설치에 관리 또는 글로벌 보안이 사용됩니다.
  • 관리 또는 글로벌 보안 비밀번호가 security.xml 파일에 정의되어 있지 않습니다.
-profileName
WebSphere Application Server 버전 9.0의 특정 프로파일로 마이그레이션하기 위한 선택적 매개변수입니다. profile_name 값은 스크립트가 구성을 마이그레이션하는 버전 9.0 프로파일의 이름을 지정합니다. WASPostUpgrade 명령을 호출하기 전에 이 프로파일을 먼저 작성해야 합니다.
-profileName 매개변수를 지정하지 않으면 기본 프로파일이 사용됩니다. 기본 프로파일이 없으면 시스템이 오류를 보고합니다.
문제점 방지 문제점 방지: -profileName에 특정 프로파일 이름을 지정하지 않으면 "default"으로 지정된 프로파일이 마이그레이션됩니다. 클라이언트가 새 환경에서 원하는 모든 프로파일마다 -oldProfile 및 -profileName 매개변수를 지정하여 WASPostUpgrade 사후 마이그레이션 명령을 사용해서 사전 마이그레이션에서 수행한 백업의 각 프로파일을 마이그레이션해야 할 수 있습니다. 샘플 애플리케이션과 시스템 애플리케이션 외에 설치된 애플리케이션(installedApps)이 이전 프로파일에 포함되어 있으면 마이그레이션 프로세스가 이 애플리케이션을 자동으로 마이그레이션합니다. gotcha
참고: 독립형 애플리케이션 서버를 버전 9.0에서 마이그레이션할 때 마이그레이션 대상으로 관리 에이전트에 이미 등록된 독립형 애플리케이션 서버 노드를 선택할 수 있습니다.
-backupConfig
WASPostUpgrade 도구가 변경하기 전에 기존 WebSphere Application Server 버전 9.0 구성이 저장되는지 여부를 지정하는 데 사용되는 선택적 매개변수입니다. 기본값은 true—즉, backupConfig 명령을 사용하여 현재 구성 사본을 profile_name/temp 디렉토리에 저장하는 것입니다.

필요에 따라 restoreConfig 명령을 사용하여 구성을 복원하십시오. 자세한 정보는 restoreConfig 명령을 참조하십시오.

-setPorts
새 프로파일에 대한 포트 설정 방법을 지정하는 선택적 매개변수입니다. 이 매개변수는 다음 값을 사용합니다.
  • useOld(기본값): 이전 프로파일에서 사용된 것과 동일한 포트를 사용합니다.
  • generateNew: 기본 포트 지정에 따라 새 포트를 생성합니다.
  • port_starting_number: 지정된 값에서부터 증분하여 새 포트를 생성합니다.

이 매개변수의 값이 지정되면 할당되는 새 포트가 이 값에 기초하여 설정됩니다. 새 포트 값이 필요할 때마다 이 값에 기초하여 포트가 작성되고 시드(seed) 값은 다음 사용을 위해 증가합니다. 중복 포트는 지정되지 않습니다.

-resolvePortConflicts
이 선택적 매개변수는 포트 값을 맵핑하는 방법을 지정하는 데 사용됩니다. 포트를 사용할 수 없는 경우 사용 가능한 포트를 발견할 때까지 시작 값에서부터 포트 값을 증분합니다.
  • incrementCurrent(기본값): 충돌된 포트 값에서부터 증분합니다.
  • port_starting_number: 지정된 공통 시작 포트 값에서부터 증분합니다.
-includeApps
마이그레이션의 일부로 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위를 포함할 수 있습니다. WASPostUpgrade 명령에 -IncludeApps 매개변수를 사용하여 선택적으로 이 항목을 마이그레이션할 수 있습니다. 다음 방식으로 지정할 수 있는 선택적 매개변수입니다.
  • true

    마이그레이션의 일부로 사용자 엔터프라이즈 애플리케이션, 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위를 포함합니다.

    이 값이 기본값입니다.

  • false

    WASPostUpgrade 처리 중 사용자 엔터프라이즈 애플리케이션, 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위에 대해 아무 것도 수행하지 않습니다.

  • 스크립트
    • 엔터프라이즈 애플리케이션

      사용자 엔터프라이즈 애플리케이션을 WASPostUpgrade 처리 중 설치하지 않고 WebSphere Application Server 버전 9.0 installableApps 디렉토리에 설치하도록 준비합니다.

      이 애플리케이션을 설치하는 데 사용할 수 있는 스크립트가 생성되어 backupDirectory 디렉토리에 저장됩니다. 그러면 WASPostUpgrade 명령이 완료된 후 언제든지 임의로 조합하여 이 파일을 실행할 수 있습니다. 파일을 재구성하고 결합하여 보다 효율적으로 애플리케이션을 설치할 수도 있습니다.

    • 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위

      install_all_BLAs.jy 스크립트가 생성되어 백업 디렉토리에 위치합니다. 이 스크립트는 백업 디렉토리에 있는 모든 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위를 대상 프로파일로 마이그레이션할 수 있습니다. <WAS_PROFILE_ROOT>/bin 디렉토리에 있는 WASPostUpgradeBLAHelper.bat/.sh 스크립트는 install_all_BLAs.txt 파일의 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위를 마이그레이션하는 데 사용됩니다.

      문제점 방지 문제점 방지: 비즈니스 레벨 애플리케이션, 자산, 컴포지션 단위를 마이그레이션하려면 먼저 종속성을 작성해야 합니다. gotcha

WebSphere Application Server 시스템 애플리케이션은 이 매개변수에 설정된 값과 상관없이 마이그레이션합니다.

-keepDmgrEnabled
기존 WebSphere Application Server 버전 7.0 이상 배치 관리자를 사용 안함으로 설정할지 여부를 지정하는 데 사용되는 선택적 매개변수입니다. 기본값은 false입니다.

이 매개변수가 true로 지정된 경우 마이그레이션이 완료되는 동안 기존 버전 7.0 이상 배치 관리자를 사용할 수 있습니다. 이는 배치 관리자를 마이그레이션할 때에만 유효하며 다른 마이그레이션에서는 무시됩니다.

주의: 이 매개변수는 주의해서 사용하십시오.
  • 일반적으로 WebSphere Application Server 버전 7.0 이상 배치 관리자가 중지되어 사용 안함으로 설정되는 이유는 여러 배치 관리자가 동일한 노드를 관리하는 것을 방지하기 위해서입니다. 버전 9.0 배치 관리자를 사용하여 시작하기 전에 버전 7.0 이상 배치 관리자를 중지해야 합니다. 중지하지 않을 경우에 발생하는 가장 가능성이 높은 오류 조건은 배치 관리자의 두 번째 인스턴스를 시작할 때 발생하는 포트 충돌입니다.
  • 이 매개변수에 true를 지정하면 이는 마이그레이션 중 수행된 이전 구성의 모든 변경사항이 마이그레이션되지 않을 수 있음을 의미하는 것입니다.
-keepAppDirectory
모든 애플리케이션을 현재 위치한 동일한 디렉토리에 설치할지 여부를 지정하는 데 사용되는 선택적 매개변수입니다. 기본값은 false입니다.

이 매개변수를 true로 지정하면 각각의 개별 애플리케이션이 자신의 위치를 유지합니다.

이 매개변수를 지정하는 경우 -appInstallDirectory 매개변수를 지정할 수 없습니다.

제한사항: 이 매개변수를 true로 지정하면 기존 WebSphere Application Server 버전 7.0 이상 설치와 버전 9.0 설치 간에 위치가 공유됩니다. 이전 버전과 동일한 위치에 마이그레이션된 애플리케이션을 두는 경우 다음과 같은 제한사항이 적용됩니다.
  • WebSphere Application Server 버전 9.0 혼합 노드 지원 제한사항을 따라야 합니다. 이는 wsadmin 명령을 호출할 때 다음 지원을 사용할 수 없음을 의미합니다.
    • JSP 사전 컴파일
    • 2진 구성 사용
    • EJB 배치
  • 나중에 버전 7.0 이상 설치를 관리할 때 이 위치에서 애플리케이션을 삭제하는 경우 마이그레이션된 애플리케이션이 의도치 않게 유실될 위험이 있습니다.
-appInstallDirectory
마이그레이션 중 모든 애플리케이션을 설치할 때 사용할 디렉토리 이름을 전달하는 데 사용되는 선택적 매개변수입니다. 이 매개변수를 지정하지 않으면 profile_name\installedApps의 기본값이 사용됩니다.

이 매개변수를 지정하는 경우에는 -keepAppDirectory 매개변수를 지정할 수 없습니다.

이름에 하나 이상의 공백이 포함된 경우 디렉토리 이름을 따옴표로 묶어야 합니다.

이 매개변수를 사용하면 마이그레이션 도구는 백업 디렉토리(이전 릴리스에 대한 변수)와 대상 프로파일(새 릴리스의 변수) 모두의 마이그레이션 중인 노드에 대한 노드 레벨 변수를 조사합니다. 경로가 이 릴리스 중 하나에서 다음 변수의 일부일 경우 도구는 경로 정보를 축약하여 관련 변수를 사용합니다.
  • APP_INSTALL_ROOT
  • USER_INSTALL_ROOT
  • WAS_INSTALL_ROOT
축약이 발생할 때 도구가 사용자 지정 값을 변경했으며 축약된 값이 무엇인지 알리는 다음과 같은 경고 메시지가 수신됩니다.
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\.
-traceString
선택적 매개변수입니다. trace_spec 값은 수집하려는 추적 정보를 지정합니다.

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

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

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

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

-requestTimeout
선택적 매개변수입니다. seconds 값은 마이그레이션이 wsadmin 연결 시도에 실패하기 전에 대기할 시간(초)을 나타냅니다.

이 값은 애플리케이션 마이그레이션 중 제한시간 매개변수로도 사용됩니다.

-oldAdminAgentProfilePath
선택적 매개변수입니다. path to old admin agent 값은 원래 관리 에이전트의 프로파일 디렉토리에 대한 파일 시스템 경로를 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.

-oldAdminAgentSoapPort
선택적 매개변수입니다. soap port of old admin agent 값은 관리 연결을 위해 원래 관리 에이전트에 사용되는 SOAP 포트를 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.

-oldAdminAgentHostname
선택적 매개변수입니다. hostname of old admin agent 값은 원래 관리 에이전트의 호스트 이름 위치를 나타냅니다. 이 매개변수를 지정하지 않는 경우 값은 기본적으로 "localhost"로 설정됩니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.

-oldAdminAgentUsername
선택적 매개변수입니다. login username for old admin agent 값은 원래 관리 에이전트의 사용자 이름을 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 보안이 사용되는 관리 에이전트에서 관리되는 경우에만 필수입니다.

-newAdminAgentProfilePath
선택적 매개변수입니다. path to new admin agent 값은 새로 마이그레이션된 관리 에이전트에 대한 프로파일 디렉토리의 파일 시스템 경로를 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.

-newAdminAgentSoapPort
선택적 매개변수입니다. soap port of old admin agent 값은 관리 연결을 위해 새로 마이그레이션된 관리 에이전트에 사용되는 SOAP 포트를 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.

-newAdminAgentHostname
선택적 매개변수입니다. hostname of old admin agent 값은 새 관리 에이전트의 호스트 이름 위치를 나타냅니다. 이 매개변수를 지정하지 않는 경우 값은 기본적으로 "localhost"로 설정됩니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 에이전트에서 관리되는 경우에만 필수입니다.

-newAdminAgentUsername
선택적 매개변수입니다. login username for old admin agent 값은 새 관리 에이전트의 사용자 이름을 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 보안이 사용되는 관리 에이전트에서 관리되는 경우에만 필수입니다.

-newAdminAgentPassword
선택적 매개변수입니다. login password for old admin agent 값은 새 관리 에이전트의 사용자 이름을 나타냅니다.

이 매개변수는 마이그레이션 중인 애플리케이션 서버가 관리 보안이 사용되는 관리 에이전트에서 관리되는 경우에만 필수입니다.

-javaoption < -Xms...m > -javaoption < -Xmx...m >
선택적 매개변수입니다. WASPostUpgrade에 사용되는 Java 힙의 메모리 크기를 지정하려면 이 매개변수를 사용하십시오.

"-Xms...m" 값은 시작 힙 크기를 지정합니다. "..."를 필요한 메가바이트 크기로 바꾸십시오. 예를 들어, 시작 힙 크기가 128MB이면 매개변수를 -javaoption -Xms128m으로 지정하십시오.

"-Xmx...m"은 최대 힙 크기를 지정합니다. "..."를 필요한 메가바이트 크기로 바꾸십시오. 예를 들어, 최대 힙 크기가 1024MB이면 매개변수를 -javaoption -Xmx1024m으로 지정하십시오.

보안 고려사항

대상 시스템은 마이그레이션 전에 보안을 사용 안함으로 설정해야 합니다. 보안이 사용된 소스 구성으로부터 마이그레이션하는 경우 WASPostUpgrade 명령은 마이그레이션 중 버전 9.0 대상 구성의 보안을 자동으로 사용 가능하게 합니다.


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



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