WebSphere® ESB에 대해
WBIPreUpgrade 명령을 사용하여 이전에 설치된
WebSphere ESB 버전의 구성을 이주 특정
백업 디렉토리에 저장합니다.
세부사항
WBIPreUpgrade 명령은
install_root 및 profile_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 명령이
자동으로 중지됩니다.
i5/OS 플랫폼에서 이주하는 경우 대상 프로파일 이름은
이주할 소스 프로파일의 프로파일 이름과 일치해야 합니다.
i5/OS 플랫폼에서 이주하는 경우 backUpConfig는 개인 권한을
소스 프로파일에서 구성한 파일 및 디렉토리에 저장하지 않습니다. 그러므로 소스 프로파일 구성 트리 아래의
파일 및 디렉토리에 있는 개인 권한을 적어두었다가 WBIPostUpgrade 명령을 실행하고
프로파일 이주를 완료한 후 대상 프로파일에 수동으로 이러한 개인 권한을 복원해야 합니다.
위치
명령 파일은 install_dir/bin
디렉토리에 있어야 하며 이 디렉토리에서 실행해야 합니다.
권한
이 명령 스크립트를 실행하려면
사용자 프로파일에 *ALLOBJ 권한이 있어야 합니다.
매개변수
매개변수는 다음과 같습니다.
- backupDirectory
- 이 매개변수는 필수이며 지정하는 첫 번째 매개변수여야 합니다. backupDirectory 값은
명령 스크립트가 WBIPreUpgrade 및 WBIPostUpgrade 중에 작성된 로그 및 저장된 구성을 저장하는
디렉토리 이름을 지정합니다.
이 디렉토리는 WBIPostUpgrade 명령이
구성을 읽는 디렉토리이기도 합니다.
디렉토리가 없는 경우
WBIPreUpgrade 명령 스크립트가 작성합니다.
- currentWebSphereDirectory
- 이 매개변수는 필수이며 지정하는 두 번째 매개변수여야 합니다. 이 매개변수는 이주가
지원하는 WebSphere ESB의 모든 에디션이
가능합니다.
currentWebSphereDirectory 값은
이주하려는 기존
WebSphere ESB 프로파일의 프로파일 루트 디렉토리 이름을
지정합니다.
i5/OS에서 이 디렉토리 경로의 형식은
user_data_root/profiles/profile_name입니다. 여기서,
profile_name은 프로파일의 이름이며
user_data_root는
WebSphere ESB의 기본 사용자
데이터 디렉토리입니다(
/QIBM/UserData/WebSphere/ESB). profiles 및 profileRegistry 하위 디렉토리는 제품을
설치할 때 이 디렉토리 아래에 작성됩니다.
주: i5/OS 플랫폼은
버전 6.1.x에서
버전 6.2로 이주하는
경우에만 지원됩니다.


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


주: 이 매개변수는
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 파일을
볼 수 있습니다.