WebSphere Enterprise Service Bus, 버전 6.2.0 운영 체제: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


WBIPostUpgrade 명령행 유틸리티

지정한 backupDirectory에서 WBIPreUpgrade 명령으로 저장한 프로파일 구성을 검색하기 위해 WebSphere® ESB에 대해 WBIPostUpgrade 명령을 사용하십시오.

For i5/OS operating system 중요사항: i5/OS버전 6.1.x에서 버전 6.2로 이주하는 경우에만 지원됩니다.
주: i5/OS® 플랫폼에서 이주하는 경우 대상 프로파일 이름은 이주하는 소스 프로파일의 프로파일 이름과 일치해야 합니다.

세부사항

WebSphere ESB에 대한 WBIPostUpgrade 스크립트는 backupDirectory에서 구성을 읽어 WebSphere ESB 버전 6.2로 이주하고 WebSphere ESB의 새 설치를 위해 이주된 모든 응용프로그램을 profile_root/installedApps 디렉토리에 추가합니다.

위치

명령은 install_root/bin 디렉토리에 있으며 이 디렉토리에서 실행해야 합니다.

구문

구문은 다음과 같습니다.

For i5/OS operating system
WBIPostUpgrade backupDirectory
                     [-username userID]
                     [-password password]
                     [-scriptCompatibility true | false]
                     [-portBlock port_starting_number]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepDmgrEnabled true | false]
                     [-keepAppDirectory true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]                     [-createTargetProfile]	
주: -profileName 매개변수는 i5/OS 플랫폼에서는 지원되지 않습니다. 사용하게 되면 유효하지 않은 매개변수로 처리됩니다.

For Linux operating systemFor UNIX operating system
WBIPostUpgrade.sh backupDirectory
                     [-username userID]
                     [-password password]
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-scriptCompatibility true | false]
                     [-portBlock port_starting_number]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]                     [-createTargetProfile]

For Windows operating system
WBIPostUpgrade.bat backupDirectory
                     [-username userID]
                     [-password password]
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-scriptCompatibility true | false]
                     [-portBlock port_starting_number]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]                     [-createTargetProfile]
주: -oldProfile 매개변수는 -profileName(새 프로파일) 매개변수 앞에 와야 합니다.

매개변수

매개변수는 다음과 같습니다.

backupDirectory
이 매개변수는 필수입니다. backupDirectory 값은 WBIPreUpgrade 도구가 저장된 구성 및 파일을 저장하고 WBIPostUpgrade 도구가 구성 및 파일을 읽는 백업 디렉토리 경로를 지정합니다.
-username
이 선택적 매개변수는 관리 보안이 WebSphere ESB의 이전 버전에서 구성된 경우에만 필요합니다. userID 값은 현재 WebSphere ESB(이주 이전) 설치의 관리 사용자 이름을 지정합니다.
-password
이 선택적 매개변수는 관리 보안이 WebSphere ESB의 이전 버전에서 구성된 경우에만 필요합니다. password 값은 현재 WebSphere ESB(이주 이전) 설치의 관리 사용자 이름의 암호를 지정합니다.
-oldProfile
제한사항: i5/OS 플랫폼에서는 이 매개변수를 사용할 수 없습니다.
이 매개변수는 이전 버전에서 인스턴스나 프로파일을 이주하는 선택적 매개변수입니다. 이 명령을 실행하기 전에 인스턴스나 프로파일이 이주 백업 디렉토리에 있어야 합니다.

-oldProfile 매개변수를 지정하지 않으면 기본 프로파일이 사용됩니다. 기본 프로파일이 없는 경우에는 시스템에서 오류를 보고합니다.

-profileName
For UNIX operating systemFor Linux operating systemFor Windows operating system
주: i5/OS 플랫폼에서는 이 매개변수가 지원되지 않습니다. 사용하면 invalid parameter 예외로 처리됩니다.
이 매개변수는 특정 프로파일을 이주하는 선택적 매개변수입니다. profile_name 값은 스크립트가 구성을 이주하는 WebSphere ESB의 가장 최신 버전에서 이미 작성된 프로파일 이름을 지정합니다. WBIPostUpgrade 명령을 호출하기 전에 이 프로파일을 작성해야 합니다.

-profileName 매개변수를 지정하지 않으면 기본 프로파일이 사용됩니다. 기본 프로파일이 없는 경우에는 시스템에서 오류를 보고합니다.

주: 올바른 프로파일이 이주되었는지 확인하려면 이 매개변수를 사용하여 프로파일 이름을 지정하고 기본값을 사용하지 마십시오.
-scriptCompatibility
주: WebSphere ESB 버전 6.1.x에서 버전 6.2로의 이주에서는 이 매개변수가 무시됩니다.
이 매개변수는 이주 시 다음 버전 6.0.2.x 구성 정의를 작성해야 하는지 여부를 지정하는 데 사용하는 선택적 매개변수입니다.
  • Transport
  • ProcessDef
  • SSL for 6.0.2
다음 버전 6.2 구성 정의 대신 작성해야 하는지 여부를 지정합니다.
  • Channels
  • ProcessDefs
  • SSL for 버전 6.2

기본값은 true입니다.

기존 관리 스크립트의 영향을 최소화하려면 이 매개변수에 true를 지정하십시오. 예를 들어, 버전 6.0.2.x 구성 정의를 작성하거나 수정하는 데 써드파티의 구성 API를 사용하는 기존의 wsadmin 스크립트 또는 프로그램이 있는 경우에는 이주 중에 이 옵션을 true로 지정합니다.

주: 환경의 모든 노드가 버전 6.2 레벨이 될 때까지 임시입니다. 모두 새 레벨이 되면 다음 조치를 수행해야 합니다.
  1. 전체 버전 6.2 설정을 사용하도록 관리 스크립트를 수정하십시오.
  2. convertScriptCompatability 명령을 실행하여 모든 버전 6.2 설정에 일치하도록 구성을 변환하십시오.

    자세한 정보는 convertScriptCompatibility 명령을 참조하십시오.

-portBlock
선택적 매개변수입니다. port_starting_number 값은 명령 스크립트가 실행될 때 지정되는 연결 포트 번호의 첫 번째 블록을 지정합니다.
-replacePorts
이 선택적 매개변수를 사용하여 가상 호스트 및 웹 컨테이너 전송 포트에 대한 포트 값을 맵핑하는 방법을 지정합니다.
  • False
    이주 중에 버전 6.0.x 또는 6.1.x 포트 정의를 바꾸지 마십시오.
    • 이전 버전 구성이 단독으로 사용되며 채널이 삭제되지 않습니다.
    • 다음 네 개의 이름 지정된 채널이 이전 릴리스에 설정된 값과 동등한 값으로 설정됩니다.
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • 이주 프로세스는 이전 릴리스의 모든 포트에 -scriptCompatibility 설정값을 사용하여 전송 또는 채널을 작성합니다.
    • 이주 프로세스는 모든 웹 컨테이너 이외의 포트를 이전 릴리스에 설정된 값으로 설정합니다.
    • 이주 프로세스에서 웹 컨테이너에서 정의된 것과 동일한 전송이나 채널을 작성하게 되면 포트 충돌이 발생합니다.

    이는 기본값입니다.

  • True

    버전 6.2 포트 정의로 이주 중에 모든 가상 호스트 별명 포트 설정을 바꿉니다.

    기본적으로 이주 프로세스는 이전 환경의 구성 데이터를 새 WebSphere ESB 환경의 데이터로 추가합니다. 그러나 일부 경우에 이런 포트 값으로 적합하지 않을 수도 있습니다. 예를 들어, 이전 릴리스의 기존 포트 정의는 다른 제품과의 포트 충돌을 방지하기 위해 설정되었습니다. 이런 경우 이 설정값을 새 버전의 구성으로 이주하려고 할 수 있습니다. 이 매개변수에 true를 지정하여 값을 새로 추가하기 전에 새 버전의 구성에서 일치하는 가상 호스트의 모든 포트를 제거하십시오.
    • 웹 컨테이너와 연관된 모든 전송 채널은 다음의 이름 지정된 네 개의 채널을 제외하고 삭제됩니다. 이 채널은 이전 릴리스에 설정된 값과 동등한 값으로 설정되어 있습니다.
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • 이주 프로세스는 이전 릴리스의 모든 포트에 -scriptCompatibility 설정값을 사용하여 전송 또는 채널을 작성합니다.
    • 이주 프로세스는 모든 웹 컨테이너 이외의 포트를 이전 릴리스에 설정된 값으로 설정합니다.
-keepAppDirectory
주: 이 매개변수는 WebSphere ESB 버전 6.1에서 버전 6.2 이주에서는 무시됩니다.
이 선택적 매개변수를 사용하여 모든 응용프로그램을 현재 설치된 동일한 디렉토리에 설치하는지 여부를 지정합니다. 기본값은 false입니다.

이 매개변수를 true로 지정하면 각 응용프로그램이 해당 위치에 유지됩니다.

제한사항: 이 매개변수를 true로 지정하면 기존 WebSphere ESB와 새 설치가 위치를 공유합니다. 이전 버전과 동일한 위치에 이주된 응용프로그램을 유지하는 경우에 다음과 같은 제한사항이 적용됩니다.
  • 버전 6.2 혼합 노드 지원 제한을 준수해야 합니다. 즉, wsadmin 명령을 호출할 때 다음 지원을 사용할 수 없습니다.
    • 사전 컴파일된 JSP
    • 2진 구성 사용
    • EJB 전개
  • 이전의 기존 설치를 관리할 때(예: 설치 제거) 이 위치에서 응용프로그램을 삭제하게 되면 이주된 응용프로그램을 실수로 제거할 수도 있습니다.
-keepDmgrEnabled
주: 이 매개변수는 WebSphere ESB 버전 6.1에서 버전 6.2 이주에서는 무시됩니다.
이 선택적 매개변수를 사용하여 기존의 WebSphere ESB Deployment Manager를 사용하지 않도록 지정할 수도 있습니다. 기본값은 false입니다.

이 매개변수를 true로 지정하면 이주가 완료되는 동안 기존 Deployment Manager를 사용할 수 있습니다. 이는 Deployment Manager를 이주하는 경우에만 유효하며 다른 이주 모두에서는 무시됩니다.

주의: 이 매개변수는 주의하여 사용하십시오.
  • 이는 동일한 노드를 여러 Deployment Manager가 관리하는 것을 방지하기 위해 기존 WebSphere ESB Deployment Manager 구성은 일반적으로 중지되어 사용 불가능하기 때문입니다. 새 버전의 Deployment Manager를 사용하기 전에 기존 Deployment Manager를 중지해야 합니다. 이를 완료하지 않는 경우에 가장 발생하기 쉬운 오류는 두 번째 Deployment Manager 인스턴스가 시작될 때 발생하는 포트 충돌입니다.
  • 이 매개변수에 true를 지정하면 이주 중에 이전 구성에 대한 모든 구성 변경이 이주되지 않습니다.
-appInstallDirectory
주: 이 매개변수는 WebSphere ESB 버전 6.1에서 버전 6.2 이주에서는 무시됩니다.
이 선택적 매개변수를 사용하여 이주 중에 모든 응용프로그램을 설치할 때 사용되는 디렉토리 이름을 전달하십시오. 매개변수를 지정하지 않으면 profile_name\installedApps의 기본값이 사용됩니다.

이름에 하나 이상의 공백이 있는 경우에는 디렉토리 이름에 따옴표를 사용해야 합니다.

팁: 인수에 ${USER_INSTALL_ROOT} 변수를 포함시킬 수도 있습니다. 이 변수는 <WPS HOME>\profiles\<profile name>으로 확장합니다. 예를 들어, WebSphere ESB, 버전 6.2C:\wps\에 설치되고 대상 프로파일이 ProcSrv01인 경우 ${USER_INSTALL_ROOT}C:\wps62\profiles\ProcSrv01을 나타냅니다.
-traceString
주: 이 매개변수는 WebSphere ESB 버전 6.0.2.x에서 버전 6.2로의 이주에서는 무시됩니다.
선택적 매개변수입니다. trace_spec 값은 수집하려는 추적 정보를 지정합니다.

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

중요사항: 이 매개변수를 지정하는 경우에는 -traceFile 매개변수도 지정해야 합니다. -traceString 매개변수는 지정하지만 -traceFile 매개변수는 지정하지 않는 경우 명령은 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 배치합니다.
-traceFile
주: 이 매개변수는 WebSphere ESB 버전 6.0.2.x에서 버전 6.2로의 이주에서는 무시됩니다.
선택적 매개변수입니다. file_name 값은 추적 정보의 출력 파일 이름을 지정합니다.
중요사항: 이 매개변수를 지정하는 경우, -traceString 매개변수도 지정해야 합니다. -traceFile 매개변수를 지정하지만 -traceString 매개변수를 지정하지 않은 경우 명령은 기본 추적 경로를 사용하고 지정한 위치에 추적 파일을 저장합니다.
-createTargetProfile

이 선택적 매개변수는 이주를 위해 올바른 구성 설정값을 사용하여 새 프로파일을 작성합니다.

로깅

WBIPostUpgrade 명령은 실행 중에 화면에 상태를 표시합니다. 이 명령은 더 확장된 세트의 로깅 정보를 backupDirectory/logs 디렉토리에 WBIPostUpgrade.timestamp.log 파일로 저장합니다. 문서 편집기를 사용하여 WBIPostUpgrade.profileNametimestamp.log 파일을 볼 수 있습니다.


reference 참조 주제

이용약관 | 피드백


시간소인 아이콘 마지막 갱신 날짜: 2010년 7월 7일 수요일


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_wbipostupgrade.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
이 Information Center는 Eclipse 기술을 기반으로 합니다(http://www.eclipse.org 웹 사이트 참조).