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


WBIPreUpgrade 명령행 유틸리티

WebSphere® ESB에 대해 WBIPreUpgrade 명령을 사용하여 이전에 설치된 WebSphere ESB 버전의 구성을 이주 특정 백업 디렉토리에 저장합니다.

세부사항

WBIPreUpgrade 명령은 install_rootprofile_root 디렉토리에서 선택한 파일을 지정한 백업 디렉토리에 저장합니다. profile_root의 기본값은 profiles/profile_name입니다. 복사된 파일은 다양한 서브디렉토리에 있게 되며 WBIPreUpgrade 명령으로 지정한 백업 디렉토리로 모두 복사됩니다. 또한 logs 하위 디렉토리가 작성되고 여기에는 실행 중인 WBIPreUpgrade 명령의 현재 인스턴스에 해당하는 새 로그 파일이 포함됩니다.

이주 원본의 버전에 따라 WBIPreUpgrade 명령은 WebSphere Enterprise Service Bus의 기존 프로파일을 한꺼번에 또는 한 번에 하나씩 백업합니다.
  • 버전 6.0.2.x에서 이주하는 경우 WBIPreUpgrade 명령은 WebSphere Enterprise Service Bus의 기존 프로파일을 한 번에 백업합니다.
  • 버전 6.1.x에서 이주하는 경우 WBIPreUpgrade 명령은 -profileName 매개변수로 식별한 기존 프로파일을 한 번에 하나씩만 백업합니다.

제한사항

  • 버전 6.1.x에서 이주하는 경우에는 WBIPreUpgrade 명령은 WebSphere Application Server Network Deployment, 버전 6.1 backupConfig 유틸리티에서 다음 제한사항을 상속합니다.
    • 기본적으로 노드의 모든 서버는 백업이 수행되기 전에 중지하여 부분적으로 동기화된 정보가 저장되지 않습니다.
    • 이주를 수행하려면 루트 권한이 있어야 합니다.
    • UNIX® 또는 Linux® 환경에서 backupConfig 명령은 파일 권한이나 소유권 정보를 저장하지 않습니다.
    • 파일을 복원할 때 restoreConfig 명령은 현재 Umask와 유효한 사용자 ID(EUID)를 사용하여 권한과 소유권을 설정합니다.
    • 이주를 시작하기 전에 소스 Deployment Manager를 중지해야 합니다. 소스 Deployment Manager를 중지하지 않으면 WBIPreUpgrade 명령이 자동으로 중지됩니다.
  • For i5/OS operating system i5/OS 플랫폼에서 이주하는 경우 대상 프로파일 이름은 이주할 소스 프로파일의 프로파일 이름과 일치해야 합니다.
  • For i5/OS operating system i5/OS 플랫폼에서 이주하는 경우 backUpConfig는 개인 권한을 소스 프로파일에서 구성한 파일 및 디렉토리에 저장하지 않습니다. 그러므로 소스 프로파일 구성 트리 아래의 파일 및 디렉토리에 있는 개인 권한을 적어두었다가 WBIPostUpgrade 명령을 실행하고 프로파일 이주를 완료한 후 대상 프로파일에 수동으로 이러한 개인 권한을 복원해야 합니다.

위치

명령 파일은 install_dir/bin 디렉토리에 있어야 하며 이 디렉토리에서 실행해야 합니다.

권한

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

구문

구문은 다음과 같습니다.

For i5/OS operating system
WBIPreUpgrade backupDirectory 
                currentProfileDirectory
                [-username userID]
                [-password password]
                [-traceString trace_spec [-traceFile file_name]]
주: 버전 6.0.2.x에서 버전 6.2로 이주하는 경우, -profileName 매개변수는 지원되지 않습니다.
For Linux operating systemFor UNIX operating system
WBIPreUpgrade.sh backupDirectory 
                currentWebSphereDirectory
                [-profileName profile_name]
                [-username userID]
                [-password password]
                [-traceString trace_spec [-traceFile file_name]]
For Windows operating system
WBIPreUpgrade.bat backupDirectory 
                currentWebSphereDirectory
                [-profileName profile_name]
                [-username userID]
                [-password password]
                [-traceString trace_spec [-traceFile file_name]]

매개변수

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

backupDirectory
이 매개변수는 필수이며 지정하는 첫 번째 매개변수여야 합니다. backupDirectory 값은 명령 스크립트가 WBIPreUpgrade 및 WBIPostUpgrade 중에 작성된 로그 및 저장된 구성을 저장하는 디렉토리 이름을 지정합니다.

이 디렉토리는 WBIPostUpgrade 명령이 구성을 읽는 디렉토리이기도 합니다.

디렉토리가 없는 경우 WBIPreUpgrade 명령 스크립트가 작성합니다.

currentWebSphereDirectory
이 매개변수는 필수이며 지정하는 두 번째 매개변수여야 합니다. 이 매개변수는 이주가 지원하는 WebSphere ESB의 모든 에디션이 가능합니다.
For i5/OS operating system currentWebSphereDirectory 값은 이주하려는 기존 WebSphere ESB 프로파일의 프로파일 루트 디렉토리 이름을 지정합니다. i5/OS에서 이 디렉토리 경로의 형식은 user_data_root/profiles/profile_name입니다. 여기서, profile_name은 프로파일의 이름이며 user_data_rootWebSphere ESB의 기본 사용자 데이터 디렉토리입니다( /QIBM/UserData/WebSphere/ESB). profiles 및 profileRegistry 하위 디렉토리는 제품을 설치할 때 이 디렉토리 아래에 작성됩니다.
주: i5/OS 플랫폼버전 6.1.x에서 버전 6.2로 이주하는 경우에만 지원됩니다.

For UNIX operating systemFor Linux operating systemFor Windows operating system currentWebSphereDirectory 값은 기존 WebSphere ESB 설치의 설치 루트 디렉토리 이름을 지정합니다.

다음 디렉토리는 WebSphere ESB 버전 6.1.x의 기본 디렉토리입니다. 기본이 아닌 다른 경로가 설치에 사용되었습니다.
  • 이전 설치에서 WebSphere Application Server와 WebSphere ESB가 동일한 설치 프로세스 중에 함께 설치된 경우: /QIBM/UserData/WebSphere/ProcServer/profiles/profile_name
  • 이전 설치에서 WebSphere Application Server가 이미 설치되어 있는 상태에 WebSphere ESB를 설치한 경우: /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/profile_name
-password
이 선택적 매개변수는 관리 보안이 WebSphere ESB의 이전 버전에서 구성된 경우에만 필요합니다. password 값은 현재 WebSphere ESB(이주 이전) 설치의 관리 사용자 이름의 암호를 지정합니다.
-profileName
For UNIX operating systemFor Linux operating systemFor Windows operating system
주: 이 매개변수는 i5/OS 플랫폼에서 지원되지 않습니다. 사용하면 invalid parameter 예외로 처리됩니다.
이 매개변수는 특정 프로파일에서 이주하는 선택적 매개변수입니다. profile_name 값은 스크립트가 구성을 이주한 WebSphere ESB의 이전 버전에서 작성된 프로파일 이름을 지정합니다.

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

주: 올바른 프로파일이 이주되었는지 확인하려면 이 매개변수를 사용하여 프로파일 이름을 지정하고 기본값을 사용하지 마십시오.
-traceFile
주: 이 매개변수는 WebSphere ESB 버전 6.1.x에서 버전 6.2로의 이주에서는 무시됩니다.
선택적 매개변수입니다. file_name 값은 추적 정보의 출력 파일 이름을 지정합니다.
중요사항: 이 매개변수를 지정하는 경우, -traceString 매개변수도 지정해야 합니다. -traceFile 매개변수를 지정하지만 -traceString 매개변수를 지정하지 않은 경우 명령은 기본 추적 경로를 사용하고 지정한 위치에 추적 파일을 저장합니다.
-traceString
주: 이 매개변수는 WebSphere ESB 버전 6.1.x에서 버전 6.2로의 이주에서는 무시됩니다.
선택적 매개변수입니다. trace_spec 값은 수집하려는 추적 정보를 지정합니다.

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

중요사항: 이 매개변수를 지정하는 경우에는 -traceFile 매개변수도 지정해야 합니다. -traceString 매개변수는 지정하지만 -traceFile 매개변수는 지정하지 않는 경우 명령은 기본적으로 추적 파일을 작성하여 backupDirectory/logs 디렉토리에 배치합니다.
-username
이 선택적 매개변수는 관리 보안이 WebSphere ESB의 이전 버전에서 구성된 경우에만 필요합니다. userID 값은 현재 WebSphere ESB(이주 이전) 설치의 관리 사용자 이름을 지정합니다.

로깅

WBIPreUpgrade 명령은 실행 중에 화면에 상태를 표시합니다. 이 명령은 더 확장된 세트의 로깅 정보를 WBIPreUpgrade.timestamp.log 파일에 작성하여 backupDirectory/logs 디렉토리에 저장하며 여기서, backupDirectory는 backupDirectory 매개변수에 지정한 값입니다. 문서 편집기로 WBIPreUpgrade.profileName.timestamp.log 파일을 볼 수 있습니다.


reference 참조 주제

이용약관 | 피드백


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


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