Configuration d'un service de conversion de documents éloigné

Pour équilibrer les charges de traitement, vous pouvez exécuter des services de conversion de documents sur un serveur IBM® WebSphere® Application Server distant qui prend en charge les services de conversion de documents. Pour déléguer les services de conversion de documents sur un serveur distant, il faut effectuer des opérations sur HCL Digital Experience et le serveur distant.

Avant de commencer

  • Si le service distant de conversion de documents (DCS) a été configuré sur une machine distante avec le programme d'installation de la recherche distante, puis sautez les étapes 1 à 7.
  • Mettez à jour le fichier content-types.properties pour garantir que les conversions de documents sont configurées pour différents types de fichier. Pour connaître les instructions à suivre, voir Activation des services de conversion de documents.
  • Copiez le fichier RemoteDCS.zip dans votre système de fichiers. Localisez le fichier RemoteDCS.zip dans le répertoire d'installation HCL Portal sous PortalServer_root/lwo/prereq.odc/RemoteSearchInstaller.
    Remarque : Il se peut que des versions mises à jour de RemoteDCS.zip soient disponibles en ligne. Consultez le site Correctifs et mises à jour recommandées pour WebSphere® Portal et Web Content Management.

Pourquoi et quand exécuter cette tâche

La conversion locale de documents est prise en charge sous z/OS®. Il n'est pas nécessaire d'exécuter des services de conversion de documents à distance pour z/OS®. Si nécessaire, installez le module suivant sur le serveur distant pour améliorer les performances graphiques des conversions de documents : X11R6.

Linux on PowerPC : Exécutez les services de conversion de documents sur un serveur WebSphere® Application Server distant prenant en charge les services de conversion de document. La conversion de documents locale n'est pas prise en charge sur Linux™ pour PowerPC®. En outre, les systèmes Linux on z System 64 bits ne prennent pas en charge l'exécution de la conversion de document ou du vérificateur orthographique au niveau local. Vous devez exécuter ces fonctions sur un serveur distant.

Procédure

  1. Installez WebSphere® Application Server sur le système distant.
    Restriction : Stellent version 8.01 doit prendre en charge le système distant.
  2. Copiez RemoteDCS.zip sur le serveur distant et extrayez-le dans un répertoire avec un outil d'archivage approprié.
    Un répertoire intitulé dcs devient disponible. Ce répertoire contient plusieurs fichiers et sous-répertoires.
  3. Déployez dcs.war sur WebSphere® Application Server.
    1. Connectez-vous à la console WebSphere® Integrated Solutions Console.
    2. Sélectionnez Applications > Installation d'une nouvelle application.
    3. Accédez au répertoire dans lequel vous avez extrait RemoteDCS.zip, puis localisez et sélectionnez dcs.war.
    4. Indiquez dcs comme racine de contexte et cliquez sur Suivant.
    5. Conservez toutes les autres valeurs comme valeur par défaut.
      Restriction : Le nom d'application doit être dcs_war. Ne modifiez pas le nom par défaut.
    6. Mappez l'application vers les serveurs appropriés et spécifiez les options d'installation si nécessaire.
    7. Cliquez sur Terminer et sauvegardez les modifications apportées à la configuration principale.
  4. Vérifiez que dcs.war est en cours d'exécution.
    1. Connectez-vous à la console WebSphere® Integrated Solutions Console.
    2. Cliquez sur Applications > Applications d'entreprise.
    3. Localisez dcs_war dans la liste des applications installées.
    4. Sélectionnez dcs_war et cliquez sur Démarrer si l'application n'a pas été lancée.
  5. Exécutez le script de configuration.
    1. Ouvrez une invite de commande.
    2. Placez-vous dans le répertoire dcs.
      Le script de configuration est situé dans la racine du répertoire dcs qui se trouve dans le répertoire dans lequel RemoteDCS.zip a été extrait.
    3. Exécutez la commande suivante :
      • AIX® HP-UX Linux™ Solaris : ./setupremotedcs.sh
      • IBM® i : setupremotedcs.sh
      • Windows™ : setupdcs.bat
    4. Lorsque vous y êtes invité, spécifiez le répertoire d'installation de WebSphere® Application Server.
      Par exemple, AppServer_root.
    5. Lorsque vous devez indiquer le profil, spécifiez le répertoire dans lequel dcs.war est installé.
      Par exemple, AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear
    Le script de configuration copie tous les fichiers dans le répertoire oiexport où vous avez installé dcs.war ; par exemple, AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
  6. Procédez comme suit pour ajouter les variables d'environnement à votre serveur de recherche distant :
    1. Connectez-vous à la console WebSphere®Integrated Solutions Console.
    2. Accédez à Serveurs > Types de serveurs > Serveurs d'applications WebSphere.
    3. Sélectionnez le serveur DCS distant.
    4. Accédez à Gestion des processus et Java > Définition de processus.
    5. Cliquez sur Entrées d'environnement.
    6. Cliquez sur Nouveau pour créer les entrées suivantes :
      Remarque : Si les entrées existent, cliquez sur l'entrée et mettez la valeur à jour.
      LD_LIBRARY_PATH
      AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
      LIBPATH
      AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
      PATH
      AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
      SHLIB_PATH
      AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
    7. Sauvegardez vos modifications.
  7. Redémarrez le serveur.
    Les services de conversion de documents sont désormais installés sur le serveur distant.
  8. Procédez comme suit :
    1. Ouvrez le fichier wkplc.properties dans un éditeur de texte depuis le répertoire wp_profile_root/ConfigEngine/properties.
    2. Ajoutez la propriété et la valeur ci-après à wkplc.properties : DcsRemoteHost=URL of the remote host.

      Où URL of the remote host est l'URL du serveur distant auquel vous envisagez de déléguer les services de conversion de documents. Par exemple, DcsRemoteHost=http://server_name:port_number/dcs/dcs. Le server_name est le nom d'hôte qualifié complet du serveur DCS distant. Le port_number est le numéro de port de l'hôte par défaut sur lequel le serveur DCS est exécuté. Par exemple, l'URL peut être DcsRemoteHost=http://example.mycompany.com:9080/dcs/dcs.

      Important : Par défaut, cette propriété n'existe pas dans le fichier wkplc.properties. Vous devez l'ajouter et spécifier une valeur avant de passer à l'étape suivante.
    3. Exécutez la tâche appropriée pour déléguer la totalité ou une partie des fonctions de conversion de document au serveur distant.
      1. Ouvrez une invite de commande.
      2. Accédez au répertoire suivant :
      3. Exécutez la tâche suivante :
        Remarque : Exécutez la commande suivante sur tous les noeuds d'un cluster, le cas échéant.
        • AIX® HP-UX Linux™ Solaris : ./ConfigEngine.shtask_name
        • IBM® i : ConfigEngine.sh task_name
        • Windows™ : ConfigEngine.battask_name
        Où task_name correspond à l'une des tâches de configuration suivantes :
        Tableau 1. Tâches pour déléguer les fonctions de conversion de document à un serveur distant.
        Tâche Description
        delegate-all-conversions Cette tâche délègue tous les services de conversion de fichier à un serveur distant.
        delegate-text-conversions Cette tâche délègue les conversions de document texte à un serveur distant.
        remove-conversion-delegation Cette tâche arrête la délégation de tous les services de conversion de fichier à un serveur distant.
    4. Redémarrez HCL Portal.