sibDBUpgrade 명령
메시징 엔진은 기존 데이터베이스 관리 시스템(DBMS) 자원을 변경하기 위해 DDL(Data Definition Language)문을 필요로 합니다. DBMS 자원은 sibDBUpgrade 명령을 사용하여 변경할 수 있습니다.
sibDBUpgrade 명령은 메시지당 실패한 전달 수 유지 및 장기 실행 잠금 제한과 같은
새 기능에 대한 테이블을 수정하는 데 필요합니다. sibDBUpgrade 명령은
메시징 엔진을 WebSphere® Application Server의 이전 버전에서 버전 9.0으로 마이그레이션하는 데
사용할 수 있습니다.
구문
Unix의 명령행 구문은
다음과 같습니다.
>>-sibDBUpgrade.sh--+-----------------------------+-------------> '- -runUpgrade--true 또는 false-' >--+-------------------------+--+---------------------------+---> '- -dbUser--데이터베이스 사용자 이름-' '- -dbSchema--데이터베이스 스키마 이름-' >--+-------------------------+--+---------------------+---------> '- -dbType--database type-' '- -serverName--서버 이름-' >--+-------------------------+--+---------------------------+---> '- -dbName--database name-' '- -dbPassword--데이터베이스 비밀번호-' >--+------------------------+--+---------------------------+----> '- -dbNode--데이터베이스 노드 이름-' '- -oracleHome--Oracle 홈 경로-' >--+-------------------------------+----------------------------> '- -scriptDir--script directory-' >--+-----------------------+--+-----------------------+-------->< '- -permanent--영구 테이블 수-' '- -temporary--임시 테이블 수-'
Windows의 명령행 구문은
다음과 같습니다.
>>-sibDBUpgrade.bat--+-----------------------------+------------> '- -runUpgrade--true 또는 false-' >--+-------------------------+--+---------------------------+---> '- -dbUser--데이터베이스 사용자 이름-' '- -dbSchema--데이터베이스 스키마 이름-' >--+-------------------------+--+---------------------+---------> '- -dbType--database type-' '- -serverName--서버 이름-' >--+-------------------------+--+---------------------------+---> '- -dbName--database name-' '- -dbPassword--데이터베이스 비밀번호-' >--+------------------------+--+---------------------------+----> '- -dbNode--데이터베이스 노드 이름-' '- -oracleHome--Oracle 홈 경로-' >--+-------------------------------+----------------------------> '- -scriptDir--script directory-' >--+-----------------------+--+-----------------------+-------->< '- -permanent--영구 테이블 수-' '- -temporary--임시 테이블 수-'
목적
데이터베이스 관리자는 메시징 엔진의 DBMS 자원을 변경하기 위해 sibDBUpgrade 유틸리티 명령을 사용할 수 있습니다. sibDBUpgrade 명령은 데이터베이스 관리자가 저장한 후 나중에 변경된 데이터베이스 테이블에 나열된 DBMS 자원을 변경하기 위해 처리할 수 있는 DDL문을 생성합니다. 데이터베이스 관리자 외에, 데이터베이스 테이블을 변경할 권한이 있는 사용자도 데이터베이스 테이블을 변경하기 위한 유틸리티를 사용할 수 있습니다.
IBM® i
명령행에 액세스하려면 STRQSH 명령을 사용하여
Qshell 세션을 시작하십시오.
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
필수 매개변수
팁: sibDBUpgrade
명령은 대소문자를 구분합니다. 예를 들어
Oracle 매개변수 값은
oracle
매개변수 값과 같지 않습니다.
- -runUpgrade true 또는 false [z/OS, Derby, Informix의 경우 값이 false여야 함]
- 데이터베이스 자원을 변경하는 명령. 데이터베이스 자원을 변경하려면 매개변수 값을 true로 지정하고 DDL 스크립트만 생성하려면 false로 지정하십시오.
- -dbUser
- DBMS와 상호 작용하는 데 사용되는 사용자 ID의 이름.
- -dbSchema
- 메시징 엔진에서 사용하는 모든 오브젝트를 포함하는 스키마의 이름.
- -dbType
- DBMS의 유형을 식별합니다. 올바른 값은 다음과 같습니다.
- DB2
- Oracle
- SqlServer
- Sybase
- Informix
- Derby
참고: zos 및 iseries 플랫폼의 DB2가 지원됩니다.
선택적 매개변수
- -dbName
- 메시징 엔진 테이블에 할당되는 데이터베이스의 이름. -dbName 매개변수는 runUpgrade 매개변수의 값이 true로 지정된 경우에 필요합니다.
- -serverName
- DBMS와 상호작용하는 데 사용되는 서버의 이름. -serverName 매개변수를 제공하지 않을 경우 기본값은 IBMUSER입니다.
- -dbPassword
- DBMS와 상호작용하는 데 사용되는 사용자 ID의 비밀번호.
- -dbNode
- 데이터베이스 노드의 이름. 이 선택적 매개변수는 DB2에만 적용 가능합니다. -runUpgrade 옵션과 함께 스크립트가 실행 중인 시스템에는 DB2 Client만 설치되어 있어야 합니다.
- -oracleHome
- -dbType 매개변수 값이 Oracle인 경우 Oracle 홈 디렉토리의 경로.
- -scriptDir
- DDL 스크립트를 생성해야 하는 디렉토리의 이름. 디렉토리를 지정하지 않은 경우, current_directory가 활성 디렉토리인 <current_directory>/SIBusUpgradeDatabase 디렉토리로 스크립트가 생성됩니다.
- -permanent
- 서비스 통합 메시징 엔진이 작성될 때 작성되는 영구 테이블의 수. 구성된 테이블 수에 대한 자세한 정보는 데이터 저장소 [Settings] 내용을 참조하십시오. 영구 테이블은 기본적으로 하나입니다. 메시징 엔진이 여러 영구 테이블을 사용하도록 구성되어 있으면 테이블 수를 지정하십시오.
- -temporary
- 서비스 통합 메시징 엔진이 작성될 때 작성되는 임시 테이블의 수. 구성된 테이블 수에 대한 자세한 정보는 데이터 저장소 [Settings] 내용을 참조하십시오. 임시 테이블은 기본적으로 하나입니다. 메시징 엔진이 여러 임시 테이블을 사용하도록 구성되어 있으면 테이블 수를 지정하십시오.
예제
서비스 통합 버스의 데이터베이스
스키마를 WebSphere Application Server의 이전 버전에서
버전 9.0으로 업그레이드합니다.
- sibDBUpgrade.sh -runUpgrade false -dbUser db2inst1 -dbSchema SIBusMESchema -dbType DB2
- sibDBUpgrade.sh -runUpgrade true -dbName SIBus -dbUser db2inst1 -dbSchema SIBusMESchema -dbType DB2
서비스 통합 버스의
데이터베이스 스키마를 WebSphere Application Server의 이전 버전에서 버전 9.0으로 업그레이드합니다.
- sibDBUpgrade.bat runUpgrade=false dbUser=db2inst1 dbSchema=SIBusMESchema dbType=DB2
- sibDBUpgrade.bat runUpgrade=true dbName=SIBus dbUser=db2inst1 dbSchema=SIBusMESchema dbType=DB2