IBM(R) WebSphere(R) Business Integration Message Brokers Toolkit 버전 5.1


변경 기록:
GA: 2004년 7월 23일
갱신일: 2004년 8월 20일
갱신일: 2004년 10월 20일
갱신일: 2004년 12월 17일
Fix Pack 5: 2005년 2월 9일

(C) Copyright IBM Corporation 2004, 2005. All rights reserved.


IBM WebSphere Business Integration Message Brokers Toolkit 버전 5.1을 시작합니다.

이 readme 파일은 Microsoft(R) Windows(R)에 Message Brokers Toolkit 버전 5.1의 설치 및 WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker 버전 5.0과 함께 사용될 때에만 작용됩니다. 여기에서는 알려진 문제점에 대해 설명하고 온라인 정보 센터에 포함되지 않은 문서 갱신사항을 포함하고 있습니다. 또한 제품에 대한 자세한 정보를 위해 IBM WebSphere Business Integration Message Brokers 버전 5.0 readme 파일을 읽어야 합니다.

경고!
WebSphere Application Development Integration Edition 버전 5.1을 설치한 경우에만 Message Brokers Toolkit 버전 5.1을 설치하십시오. WebSphere Studio Application Developer Integration Edition의 이전 레벨이 설치된 경우에는 버전 5.1을 설치하지 마십시오. 이런 경우 WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker 버전 5.0과 함께 제공된 Message Brokers Toolkit 버전 5.0을 사용해야 합니다. Message Brokers Toolkit 버전 5.1에는 Message Brokers Toolkit 버전 5.0과 동일한 기능이 있습니다.

팀 환경에서 Message Brokers Toolkit 버전 5.1 설치
WebSphere Studio Application Developer Integration Edition 버전 5.1은 모든 Message Brokers Toolkit 버전 5.1 설치의 필수조건은 아닙니다. 그러나 적어도 하나의 Message Brokers Toolkit 설치가 WebSphere Studio Application Developer Integration Edition 버전 5.1과 통합되는 경우 데이터 공유 및 무결성을 위해 모든 Message Brokers Toolkit 설치는 버전 5.1이어야 합니다.

시스템에서 WebSphere Studio Application Developer Integration Edition 버전 5.1을 사용하지 않거나 WebSphere Studio Application Developer Integration Edition 버전 5.0을 사용하는 경우, Message Brokers Toolkit 버전 5.0을 설치해야 합니다.

CVS compatibility
The Message Brokers Toolkit Version 5.1 is based on Eclipse 2.1.2, and uses CVS client plugin version 2.1.1. For this version, your CVS server must be at version 1.11.6 or earlier (Linux and UNIX only, CVSNT is not supported).

사용자를 위한 필수 정보

이 readme 파일의 최신 버전을 보도록 적극 권장합니다. 최신 버전(영문)은 다음 사이트에 있습니다.
http://www.ibm.com/software/integration/mqfamily/support/readme/

설치를 완료하려면 install.html 파일을 참조하십시오. 여기에는 제품 설치 이전에 완료해야 하는 작업에 대한 정보가 들어 있습니다.

readme 파일 및 install.html 파일의 한국어 버전은 다음 FTP에서 사용 가능합니다. ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

정보 센터의 번역 버전은 이 패키지에 포함되어 있지 않습니다. 정보 센터의 모든 자국어 부분은 비어 있으며 모든 정보는 영어로 표시됩니다. 영어 외의 다른 지원 언어로 정보 센터를 표시하려면 Fix Pack을 설치한 이후에 적절한 Eclipse 기능을 다운로드해야 합니다. Fix Pack이 발표되면 번역본도 사용 가능해집니다. 이러한 갱신사항의 다운로드에 대한 지시사항은 기능 갱신사항을 참조하십시오.

이주 관련 필수 정보

이주하는 경우 설치 전에 취해야 하는 조치에 대한 자세한 내용은 install.html 파일을 참조하십시오.

Message Brokers Toolkit 버전 5.0이 이미 설치된 시스템에 Message Brokers Toolkit 버전 5.1을 설치하려는 경우, 먼저 버전 5.0 Toolkit을 설치 제거해야 합니다. 두 버전은 공존할 수 없습니다.

정보 센터는 이주에 대한 추가적인 정보를 제공합니다. 설치 전에 이 정보를 보려면 정보 센터의 독립형 버전을 다운로드하십시오(지시사항은 문서 참조).

다음 이주 및 전개 관련 문제를 인식하고 있어야 합니다.

다른 시스템상의 버전 간에 자원을 공유할 수 있습니다.

문서

WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker 버전 5.0의 독립형 정보 센터로 다운로드할 수 있습니다. ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/wbimb_help.zip에서 압축 파일을 다운로드할 수 있습니다.

wbimb_help.zip 파일에 들어 있는 installing_and_managing.htm 파일을 읽으십시오.

지원

이 Readme 파일에서는 디펙트(defect) 번호를 사용합니다. 이 번호는 IBM 내에서 알려진 문제점 번호를 나타내는 것으로서 IBM 서비스 담당자와 문제점에 대해 상담할 때 유용합니다.
알려진 문제점 및 사용 가능한 수정사항에 대한 최신 정보는 WebSphere Business Integration Message Broker의 경우
http://www.ibm.com/software/integration/wbimessagebroker/support/
웹 사이트를, WebSphere Business Integration Event Broker의 경우
http://www.ibm.com/software/integration/wbieventbroker/support/
웹 사이트를 참조하십시오.

기능 갱신사항

기능 갱신사항(문서 갱신사항 및 기타 지원되는 언어 포함)을 주기적으로 점검해야 합니다.
  1. 툴킷에서 도움말 > 소프트웨어 갱신사항 > 새 갱신사항을 선택하십시오. Eclipse에서 사용 가능한 갱신사항을 검색합니다.
  2. Eclipse가 사용 가능한 갱신사항을 표시합니다. 설치할 갱신사항을 선택하십시오.
  3. 설치할 갱신사항을 선택하면 기능에 디지털 서명이 없다는 경고가 표시됩니다. 이 경고를 무시할 수 있습니다.
  4. 기능을 설치하고 나면 Eclipse는 Workbench를 다시 시작하라는 프롬프트를 표시합니다.
  5. Workbench를 다시 시작하고 나면 새 기능이 설치되어 사용할 수 있게 됩니다.

목차

제한사항:

주의사항 및 상표

유용한 웹 페이지


제한사항

이 절에는 구성요소별로 WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker에 대한 제한사항 및 한계에 대한 개요를 제공합니다.


WebSphere Studio Application Developer Integration Edition

이 제품에서 WebSphere Studio Application Developer Integration Edition Workbench를 확장하려면 WebSphere Studio Application Developer Integration Edition을 적절한 지원 레벨로 업그레이드해야 합니다. 확장할 수 있는 WebSphere Studio Application Developer Integration Edition Workbench 버전은 "중간 수정사항 002 - 일반 수정사항 2.0.0"이 포함된 WebSphere Studio Application Developer Integration Edition 버전 5.1 GA입니다. WebSphere Studio Application Developer Integration Edition 5.1의 이전 버전은 지원되지 않습니다.

WebSphere Business Integration Message Broker 또는 WebSphere Business Integration Event Broker를 설치한 후에 "WebSphere Business Integration Message Broker v5.1.5 중간 수정사항 001 - 필수조건 수정사항 1.0.0.1" 수정사항을 적용해야 합니다.

자세한 지시사항은 install.html 파일을 참조하십시오.


공존

Message Brokers Toolkit 버전 5.0이 이미 설치된 시스템에 Message Brokers Toolkit 버전 5.1을 설치하려는 경우, 먼저 버전 5.0 Toolkit을 설치 제거해야 합니다. 두 버전은 공존할 수 없지만 다른 시스템상의 버전 간에 자원을 공유할 수 있습니다. 자원과 사용자 데이터를 버전 5.1로 이주하는 방법에 대한 정보는 온라인 정보 센터의 이주 절을 참조하십시오.

설치

  1. 디펙트 34320
    설치 중에 라이센스 계약을 승인하지 않으면 예와 아니오 단추가 있는 팝업 창이 나타납니다. 선택하는 단추에 상관 없이 라이센스 계약 페이지로 리턴됩니다. 예를 누르면 설치가 취소되고 런치패드가 닫힙니다.

    또한, 설치 중에 라이센스 계약 페이지에서 '뒤로'를 누르면 여러 JVM(JavaTM Virtual Machine) 오류 메시지가 나타나며 런치패드가 정지됩니다.

    해결 방법: 제품을 설치하려면 라이센스 계약을 승인하십시오.

  2. 디펙트 37122
    Installshield의 버그로 인해 자동 설치에 사용되는 응답 파일이 잘못 해석됩니다. 이 문제점을 피하려면 다음 조치를 완료하십시오.

    아래 예는 도구를 C:\Program Files\IBM\WBIMB 위치로 설치합니다.

    ---start of response file---------
    
    -P installLocation="C:\Program Files\IBM\WBIMB"
    -W setupTypes.selectedSetupTypeId=custom
    
    ###############################################################################
    #
    # User Input Field - suiteFeatures
    #
    #
    
    #Do not change this - it sets the installer to ignore the standard custom setup route
    -W featureSelectionIB.active=false
    
    #Set a value to true to install that component
    # If any of the Broker, UNS or Config Manager parameters are set to true, 
    # the core value must also be set to true.  
    # Otherwise set this should be set to false to avoid installing most of the product.
    
    -W enableCore.value=true
    -W setCustomSuiteBrokerFeatureTrue.propertyValue=false
    -W setCustomSuiteUNSFeatureTrue.propertyValue=false
    -W setCustomSuiteConfigMgrFeatureTrue.propertyValue=false
    
    #Set to true if the Message Broker extension features are required.
    #The broker and core features must also be set to true to install this
    
    -W setCustomMessageTrue.value=false
    
    #Set to true if the tooling is required
    -W setCustomToolingTrue.value=true
    
    ------ end of response file----------
    

설치한 후에

  1. Message Brokers Toolkit 버전 5.1을 설치하고 버전 5.0을 대체한 경우:
    1. 디펙트 34555
      작업공간에 정의된 모든 프로젝트를 다시 빌드해야 합니다.
    2. 디펙트 34930
      INSTALL_PATH\eclipse\workspace\.metadata가 존재하는 경우에는 Message Brokers Toolkit을 열 때 갱신 관리자는 제대로 시작되지만 플러그인에 대한 모든 갱신이 실패할 수도 있습니다. 이로 인해 Message Brokers Toolkit이 올바른 플러그인 레벨로 열리지 않으며 툴킷이 실패할 수 있습니다.

      예를 들어, 브로커 응용프로그램 개발 Perspective에 있는 경우에는 메시지 정의 파일 메뉴 항목이 파일 > 새 메뉴의 생성된 목록에서 누락됩니다. 이는 Message Brokers Toolkit용 플러그인의 올바른 레벨 또는 버전이 설치에 포함되지 않음을 의미합니다.

      Message Brokers Toolkit for WebSphere Studio 창에서 도움말 > Message Brokers Toolkit for WebSphere Studio - Message Broker 제품 정보를 선택하여 사용 중인 플러그인 레벨이 올바른지 점검할 수 있습니다. "Message Brokers Toolkit for WebSphere Studio" 표제 아래에 버전 번호가 표시됩니다. 버전 5.1을 설치한 후에 올바른 플러그인 버전을 사용하는 경우 표시되는 버전은 5.1.0입니다. 표시되는 버전이 이보다 낮으면 아래의 지시사항을 수행하십시오.
      1. .metadata 디렉토리를 삭제하십시오.
      2. Message Brokers Toolkit을 다시 여십시오.
      3. 각각의 프로젝트에 대해 다음을 수행하여 작업공간으로 기존 프로젝트를 다시 가져오십시오.
        1. 파일 > 들여오기를 클릭하십시오.
        2. 들여오기(import) 마법사가 나타나면 작업공간으로 기존 프로젝트를 선택하고 다음을 누르십시오.
        3. 찾아보기를 누르고 작업공간에 있는 프로젝트의 위치를 정의하십시오.
        4. 완료를 누르십시오.
  2. 디펙트 32898
    LAN 설정이 로컬 호스트 액세스에 대해 제대로 구성되지 않은 경우, 자동 구성 스크립트의 설정으로 인해 다음 중 하나가 발생할 수 있습니다.
    해결책: 다음을 수행하여 로컬 도움말 서버에서 도움말 문서가 성공적으로 액세스될 수 있도록 시스템 관리자가 LAN 설정을 구성할 수 있습니다.
    1. 제어판에서 인터넷 옵션을 열고 연결 탭을 선택한 후에 LAN 설정을 선택하십시오.
    2. 호스트가 IP 지정을 위해 DHCP를 사용하도록 구성된 경우에는 자동으로 설정 검색 선택란이 지워져 있는지 확인하십시오.
    3. 프록시 서버를 사용하는 경우에는 로컬 주소에 프록시 서버 사용 안함이 선택되어 있는지 확인하십시오.
    4. 프록시 고급 설정에서 '127.0.0.1;localhost'가 나열되어 있지 않으면 이 주소를 예외에 추가하십시오.
    5. 프록시 설정을 위한 자동 구성 스크립트를 사용하고 이 스크립트가 올바른지 확인할 수 없는 경우에는 자동 구성 스크립트 사용 선택란을 지우십시오.

    위의 단계로도 문제점이 해결되지 않으면 org.eclipse.tomcat\preferences.ini에서 포트 및 호스트 등록 정보를 변경해 보십시오. host=localhost 또는 host=127.0.0.1 설정이 작동해야 합니다. 방화벽을 실행 중인 경우에는 port=80(또는 일부 기타 방화벽 관련 값)도 설정해야 할 수 있습니다.
  3. 디펙트 T 32243
    mxsd 파일 확장자는 메시지 정의 편집기와 올바르게 연관되어 있지 않습니다. mxsd 파일이 메시지 정의 편집기에서 디폴트 조치로 열려 있는지 확인하려면 Window > 환경설정 > Workbench > 파일 연관을 선택하십시오. 파일 유형 목록을 아래로 화면 이동하고 *.mxsd를 선택하십시오. 그런 다음, 연관된 편집기 목록에서 메시지 정의 편집기를 선택하십시오. 디폴트를 누른 다음 확인을 누르십시오.
  4. 디펙트 36638
    메시지 세트 편집기 환경설정 토픽(ad15810_)은 버전 5.0 툴킷에서 사용 가능한 옵션만 설명합니다. 버전 5.0 옵션은 버전 5.1에서는 사용 불가능합니다. 버전 5.1 툴킷에서 옵션은 다음과 같습니다.
  5. 디펙트 36655
    -silent 옵션과 함께 uninstaller.exe를 호출하여 툴킷을 설치 제거하는 경우 설치 제거 프로그램이 즉시 제어권을 반환하고 백그라운드 작업으로 실행됩니다. 설치 제거 프로그램이 완료될 때까지 반환하고 싶지 않은 경우 다음 명령을 사용하여 Java 안에서 설치 제거 프로그램을 호출해야 합니다.
    java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
    여기서 <install_dir>은 제품을 설치한 디렉토리입니다.
    jvm(버전 1.3.1 이상)이 구성되지 않은 경우 설치된 제품의 <install_dir>\_sjvm\bin\ 디렉토리에서 해당 jvm을 사용할 수 있습니다. 이를 수행하면 설치 제거가 완료되었을 때 이 디렉토리를 수동으로 삭제해야 할 수 있습니다.
  6. 디펙트 37671
    COBOL 사본 들여오기: COBOL 사본을 들여와서 메시지 세트 정의 파일을 채우려는 경우 해당 사본에 적어도 하나의 01 레벨 구조가 있는지 확인하십시오. 01 레벨 구조가 없으면 오브젝트(요소, 그룹, 유형)를 들여올 수 없습니다.
  7. Database Views definitions are not supported in the ESQL editor. References to database views in the ESQL code (instead of to schemas or tables) are flagged as warnings (unresolved reference) in the ESQL editor. These warnings do not prevent you from deploying the corresponding ESQL.
    These unresolved reference warnings might also appear when you have migrated a Version 2.1 message flow, because the 5.0 ESQL editor validates database references.
    References to database tables and schemas only are supported.
  8. ESQL compilation restriction: if you create a subflow, and choose to distribute this as a plug-in project, calls to ESQL global routines within the subflow might not be generated correctly when you add a message flow that contains the subflow to a BAR file. When you deploy the BAR file, it will fail.
    Workaround: Implement one of the following options:

주의사항

이 정보는 미국에서 제공되는 제품 및 서비스용으로 작성된 것입니다.

IBM은 다른 국가에서는 이 정보에 기술된 제품, 서비스 또는 기능을 제공하지 않을 수도 있습니다. 현재 사용할 수 있는 제품 및 서비스에 대한 정보는 한국 IBM 담당자에게 문의하십시오. 이 책에서 IBM 제품, 프로그램 또는 서비스를 언급하는 것이 해당 IBM 제품, 프로그램 또는 서비스만을 사용할 수 있다는 것을 의미하지는 않습니다. IBM의 지적 재산권을 침해하지 않는 한, 기능상으로 동등한 제품, 프로그램 또는 서비스를 대신 사용할 수 있습니다. 그러나 비IBM 제품, 프로그램 또는 서비스의 운용에 대한 평가 및 검증은 사용자의 책임입니다.

IBM은 이 정보에서 다루고 있는 특정 내용에 대해 특허를 보유하고 있거나 현재 특허 출원 중일 수 있습니다. 이 정보를 제공한다고 해서 특허에 대한 라이센스까지 부여하는 것은 아닙니다. 라이센스에 대한 의문사항은 다음으로 문의하십시오.

2바이트(DBCS) 정보에 관한 라이센스 문의는 한국 IBM 고객만족센터에 문의하거나 다음 주소로 서면 문의하시기 바랍니다.

다음 단락은 현지법과 상충하는 영국이나 기타 국가에서는 적용되지 않습니다.

IBM은 타인의 권리 비침해, 상품성 및 특정 목적에의 적합성에 대한 묵시적 보증을 포함하여(단, 이에 한하지 않음) 묵시적이든 명시적이든 어떠한 종류의 보증없이 이 책을 "현상태대로" 제공합니다. 일부 국가에서는 특정 거래에서 명시적 또는 묵시적 보증의 면책사항을 허용하지 않으므로, 이 사항이 적용되지 않을 수도 있습니다.

이 정보에는 기술적으로 부정확한 내용이나 인쇄상의 오류가 있을 수 있습니다. 이 정보는 주기적으로 변경되며, 변경사항은 최신판에 통합됩니다. IBM은 이 정보에 기술된 제품 및(또는) 프로그램을 사전 통지없이 언제든지 개선 및(또는) 변경할 수 있습니다.

이 정보에서 언급되는 비IBM의 웹 사이트는 단지 편의상 제공된 것으로, 어떤 방식으로든 이들 웹 사이트를 옹호하고자 하는 것은 아닙니다. 해당 웹 사이트의 자료는 본 IBM 제품 자료의 일부가 아니므로 해당 웹 사이트 사용으로 인한 위험은 사용자 본인이 감수해야 합니다.

IBM은 귀하의 권리를 침해하지 않는 범위 내에서 적절하다고 생각하는 방식으로 귀하가 제공한 정보를 사용하거나 배포할 수 있습니다.

(i) 독립적으로 작성된 프로그램과 기타 프로그램(본 프로그램 포함) 간의 정보 교환 및 (ii) 교환된 정보의 상호 이용을 목적으로 본 프로그램에 관한 정보를 얻고자 하는 라이센스 사용자는 다음 주소로 문의하십시오.

이러한 정보는 적절한 조건(예를 들어, 사용료 지불 등)하에서 사용될 수 있습니다.

이 정보에 기술된 라이센스가 있는 프로그램 및 이 프로그램에 대해 사용 가능한 모든 라이센스가 있는 자료는 IBM이 IBM 기본 계약, IBM 프로그램 라이센스 계약(IPLA) 또는 이와 동등한 계약에 따라 제공한 것입니다.

비IBM 제품에 관한 정보는 해당 제품의 공급업체, 공개 자료 또는 다른 기타 범용 소스로부터 얻은 것입니다. IBM에서는 이러한 비IBM 제품을 테스트하지 않았으므로, 이들 제품과 관련된 성능의 정확성, 호환성 또는 기타 주장에 대해서는 확신할 수 없습니다. 비IBM 제품의 성능에 대한 의문사항은 해당 제품의 공급업체에 문의하십시오.

이 정보에는 일상의 비즈니스 운영에서 사용되는 자료 및 보고서에 대한 예제가 들어 있습니다. 이 예제에는 가능한 완벽하게 개념을 설명하기 위해 개인, 회사, 상표 및 제품의 이름이 사용될 수 있습니다. 이들 이름은 모두 가공의 것이며 실제 기업의 이름 및 주소와 유사하더라도 이는 전적으로 우연입니다.

저작권:

이 정보에는 여러 가지 운영 플랫폼에서의 프로그래밍 기법을 보여주는 원어로 된 샘플 응용프로그램이 들어 있습니다. 귀하는 샘플 프로그램의 작성 기준이 된 운영 플랫폼의 응용프로그램 프로그래밍 인터페이스에 부합하는 응용프로그램을 개발, 사용, 마케팅 및 배포하기 위한 목적으로 이러한 샘플 프로그램을 추가 비용없이 어떤 형태로든 복사, 수정 및 배포할 수 있습니다. 이러한 예제는 모든 조건하에서 철처히 테스트된 것은 아닙니다. 따라서 IBM은 이러한 프로그램의 신뢰성, 서비스 가능성 또는 기능을 보증하거나 암시하지 않습니다. 귀하는 IBM의 응용프로그램 프로그래밍 인터페이스(API)에 부합하는 응용프로그램을 개발, 사용, 판매 또는 배포할 목적으로 추가 비용없이 이러한 샘플 응용프로그램을 어떠한 형태로든 복사, 수정 및 배포할 수 있습니다.

상표

다음 용어는 미국 또는 기타 국가에서 사용되는 IBM Corporation의 상표입니다.

IBM WebSphere.

Java 및 모든 Java 기반 상표는 미국 또는 기타 국가에서 사용되는 Sun Microsystems, Inc.의 상표입니다.

Microsoft 및 Windows는 미국 또는 기타 국가에서 사용되는 Microsoft Corporation의 상표입니다.

기타 회사, 제품 또는 서비스 이름은 타사의 상표 또는 서비스표입니다.


유용한 웹 페이지

WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker 픽스팩
http://www.ibm.com/software/integration/mqfamily/support/summary/wbib.html

WebSphere Business Integration Message Broker 요구사항
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

WebSphere Business Integration Event Broker 요구사항
http://www.ibm.com/software/integration/wbieventbroker/requirements/

WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker Install.html
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker Readme 파일
http://www.ibm.com/software/integration/mqfamily/support/readme/

WebSphere Business Integration Message Broker 독립형 정보 센터
http://www.ibm.com/software/integration/wbimessagebroker/library/

WebSphere Business Integration Event Broker 독립형 정보 센터
http://www.ibm.com/software/integration/wbieventbroker/library/