Bem-vindo ao IBM WebSphere Message Broker. Este é o arquivo leia-me para a Versão 6.1.0.3 das ferramentas e componentes de tempo de execução.
Este readme descreve problemas conhecidos e contém atualizações para o nível disponível da documentação do produto.
Sempre use a versão mais recente deste
arquivo leia-me, que fica disponível apenas em inglês em:
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
Arquivos leia-me
traduzidos ficam disponíveis em:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/
Para completar a instalação, consulte o WebSphere Message Broker Installation Guide. Ele inclui informações sobre as tarefas que você deve executar antes de instalar o produto.
Se estiver aplicando o serviço V6.1.0.3 ao kit de ferramentas do intermediário de mensagens, consulte o Guia de Instalação para instruções sobre este processo para garantir que o processo seja completado corretamente.
Acesse o Guia de Instalação on-line no IBM Publications Center em:
http://publib.boulder.ibm.com/epubs/pdf/c3468662.pdf
Um documento descrevendo problemas específicos de migração que foram relatados através do Suporte IBM que é constantemente atualizado Web site de Suporte do Intermediário de Mensagens Websphere em: http://www.ibm.com/software/integration/wbimessagebroker/support/. Clique em Resolução de problemas > Ver todos os documentos de Resolução de problemas e procure por um documento chamdo "Problemas e soluções ao migrar para o Intermediário de Mensagem WebSphere 6.0 e 6.1".
O Centro de Informações independente para o Intermediário de Mensagem WebSphere é fornecido no CD Início Rápido, e também pode ser acessado on-line em: http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp
Também
está disponível para download em:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz (versão Linux®)
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip
(versão Windows®)
Leia o arquivo quickstart_welcome.html, que está incluído na pasta ibm_help nos arquivos wmb_help_linux.tgz e wmb_help_win.zip.
Uma compilação de tópicos de informação em
Portable Document Format (.pdf) pode ser encontrado em:
http://www.ibm.com/software/integration/wbimessagebroker/library/
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 informações atuais
sobre problemas conhecidos e correções disponíveis, vá até o Web site de suporte do Intermediário de Mensagem Websphere em:
http://www.ibm.com/software/integration/wbimessagebroker/support/
Para
encontrar informações:
Todas as Notas Técnicas relevantes são exibidas e podem ser pedidas e procuradas mais adiante.
Para obter informações sobre o download das imagens de instalação
do WebSphere Message Broker Versão 6.1 no Web site do Passport
Advantage®, consulte o documento para download Passport
Advantage downloads para WebSphere Message Broker V6.1, que está
disponível em:
http://www.ibm.com/support/docview.wss?rs=849&uid=swg24017456
Versões: Para saber o status mais recente em que
determinadas versões de sistemas operacionais e bancos de dados são
suportadas pelo WebSphere Message Broker, consulte a página
Requisitos do sistema em:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Esta seção destaca as restrições e limitações do WebSphere Message Broker, por componente.
Ao criar o caminho da instalação, certifique-se de que o comprimento do caminho não exceda o comprimento máximo de caracteres do seu sistema. (Por exemplo; o Windows permite no máximo 256 caracteres).
Instalações do Intermediário de Mensagem WebSphere versão 6.1.0.2 ou inferior no Windows Vista ou Windows Server 2008 não funcionam corretamente e criam elementos anormais no sistema de arquivos registro o que pode exigir remoção manual.
Solução:
Instale o Intermediário de Mensagem WebSphere Fix Pack 3 que é suportado no Windows Vista e Windows Server 2008.
Se você escolher instalar os componentes de tempo de execução silenciosamente e gerar um modelo ou gravar um arquivo de resposta, os exemplos no Guia de Instalação, Capítulo 7 "Escolhendo uma Interface de Instalação" na página 79, estarão incorretos. Para registrar um arquivo de resposta entre com:
installer
-options-record responsefile.
Para gerar um modelo, entre com
installer -options-template responsefile.
Os comandos correspondentes na tabela 13, na página 80, também estão incorretos; você não deve incluir um espaço entre -options e -record ou -template.
Ao usar o assistente de extração do Windows para extrair os arquivos comprimidos do Intermediário de Mensagem Websphere v6.1 transferido por download pelo Web site do Passport Advantage Xtreme Leverage, especificando um longo caminho de diretório para extrair os arquivos pode causar o aparecimento de uma mensagem de senha.
Se extrair um arquivo em um diretório com um caminho muito longo, o tamanho do caminho pode ser grande demais para o assistente de extração do Windows processar, e ao invés de receber uma mensagem de erro, uma janela abre com uma mensagem solicitando uma senha. Por exemplo, "Senha Requerida Arquivo 'DB2CS_NewCLRProcWizard...' está protegido por senha. Digite a senha na caixa abaixo". Esta mensagem é errônea e pode se repetir por vários arquivos.
Solução:
Extraia o arquivo em um local com um caminho de diretório curto, tal como C:\temp\dbimage.
Após implementar um fluxo de mensagens e iniciar um intermediário, é possível ver os seguintes sintomas:
BIP2060W: O intermediário detectou que o Grupo de
Execução <insert_1>, ID do processo <insert_2>, foi encerrado.
BIP2227E:
Erro encontrado durante processo de encerramento de forma anormal: <insert_1> - finalizando.
Além disso, o comando mqsistart pode não iniciar o intermediário, e o syslog pode conter a seguinte mensagem de erro:
BIP8893E:
Falha na verificação. Não foi possível acessar o arquivo '/var/mqsi/components/AIX53_BK/bipcvp_javaversion.tmp'
com o ID do usuário <insert_2>.
Estes problemas podem ocorrer se o nível do conjunto de arquivos bos.rte.libc do AIX V5.3 é inferior a 5.3.0.52.
Solução:
Para superar esse problema, faça o upgrade do conjunto de arquivos bos.rte.libc a um nível mínimo de 5.3.0.52. A Versão 5.3.0.52 está disponível no AIX versão 5.3 TL05 SP2.
Ao migrar um componente de tempo de execução a partir das versões 5.0 ou 6.0 para versão 6.1 no mesmo computador, abra uma nova estrutura antes de executar o mqsiprofile para configurar seu ambiente de comando.
Migração para z/OS requer IC54505. O IC54505 está incluído no Fix Pack 2.
Nas versões 5.0 e 6.0, você pode obter um conjunto de mensagens contendo ambos os modelos MRM e não-MRM com o conjunto de mensagens de propriedade Message Domain configurado para algo que não seja 'MRM' ou 'IDOC' e gerar um arquivo .dictionary quando o conjunto de mensagens for incluído a um arquivo BAR, não obstante a configuração do Message Domain.
Na versão 6.1, um dicionário é gerado somente se Message Domain for 'MRM' ou 'IDOC'.
Solução:
Selecione a caixa de opção MRM abaixo do conjunto de mensagens da propriedade suportada dos domínios de mensagem.
Quando você tenta iniciar o Toolkit, um erro "JVM terminated Exit Code = 1" é exibido ou o processo javaw.exe utiliza 100% da CPU e pára.
O problema pode ser devido ao -Xshareclasses:singleJVM, mantenha o comutador no arquivo eclipse.ini. Esse comutador cria um cache que fornece um meio de compartilhar todas as classes carregadas e não faz nenhuma restrição sobre as JVMs que estão compartilhando os dados da classe. Se o cache for corrompido, nenhuma conexão de JVM nova ao cache será permitida. JVMs existentes podem continuar funcionando, mas não podem atualizar o cache.
Solução:
Para resolver o problema, exclua o cache corrompido. O cache é reconstruído na próxima vez em que o produto for ativado. Para excluir o cache:
1. Abra um prompt de comandos.
2. Navegue para Diretório do Message Broker Toolkit/jdk/jre/bin
3. Digite o seguinte comando:
No Microsoft Windows:
javaw.exe -Xshareclasses:destruir
No Linux:
./javaw -Xshareclasses:destruir
O produto iniciará com êxito agora.
Se você precisa atualizar pacotes que foram originalmente instalados utilizando o IBM Installation Manager, será necessário, também, atualizá-los utilizando o IBM Installation Manager. Embora você possa utilizar o Gerenciador de Atualização Eclipse para instalar plug-ins não-IBM, é importante que você não utilize o Gerenciador de Atualização Eclipse para atualizar recursos do Eclipse e plug-ins que foram originalmente instalados utilizando o IBM Installation Manager. Quando você incluir plug-ins utilizando o Gerenciador de Atualização Eclipse, certifique-se de instalá-los no diretório do grupo de pacote e não no diretório de recursos compartilhados (que é gerenciado pelo IBM Installation Manager e é reservado).
Quando vários produtos foram instalados como parte de um grupo de pacotes, o painel exibido quando o programa está iniciando (que, às vezes, é chamado de "tela inicial") depende de qual produto no grupo de pacotes foi instalado primeiro. Por exemplo, se você instalou o Rational® Application Developer (RAD), depois o WebSphere Message Broker e depois o WebSphere Integration Developer (WID), o painel de inicialização para o RAD será exibido quando qualquer um dos três programas estiver sendo iniciado.
Formatar um arquivo WSDL ou XSD de uma determinada forma pode causar problemas no projeto resultante após importação.
Sintomas:
1. Um ou mais elementos no arquivo original WSDL ou XSD pode não aparecer no arquivo de definição de mensagem que é criado quando o arquivo WSDL ou XSD é importado, resultando em erros de validação do tempo de execução.
2. No momento do desenvolvimento, erros aparecem quando um recurso 'Deployable WSDL' é validado. Exemplo de erro; "Um Conjunto de mensagens não pode conter duas declarações elementos globais com o mesmo nome e espaço de nomes (destino ou camaleão)".
Solução:
Se encontrar qualquer resultado inesperado após importar recursos WSDL ou Esquema em um conjunto de mensagens, limpe ou formate o arquivo. Complete as etapas seguintes para limpar ou formatar o arquivo:
1. Copie o arquivo WSDL ou XSD no espaço de trabalho. Não importe o arquivo no espaço de trabalho.
2. Abra o arquivo WSDL ou XSD no editor, e clique em Formatar > Documento que está localizado na opção Origem no menu principal do ambiente de trabalho ou clique em Limpar Documento.
3. Salve o arquivo modificado.
4. Importe arquivo modificado.
O arquivo será importado com sucesso agora.
No Windows, os itens de menu "Iniciar Ajuda" e "Parar Ajuda" em Iniciar->Arquivos de Programa estão faltando.
Se você importar definições do WSDL ou do XSD, poderá encontrar erros na validade do arquivo para certas codificações de arquivos, tais como: EBCDIC-CP-US. Para importar essas definições com sucesso, atualize o atributo de codificação dentro do arquivo XML para a codificação do sistema (por exemplo: UTF-8).
O Windows .NET Server Web Services Security X509 não é suportado com o WebSphere Message Broker Versão 6.1. Todos os outros recursos do WebSphere Message Broker Web Services com Windows .NET são totalmente suportados, especificamente tokens USERNAME para Web Services Security.
O uso do Mecanismo de Otimização de Transmissão de Mensagem (MTOM) em anexos maiores em tamanho que 16KB não é suportado.
O nó Coletor pode causar encerramentos de forma anormal que são resolvidos em IC54505. O IC54505 está incluído no Fix Pack 2.
Ao usar o analisador XMLNSC para determinar o fim da mensagem na entrada TCP/IP nós de recebimento, o analisador XMLNSC encontrará o fim da mensagem apenas se o próximo documento XML apareça no fluxo de bits, ou se o final do fluxo de bits for visto pelo analisador XMLNSC. Se isso não acontecer, uma exceção de tempo limite é exibida.
Para
superar isso, configure a propriedade de detecção de registro para Delimitado,
e adicione um caractere nulo ao fluxo de bits.
Os nós TCP/IP no Solaris x86-64 não processam dados e podem recusar conexões. Se tiver um destes problemas, ajuste o rlim_fd_max e rlim_fd_cur para 8193 ou menor.
Os nós JMS no z/OS não suportam as transações coordenadas até IC54505. O IC54505 está incluído no Fix Pack 2.
Intermediário de Mensagem WebSphere V6.1 Fix Pack 1 nós EndpointLookup e RegistryLookup podem ser usados como serviço de acesso de metadados que residem no WebSphere Service Registry and Repository (WSRR) versão 6.0.2 ou versão 6.1. Entretanto, a nova funcionalidade introduzida no WSRR versão 6.1, tal como referenciar Terminais MQ dentro do WSDL e acessar objetos e elementos modelados, não está suportada atualmente.
O WSRR (WebSphere Service Registry and Repository) versão 6.1 é suportado. Versões anteriores do WSRR não são suportadas.
Para migrar do link do MQ para SAP R/3 para o Message Broker V6.1 você necessita do IC54505. O IC54505 está incluído no Fix Pack 2.
JDBC/XA transações globalmente coordenadas ('XA') não são suportadas com conexão com o banco de dados JDBC.
Transações globalmente coordenadas ('XA') não são suportadas.
Procedimentos armazenados não são suportados.
A manipulação de dados Unicode nos bancos de dados não é suportada.
Se tiver instalado o Intermediário de Mensagem Websphere 6.1.0.2 (ou menor) no HP-UX no PA-RISC, é preciso usar o DataDirect Connect (ou DataDirect Connect64) para Drivers ODBC (DD) V5.0 para configurar Conexões ODBC aos bancos de dados. Os tópicos do Centro de Informações sobre o DD V5.3, que não é suportado nesta plataforma.
Antes de iniciar a configuração de uma conexão ODBC para um banco de dados intermediário ou um banco de dados do usuário, leia a nota técnica “Configurando as conexões banco de dados ODBC para o Intermediário de Mensagem Websphere V6.1 no HP-UX (plataforma PA-RISC)” em: http://www.ibm.com/support/docview.wss?rs=0&context;=SSMKUK&uid=swg21305099. Este documento fornece informações detalhadas sobre como definir conexões e configurar coordenações globais de transações usando os drivers DD V5.0. Nenhuma outra plataforma é afetada com esta alteração.
Transações globalmente coordenadas ('XA') não são suportadas.
Se um procedimento armazenado DB2 Versão 9 que tem parâmetros do tipo 'REAL' é executado com um banco de dados DB2 que está em um sistema z/OS, a chamada falha com um erro DB2 "CLI0111E valor numérico fora de alcance. SQLSTATE=22003".
Solução:
Instale as seguintes versões mínimas do DB2:
Para o DB2 V9.1: Fix Pack 6 com APAR IZ23102.
Para o DB2 V9.5: Fix Pack 2 com APAR IZ23103.
Se criou anteriormente um intermediário que use um banco de dados Sybase como o banco de dados de intermediário, e quiser fazer o upgrade para o Intermediário de Mensagem V6.1.0.2, o intermediário e o banco de dados de intermediário podem encontrar problemas ao iniciar o intermediário.
Para superar isso, execute os seguintes comandos após ter migrado, e antes de iniciar o intermediário.
isql -Umqsiuid -Pmqsipw
Se tiver autorizado outro ID do usuário e senha para o acesso
ao intermediário para o banco de dados, substitua seus valores por mqsiuid e mqsipw no
comando correspondente.
use WBRKBKDB
Se criou seu banco de dados de intermediário com um nome diferente, substitua o nome de seu banco de dados de intermediário por WBRKBKDB naquele comando.
go
alter table BROKERAA
modify MsgId NOT NULL
modify ReplyToQ NOT NULL
go
alter table BROKERAAEG
modify MsgId NOT NULL
modify CntlMsgId NOT NULL
go
alter table BSUBSCRIPTIONS
modify Expiration NOT NULL
modify Creation NOT NULL
go
alter table BMQPSTOPOLOGY
modify Migrated NOT NULL
go
alter table BACLENTRIES
modify QopLevel NOT NULL
go
alter table BMULTICASTTOPICS
modify GroupAddress NOT NULL
go
alter table BAGGREGATE
modify ReplyGroupId NOT NULL
go
A amostra não é suportada até IC54505. O IC54505 está incluído no Fix Pack 2.
A amostra não é suportada até IC54505. O IC54505 está incluído no Fix Pack 2.
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 os 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, ou outros direitos legalmente protegidos, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de inteira 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 consultas sobre licença relacionadas a informações de DBCS (conjunto de caracteres de byte duplo), entre em contato com o IBM Intellectual Property Department em sua empresa ou envie consultas 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 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 incluir 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 que não sejam da IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a estes 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 do desempenho, da compatibilidade ou de 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 incluem 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 de origem, ilustrando as técnicas de programação em diversas plataformas operacionais. É possível 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 aplicativos da plataforma operacional para a qual os programas de exemplo são criados. Estes 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, developerWorks,
IBM, Passport Advantage, Rational, WebSphere, z/OS.
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
É
possível obter DB2 Fix Packs em CD ou fazendo o download na Web. Observe que,
no entanto, os Fix Packs podem ser grandes e requisitar versões em CD
evitará longos downloads.
Se tiver um contrato de suporte,
é possível pedir os DB2 Fix Packs em CD contatando o suporte 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
Broker
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367
Requisitos do WebSphere Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Leia-me do WebSphere Message
Broker
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
Centro de Informações Independente do
WebSphere Message Broker
Para Linux:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz
Para o Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip
Centro de informações on-line do WebSphere Message Broker V6.1
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp
IBM Centre para Java™ Technology
Development Downloads
http://www.ibm.com/developerworks/java/jdk/
WSDL (Web Services Description Language) Specification
http://www.w3.org/TR/wsdl
WebSphere Message Broker
developerWorks® Zone
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html