Instructions relatives à WebLogic

Vous devez effectuer des étapes supplémentaires si vous prévoyez d'installer Unica Plan sur un cluster dans WebLogic.

Préparation de l'installation

Avant de commencer, vous devez créer un domaine WebLogic pour le cluster. Pour obtenir de l'aide sur cette étape, reportez-vous à la documentation WebLogic.

Préparation des sources des données

Le chapitre relatif aux sources de données vous demande de créer une base de données pour Unica Plan, puis de configurer une source de données JDBC pour cette base dans votre serveur d'applications. Lorsque vous réalisez ces tâches pour un cluster, prenez en compte les instructions supplémentaires suivantes :

  • Vous devez configurer l'utilisation du pilote JDBC approprié dans les serveurs d'applications Web sur toutes les machines du cluster.
  • Créez la source de données des tables système Unica Platform (UnicaPlatformDS) sur le serveur d'administration et sur les membres du cluster.
  • Lorsque vous créez la source de données des tables système Unica Plan (plands), déployez-la sur le cluster et non sur le serveur d'administration. Sélectionnez Tous les serveurs du cluster.

Installation des produits

Lorsque vous exécutez le programme d'installation, veillez à n'installer Unica Platform et Unica Plan qu'une seule fois, sur la machine désignée comme serveur d'administration du cluster. Il est inutile d'installer les logiciels sur chaque membre du cluster. Installez-les une fois sur le serveur d'administration, créez le fichier EAR, puis déployez le fichier EAR sur chaque membre du cluster.

Etapes de prédéploiement

Avant de déployer Unica Plan, effectuez les tâches suivantes en plus de celles indiquées dans le chapitre relatif à la configuration du déploiement :

  • Partagez le répertoire de niveau supérieur à la base duquel Unica Plan est installé. Supposons, par exemple, que Unica Plan soit installé dans le répertoire suivant : C:\PlanCluster\HCL_Unica\Plan. Dans ce cas, vous devez partager la totalité du répertoire MktOpsCluster.
  • Créez et partagez un dossier sur le serveur d'administration pour contenir les fichiers de téléchargement de Unica Plan. Ce dossier sera appelé Shared_UMO_Artifacts. Tous les membres du cluster doivent disposer du contrôle total (lecture, écriture, changement et suppression) sur ce dossier. Vous pouvez placer ce dossier sous le répertoire de base de dans la hiérarchie du système de fichiers local, mais cela est facultatif.

Déploiement de l'application sur WebLogic

Outre les instructions du chapitre traitant du déploiement, vous devez prendre en compte les ajouts suivants :

1. Définition de l'option d'accessibilité de la source

Lorsque vous déployez le fichier EAR sur le serveur d'administration, affectez à l'option Source accessibility la valeur Use the defaults defined by the deployment's targets.

2. Instructions supplémentaire pour la définition de la variable JAVA_OPTIONS

Veillez à configurer la propriété JAVA_OPTIONS dans le fichier setenv de chacune des machines du cluster.

Le chemin que vous entrez dans plan.home doit pointer vers le répertoire d'installation partagé.

Deux paramètres supplémentaires doivent être définis pour les clusters :

  • -DPLAN_CONFIG_GUID=Plan
  • Sur les machines qui ne doivent pas envoyer de notifications, définissez le paramètre de suppression des notifications de la manière suivante :

    -Dplan.suppressNotifications=true

    Vérifiez que la propriété suppressNotifications a pour valeur false sur la machine conçue pour envoyer des notifications. Affectez à cette propriété la valeur true sur chacune des autres machines.

3. Définition d'un autre fichier ehcache

Le fichier plan_ehcache.xml défini dans le répertoire CONF est utilisé pour tous les nœuds du cluster. Pour remplacer ce fichier par défaut sur un nœud particulier, éditez startWeblogic.cmd (Windows™) ou startWeblogic.sh (UNIX™) sur ce nœud pour configurer la propriété JAVA_OPTIONS : ajoutez le paramètre -Dplan_ehcache pour indiquer l'emplacement d'un autre fichier plan_ehcache.xml.

Configuration du cookie de gestion de session

Pour définir le nom du cookie de gestion de session utilisé par les serveurs du cluster, éditez le fichier plan.war qui est créé par le programme d'installation et déployé sur votre serveur d'applications.

Procédez comme suit pour configurer le cookie de gestion de session :

  1. Ouvrez une invite de commande et vérifiez que la version de Java™ est la même que celle de l'environnement JRE utilisé par Unica Plan : entrez java -version.
  2. Copiez plan.war dans un dossier temporaire et renommez le fichier plan.war d'origine.
  3. Décompressez le contenu de la nouvelle archive temporaire plan.war : entrez jar -xvf plan.war.
  4. Supprimez le plan.war décompressé : entrez rm plan.war.
  5. Accédez au répertoire WEB-INF : entrez cd WEB-INF.
  6. Editez le fichier web.xml pour ajouter la balise suivante et remplacer le nom du cookie :
    <init-param>
   <param-name>CookieName</param_name>
   <param-value>UMOSESSIONID</param-value>
</init-param>
  7. Compressez à nouveau le plan.war : entrez cd .., puis jar -cvf * plan.war.
  8. Copiez le fichier plan.war mis à jour à son emplacement d'origine sur le serveur.
  9. Déployez le fichier plan.war mis à jour.

Etapes de post-déploiement

Si vous utilisez un plug-in pour l'équilibrage de charge, effectuez les étapes de configuration suivantes :

  • Pour qu'Unica Plan puisse fonctionner efficacement dans un environnement en cluster, les utilisateurs doivent rester sur le même noeud pendant l'intégralité de leur session. Cette option de gestion de session et d'équilibrage de charge est appelée affinité de session ou équilibrage de charge permanent. Pour plus d'informations sur la configuration de cette option dans votre installation, reportez-vous à la documentation du serveur d'applications.
    Remarque : Lorsqu'un nœud tombe en panne sur un système qui met en œuvre cette option, chaque session utilisateur sur ce nœud tombe également. L'équilibreur de charge doit basculer les utilisateurs vers un autre noeud disponible, l'authentification des utilisateurs ne s'appliquant qu'à un seul noeud dans Unica Plan. Les utilisateurs sont invités à se reconnecter et, dans certains cas, une erreur inattendue et la perte des données correspondante peuvent se produire.
  • Connectez-vous à Unica Plan et sélectionnez Paramètres > Configuration. Configurez les paramètres d'URL suivants de sorte que toutes les références au serveur Unica Plan utilisent l'hôte et le port du proxy :
    • Plan | navigation | serverURL
    • Plan | umoConfiguration | balisage | markupServerURL
    • Plan | umoConfiguration | notifications | notifyPlanBaseURL