사용자 정의 확장을 현재 버전 및 이전 버전의 브로커에 설치

시작하기 전에

  1. Java 사용자 정의 노드 컴파일 또는 C 사용자 정의 확장 구성요소 컴파일에서 설명하는 대로 사용자 정의 노드를 컴파일해야 합니다.
  2. 사용자 정의 노드 테스트에서 설명한 대로 사용자 정의 노드를 테스트해야 합니다.

이 주제는 사용자의 개입을 최소화한 상태에서 WebSphere Message Broker에 설치하기를 원하는 Third-Party 사용자를 위한 것입니다.

사용자 정의 확장을 설치하려면, 확장을 런타임과 툴킷에 설치해야 합니다. 구성요소는 별도로 설치하거나 한 프로세스의 일부로 설치할 수 있습니다. 구성요소는 다른 시스템에 있어도 되기 때문에, 일반 사용자가 영향을 받는 모든 시스템에서 설치를 실행하는지 확인하십시오.

툴킷 설치

특정 버전의 툴킷이 사용자 정의 확장의 필수조건이거나 특정 파일을 필요로 할 수 있기 때문에, 확장을 설치하기 전에 툴킷의 버전을 확인하십시오.

툴킷 버전을 판별하려면 설치된 WebSphere Message Broker 버전 감지를 참조하십시오.

제품이 다른 제품과 쉘을 공유하다면 설치 경로는 먼저 설치된 RAD 프로그램의 설치 경로입니다. 다음 단계를 사용하여 툴킷의 위치를 확인하십시오.

툴킷의 설치 위치를 확인하려면 RAD에 의해 설정된 cdi_ref.properties 파일을 살펴보십시오. 이 파일은 Message Brokers Toolkit 및 Rational 버전 6.x 제품에 의해 설치됩니다. 이 제품 중 하나가 최초에 설치될 때 파일이 생성됩니다. 모든 후속 설치에 의해 공유됩니다. Message Brokers Toolkit 및 Rational 버전 6.x 제품이 설치되어 있지 않다면 마지막 제품의 설치를 제거할 때 파일이 제거됩니다.

  1. Installshield Multiplatform Edition을 사용하여 위치를 확인하는 경우 위치는 $D(os_main)/IBM/RAT60/.sdpinst/cdi_ref.properties입니다.

    이 예에서 $D(os_main)은 CDI 설치 프레임워크가 빌드되는 Installshield 변수입니다.

  2. Installshield Multiplatform Edition를 사용하지 않는 경우
    1. 위치는 /etc/IBM/RAT60/.sdpinst/cdi_ref.properties입니다.
    2. 다음과 같은 순서로 두 위치에서 파일을 찾아보십시오.
      1. %windir%/IBM/RAT60/.sdpinst/cdi_ref.properties
      2. %SystemRoot%/IBM/RAT60/.sdpinst/cdi_ref.properties
  3. cdi_ref.properties 파일을 사용하여 Message Brokers Toolkit 설치가 존재하는지 살펴보고, c_wmbt_specific.products=wmbt를 찾아보십시오.

    위치에 대해서는 c_wmbt_specifc.b_wmbt_specific.location 변수를 살펴보십시오.

    예: C:\Program Files\IBM\MessageBrokersToolkit\6.0

    예: /opt/ibm/MessageBrokerToolkit/6.0

    Workbench의 위치는 c_wb.b_wb.location 변수를 살펴보십시오.

    예: C:\Program Files\IBM\MessageBrokersToolkit\6.0

    예: /opt/ibm/MessageBrokerToolkit/6.0

c_wb.b_wb.location의 값은 c_wmbt_specifc.b_wmbt_specific.location의 값과 다를 수 있습니다. WebSphere Message Broker 이전에 다른 RAD가 설치된 경우 이러한 상황이 발생할 수 있습니다.

cdi_ref.properties가 없으면 설치된 Rational 제품이 없으며, Message Brokers Toolkit이 설치되어 있지 않습니다.

아이콘 및 새로운 사용자 정의 노드를 위한 옵션과 함께 Message Brokers Toolkit을 설정하려면 Eclipse 플러그인 파일이 포함된 디렉토리를 가리키는 새 Eclipse 링크 파일을 설정해야 합니다. 링크 파일에는 대상 디렉토리의 전체 경로를 가리키는 한 행이 있어야 합니다. 작성된 Eclipse 링크 파일은 <c.wb.b_wb.location>/eclipse/links/에 저장하십시오. 예를 들면, 다음과 같습니다.

opt/ibm/MessageBrokerToolkit/6.0/Myextension 파일에 path=/opt/My/Extension/Nodes 행이 포함될 수 있습니다. 위의 행이 가리키는 디렉토리에는 사용자 정의 확장 분배의 지시사항을 사용하여 어셈블한 플러그인 단편이 포함되어 있어야 합니다.

확장 설치를 완료한 다음에는 -clean 옵션을 사용하여 대상 Workbench를 재시작하십시오. 메뉴 바로 가기를 수정하여 명령행에서 이를 수행할 수 있습니다. 사용자 정의 확장을 변경할 때마다 -clean 옵션을 사용하여 메시지 플로우 노드 팔레트가 변경사항을 적용하도록 하십시오. Workbench가 재시작되면, 노드의 새 범주가 플로우 편집기의 색상표에 표시됩니다.

런타임 설치

설치되는 런타임의 버전을 확인하고, 올바른 레벨의 브로커가 올바른 .lil 파일을 로드하는지 확인할 필요가 있습니다. 설치된 WebSphere Message Broker 버전 감지를 참조하십시오.

WebSphere Business Integration Message Broker 버전 5.0 또는 나중에 변경 시작에서 런타임 파일에 .jar 또는 .lil 파일을 추가하려면 브로커 도메인에 사용자 정의 확장 구성요소 설치변경 끝을 참조하십시오. 버전 2 브로커의 경우에는 플러그인을 <WebSphere Brokers Install Dir>/lil/에 추가하고 브로커를 재시작하십시오.

단일 브로커 확장

시스템의 한 브로커만 확장에 액세스할 수 있게 하려면 mqsicreatebroker 또는 mqsichangebroker 명령에서 -l 매개변수를 사용하여 해당 브로커의 사용자 .lil 경로를 수정할 수 있습니다. 자세한 정보는 mqsicreatebroker 명령mqsichangebroker 명령를 참조하십시오.

다중 브로커 확장

시스템의 모든 브로커에 영향을 미치려면 시스템 lil 경로를 수정해야 합니다. 확장이 있는 디렉토리를 포함하는 디렉토리를 MQSI_LILPATH 환경 변수에 추가함으로써 시스템 .lil 경로를 수정할 수 있습니다. Windows%ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles 또는 UNIX/var/mqsi/common/profiles에서 사용자 정의 환경 스크립트를 작성함으로써 시스템 .lil 경로를 수정할 수도 있습니다. 환경 스크립트의 이름에는 아무런 제한이 없지만 파일 확장자는 Windows에서는 .cmd이어야 하고, 다른 모든 플랫폼에서는 .sh이어야 합니다. 스크립트는 쉘 스크립트의 모든 조작을 수행할 수 있지만, 다음 변수를 추가하는 데 한정해야 합니다.
MQSI_LILPATH
플러그인을 검색할 디렉토리를 정의합니다.
CLASSPATH
Java에서 추가 클래스를 검색해야 하는 위치를 정의합니다.
NLSPATH
메시지 카탈로그의 위치를 정의합니다.
PATH
실행 파일의 위치를 정의합니다. Windows에서는 종속 라이브러리의 위치도 정의합니다.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
종속 라이브러리의 위치를 정의합니다.

예제 스크립트

C:\Program Files\MyExtensions에 설치된 MyExtension의 환경 프로파일. 이 스크립트를 C:\Documents and Settings\All Users\Application Data\IBM\MQSI\common\profiles\MyExtension.cmd라고 합니다.
REM Added by MyExtension install, do not modify
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Program Files\MyExtension\bin"
/opt/MyExtension에 설치된 MyExtension의 환경 프로파일. 이 스크립트를 /var/mqsi/common/profiles/MyExtension.sh라고 합니다.
#!/bin/ksh
# Added by MyExtension install, do not modify
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

예를 들어 사용자 정의 확장이 특정 버전의 브로커에서만 실행되는지 확인하려는 경우 프로파일 스크립트에서 다음 변수를 테스트할 수 있습니다.

MQSI_FILEPATH
WebSphere Message Broker의 설치 파일에 대한 전체 경로를 포함합니다.
MQSI_WORKPATH
WebSphere Message Broker의 구성 데이터에 대한 전체 경로를 포함합니다.
MQSI_VERSION
WebSphere Message Broker 버전, version.release.modification.fix 형식
MQSI_VERSION_V
WebSphere Message Broker 주요 버전의 값
MQSI_VERSION_R
WebSphere Message Broker 릴리스의 값
MQSI_VERSION_M
WebSphere Message Broker 수정 번호의 값
MQSI_VERSION_F
WebSphere Message Broker 수정 레벨의 값
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as04540_