Notas sobre o Release para o IBM WebSphere Business Integration Server Express, Versão 4.3.1, para Linux

Estas notas sobre o release informam a respeito do IBM(R) WebSphere(R) Business Integration Server Express, Versão 4.3.1, para Linux(TM) e contêm as seguintes seções:
Visão Geral Informações sobre Desinstalação
Requisitos de Hardware e Software Problemas Conhecidos e Soluções Alternativas
Informações sobre Instalação e Configuração Documentações

Nota: Informações importantes sobre este produto podem estar disponíveis nos Technical Support Flashes emitidos após a publicação destas notas sobre o release. Estes podem ser localizados no Web site de suporte do WebSphere Business Integration, http://www.ibm.com/software/integration/wbiserverexpress/support. Escolha a área de componentes de interesse e pesquise a seção de boletins.

Visão Geral

O IBM WebSphere Business Integration Server Express e o IBM WebSphere Business Integration Server Express Plus incluem os seguintes componentes:

Além do suporte existente para Windows(R) 2000, este release inclui suporte para o InterChange Server Express nos seguintes sistemas operacionais:

Requisitos de Hardware e Software

Os requisitos de hardware e software estão inclusos na documentação do produto. Consulte Informações sobre instalação, migração, atualização e configuração para obter links para esses guias.

Informações sobre Instalação e Configuração

Se você estiver instalando o software a partir do CD ou fazendo download a partir do Passport Advantage e instalando-o a partir de um diretório local, consulte a publicação WebSphere Business Integration Server Express Installation Guide for Linux.

Nota: Se você estiver instalando os adaptadores de tecnologia e adaptadores de aplicativos na mesma máquina, instale os adaptadores de tecnologia primeiro, através do Server Express Plus, depois instale cada adaptador de aplicativos através do instalador Pacote de Capacidade do Adaptador.

Problemas Conhecidos e Soluções Alternativas

Os seguintes problemas foram encontrados neste release:

Nome do Componente Número de Rastreio Descrição
Editor de Atividade 42343 No Editor de Atividade, você pode selecionar a partir de uma lista de variáveis globais na Janela Biblioteca para utilizar em uma atividade personalizada. Variáveis globais podem ser simples como uma variável Java (por exemplo, do tipo String) ou podem ser sofisticadas como uma variável de objeto (por exemplo, do tipo BusObj). Quando uma variável global é utilizada em uma atividade, sua designação ocorre apenas no final da atividade, portanto você deve evitar o uso de variáveis separadas que possuam as mesmas variáveis raiz em uma atividade.

Ao invés disso, você pode realizar duas subatividades em ações diferentes. Se precisar utilizar variáveis com a mesma raiz, tente reutilizar a variável com raiz única.

Adaptadores 43586 A propriedade AgentTraceLevel de um conector sendo executado através do transporte de entrega JMS e utilizando uma configuração de conector local (especificada através da opção de linha de comandos -c) pode ser atualizada dinamicamente somente uma vez através do System Manager durante a existência do conector. Tentativas subseqüentes de atualizar essa propriedade irão falhar. Uma mensagem parecida com a seguinte será mostrada nos logs:

[Tipo: Aviso] [ID da Msg: 14211] [Msg: Atualização dinâmica não é permitida para AgentTraceLevel. No arquivo de configuração, o valor já estava definido para o agente de conector e o valor definido anteriormente será utilizado.]

A propriedade AgentTraceLevel para um conector sendo executado através do transporte de entrega JMS e utilizando uma configuração de conector local não deve ser atualizada dinamicamente através do System Manager. Se a propriedade precisar ser modificada, você deve atualizar o arquivo de configuração do conector e reiniciar o agente do conector. Caso contrário, o erro que acaba de ser descrito será encontrado e uma incompatibilidade entre a definição do controlador do conector e a definição do agente do conector poderá ocorrer.
Adaptador para JDBC 43503 Ao utilizar o ODA para gerar um objeto de negócios a partir de um servidor de banco de dados DB2 sendo executado no Linux, o Business Object Designer será interrompido. Isso ocorre porque o DB2 JDBC Applet Server não é iniciado.

Para solucionar esse problema, efetue login no servidor DB2 e execute o seguinte comando: db2jstrt LISTENPORT.

Adaptador para JDBC e Adaptador para Aplicativos Oracle 43246 O script inicial do OracleAppsODA inclui o arquivo xworacle.jar no DRIVERPATH, que não lista todas as tabelas no banco de dados Oracle da maneira esperada. Se você quiser listar todas as tabelas do banco de dados, pode solucionar esse problema utilizando o arquivo driver-classes12.zip JDBC nativo fornecido pelo Oracle. Defina o caminho do driver apropriadamente nos scripts iniciais de acordo com as instruções no guia do usuário do adaptador.
Adaptador para JMS e Adaptador para WebSphere MQ 37094 Durante o processamento de uma mensagem duvidosa (do InProgressQueue) que foi originada em uma das várias filas de entrada configuradas, o adaptador recupera as propriedades de conversão com base na primeira fila de entrada das propriedades específicas do conector.
Adaptador para JMS 36438 Há distinção entre maiúsculas e minúsculas nos nomes de propriedades de conversão das informações específicas de aplicativos do metaobjeto de configuração e dos nomes de metaobjetos dinâmicos.
Adaptador para JMS 36128 A inicialização do adaptador falha quando a propriedade InputQueue não está configurada.
Adaptador para JMS e Adaptador para WebSphere MQ 34323 As amostras dos adaptadores JMS e WebSphere MQ foram projetadas para oferecer configuração e uso dos adaptadores em um ambiente WebSphere InterChange Server Express. As instruções para utilização dessas amostras são fornecidas nas technotes que descrevem como você pode utilizar as amostras para enviar e receber objetos de negócios em um ambiente WebSphere Business Integration Server Express.

A technote do adaptador JMS pode ser encontrada no seguinte local:
http://www-1.ibm.com/support/docview.wss?rs=0&q1=JMS+adapter&uid=swg21174512&loc=en_US&cs=utf-8&cc=us&lang=en
A technote do adaptador WebSphere MQ está disponível no seguinte local:
http://www-1.ibm.com/support/docview.wss?rs=0&q1=WebSphereMQ+adapter&uid=swg21174510&loc=en_US&cs=utf-8&cc=us&lang=en
Adaptador para JMS e Adaptador para WebSphere MQ 33728 Durante o processamento de eventos, quando várias propriedades de conversão correspondem ao InputFormat e/ou ao InputQueue de uma mensagem de entrada, o adaptador tenta utilizar incorretamente o último atributo de objeto de negócios correspondente em um metaobjeto estático como o mapa para a mensagem de entrada. Nesses casos, o adaptador deve passar o conteúdo da mensagem para a rotina de tratamento de dados para permitir que ela determine o nome do objeto de negócios.

Para solucionar esse problema, configure as chaves InputFormat e InputQueue de cada um dos atributos BusinessObjectType_verb do metaobjeto estático.

Adaptador para JText 46499 Se mais de um arquivo corresponder à máscara de evento do MVS PDS e o FTPRenameExt for especificado o conector arquiva apenas um arquivo e não é capaz de renomear e arquivar um segundo arquivo. Para solucionar esse problema, especifique tanto FTPArchiveDir quanto FTPRenameExt em branco, para que o arquivo de eventos MVS seja excluído sem ser renomeado.
Adaptador para JText 43454 Quando o adaptador JText estiver em poll com o atributo EventExt do MO_JTextConnector_Default do metaobjeto de configuração em branco, o polling falha e o adaptador é desligado.
Adaptador para JText 35571 Uma provisão para especificar 'EOF' como um valor para EndBODelimiter no modo de processamento binário é requerida.
Para solucionar esse problema, para todos os arquivos que não possuam um EndBODelimiter diferente do próprio EOF, utilize um editor Hex para incluir alguns bytes (por exemplo, FF02) como o delimitador e especifique os bytes como o EndBODelimiter.
Adaptador para JText 34834 Suporte para FTP seguro é requerido pelo JText. O campo de senha, visível para o administrador do sistema JText agora, não estaria visível para qualquer pessoa com FTP Seguro.
Adaptador para WebSphere Commerce 42516 Quando o WebSphere Commerce, Business Edition, Versão 5.5 com Fix Pack 4 (ou versão anterior) for utilizado no servidor de comércio, o usuário da loja não pode ser criado apropriadamente com o adaptador WebSphere Commerce. O usuário da loja não pode efetuar logon na loja devido a uma autoridade incorreta. Uma efix do Websphere Commerce é requerida para corrigir este problema. A efix é JR20090 no WebSphere Commerce 5.5 com Fix Pack 4.
Adaptador para WebSphere MQ 34969 Durante o processamento de eventos síncrono, uma mensagem de relatório não é enviada para erros da rotina de tratamento de dados.
DB2(R) Enterprise no Windows 35380 O DB2 Enterprise não reinicia o gerenciador de banco de dados quando o Windows é reiniciado. Como o gerenciador de banco de dados não é executado, dois problemas podem ocorrer se o Windows for reiniciado durante a instalação do WebSphere Business Integration Server Express ou Express Plus:
  • A criação do repositório pode falhar. Quando isto ocorre, o log do Instalador inclui a seguinte linha de mensagem:
    Nenhum comando de início do gerenciador de banco de dados foi emitido.
  • A inicialização do InterChange Server Express pode falhar, porque sem a execução do gerenciador de banco de dados, o InterChange Server Express não pode se conectar ao SMB_DB. Quando isto ocorre, as mensagens do arquivo de log do InterchangeSystem incluem a seguinte linha:
    Nenhum comando de início do gerenciador de banco de dados foi emitido.

Você pode tratar esses problemas executando as seguintes etapas:

  1. Abra o Centro de Controle do DB2.
  2. Expanda a pasta Todos os Sistemas Catalogados e expanda a pasta de seu host e depois a pasta Instâncias.
  3. Na pasta Instâncias, clique com o botão direito no ícone DB2 e clique em Iniciar.
    A seguinte mensagem do DB2 é exibida:
    O processamento DB2START obteve êxito.

Quando você tiver concluído essas etapas, poderá criar um repositório e iniciar com êxito o InterChange Server Express.

Desinstaladores do DB2 Enterprise e do DB2 Express no Windows 35380 Se o DB2 Enterprise ou o DB2 Express e o WebSphere Business Integration Server Express ou Express Plus tiverem sido anteriormente instalados e desinstalados, a criação do repositório falha durante a nova instalação do WebSphere Business Integration Server Express ou Express Plus. Isso ocorre porque o processo de desinstalação do DB2 Enterprise e do DB2 Express não remove os aliases de bancos de dados do diretório C:\DB2\aliases_directory.

Portanto, o alias do repositório do InterChange Server Express denominado SMB_DB, que é criado durante a instalação original do WebSphere Business Integration Server Express ou do Express Plus, permanece após a desinstalação do DB2. Embora a existência desse alias não afete a reinstalação do DB2 Enterprise ou do DB2 Express, quando o WebSphere Business Integration Server Express ou Express Plus for reinstalado, a criação do repositório irá falhar porque o sistema encontra o alias SMB_DB antigo.

Para solucionar esse problema, exclua manualmente o banco de dados SMB_DB antes de desinstalar e reinstalar o DB2 Enterprise ou o DB2 Express. A exclusão do banco de dados real elimina seu alias.

Documentação 44024 WebSphere Business Integration Server Express Installation Guide for Linux
Na seção "Configuring System Monitor and Failed Event Manager when using a Web server," o campo de exemplo está incorreto. Ele deveria parecer da seguinte maneira:
Home_directory/IBM/WebSphereServer/CWDashboard.sh \
"/opt/IBM/WebSphere/Express502/AppServer" \
hostname.ibm.com "Home_directory/IBM/WebSphereServer" \
"DB2_Installation_Dir/java" y
Documentação 44025 WebSphere Business Integration Server Express Installation Guide for Linux
Na seção "Viewing WebSphere Business Integration Server Express and Express Plus files and directories," falta uma entrada de tabela. Além dos "logs" da entrada, deveria haver uma entrada denominada "log" com a seguinte descrição: "This directory includes several log files related to product installation and uninstallation, such as installer logs for the InterChange Server Express
(wbi_server_exp_install_log.txt), the Adapter Capacity Pack (adapterCPInstallLog.txt), and the Collaboration Capacity Pack (collabCPInstallLog.txt)."
Uma correção semelhante precisa ser feita na seção "Installing WebSphere Business Integration Server Express and Express Plus using the GUI." A sentença final no segundo parágrafo após o procedimento de instalação deveria ser da seguinte maneira: "The log file called wbi_server_exp_install_log.txt, which details the installation process, is located in the directory ProductDir/log."
Documentação 44026 WebSphere Business Integration Server Express Installation Guide for Linux Na seção "Installing WebSphere Business Integration Server Express and Express Plus using the GUI," na lista com marcadores que segue o procedimento de instalação há um marcador com a seguinte informação: "Added a new system variable called LD_ASSUME_KERNEL to the /etc/profile file and set its value to 2.4.19." O instalador cria a variável de sistema apenas em sistemas Red Hat Linux; ele não a cria em sistemas SuSE Linux.
Documentação O guia Data Handler Guide faz referência de maneira incorreta e oferece documentação para a rotina de tratamento de dados do host. A rotina de tratamento de dados do host binário não está incluída no produto.
Documentação O guia do MetaSolv Adapter deve informar que o Metasolv Adapter agora suporta PSR (Product Service Request) e LSR (Local Service Request).
Documentação Em todos os guias, a seção "New in this release" deve conter o seguinte:
Além do suporte existente para Windows 2000, esse release inclui suporte para o InterChange Server Express nos seguintes sistemas operacionais:
  • IBM OS/400 V5R2, V5R3
  • Red Hat Enterprise AS Linux 3.0, Atualização 1
  • SuSE Linux Enterprise Server 8.1 com SP3
  • Microsoft Windows 2003
Documentação No Quick Start Guide, o caminho a seguir, que está localizado na etapa 1 da seção "Starting InterChange Server Express" do capítulo "Validating your Linux installation", está incorreto: $cd /home/USER/IBM/WebSphereICS/bin

O caminho correto é: $cd/home/USER/IBM/WebSphereServer/bin ou $cd/ProductDir/bin

As seguintes informações que explicam sobre o caminho também foram incluídas nesta seção.

Notes: In the scripts shown above:
"$" is the Linux command line prompt
"cd" is a command used to change directories
"bin" is a folder within the product installation directory
Instalador (Pacote de Capacidade do Adaptador) 44001 Quando você realiza uma instalação remota ou local do Pacote de Capacidade para o Adaptador para Metasolv e JD Edwards OneWorld no Windows 2000 e tenta ativar o adaptador, ele é finalizado com um erro: A linha de entrada é muito longa. Isso ocorre por problemas com o comprimento da linha de comandos no Windows 2000. Você verá o mesmo problema com o WebSphere Business Integration Adapters para Aplicativos Siebel e Oracle quando realizar uma instalação de CP remota. Existe uma solução alternativa planejada para esse problema, através de uma technote que estará disponível após esse release.
Instalador (Todos) 46851 O texto não resolvido de pacotes de recursos pode ser exibido na janela durante a transferência de arquivos. Em particular, pode ser exibido o seguinte:
$L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.
displayName)
O que deveria ser exibido é:
WebSphere Business Integration Server Express Plus V4.3.1
Instalador (Todos) 43593 O texto do título pode estar truncado nas caixas de diálogo da mensagem devido ao seu comprimento; no entanto, o conteúdo pretendido da mensagem é exibido.
Launchpad 43688 O IBM WebSphere Application Server V5.0.2.4 para Linux não pode ser instalado no Red Hat Enterprise Linux AS 3.0. Utilize o IBM WebSphere Application Server - Express V5.1 em seu lugar.
Launchpad 58560 O componente Toolset Express é instalado automaticamente quando o componente Samples está sendo instalado, mesmo se você apagar a caixa de opções ao lado de Ferramentas Administrativas e Ferramentas de Desenvolvimento. Isso ocorre porque a GUI do Launchpad não é atualizada corretamente para reconfigurar as caixas de opções.
Servidor (Amostras) 43775 Há um erro no arquivo \mqseries\RemoteServerSample.mqsc.

Na expressão a seguir, o texto destacado está incorreto:
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

A expressão deveria ser a seguinte (veja o texto destacado):
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(XMITQ_TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

Para solucionar esse problema, modifique o arquivo \mqseries\RemoteServerSample.mqsc após a instalação.
Monitor do Sistema 43360 Se você criar uma visualização com mais de 20 monitores a partir da página Criar e Configurar Visualizações, pode encontrar uma exceção ao selecionar a visualização. Limite o número de monitores em uma visualização para menos de 20.
Monitor do Sistema 42481 O System Monitor suporta a execução do Web Application Server e do cliente no mesmo código do idioma. Se o servidor e o cliente estiverem em códigos do idioma diferentes, o texto será exibido em ambos os idiomas. Se não for possível executar o servidor no mesmo código do idioma do cliente, defina o código do idioma da JVM igual ao código do idioma do cliente, executando as seguintes etapas:
  1. A partir do WebSphere Application Server, inicie o WebSphere Application Server Administrator Console (para o Express, você deve ativar o aplicativo adminconsole):
  2. Vá para a Java Virtual Machine através do seguinte caminho:
    Servidores > Servidores de Aplicativos > ICSMonitor > Definição de Processo > Java Virtual Machine
  3. Inclua os seguintes argumentos nos argumentos de JVM genéricos:
    -Duser.language=language code -Duser.region=country code
    Substitua language code e country code por seus códigos de idioma e país específicos.
  4. Reinicie o servidor do monitor InterChange Server e defina o navegador cliente para o mesmo idioma utilizado na etapa anterior.
Monitor do Sistema 43759 Se você estiver utilizando o Netscape 4.7x com idiomas de caracteres de byte duplo, os caracteres podem não ser exibidos no Netscape. Para configurar o Netscape para permitir que o caracteres de conjuntos de caracteres de byte duplo sejam exibidos, siga essas etapas:
  1. No menu View do Netscape, selecione Character Set > Unicode (UTF-8).
  2. No menu View, selecione Character Set > Set Default Character Set.
  3. Abra o menu Edit e selecione Preferences.
  4. Na janela Preferences, selecione Appearance > Fonts.
  5. No campo For the Encoding, selecione Unicode.
  6. No campo Variable Width Font, selecione Lucida Sans Unicode.
  7. Selecione Use my default fonts, overriding document-specified fonts.
  8. Clique em OK.
Ferramentas - Editor de Atividade 36145 A marcação de cores no editor de código Java(TM) do Editor de Atividades não manipula aspas dentro de cadeias; entretanto, isso não deve afetar a compilação.

Documentações

A documentação do produto não faz parte do pacote de produtos, por CD ou distribuição eletrônica de produtos. A documentação desse produto pode ser encontrada no IBM WebSphere Business Integration Server Express InfoCenter.

Os seguintes documentos podem ser encontrados nesse Web site:

Map Development Guide
Business Object Development Guide
Collaboration Development Guide
Data Handler Guide
Access Development Guide
WebSphere Business Integration Server Express Installation Guide for Windows
Guia de Instalação do WebSphere Business Integration Server Express para Linux
WebSphere Business Integration Server Express Installation Guide for OS/400
Quick Start Guide
System Implementation Guide
System Administration Guide
Adapter for COM User Guide
Adapter for e-Mail User Guide
Adapter for Exchange User Guide
Adapter for iSeries User Guide
Adapter for JD Edwards OneWorld User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for JText User Guide
Adapter for Lotus Domino User Guide
Adapter for MetaSolv Applications User Guide
Adapter for mySAP.com (SAP R/3 V. 4.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for PeopleSoft User Guide
Adapter for Portal Infranet User Guide
Adapter for Siebel eBusiness Applications User Guide
Adapter for SWIFT User Guide
Adapter for Telcordia User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide
Adapter for XML User Guide

Collaborations for Customer Relationship Management
Collaborations for Procurement
Collaborations for Financials and Human Resources
Collaborations for Order Management

Copyright IBM Corp. 2004