Configuration de la copie du FTP ou du système de fichiers pour l'extraction des ressources gérées

Cette tâche décrit la méthode par laquelle la fonction de copie du FTP ou du système de fichiers peut être configurée pour extraire des ressources Web gérées de la base de données HCL Commerce vers un système de fichiers. Une fois cette tâche terminée, le contenu statique est extrait et déplacé à l'aide de la méthode de transfert de fichiers spécifique et n'est plus déployé dans l'EAR HCL Commerce.Il est recommandé que les administrateurs de site configurent l'une des méthodes suivantes pour maintenir les performances de WebSphere Commerce dans un environnement de production. Pour plus d'informations, voir Déploiement de ressources gérées.

Procédure

Déterminez si une implémentation est spécifiée pour l'interface. Exécutez la requête SQL suivante :

select * from cmdreg where interfaceName='com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentCmd'

Effectuez l'une des actions suivantes :

Si une implémentation est spécifiée, choisissez l'une des méthodes de transfert de fichiers et exécutez la commande :

FTP

update cmdreg set className='com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentUsingFTPCmdImpl' 
where interfaceName='com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentCmd';

FileSystemCopy

 update cmdreg set className='com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentUsingFileSystemCmdImpl' 
where interfaceName='com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentCmd';

Si l'implémentation n'est pas spécifiée, choisissez l'une des méthodes de transfert de fichiers et exécutez la commande :

FTP

insert into cmdreg (storeent_id,interfacename,description,classname) 
values 
(0, 'com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentCmd', 'FTP implementation for UpdateStaticEARContentCmd', 'com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentUsingFTPCmdImpl');

FileSystemCopy

 insert into cmdreg (storeent_id,interfacename,description,classname) 
values 
(0, 'com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentCmd', 'FileSystemCopy implementation for UpdateStaticEARContentCmd', 'com.ibm.commerce.wc.appmanagement.commands.UpdateStaticEARContentUsingFileSystemCmdImpl');

Remarque : La valeur storeend_id doit être définie sur 0, car la commande ne s'applique qu'en tant que tâche d'administrateur de site.

Configurez la fonction de transfert de fichiers sélectionnée :
- Pour FTP :
```
Le service FTP doit être configuré sur le nœud du serveur Web.
```
  Remarque : Si vous utilisez la méthode FTP, le logiciel du serveur FTP qui n'est pas entièrement conforme à la norme FTP (RFC 959) risque de ne pas fonctionner correctement.
  1. {\f7 Indiquez l'emplacement de ce fichier} {\f7 :} WC_eardir/xml/config/FTP.xml.
  2. Créez une sauvegarde du fichier dans un emplacement temporaire sur votre système.
  3. Editez le fichier WC_eardir/xml/config/FTP.xml et fournissez des valeurs pour les attributs suivants. Si vous prévoyez d'utiliser la publication immédiate, vous devez définir des valeurs pour les attributs <FTPServer> et <ProdFTPServer>. Sinon, vous devez uniquement spécifier une valeur pour l'attribut <FTPServer>.
    proceedOnlyWhenAllServersAreWorking
    
    Définissez cette valeur sur false. Cet attribut s'applique uniquement à l'élément root des serveurs FTP.
    
    FTPHost
    
    Nom d'hôte qualifié complet du système de serveur Web distant. Le serveur d'applications doit pouvoir accéder à ce nom d'hôte. Assurez-vous que les pare-feu configurés autorisent la communication FTP entre les serveurs Web et les serveurs d'applications.
    
    FTPPort
    
    Port du serveur FTP. Si le port n'est pas spécifié, un port par défaut de 21 est utilisé.
    
    FTPUser
    
    Utilisateur à connecter au serveur FTP. Assurez-vous que le répertoire de connexion de cet utilisateur a la même valeur que l'attribut FTPTargetDir.
    
    FTPPassword
    
    Mot de passe chiffré de l'utilisateur FTP. Chiffrez le mot de passe avec l'utilitaire wcs_encrypt, sans spécifier la clé de commerçant.
    
    FTPTargetDir
    Répertoire du système de serveur Web qui représente l'alias wcsstore. Il s'agit du répertoire dans lequel le contenu statique est placé.
    Par exemple, sur un serveur HTTP IBM, le nom du répertoire est déterminé en procédant comme suit sur le système serveur Web :
    
    Ouvrez le fichier httpd.conf qui se trouve dans le répertoire suivant :
    
    WC_installdir/instances/instance_name/httpconf/
    
    WC_userdir/instances/instance_name/httpconf/
    
    Dans le fichier httpd.conf, recherchez une ligne similaire à :
    Alias /wcsstore "temp/filehold/Stores.war"
    
    Enregistrez le répertoire complet. Dans cet exemple, le répertoire est temp/filehold/Stores.war. Accédez à ce répertoire pour l'attribut FTPTargetDir.
    
    Assurez-vous que la valeur de l'attribut FTPTargetDir est identique au répertoire de connexion FTPUser.
    
    Exemple de fichier FTP.xml :
    <FTPServers xmlns="http://www.ibm.com/xmlns/prod/WebSphereCommerce" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com/xmlns/prod/WebSphereCommerce xsd/FTP.xsd" proceedOnlyWhenAllServersAreWorking="false"> <FTPServer FTPHost="" FTPPort="" FTPUser="" FTPPassword="" FTPTargetDir="" /> <ProdFTPServer FTPHost="" FTPPort="" FTPUser="" FTPPassword="" FTPTargetDir="" /> </FTPServers>
    Remarque : Si vous utilisez HCL Commerce version 8.0.0, groupe de correctifs 5 ou une version antérieure, il se peut que le bloc <ProdFTPServer> ne s'affiche pas. Ajoutez l'attribut si nécessaire.
  4. Enregistrez les modifications apportées au fichier WC_eardir/xml/config/FTP.xml.
  5. Mettez à jour le fichier de configuration maître afin que les modifications ne soient pas perdues lors du déploiement suivant.
- Pour la copie du système de fichiers :
  Remarque : Si vous utilisez la fonction de lecteur mappé Windows avec Windows hébergeant à la fois des systèmes locaux et distants, assurez-vous que les configurations de sécurité permettent des activités telles que l'accès aux dossiers distants et aux lecteurs mappés localement pour les comptes suivants :
  - Service local
  - Service réseau
  - Service du système
  Les comptes intégrés mentionnés sont généralement utilisés lors de l'exécution d'un processus en tant que service Windows.
  1. {\f7 Indiquez l'emplacement de ce fichier} {\f7 :} WC_eardir/xml/config/FileSystem.xml.
  2. Créez une sauvegarde du fichier dans un emplacement temporaire sur votre système.
  3. Editez le fichier WC_eardir/xml/config/FileSystem.xml et fournissez des valeurs pour les attributs suivants :
    proceedOnlyWhenAllServersAreWorking
    
    Définissez cette valeur sur false. Cet attribut s'applique uniquement à l'élément root des serveurs FTP.
    
    FSLocation (et ProdFSLocation)
    
    Répertoire local sur le système HCL Commerce mappé ou monté sur un répertoire distant sur le système de serveur Web.
    Si vous prévoyez d'utiliser la publication immédiate, vous devez également définir une valeur pour l'attribut ProdFSLocation. Sinon, vous devez uniquement spécifier une valeur pour l'attribut FSLocation.
    Pour déterminer le répertoire local :
    
    Sur le système de serveur Web, ouvrez :
    
    WC_installdir/instances/instance_name/httpconf/httpd.conf
    
    WC_userdir/instances/instance_name/httpconf/httpd.conf
    
    Dans le fichier httpd.conf, recherchez une ligne similaire à la suivante :
    Alias /wcsstore "temp/filehold/Stores.war"
    Enregistrez ce répertoire, mais supprimez Stores.war. Dans cet exemple, le répertoire des attributs FSLocation et ProdFSLocation est temp/filehold.
    
    Sur le système HCL Commerce, mappez ou montez le répertoire de l'étape 3.c.ii sur un lecteur ou un répertoire local. Utilisez ce lecteur ou ce répertoire local comme valeur pour FSLocation et ProdFSLocation.
    Exemple de fichier FileSystem.xml :
    <FSLocations xmlns="http://www.ibm.com/xmlns/prod/WebSphereCommerce" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com/xmlns/prod/WebSphereCommerce xsd/FileSystem.xsd" proceedOnlyWhenAllServersAreWorking="false"> <FSLocation dir="/temp/filehold"/> <ProdFSLocation dir="/temp/filehold"/> </FSLocations>
    
    Remarque : Si vous utilisez HCL Commerce version 8.0.0, groupe de correctifs 5 ou une version antérieure, il se peut que l'attribut <ProdFSLocation> ne s'affiche pas. Ajoutez l'attribut si nécessaire.
  4. Enregistrez les modifications apportées au fichier WC_eardir/xml/config/FileSystem.xml.
  5. Mettez à jour le fichier de configuration maître afin que les modifications ne soient pas perdues lors du déploiement suivant.
Pour spécifier les fichiers marqués comme contenu statique, examinez et mettez à jour le fichier UpdateEARFilter.properties. Effectuez les étapes suivantes :
1. Ouvrez le fichier suivant et examinez son contenu :
  - WC_eardir/properties/com/ibm/commerce/wc/appmanagement/properties/UpdateEARFilter.properties
2. Dans l'exemple de fichier, des paires nom-valeur sont définies. Si une extension est marquée comme true, tout fichier avec cette extension spécifique est considéré comme du contenu statique. Cet exemple de fichier indique que tout fichier avec l'extension .gif est un contenu statique.
```
#-------------------------------------------------------------------
# Licensed Materials - Property of IBM
#
# HCL Commerce
#
# (c) Copyright IBM Corp. 2006
#
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#-------------------------------------------------------------------
#
 .gif=true
 .jpg=true
 .js=true
 .swf=true
 .GIF=true
 .JPG=true
 .JS=true
 .SWF=true
```
3. Si vous devez mettre à jour ou spécifier des paires nom-valeur supplémentaires, procédez comme suit :
  1. Créez un fichier UpdateEARFilter.properties qui stocke les paires nom-valeur mises à jour ou supplémentaires. Assurez-vous que le fichier est stocké dans le fichier :Temp_dir/properties/extensions/appmanagement/UpdateEARFilter.properties Le contenu de ce fichier est fusionné avec la version du fichier à l'étape 4.a.
  2. Suivez l'exemple de fichier à l'étape 4.b pour mettre à jour votre nouveau fichier UpdateEARFilter.properties avec des paires nom-valeur en suivant les instructions suivantes :
    - Les extensions marquées comme true sont considérées comme du contenu statique. Les extensions marquées comme false sont du contenu non statique.
    - Si vous ajoutez des paires de valeurs personnalisées, veillez à ajouter une entrée pour les majuscules et les minuscules.

Résultats

Lorsque vous mettez à jour le contenu via n'importe quel outil HCL Commerce, les actifs statiques sont automatiquement transférés vers le serveur Web distant via la méthode configurée.

Que faire ensuite

Définissez les valeurs de fréquence de transfert pour vos ressources Web gérées. Pour en savoir davantage sur la modification de ces valeurs, voir Modification des paramètres de l'utilitaire de mise à jour du fichier EAR de HCL Commerce avec les fichiers gérés. En raison de la charge réduite du chargement des actifs vers l'EAR HCL Commerce, la fréquence du chargement des actifs peut être augmentée en définissant des valeurs inférieures des variables suivantes :
```
minNumOfFileForUpdate=1
minSecFromLastUpload=300
```
Redémarrez l'application HCL Commerce.