README

IBM(R) WebSphere(R) Commerce
Professional Edition
Business Edition
para software Solaris Operating Environment(TM)

Versão 5.4

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

Conteúdo

• Itens abordados neste README
• Documentação
• Instalação
• Gerenciador de Configuração
• WebSphere Application Server
• Implementação de Código Personalizado
• Comandos
• Publicação de Loja
• Gerenciador de Catálogo e Loader

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. Muitas mensagens de aviso aparecem durante a instalação. Para evitar isso, faça o seguinte antes de incluir o pacote docs do WebSphere Commerce:
   1. Clique no menu Propriedades.
   2. Clique no menu Administração de Pacotes.
   3. A opção padrão para Arquivos Existentes deve ser "Perguntar". Altere-a para "Sobrepor"
   4. Clique em OK
   5. Prossiga com a inclusão do pacote docs.
      
      
2. Para máquinas que não alocam um sistema de arquivos para /opt e /export/home, o script wc54sunpreq.sh retorna o seguinte erro:
   
   ESPAÇO EM DISCO RÍGIDO LIVRE em blocos de 1K:
   Nenhum diretório /opt detectado  FALHA
   Nenhum diretório /export/home detectado  FALHA
   
   Você precisará de 5 GB de espaço livre no total para /opt e /export/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. Quando você executa o script utilizado para iniciar o Gerenciador de Configuração, pode obter uma mensagem de erro que diz: "whoami não encontrado". Assegure que as duas linhas a seguir estejam no arquivo .profile dos usuários root e wasuser:
   
   PATH=$PATH:/usr/ucb
   export PATH
   
   Execute o script novamente para lançar o Gerenciador de Configuração.
   
   
4. 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.
    
5. 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 /export/home/userID. Se você optar por criar um novo ID de usuário, o diretório principal desse ID será criado corretamente pelo script.
    
6. O WebSphere Commerce suporta os seguintes conjuntos de código:

   Idioma	Valor da variável LANG
   Alemão	de_DE.ISO8859-1
   Inglês	en_US.ISO8859-1
   Espanhol	es_ES.ISO8859-1
   Francês	fr_FR.ISO8859-1
   Italiano	it_IT.ISO8859-1
   Português do Brasil	pt_BR.ISO8859-1
   Japonês	ja_JP.eucJP
   Coreano	ko_KR.EUC
   Chinês Simplificado	zh_CN.GBK
   Chinês Tradicional	zh_TW.BIG5

   Assegure que o conjunto de códigos suportado para seu locale esteja instalado em sua máquina Solaris. Para verificar os conjuntos de código instalados, execute locale -a.
   Assegure que todas as variáveis de ambiente relacionadas a locale (LANG, LC_ALL) estejam definidas de maneira a incluir o locale suportado pelo WebSphere Commerce. Para verificar, execute locale e verifique as variáveis LANG e LC_ALL. Se seu locale não estiver definido para o conjunto de códigos suportado, altere suas propriedades de locale, executando os seguintes comandos como usuário root:

   LANG=xx_XX.XXXX
   export LANG
   LC_ALL=xx_XX.XXXX
   export LC_ALL

   Por exemplo:
   LANG=en_US.ISO8859-1
   export LANG
   LC_ALL=en_US.ISO8559-1
   export LC_ALL

   Será necessário assegurar que esses valores estejam definidos corretamente como raiz antes de executar wcpostinstall.sh. Para configurações não-raiz, após executar wcpostinstall.sh, você deve editar o arquivo/export/home/wasuser/.profile. No arquivo .profile, o valor LANG deve ser definido como o conjunto de códigos suportado. Inclua a extensão do conjunto de códigos. Por exemplo: de LANG=en_US para LANG=en_US.ISO8559-1.
    

7. 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á.
    
8. O script de verificação de pré-requisitos (wc54sunpreq.sh) não conseguirá encontrar o e-fix PQ57446 do WebSphere Application Server, pois esse e-fix foi substituído por PQ58443. Para verificar se este e-fix está em seu sistema, verifique o arquivo product.xml para o WebSphere Application Server, para consultar 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 estiver instalando o WebSphere Application Server Advanced Single Server Edition em uma máquina Sun Solaris, você precisará alterar a chave GB2312 para GBK no arquivo converter.properties para evitar páginas danificadas. O arquivo converter.properties está localizado no seguinte diretório: WebSphere/AppServer/properties. 

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.

• "Exportando informações sobre configuração XML para o aplicativo corporativo" no Capítulo 9.
• "Exportando informações sobre configuração XML para o aplicativo corporativo" no Capítulo 10.
• "Exportando informações sobre configuração para beans corporativos" no Apêndice B.

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.

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 = /opt/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 opt/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

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