README

IBM(R) WebSphere(R) Commerce
Professional Edition
Business Edition
para AIX(R)

Versão 5.4

Última Atualização: 15 de Abril de 2002

Conteúdo

Itens abordados neste README

Este arquivo README contém informações sobre problemas conhecidos no produto. Atualizações deste arquivo README serão publicadas na página  Technical Library do WebSphere Commerce Business Edition e na página Technical Library do WebSphere Commerce Professional Edition. Você também pode verificar o banco de dados Technotes na página Support do WebSphere Commerce Business Edition e na página Support do WebSphere Commerce Professional Edition para obter informações sobre problemas relatados e sobre suporte ao produto.

Documentação

  1. A página Technical Library do WebSphere Commerce Business Edition e a página Technical Library do WebSphere Commerce Professional Edition contêm todas as atualizações feitas na ajuda online e no guia de instalação. Também estão disponíveis informações adicionais do produto não inclusas no CD.
     
  2. Se você utilizar a função de pesquisa da ajuda online do WebSphere Commerce em uma máquina configurada com definições regionais diferentes de en_US, pode enfrentar problemas, como exibição incorreta de caracteres nacionais ou nenhum resultado de pesquisa. A atualização do Java(TM) Runtime Environment pode corrigir esse problema. Para obter uma versão mais recente, vá para java.sun.com e procure Java 2 Runtime Environment. Depois de atualizar o Java Runtime Environment, você deve fechar todas as janelas do Internet Explorer antes de iniciar a ajuda online novamente.

Instalação

  1. Ao instalar Commerce.Docs, você vê mensagens de aviso conforme o sistema substitui arquivos de ajuda existentes. Essas mensagens são apenas informativas e podem ser ignoradas.

  2. Para máquinas que não alocam um sistema de arquivos para /usr e /home, o script wc54aixpreq.sh retorna o seguinte erro:

    ESPAÇO EM DISCO RÍGIDO LIVRE em blocos de 1K:
    Nenhum diretório /usr detectado  FALHA
    Nenhum diretório /home detectado  FALHA

    Você precisará de 5 GB de espaço livre no total para /usr e /home.

    Observe que a mensagem de erro aparece de qualquer maneira, havendo ou não 5 GB de espaço livre. Se você tiver 5 GB de espaço livre, ignore a mensagem.

  3. Para iniciar o WebSphere Application Server (WAS) como usuário não root, o diretório /tmp deve ter permissões de arquivos definidas como 777, pois o WAS irá gravar nesse diretório.
     
  4. Ao executar wcpostinstall.sh, se você escolher um ID de usuário diferente do padrão para executar o WebSphere Application Server, o diretório principal padrão desse ID de usuário deve ser /home/userID. Se você optar por criar um novo ID de usuário, o diretório principal desse ID será criado corretamente pelo script.
     
  5. No assistente de Criação de Instância, o campo Diretório principal do Administrador do Banco de Dados é obrigatório. Se não for preenchido, a criação da instância falhará.
     
  6. O script de verificação de pré-requisitos (wc54aixpreq.sh) não conseguirá encontrar o e-fix PMR60732 do WebSphere Application Server. Para verificar se este e-fiz está em seu sistema, verifique se o arquivo <WASDIR>/java/jre/lib/extfix/PMR60732.jar existe, onde WASDIR é o diretório de instalação do WebSphere. 
     
  7. O script de verificação dos pré-requisitos (wc54aixpreq.sh) não conseguirá encontrar o e-fix PQ57446 do WebSphere do Application Server, porque esse e-fix foi substituído pelo PQ58443. Para verificar se este e-fix está em seu sistema, verifique o arquivo product.xml para o WebSphere Application Server para ver se ele está instalado. Os instaladores de e-fix do WebSphere Application Server fornecidos devem instalar corretamente os dois e-fixes acima; você poderá verificar o arquivo de log wc54efixunix.log localizado no diretório <WC>/logs ou no diretório /tmp.

WebSphere Application Server

  1. O e-fix PQ57024 é obrigatório para o WebSphere Application Server 4.0 FixPak2 em um ambiente em japonês. Depois de aplicar o FixPak, instale o e-fix PQ57024 fornecido para corrigir um problema na tradução japonesa. Você pode fazer download do e-fix a partir do seguinte site na Web:

    WebSphere Application Server Support

    Para obter detalhes sobre o problema corrigido pelo e-fix, consulte o arquivo README fornecido com o e-fix.
     
  2. Se você tiver rendimento inadequado, verifique a definição de cache de instruções preparadas. Você pode ajustar o tamanho da cache. A regra prática para dimensionar a cache de instrução preparada do WebSphere Application Server é a seguinte:

    Número máximo de conexões do banco de dados * 100

    Isso implica que cada conexão do banco de dados tem uma cache de instruções de tamanho 100. Assim como qualquer parâmetro de ajuste, esse valor deve ser ajustado conforme o aplicativo e a carga de trabalho. 


    3.  
  3. Quando a Segurança do WebSphere estiver ativada, após alguns instantes a falha java OutofMemory irá ocorrer, porque a memória está alocada, mas nunca foi liberada. Para corrigir este problema, o cliente precisa aplicar o e-fix PQ59010 do WAS. Você poderá fazer o download deste e-fix a partir do seguinte site da Web:

    WebSphere Application Server Support

Implementação de Código Personalizado

Como parte da implementação de novos beans corporativos e beans de entidade públicos modificados do WebSphere Commerce, um arquivo XML deve ser gerado, descrevendo cada um dos beans do aplicativo corporativo do WebSphere Commerce. Esse arquivo é criado utilizando a ferramenta XMLConfig com a opção "export".

Esse arquivo XML não pode ter caracteres de retorno de carro incluídos na especificação do nome completo do servidor de aplicativos para cada bean corporativo. A aplicação dessa alternativa assegura que os nomes completos de servidores de aplicativos sejam formatados corretamente (ou seja, sem retornos de carro) no arquivo XML.

A alternativa deve ser realizada depois da conclusão de qualquer das seguintes tarefas descritas no Manual do Programador do WebSphere Commerce.

Cada uma das tarefas precedentes utiliza o comando XMLConfig -export para criar um arquivo XML que fornece informações de configuração para os beans corporativos em um aplicativo corporativo. Esse arquivo não é formatado corretamente. Em particular, o nome do servidor de aplicativos é dividido em várias linhas. Se isso não for reformatado para ocupar apenas uma linha, será encontrado um erro indicando que o servidor de aplicativos não pode ser encontrado quando o arquivo for utilizado como entrada para o comando XMLConfig -import.

Para formatar corretamente o arquivo XML que é gerado pelo comando XMLConfig -export, faça o seguinte:

  1. Utilizando um editor de texto, abra OutputFile.xml, em que OutputFile é o nome do arquivo gerado pelo comando XMLConfig -export.
  2. Para cada valor contido entre as tags <application-server-full-name> e </application-server-full-name>, assegure que não haja retornos de carro no valor. Se existir um retorno de carro nesse valor, exclua-o de modo que o nome do servidor de aplicativos seja especificado em uma única linha.
  3. Salve o arquivo.
  4. Continue com as próximas etapas para implementação de código, conforme descrito no Manual do Programador do WebSphere Commerce.

Comandos

Se o objeto de propriedades de resposta de qualquer comando que redireciona para outro pedido HTTP (por exemplo, redirecionando para um JavaServer Page)  tiver tamanho maior que 4KB, será gerado um erro. Para evitar esse erro, você deve modificar o objeto de propriedades de resposta para conter menos que 4KB de dados antes de redirecionar. Uma maneira de reduzir o tamanho do objeto de propriedades de resposta é remover parâmetros desnecessários das cadeias de URL. Para obter informações sobre isso, consulte "Tratamento de uma URL de redirecionamento de comprimento limitado" no Manual do Programador do WebSphere Commerce.

Integração

O WebSphere Commerce não pode utilizar o Domino como servidor LDAP com o IBM Developer Kit para AIX, Java2 Technology Edition, v1.3, que é fornecido como parte da versão atual do WebSphere Application Server. Verifique a página Support do WebSphere Commerce Business Edition e a página Support do WebSphere Commerce Professional Edition para obter atualizações.

Publicação de Loja

A seguinte propriedade do sistema java é necessária para garantir o tratamento correto de erros se a publicação da loja falha.

Inclua esta propriedade utilizando o console administrativo do WebSphere Application Server:

  1. Abra o console administrativo do WebSphere Application Server.
  2. Expanda Nós.
  3. Expanda seu_nó.
  4. Expanda Servidores de Aplicativos.
  5. Clique em nome_instância.
  6. Clique em Definições de JVM e inclua o seguinte:
    com.ibm.wcm.ErrorReporterDir = /usr/WebSphere/CommerceServer/temp/nome_instância/tools/devtools
  7. Clique em Aplicar e depois inicie novamente a instância.

Gerenciador de Catálogo e Loader

  1. A ajuda online não é lançada para o Transformador de Texto e o Editor XSL. As ferramentas não lançam a ajuda e a mensagem de erro refere-se a arquivos .hlp. A página da Web do Transformador de Texto está localizada no arquivo usr/WebSphere/CommerceServer/web/doc/locale/f1_fs/fdpttt.htm. Para o Editor XSL, consulte o arquivo chamado fdpxtt.htm no mesmo diretório.

  2. O Loader pode não retroceder registros em uma consolidação que falhou. Se isso ocorrer, você pode excluir manualmente os registros do banco de dados. Você também pode especificar a opção -method delete no comando Load para excluir os registros do banco de dados. O arquivo de entrada para o Loader deve conter os registros que precisam ser excluídos ao utilizar esta opção. Consulte o Manual do Usuário do Gerenciador de Catálogos para obter mais informações.

Marcas Registradas e Marcas de Serviço

As marcas ou marcas registradas a seguir são de propriedade da IBM Corporation nos Estados Unidos e em outros países:
IBM      WebSphere    AIX

Java e todas as marcas baseadas em Java são marcas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.

Windows e  Windows NT são marcas registradas da Microsoft Corporation nos Estados Unidos, em outros países ou em ambos.

Outros nomes de empresas, produtos e serviços podem ser marcas ou marcas de serviço de terceiros. 

**************************************************************************

** COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2002

** TODOS OS DIREITOS RESERVADOS.

**************************************************************************
-

Fim do arquivo README