Fichier README

IBM WebSphere Commerce
Professional Edition
Business Edition
pour iSeries(R) eServer(TM) 400

Version 5.4

Dernière mise à jour : 4 mars 2002

Table des matières

• Contenu de ce fichier README
• Contenu des CD-ROM
• Documentation
• Déploiement de code personnalisé
• WebSphere Application Server
• Instructions
• WebSphere Commerce Accelerator
• Publication de magasin
• Module Loader

Contenu de ce fichier README

Ce fichier Readme détaille les problèmes recensés concernant le produit. Les mises à jour de ce fichier README seront publiées sur la page de la  Bibliothèque technique de WebSphere Commerce Business Edition et sur la page de la Bibliothèque technique de WebSphere Commerce Professional Edition. Vous pouvez également consulter, dans la base de données Technotes, la page Support de WebSphere Commerce Business Edition et la page Support de WebSphere Commerce Professional Edition pour prendre connaissance des problèmes signalés et de toute autre information du support produit.

Contenu des CD-ROM

WebSphere Commerce Professional Edition est livré sur deux CD-ROM. WebSphere Commerce Business Edition est livré sur trois CD-ROM. Ces CD-ROM contiennent toutes les versions en langues nationales.
Le contenu des CD-ROM est le suivant :

Disque 1

• *BASE
• Option 1
• Option 2
• Anglais (MRI2924, MRI2938, MRI2950, MRI2984)

  Pour mener à bout l'installation et tirer profit de toutes les options du produit, vous devez installer *BASE, Option 1 et Option 2. Le MRI Anglais est facultatif, sauf si vous utilisez un ordinateur iSeries sous cet environnement.

Disque 2

• Portugais (Brésil) (MRI2980)
• Français (MRI2928, MRI2940)
• Allemand (MRI2929, MRI2939)
• Italien (MRI2932, MRI2942)
• Espagnol (MRI2931)
• Japonais (MRI2962)
• Coréen (MRI2986)
• Chinois simplifié (MRI2989)
• Chinois traditionnel (MRI2987)
  
  Installez les MRI requis pour chaque langue que vous comptez prendre en charge.

Disque 3 (Business Edition uniquement)

• Option 3.
  
  Vous devez installer cette option si vous utilisez WebSphere Commerce Business Edition.

Documentation

1. La page Bibliothèque technique de WebSphere Commerce Business Edition et la page Bibliothèque technique de WebSphere Commerce Professional Edition contiennent toutes les mises à jour apportées à l'aide en ligne et au Guide d'installation. Vous y trouverez également d'autres informations produit non disponibles sur le CD-ROM.
    
2. Si vous utilisez la fonction de recherche de l'aide en ligne de WebSphere Commerce sur un ordinateur configurés avec des paramètres régionaux autres que en_US, vous pouvez rencontrer des problèmes, comme par exemple des caractères nationaux s'affichant de manière incorrecte ou une recherche qui ne renvoie pas de résultats. La mise à niveau de l'environnement d'exécution Java (Java Runtime Environment) est susceptible de corriger ce problème. Pour vous procurer une version plus récente de cet environnement, accédez au site java.sun.com et effectuez une recherche sur Java 2 Runtime Environment. Après la mise à niveau de l'environnement d'exécution Java, vous devez refermer toutes des fenêtres de Internet Explorer avant de relancer l'aide en ligne.

Déploiement de code personnalisé

Dans le cadre du déploiement de nouveaux beans d'entreprise, tout comme de beans modifiés d'entités publiques de WebSphere Commerce, un fichier XML décrivant chacun de ces beans dans l'application entreprise de WebSphere Commerce doit être généré. Ce fichier est créé à l'aide de l'outil XMLConfig, en sélectionnant l'option "export".

Ce fichier XML ne doit inclure aucun caractère de retour chariot dans la spécification du nom complet du serveur d'application pour chaque bean d'entreprise. L'application de ce palliatif garantit un formatage correct des noms complets des serveurs d'applications (à savoir, sans retours chariot) dans le fichier XML.

Ce palliatif doit être utilisé après l'exécution d'une des tâches suivantes (décrites dans le manuel WebSphere Commerce Programmer's Guide) :

• "Exporting XML configuration information for the enterprise application" (Exportation des informations de configuration XML pour l'application d'entreprise), au chapitre 9.
• "Exporting XML configuration information for the enterprise application" (Exportation des informations de configuration XML pour l'application d'entreprise), au chapitre 10.
• "Exporting configuration information for enterprise beans" (Exportation des informations de configuration pour les beans d'entreprise), à l'annexe B.
   

Chacune des tâches ci-dessus invoque l'instruction XMLConfig -export afin de créer un fichier XML fournissant des informations de configuration pour les beans d'entreprise dans une application d'entreprise. Ce fichier n'est pas formaté correctement. En particulier, le nom du serveur d'application est scindé sur plusieurs lignes. S'il n'est pas reformaté de sorte à ne couvrir qu'une seule ligne, une erreur signalant que le serveur d'application est introuvable est générée lorsque ce fichier est utilisé comme entrée de l'instruction XMLConfig -import .

Pour formater correctement le fichier XML généré par l'instruction XMLConfig -export, procédez comme suit :

1. A l'aide d'un éditeur de texte, ouvrez le fichier Fichier_sortie.xml, où Fichier_sortie désigne le nom du fichier généré par l'instruction XMLConfig -export.
2. Vérifiez qu'aucun retour chariot ne figure dans les valeurs délimitées par les balises <application-server-full-name> et </application-server-full-name>. Si une valeur contient un retour chariot, supprimez celui-ci afin que le nom JNDI soit spécifié sur une seule ligne.
3. Enregistrez le fichier.
4. Complétez les étapes suivantes pour déploiement du code, tel que décrit dans le manuel WebSphere Commerce Programmer's Guide.

WebSphere Application Server

1. Après avoir complété la configuration de l'instance WebSphere Commerce, vous devez régénérer le module d'extension du serveur Web dans la console d'administration de WebSphere Application Server, en procédant ainsi :
   1. Ouvrez la console d'administration de WebSphere Application Server.
   2. Développez l'entrée Noeuds.
   3. Cliquez avec le bouton droit sur votre_noeud.
   4. Sélectionnez Régénérer le module d'extension du serveur Web.
   5. Depuis une fenêtre de commandes de iSeries, démarrez votre serveur HTTP après seulement que l'horodatage du fichier /QIBM/UserData/webasadv4/was_inst/config/plugin-cfg.xml ait changé.

      Cette procédure est requise après toute mise à jour d'une instance affectant le serveur WebSphere Application Server, comme la mise à jour des hôtes virtuels, du clonage et autres modifications de ce genre.
       

2. Lorsque vous créez une autre instance WebSphere Commerce, vous recevez un message d'erreur indiquant que le port de transport HTTP est déjà uilisé. Vousd evez effectuer les opérations suivantes puis régénérer le module d'extension dans la console d'administration de WebSphere Application Server :
1. Ouvrez la console d'administration de WebSphere Application Server.
2. Développez Domaine d'administration Websphere.
3. Développez l'entrée Noeuds.
4. Développez nom_hôte.
5. Développez Serveur d'applications.
6. Sélectionnez nom_instance - WebSphere Commerce Server.
7. Cliquez sur l'onglet Services.
8. Sélectionnez Service de conteneur Web.
9. Cliquez sur l'option permettant de modifier les propriétés.
10. Cliquez sur l'onglet Transport.
11. Sélectionnez Transport HTTP et cliquez sur Modifier.
12. Dans la zone Port de transport, entrez un numéro de port unique.
13. Cliquez sur OK.
14. Cliquez sur OK.
15. Cliquez sur Appliquer.

Instructions

Si la taille de l'objet de propriétés de réponse d'une instruction quelconque redirigeant vers une autre requête HTTP (par exemple, vers une page JavaServer Page)  est supérieure à 4 Ko, une erreur est générée. Pour éviter cette erreur, vous devez modifier l'objet de propriétés de réponse de sorte à ce qu'il contienne moins de 4 Ko de données avant redirection. Une possibilité de réduire la taille de cet objet consiste à supprimer les paramètres superflus des chaînes URL. Pour plus d'informations, reportez-vous à la rubrique "Handling a limited length redirect URL" du manuel WebSphere Commerce Programmer's Guide.

WebSphere Commerce Accelerator

Le bouton Supprimer a été retiré de la page Centres de distribution.

Publication de magasin

La propriété java suivante est requise pour le traitement adéquat des erreurs en cas d'échec de la publication d'un magasin.

Ajoutez cette propriété comme suit depuis la console d'administration de WebSphere Application Server :

1. Ouvrez la console d'administration de WebSphere Application Server.
2. Développez l'entrée Noeuds.
3. Développez votre_noeud.
4. Développez Serveurs d'applications
5. Cliquez sur le nom_d'instance.
6. Cliquez sur Paramètres de la JVM et ajoutez comme suit :
   com.ibm.wcm.ErrorReporterDir = /QIBM/UserData/WebCommerce/instances/nom_instance/temp/tools/devtools
   
   Cette valeur doit être identique à celle de la propriété TempPath, spécifiée dans le fichier de configuration de l'instance dont le nom est similaire à : /QIBM/UserData/WebCommerce/instances/nom_instance/xml/nom_instance.xml
7. Cliquez sur Valider et redémarrez votre instance.

Module Loader

Il est possible que le module Loader n'invalide pas des enregistrements lors de l'échec d'une validation (commit). Dans ce cas, vous pouvez supprimer les enregistrements de la base manuellement. Vous pouvez également indiquer l'option METHOD(*DLT) dans la commande LODWCSDTA pour supprimer les enregistrements de la base. Le fichier d'entrée utilisé par le module Loader doit contenir les enregistrements devant être supprimés avec cette option. Pour plus d'informations, reportez-vous au guide d'utilisation de Catalog Manager.

Marques

IBM      WebSphere     iSeries
eServer

Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc.

D'autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document.

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

** COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2002

** TOUS DROITS RESERVES.

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

Fin du fichier README