Bem-vindo ao IBM WebSphere Message Broker e ao IBM WebSphere Event Broker. Este é o arquivo leia-me da Versão 6.0.0.3 (Fix Pack 3) do componente Runtime e da Versão 6.0.2.0 do Toolkit.
Este leia-me descreve problemas conhecidos e contém atualizações de documentação que não foram disponibilizadas a tempo para serem incluídas no centro de informações on-line.
Sempre utilize a versão mais recente deste arquivo leia-me, que pode ser localizada (apenas em inglês) em:
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
Versões traduzidas do arquivo leia-me estão disponíveis em: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0
Para completar a instalação, consulte o WebSphere Message Broker Installation Guide ou o WebSphere Event Broker Installation Guide. Eles incluem informações sobre tarefas que você deve concluir antes de instalar o produto. Eles também incluem informações sobre o suporte para HP-UX (plataforma Itanium).
Acesse o Guia de Instalação on-line no IBM Publications Center em:
http://publib.boulder.ibm.com/epubs/pdf/c3466213.pdf for Message Broker
http://publib.boulder.ibm.com/epubs/pdf/c3466223.pdf for Event Broker
O Centro de Informações do WebSphere Message Broker e do WebSphere Event Broker reflete a Versão 6.0.0.3 do componente Runtime e a Versão 6.0.2.0 do componente Tooling.
O Toolkit contém alguns aprimoramentos que não são documentados nessa versão do centro de informações. O tópico "O Que Há de Novo na Versão 6.0?" trata das novas funções descritas no centro de informações, mas há também aprimoramentos nas seguintes áreas do Toolkit, os quais ainda não foram documentados:
Uma versão atualizada do centro de informações que contém as novas informações relacionadas a esses aprimoramentos estará disponível brevemente.
O centro de informações independente do WebSphere Message Broker e do WebSphere Event Broker é acessível a partir de: http://www.ibm.com/software/integration/wbimessagebroker/library/
Ele também está disponível para download a partir de:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_lin.tgz (versão Linux)
e
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip (versão Windows).
Leia o arquivo installing_and_managing.htm, incluído nos arquivos wmb_help_lin.tgz e wmb_help_win.zip.
Coletas de tópicos de informações formatados para impressão e toda a documentação para Regras e Formatador, podem ser localizadas em:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/
Defeitos: 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.
Technotes: Para obter informações atuais sobre problemas conhecidos e correções disponíveis, consulte:
http://www.ibm.com/software/integration/wbimessagebroker/support/
Você pode localizar informações utilizando qualquer um dos seguintes métodos:
Versões: Para obter o status mais recente, no qual versões específicas de sistemas operacionais e bancos de dados são suportados pelo WebSphere Message Broker e
o WebSphere Event Broker, consulte as páginas do WebSphere MQ Family
Supported Software em:
http://www.ibm.com/support/docview.wss?uid=swg27007065
Esta seção destaca, por componente, as restrições e limitações do WebSphere Message Broker e do WebSphere Event Broker.
O CD WebSphere Message Broker Extensions, Samples, and Demos, descrito no Guia de Instalação e no tópico do centro de informações "Nova Função Incluída nos Fix Packs da Versão 6.0", está disponível somente no Windows XP.
Em qualquer plataforma UNIX, se você instalar o componente Configuration Manager sem o componentes Broker e, em seguida, instalar o Broker no mesmo diretório, diversos links simbólicos de arquivo estarão ausentes nos diretórios lil e lil64 do Broker. Para evitar esse problema:
Para fazer upgrade do Message Brokers Toolkit para a Versão 6.0.2.0 (da Versão 6.0, Versão 6.0.0.1 ou Versão 6.0.0.2), você deve utilizar o RPU (Rational Product Updater), que deve estar no nível 6.0.1 ou superior. Se você utiliza atualmente uma versão mais antiga do RPU, deve fazer upgrade para a Versão 6.0.1 antes de atualizar o Message Brokers Toolkit. Para obter informações sobre upgrade do RPU, consulte o WebSphere Message Broker Installation Guide.
Você pode utilizar o RPU para instalar o Message Brokers Toolkit (V6.0.2.0) diretamente da Web ou de um sistema local. O procedimento de upgrade para a Versão 6.0.2.0 utilizando o RPU está documentado no WebSphere Message Broker Installation Guide.
Se você estiver utilizando o RPU para instalar o pacote de um sistema local (em vez de diretamente da Web), o pacote que você precisará transferir por download variará de acordo com a versão instalada atualmente:
Depois de ter feito upgrade para a Versão 6.0.2.0, você precisa fazer o seguinte:
Technotes estão disponíveis abrangendo vários problemas importantes relacionados à instalação dos Toolkits do Message Broker e do Event Broker com os produtos RAD (Rational Application Developer) ou RSA (Rational Software Architect). É extremamente recomendado que você consulte esses Technotes ao instalar o Toolkit do Message Brokers. As informações sobre como acessá-los é fornecida na seção Suporte deste leia-me.
Quando você utiliza arquivos de resposta para instalação silenciosa, eles podem conter um sinalizador definido incorretamente. Como resultado, se você selecionar um ou mais componentes específicos para serem instalados (em vez do produto inteiro), as seleções serão ignoradas e o produto inteiro será instalado. Para superar este problema, você precisa editar o arquivo de resposta e modificar o sinalizador apropriado, como segue:
A seguinte linha:
-W setupTypes.selectedSetupTypeId=custom
deve ser alterada para:
-W setupTypes.selectedSetupTypeId=
(ou seja, definida como nada) a fim de evitar que instalações típicas ou customizadas padrão (que instalam todos os componentes) sejam executadas.
Se você desenvolve fluxos de mensagem que utilizam o WebSphere MQ Real-time Transport com suporte a Multicast PGM, é necessário instalar o WebSphere MQ Versão 6.0 ou posterior em cada sistema broker afetado. Também é necessário aplicar a APAR IC47032 e o USERMOD ANPGM01.
O Message Broker é suportado na zona Global ou em uma zona não global de raiz integral e deve ser instalado separadamente em cada um.
Se você tiver um ou mais componentes do WebSphere Message Broker já instalados em um computador e tentar instalar quaisquer componentes adicionais, o InstallShield irá verificar se há espaço em disco suficiente para instalar o produto inteiro e não apenas os componentes adicionais que você deseja instalar. Como resultado, você pode não conseguir instalar os componentes adicionais mesmo que haja espaço suficiente para eles no computador. Se houver espaço suficiente para instalar o produto inteiro, você pode instalar os componentes selecionados com êxito. Entretanto, se não houver espaço suficiente, você precisará desinstalar os componentes instalados anteriormente e iniciar novamente.
O Assistente do Assistente de Comandos não pode administrar atualmente os componentes do Gerenciador de Configuração. Uma correção será disponibilizada para retificar esse situação.
Se você desejar instalar os plug-ins do WebSphere MQ V6 Explorer para uso com o Toolkit do WebSphere Message Brokers, poderá utilizar o Eclipse Update Manager. No entanto, deverá primeiro instalar o pacote de atualização da V6.0.1 para o WebSphere MQ V6.
Na barra de ferramentas do Eclipse, selecione Ajuda > Atualizações de Software > Localizar e Instalar. Selecione a opção Novos Recursos. Inclua <diretório de instalação do WebSphere MQ>/eclipse como uma nova origem de local e os recursos do Explorer serão exibidos como disponíveis para instalação.
Como uma solução alternativa, antes da disponibilização da atualização da V6.0.1, você pode copiar manualmente os diretórios contendo os recursos e plug-ins do WebSphere MQ Explorer para o diretório do Toolkit do WebSphere Message Brokers. Após reiniciar o Toolkit do WebSphere Message Brokers, o WebSphere MQ Explorer pode então ser aberto como uma nova perspectiva.
Quando você utiliza o sinalizador -options-record para criar um arquivo de resposta para utilização durante uma desinstalação silenciosa, o arquivo de resposta contém um sinalizador incorretamente determinado. Como resultado, se você selecionar um ou mais componentes específicos para serem desinstalados (ao invés do produto inteiro), a opção é ignorada e o produto inteiro é desinstalado.
Para superar este problema, você precisa editar o arquivo de resposta e modificar cada linha que especifique se um componente individual deve ou não ser desinstalado. Isto significa que você precisa alterar todas as instâncias da seguinte cadeia:
-P feature.active=truepara o seguinte:
-P feature.activeForUninstall=trueem que feature é o nome do componente a ser desinstalado.
Você também precisa alterar todas as instâncias da seguinte cadeia:
-P feature.active=falsepara o seguinte:
-P feature.activeForUninstall=falseem que feature é o nome do componente que você não deseja desinstalar.
Você deve assegurar que uma dessas instruções (activeForUninstall=true ou ctiveForUninstall=false) exista para cada componente.
Entretanto, no arquivo de respostas gerado também pode haver instruções activeForUninstall relacionadas a componentes que não foram instalados. Se tais instruções existirem, certifique-se de que a opção activeForUninstall para cada um destes componentes seja configurada como true. Se a opção activeForUninstall estiver configurada como false para estes componentes, o programa de desinstalação falhará.
Todos os usuários das seguintes soluções para o Dublin Adapter devem entrar em contato com o Dublin Adapters Support (dubadsup@ie.ibm.com) para obter uma versão da solução que foi testada na Versão 6 do Message Broker. Não migre simplesmente a solução da Versão 5, porque isso poderá resultar em algumas diferenças sutis no comportamento da Versão 5:
Antes de tentar uma migração da solução para a Versão 6, todos os usuários das seguintes soluções para o Dublin Adapter devem entrar em contato com o Dublin Adapters Support (dubadsup@ie.ibm.com) para verificar se há uma versão disponível que tenha sido testada na Versão 6 do Message Broker e se há problemas adicionais:
Se você estiver migrando um conjunto de mensagens do WebSphere MQ Integrator Versão 2.1 e o conjunto de mensagens contiver um formato físico TDS padrão de mercado, como SWIFT, e se você pretende implementar o conjunto de mensagens em um intermediário da Versão 2.1 (ou em um intermediário da Versão 5 que está em um nível de serviço anterior ao Fix Pack 3), será preciso concluir as seguintes etapas após utilizar o comando mqsimigratemsgsets.
Se você não fizer essa atualização, a mensagem a seguir é exibida quando você incluir o conjunto de mensagens em um arquivo bar (CSD3 nessa mensagem refere-se ao Fix Pack 3):
BIP0202W Este dicionário requer um intermediário com versão 5 CSD3 ou superior. Formato TDS "SWIFT" utiliza "Verificação Numérica Precisa". Essa opção não é suportada por intermediários anteriores à versão 5 CSD 3.
Você deve corrigir esse erro antes de implementar o arquivo bar com êxito.
Ao utilizar o nó Real-timeInput com aplicativos de publicação/assinatura, ocorre uma possível fuga de memória no processo DataFlowEngine em todas as plataformas distribuídas. A memória utilizada pelo processo DataFlowEngine aumenta constantemente, dependendo da plataforma e do número de clientes de publicação/assinatura.
Se o processo DataFlowEngine ficar sem memória, ele pára. No Windows, um arquivo ABEND e um dump são gerados na pasta 'erros'. Em outros sistemas, são gerados um arquivo ABEND e um arquivo de núcleo. Então, o processo DataFlowEngine reinicia.
Por exemplo, ao utilizar um único fluxo de mensagens (sem instâncias adicionais) em um intermediário com um grupo de execução e 80 clientes de publicação/assinatura em um computador de 4 vias - 4 GB que executa o Windows, o processo DataFlowEngine parou depois de aproximadamente 1,5 horas.
Você provavelmente verá erros no registro de eventos do sistema, como:
Erro OutOfMemoryError de Java Virtual Machine. A JVM relatou uma situação OutOfMemoryError.
O arquivo ABEND poderá conter erros como:
Arquivo: F:\build\S000_P\src\DataFlowEngine\JavaNodeLibrary\ImbJmsIpJNIJmsIpNode.cpp Linha: 417 Função: Java_com_ibm_broker_server_JmsIpNode_logFatalError AbendAction: 3
Para resolver esse problema, poderá ser necessário parar e reiniciar o intermediário e aumentar o tamanho de Heap da Java Virtual Machine. Você poderá eliminar alguns problemas de memória se utilizar o nó Real-timeOptimizedFlow em vez do nó Real-timeInput.
Em plataformas z/OS: Se você incluir um nó Trace, com sua propriedade de destino definida para "Rastreio de Usuário", em um fluxo de mensagens de alto rendimento do processamento, o grupo de execução proprietário poderá parar (abend S2C1). Como os nós Trace estão sempre ativos, eles não devem ser normalmente incluídos nos fluxos de produção. Mas para evitar esse problema, assegure-se de que os nós Trace conectados não estejam incluídos em fluxos de alto rendimento do processamento, estando sempre ativos, esses nós terão um alto código extra de E/S.
Para que o nó de gerenciamento funcione com o analisador de domínio MIME, o mime_multipart.xsd ou o mime_nested_multipart.xsd, fornecido pelas Definições de Mensagens Fornecidas pela IBM dos Intermediários de Mensagens, deve ser utilizado.
Se você quiser utilizar o depurador de fluxo, os nomes de um intermediário e de um grupo de execução devem estar em caracteres do alfabeto inglês, qualquer que seja o código do idioma do computador.
No AIX, um gerenciador de fila do WebSphere MQ ativado para XA (no WebSphere MQ Versão 5) falha ao iniciar se não houver nenhum link de /usr/lib para a biblioteca cliente de 32 bits fornecida pela Oracle 'libclntsh.a'.
Para resolver esse problema, emita o seguinte comando (como raiz):
ln -s $ORACLE_HOME/lib32/libclntsh.a /usr/lib/libclntsh.a
Isso permite que o gerenciador de filas inicie corretamente.
Note que isso não se aplica ao WebSphere MQ Versão 6.
Se você tiver o Oracle9i ou o Oracle10g e o DB2v8 instalados no mesmo sistema HP-UX, poderá ter problemas ao utilizar o intermediário com um banco de dados do intermediário Oracle.
O intermediário é impedido de iniciar e um arquivo abend é criado. No arquivo você vê símbolos das bibliotecas Oracle resolvidos em uma biblioteca DB2, causando a uma violação de segmentação.
Se você desejar utilizar o Oracle com o intermediário e tiver o DB2 instalado no mesmo computador (HP-UX), desative o arquivo <diretório_de_instalação>/lib/imbdfdb2.lil. A forma mais fácil de fazer isso é renomear imbdfdb2.lil para algo diferente. Isso impede o intermediário de obter bibliotecas DB2 que o sistema operacional HP-UX então utiliza para resolver os símbolos Oracle.
O Oracle XA não é suportado com EGs de 64 bits no AIX, Solaris e HP-UX.
A manipulação de dados Unicode nos banco de dados não é suportada.
Além das restrições descritas no tópico "Bancos de Dados Suportados" no centro de informações, note que apenas o Informix Dynamic Server de 32 bits e o SDK Cliente de 32 bits são suportados. Atualmente, não há suporte para o servidor ou cliente Informix de 64 bits.
A versão mínima exigida do cliente Informix é SDK V2.90 com o fix pack UC4X8; entre em contato com a Informix para solicitar esse fix pack.
No tópico do centro de informações que descreve a função ROUND, os exemplos mostram um caractere de sublinhado entre MODE e RoundingMode, que está incorreto. Um caractere de sublinhado deve ser substituído por um espaço. Por exemplo:
ROUND(5.5, 0 MODE_ROUND_UP); returns 6está incorreto, e a forma correta é:
ROUND(5.5, 0 MODE ROUND_UP); returns 6
No Linux e no Windows, algumas das amostras possuem problemas pequenos de usabilidade. Antes de utilizá-las, consulte a
seguinte Technote:
http://www.ibm.com/support/docview.wss?rs=849&context=SSKM8N&context=SSKMAB&q1=samples&uid=swg21239255&loc=en_US&cs=utf-8&lang=en
Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos.
É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação em outros países. Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. No entanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente.
A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:
Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:
O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local:
A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE NÃO-INFRAÇÃO, DE MERCADO OU DE ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar ao Cliente.
Estas informações podem conter imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio.
Referências nestas informações a Web sites não-IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais contidos nesses Web sites não fazem parte dos materiais deste produto IBM e a utilização desses Web sites é de inteira responsabilidade do Cliente.
A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente.
Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:
Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa.
O programa licenciado descrito neste documento e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato de Licença do Programa Internacional IBM ou qualquer outro contrato equivalente.
As informações relativas a produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou estes produtos e não pode confirmar a precisão de seu desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não-IBM. Dúvidas sobre os recursos de produtos não-IBM devem ser encaminhadas diretamente a seus fornecedores.
Estas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos esses nomes são fictícios e qualquer semelhança com os nomes e endereços utilizados por uma empresa real é mera coincidência.
LICENÇA DE COPYRIGHT:
Estas informações contêm programas de aplicativos de exemplo na linguagem fonte, ilustrando as técnicas de programação em diversas plataformas operacionais. Você pode copiar, modificar e distribuir estes programas de exemplo sem a necessidade de pagar à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com a interface de programação de aplicativo para a plataforma operacional para a qual os programas de exemplo são criados. Esses exemplos não foram testados completamente em todas as condições. Portanto, a IBM não pode garantir ou implicar a confiabilidade, manutenção ou função destes programas. Você pode copiar, modificar e distribuir estes programas de exemplo de qualquer maneira sem pagamento à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com interfaces de programação de aplicativos da IBM.
Os termos a seguir são marcas registradas da International Business Machines Corporation
nos Estados Unidos e/ou em outros países:
AIX, DB2, Everyplace, IBM, Universal Database, WebSphere, z/OS, zSeries.
Java e todas as marcas registradas baseadas em Java são marcas registradas da Sun Microsystems,
Inc. nos Estados Unidos e/ou em outros países.
Microsoft e Windows são marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.
UNIX é uma marca registrada da The Open Group nos Estados Unidos e em outros países.
Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou em outros países.
Outros nomes de empresas, produtos e serviços podem ser marcas
registradas ou marcas de serviço de terceiros.
Fix Packs do DB2
Você pode obter Fix Packs do DB2 em CD-Rom ou fazendo o download a partir da Web. Observe, contudo, que os Fix Packs podem ser grandes e, portanto, solicitar versões em CD-Rom evitará downloads demorados.
Se você tiver um contrato de suporte atual, poderá pedir os Fix Packs do DB2 em CD-Rom ligando para o suporte do DB2.
Detalhes para contato são fornecidos no endereço:
http://www.ibm.com/software/data/db2/udb/support.html
A partir do mesmo Web site é possível fazer download dos
Fix Packs do WebSphere MQ
http://www.ibm.com/software/integration/wmq/support/
Fix Packs do WebSphere Message Brokers
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367
Requisitos do WebSphere Message Broker e do WebSphere Event Broker
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
e
http://www.ibm.com/software/integration/wbieventbroker/requirements/
Leia-me do WebSphere Message Broker e do WebSphere
Event Broker
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
Information Center Independente do WebSphere Message Broker e do WebSphere Event Broker
Para Linux:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_lin.tgz
Para o Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip
Ajuda On-line do WebSphere Message Brokers V6
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r0m0/index.jsp
Centro IBM para Downloads de
Desenvolvimento de Tecnologia Java
http://www.ibm.com/developerworks/java/jdk/
WSDL (Web Services Description Language) Specification
http://www.w3.org/TR/wsdl
WebSphere Message Broker Basics (Redbook)
http://www.redbooks.ibm.com/abstracts/sg247137.html
Migrating to WebSphere Message Broker V6 (Redbook)
http://www.redbooks.ibm.com/abstracts/sg247198.html