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

변경 기록:
GA: 2004년 7월 23일
Updated: 20 August 2004

(C) Copyright IBM Corporation 2004. 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과 함께 사용될 때에만 적용됩니다.

경고!
WebSphere Application Development Integration Edition(WSADIE) 버전 5.1을 설치한 경우에만 Message Brokers Toolkit 버전 5.1을 설치할 수 있습니다. WSADIE의 이전 레벨이 설치된 경우에는 버전 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.3(Fix Pack 3)과 동일한 기능이 있습니다.

WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker 버전 5.0의 다른 모든 구성요소에 대한 정보는 버전 5.0 README를 참조하십시오.

Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation of the Message Brokers Toolkit Version 5.1. However, if at least one of your Message Broker Toolkit installations integrates with WSADIE Version 5.1, all your Message Broker Toolkit installations must be at Version 5.1 to ensure data sharing and integrity.

If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.0.

사용자를 위한 필수 정보
최신 버전의 Readme를 참조할 것을 적극 권장합니다. 이 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/

이주 관련 필수 정보

If you are migrating, refer to the install.html file for details of the actions that you must take before you install.

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first; the two versions cannot coexist.

The information center provides further information about migration; to view this before you install, download a stand-alone version of the information center (see the "Documentation" section for instructions).

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

• 버전 5.1 툴킷에서 메시지 플로우, 메시지 세트 및 메시지 맵핑을 작성하거나 수정하는 경우 버전 5.0 툴킷에서 그러한 자원에 더 이상 액세스할 수 없습니다. 팀 환경에서 프로젝트를 공유하는 모든 사용자가 이러한 제한을 인식하고 필요한 경우 백업 사본을 만들어 두도록 하십시오.
• 모든 사용자 정의 노드 플러그인의 이주 버전을 포함하는 메시지 플로우를 성공적으로 전개할 수 있으려면 제공업체로부터 이러한 이주 버전을 받아야 합니다.

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

• 버전 5.0에서 개발된 프로젝트를 변경하지 않고 전개할 수 있습니다.
• 이 버전에서 작성된 브로커 아카이브 파일을 버전 5.0 작업공간으로 가져와서 이를 성공적으로 전개할 수 있습니다.

문서
WebSphere Business Integration Message Broker 및 WebSphere Business Integration Event Broker 버전 5.0의 독립형 정보 센터는 Message Brokers Toolkit 버전 5.1에 필요한 변경사항을 포함하기 위해 갱신되었으며 다운로드 가능합니다. ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip에서 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 Studio Application Developer Integration Edition
• 공존
• 설치
• 설치한 후에

주의사항 및 상표

유용한 웹 페이지

제한사항

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

WebSphere Studio Application Developer Integration Edition

이 제품에서 WebSphere Studio Application Developer Integration Edition(WSADIE) Workbench를 확장하려면 WSADIE를 적절한 지원 레벨로 업그레이드해야 합니다. 확장 가능한 WSADIE Workbench 버전은 WSADIE 버전 5.1 GA("중간 수정사항 002 - 일반 수정사항 2.0.0" 포함)입니다.

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

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

공존

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first. The two versions cannot coexist, however you can share resources between versions on different systems:

• 버전 5.0에서 개발된 프로젝트를 변경하지 않고 전개할 수 있습니다.
• 이 버전에서 작성된 브로커 아카이브 파일을 버전 5.0 작업공간으로 가져와서 이를 성공적으로 전개할 수 있습니다.

자원과 사용자 데이터를 버전 5.1로 이주하는 방법에 대한 정보는 온라인 정보 센터의 이주 절을 참조하십시오.

설치

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

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

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

설치한 후에

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 Broker 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 Broker Toolkit을 다시 여십시오.
      3. 각각의 프로젝트에 대해 다음을 수행하여 작업공간으로 기존 프로젝트를 다시 가져오십시오.
         1. 파일 > 들여오기를 클릭하십시오.
         2. 들여오기(import) 마법사가 나타나면 작업공간으로 기존 프로젝트를 선택하고 다음을 누르십시오.
         3. 찾아보기를 누르고 작업공간에 있는 프로젝트의 위치를 정의하십시오.
         4. 완료를 누르십시오.
2. 디펙트 32898
   LAN 설정이 로컬 호스트 액세스에 대해 제대로 구성되지 않은 경우, 자동 구성 스크립트의 설정으로 인해 다음 중 하나가 발생할 수 있습니다.
   • 도움말 브라우저가 공백 페이지로 열립니다.
   • 도움말 브라우저가 도움말 페이지 대신에 HTTP 오류를 표시합니다.
   • 정보 센터가 로드될 때 오랫 동안 지연됩니다.
   
   해결책: 다음을 수행하여 로컬 도움말 서버에서 도움말 문서가 성공적으로 액세스될 수 있도록 시스템 관리자가 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. Defect T32243
   The mxsd file extension is not associated correctly with the Message Definition Editor. To ensure that mxsd files are opened in the Message Definition Editor as the default action, select Window > Preferences > Workbench > File Associations. Scroll down the list of file types and select *.mxsd. Then select Message Definition Editor in the list of Associated editors. Click Default then OK.
4. Defect 36422
   In the topic "Distributing a user-defined node" in the online information center, the instructions about extracting the zip file are incorrect. Step 2 of the instructions tells you to unzip the file to the install_dir\eclipse\plugins directory. Instead, the correct location to unzip the file to is the WBIMB_install_dir\evtoolkit\eclipse\plugins directory.
   In the topic "Installing a user-defined extension on a broker domain" in the online information center, the install location for Windows is ambiguous. For C user-defined nodes, the topic tells you to use the location install_dir\bin. This should be WBIMB_install_dir\bin. For Java user-defined nodes, the topic tells you to use the location install_dir\jplugin. This should be WBIMB_install_dir\jplugin.
5. Defect 36589
   If you use any of the predefined ESQL constants, such as MQMO_NONE, in ESQL code, the code is flagged as Message Brokers Toolkit Version 5.0 compatible. This means that you cannot deploy message flows referencing this ESQL code to a Version 2.1 broker, regardless of the compatibility level set in the preferences. This limitation will be lifted in the next fix pack for Message Brokers Toolkit Version 5.1.
6. Defect 36605
   The description of the property Namespace in topics "Wildcard attribute logical properties" (ad11870_) and "Wildcard element logical properties" (ad11890_) is incorrect. In the current implementation, there is no enumerated list of options and the field is initially blank. You can specify a namespace in this field; this causes a Task List warning to be displayed which explains that the broker will not use this information and will allow an element from any namespace to be used as the wildcard.
7. Defect 36638
   The Message Set Editor Preferences topic (ad15810_) describes only the options available in the Version 5.0 toolkit. The Version 5.0 options are not available for Version 5.1. In the Version 5.1 toolkit, the options are:
   • Message set editor settings, Outline view settings. These options are displayed but are not operational:
     • Group by namespace and then by collections
     • Group by collections and then by namespace
   • Message definition editor settings:
     • Show base complex types
       If you have defined one or more complex types based on other complex types, select this option if you want the content of those base complex types to be displayed in the message definition editor overview and outline views (this is selected by default).
       If you do not want them displayed, clear the check box.
8. TDS properties
   The grouping and order of TDS properties of global attribute, global element, local attribute, and local element shown in the workbench differ from the grouping and order shown in the topics that describe them. Their meaning and use is unchanged.
9. Defect 36655
   If you uninstall the toolkit by invoking uninstaller.exe with the -silent option, the uninstall program returns control immediately and runs as a background task. If you do not want the uninstall program to return until it has completed, you must invoke the uninstaller within java using this command:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   where <install_dir> is the directory in which you installed the product.
   If you do not have a jvm configured (Version 1.3.1 or above), you can use the jvm within the installed product in directory <install_dir>\_sjvm\bin\. If you do this, you might have to delete this directory manually when uninstallation is complete.