LEIA-ME do IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit Versão 5.1

Alterar histórico:
GA: 23 de julho de 2004
Updated: 20 August 2004

(C) Copyright IBM Corporation 2004. Todos os direitos reservados.

Bem-vindo ao IBM WebSphere Business Integration Message Brokers Toolkit Versão 5.1. Este arquivo LEIA-ME contém informações que não estavam disponíveis a tempo de serem incluídas em nossos centros de informações on-line. Ele se aplica somente para a instalação do Message Brokers Toolkit Versão 5.1 no Microsoft^(R) Windows^(R) e seu uso com o WebSphere Business Integration Message Broker e o WebSphere Business Integration Event Broker Versão 5.0.

AVISO!
Instale o Message Brokers Toolkit Versão 5.1 somente se já instalou o WSADIE (WebSphere Application Development Integration Edition) Versão 5.1. Não instale a Versão 5.1 caso possua um nível anterior do WSADIE; para esse, você deve utilizar o Message Brokers Toolkit Versão 5.0, a qual é fornecida com o WebSphere Business Integration Message Broker e o WebSphere Business Integration Event Broker Versão 5.0. O Message Brokers Toolkit Versão 5.1 tem função idêntica à do Message Brokers Toolkit Versão 5.0.3 (Fix Pack 3).

Para obter informações sobre todos os outros componentes do WebSphere Business Integration Message Broker e do WebSphere Business Integration Event Broker Versão 5.0, consulte o LEIA-ME da Versão 5.0.

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.

Informações Essenciais para Todos os Usuários
É altamente recomendável que você consulte a última versão do LEIA-ME. Você pode localizar a versão mais recente (apenas em inglês) em:
http://www.ibm.com/software/integration/mqfamily/support/readme/

Para concluir a instalação, consulte o arquivo install.html.

Versões traduzidas do arquivo LEIA-ME e do arquivo install.html estão disponíveis em: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Informações Essenciais se Você Estiver Migrando

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).

Você deve estar ciente dessas relações de migração e implementação:

• Quando você cria ou modifica fluxos de mensagens, conjuntos de mensagens e mapeamentos de mensagens no kit de ferramentas da Versão 5.1, não poderá mais acessar tais recursos em um kit de ferramentas da Versão 5.0. Assegure-se de que todos os usuários que compartilham projetos em um ambiente de equipe estão cientes dessa restrição e faça cópias de backup, se necessário.
• Você deve obter uma versão migrada de todos os plug-ins de nó definidos pelo usuário do fornecedor antes de implementar com êxito os fluxos de mensagens que os contém.

Você pode compartilhar recursos entre versões em sistemas diferentes:

• Você pode implementar qualquer projeto desenvolvido na Versão 5.0 sem a necessidade de alterá-los.
• Você pode importar arquivos de archive do intermediário criados nesta versão para um espaço de trabalho da Versão 5.0 e implementá-los com êxito.

Documentação
O centro de informações independente do WebSphere Business Integration Message Broker e do WebSphere Business Integration Event Broker Versão 5.0 foi atualizado para incluir as alterações necessárias ao Message Brokers Toolkit Versão 5.1 e está disponível para download. Você pode fazer download do archive zip a partir do endereço: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip

Leia o arquivo installing_and_managing.htm, que está incluído no arquivo wbimb_help.zip.

Suporte
Através deste documento leia-me, existem referências aos números de defeitos. Esses números referem-se a números de problemas internos da IBM; você pode achar esses números úteis quando estiver discutindo problemas com o seu representante de serviços da IBM.
Para obter informações atuais sobre problemas conhecidos e correções disponíveis, consulte
http://www.ibm.com/software/integration/wbimessagebroker/support/
para o WebSphere Business Integration Message Broker, e
http://www.ibm.com/software/integration/wbieventbroker/support/
para o WebSphere Business Integration Event Broker.

Atualizações de Recurso
Você deve verificar periodicamente as atualizações de recurso (incluindo atualizações de documentação).

Siga estas etapas:

1. No kit de ferramentas, selecione Ajuda > Atualizações de Software > Novas Atualizações. O Eclipse, em seguida, procura as atualizações disponíveis.
2. O Eclipse exibe quais atualizações estão disponíveis. Selecione as atualizações que você deseja instalar.
3. Ao selecionar as atualizações a serem instaladas, você receberá um aviso de que os recursos não foram marcados digitalmente. Você pode ignorar esse aviso.
4. Após instalar os recursos, o Eclipse solicita que você inicie novamente o workbench.
5. Após reiniciar o workbench, os novos recursos estão instalados e prontos para serem utilizados.

Índice

Restrições e Limitações:

• WebSphere Studio Application Developer Integration Edition
• Coexistência
• Instalação
• Após a Instalação

Avisos e Marcas Registradas

Páginas da Web Úteis

Restrições e Limitações

Esta seção destaca, por componente, as restrições e limitações do WebSphere Business Integration Message Broker e do WebSphere Business Integration Event Broker.  

WebSphere Studio Application Developer Integration Edition

Para estender um workbench do WSADIE (WebSphere Studio Application Developer Integration Edition) com este produto, você deve fazer upgrade do WSADIE para o nível apropriado suportado. A versão do workbench do WSADIE que pode ser estendida é WSADIE Versão 5.1 GA com "Interim Fix 002 - General Fixes 2.0.0".

Você deve, também, aplicar a correção "WebSphere Business Integration Message Broker v5.1.0 Interim Fix 001 - Prerequisite Fixes 1.0.0.1" depois de ter instalado o WebSphere Business Integration Message Broker ou o WebSphere Business Integration Event Broker.

Para obter instruções detalhadas, consulte o arquivo install.html.

Coexistência

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:

• Você pode implementar qualquer projeto desenvolvido na Versão 5.0 sem a necessidade de alterá-los.
• Você pode importar arquivos de archive do intermediário criados nesta versão para um espaço de trabalho da Versão 5.0 e implementá-los com êxito.

Para obter informações sobre como migrar seus recursos e dados de usuário para a Versão 5.1, consulte a seção Migração do centro de informações on-line.

Instalação

1. Durante a instalação, se você optar por NÃO aceitar o Acordo de Licença, aparecerá um pop-up com os botões SIM e NÃO. Independente do botão que selecionar, você retornará à página do Acordo de Licença. Clicar em SIM pode ter causado o cancelamento da instalação e o fechamento da barra de ativação.

   Além disso, se durante a instalação você clicar em VOLTAR na página do Acordo de Licença, várias mensagens de erro JVM (Java^TM Virtual Machine) ocorrerão e a Barra de Lançamento travará.

   Solução: Aceite o Acordo de Licença se você quiser instalar o produto com sucesso.

Após a Instalação

1. Se você instalou o Message Brokers Toolkit Versão 5.1 e substituiu a Versão 5.0:
   1. Defeito 34555
      Você deve reconstruir todos os projetos definidos em seu espaço de trabalho.
   2. Defeito 34930
      Se o INSTALL_PATH\eclipse\workspace\.metadata existir, você poderá pensar que ao abrir o Message Brokers Toolkit, o Update Manager será ativado corretamente, mas todas as atualizações em seus plug-ins falharão. Como resultado disso, o Message Brokers Toolkit não abrirá com os níveis corretos de plug-in e poderão ocorrer falhas do kit de ferramentas.
      
      Por exemplo, quando você está no Broker Application Development Perspective, pode ver que o item de menu Arquivo de Definição de Mensagem está faltando na lista produzida por Arquivo > Novo Menu. Esta é uma indicação de que a instalação não contém o nível ou a versão corretos de plug-ins para o Message Brokers Toolkit.
      
      Você pode verificar se os níveis de plug-ins que está utilizando estão corretos clicando em Ajuda > Sobre o Message Brokers Toolkit para WebSphere Studio - Message Broker na janela do Message Brokers Toolkit para WebSphere Studio. Sob o título "Message Brokers Toolkit para WebSphere Studio", o número de uma versão é exibido. Se as versões corretas dos plug-ins estão sendo utilizadas após a instalação da Versão 5.1, a versão exibida é a 5.1.0. Se a versão exibida for menor que esta:
      1. Exclua o diretório .metadata.
      2. Abra novamente o Message Brokers Toolkit.
      3. Importe novamente seus projetos existentes para o espaço de trabalho fazendo o seguinte para cada projeto:
         1. Clique em Arquivo> Importar.
         2. Quando o Assistente de Importação aparecer, selecione Projeto Existente no Espaço de Trabalho e clique em Avançar.
         3. Clique em Procurar e defina o local do projeto no espaço de trabalho.
         4. Clique em Concluir.
2. Defeito 32898
   Se suas definições de LAN não estiverem configuradas corretamente para o acesso do host local, talvez devido às definições no script de configuração automática, pode ocorrer uma das alternativas a seguir:
   • O navegador de ajuda abre em uma página em branco.
   • O navegador de ajuda exibe um erro HTTP em vez de uma página de ajuda.
   • Há grandes retardos quando o centro de informações estiver carregado.
   
   Solução: O administrador do sistema pode configurar as definições de LAN para que os documentos de ajuda possam ser acessados com êxito a partir do servidor de ajuda local fazendo o seguinte:
   1. No Painel de Controle, abra Opções de Internet, selecione a guia Conexões e escolha Definições de LAN.
   2. Se o host for configurado para utilizar DHCP para a atribuição de IP, certifique-se de que a caixa de opções Detectar definições automaticamente esteja limpa.
   3. Se utilizar o servidor proxy, certifique-se de que Ignorar servidor proxy para endereços locais esteja selecionado.
   4. Nas definições Avançadas para os proxies, inclua '127.0.0.1;localhost' nas Exceções se este endereço não estiver listado.
   5. Se você estiver utilizando um script de configuração automática para definições de proxy e não tiver certeza se o script está correto, limpe a caixa de opções Utilizar script de configuração automática.
   
   Se as etapas acima não corrigirem o problema, tente alterar as propriedades da porta e do host em org.eclipse.tomcat\preferences.ini. Definir host=localhost ou host=127.0.0.1 deve funcionar. Se estiver executando um firewall, poderá também ser necessário definir port=80 (ou algum outro valor favorável ao firewall).
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.