Déploiement de Unica Plan sur Websphere

Vous pouvez déployer l'application Unica Plan à partir d'un fichier WAR ou d'un fichier EAR sur le serveur d'applications WebSphere® (WAS).

Avant de commencer

Avant de déployer Unica Plan sur Websphere :
  • Vérifiez que la version de WebSphere est conforme aux conditions préalables décrites dans le document Recommended Software Environments and Minimum System Requirements, y compris les groupes de correctifs ou les mises à jour.
  • Vérifiez que vous utilisez la console WebSphere Integrated Solutions pour configurer WebSphere Application Server. La procédure qui suit vous guide dans la configuration des contrôles spécifiques.
  • Vérifiez que vous avez ajouté el-api.jar dans le répertoire de la bibliothèque du serveur WAS.
Remarque : Les contrôles de l'interface de WebSphere Application Server peuvent s'afficher dans une séquence et sous des libellés différents selon la version du produit.

Pourquoi et quand exécuter cette tâche

Procédez comme suit pour définir l'environnement pour le déploiement de Unica Plan :

Procédure

  1. Définissez une propriété personnalisée : Dans le formulaire Serveur d'applications > <serveurs> > Conteneur Web > Propriétés personnalisée, cliquez sur Nouveau et entrez les valeurs suivantes :
    • Nom : com.ibm.ws.webcontainer.invokefilterscompatibility
    • Valeur : true
  2. Créez le fournisseur JDBC : dans le formulaire Ressources > JDBC > Fournisseurs JDBC, cliquez sur Nouveau. Renseignez les zones de l'assistant Création d'un nouveau fournisseur JDBC, y compris les zones suivantes :

    La création de la source de données sur le serveur d'applications Web peut être ignorée si vous procédez à la configuration à l'aide du programme d'installation.

    1. Pour le type d'implémentation, sélectionnez la source de données du pool de connexions.
    2. Spécifiez le chemin de bibliothèque natif du fichier JAR de pilote de base de données sur le serveur.
      Par exemple, db2jcc4.jar / ojdbc6.jar / sqljdbc4.jar / mariadb-java-client-2.4.1 / onedb-jdbc-8.0.0.1-complete.jar.
    3. Pour MariaDB, fournissez un nom de classe d'implémentation tel que org.mariadb.jdbc.MariaDbDataSource
  3. Créez la source de données : dans le formulaire Resources > JDBC > Sources de données, cliquez sur Nouveau. Renseignez les zones de l'assistant de création d'une source de données en effectuant les opérations suivantes :

    La création de la source de données sur le serveur d'applications Web peut être ignorée si vous procédez à la configuration à l'aide du programme d'installation.

    1. Spécifiez un nom de source de données.
    2. Pour le nom JNDI, entrez plands.
    3. Sélectionnez le fournisseur JDBC créé à l'étape 2.
    4. Spécifiez le nom de la base de données et le nom du serveur.
    5. Sélectionnez l'alias de configuration de mappage WSLogin.
  4. Définissez les propriétés personnalisées de la source de données : dans le formulaire Fournisseurs JDBC > <fournisseur de la base de données> > Sources de données > Propriétés personnalisées, cliquez sur Nouveau pour ajouter deux propriétés :
    • Nom : utilisateur
    • Valeur : <user_name>
    • Nom : mot de passe
    • Valeur : <password>

    Si vos tables de données Unica Plan se trouvent dans DB2®, recherchez la propriété resultSetHoldability et définissez sa valeur sur 1. Si cette propriété n'existe pas, ajoutez-la.

  5. Créez des propriétés personnalisées pour la source de données MariaDB.
    • Port : <portnumber>
    • databaseName: <database name>
    • serverName: <server name>
    • driverType : 4
  6. Configurez la machine virtuelle Java : dans le formulaire Serveurs d'application > <serveur> > Définition de processus > Machine virtuelle Java, identifiez le Classpath, puis ajoutez les entrées suivantes comme arguments JVM génériques, séparés par un espace :
    • -Dplan.home=<HCL_Unica_Home>\<Plan_Home>

      Où <HCL_Unica_Home> est le chemin d'accès au répertoire de niveau supérieur et <Plan_Home> est le chemin d'accès au répertoire dans lequel vous avez installé Unica Plan. En règle générale, ce chemin est HCL_Unica/Plan.

    • -Dclient.encoding.override=UTF-8
    • Vérifiez que les paramètres JVM suivants sont présents : Si ce n'est pas le cas, ajoutez-les :
      • Pour les versions 12.1.0, 12.1.0.1, 12.1.0.2 et 12.1.0.3, ajoutez les paramètres suivants :
        • -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
        • -Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
        • -Dlog4j.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
      • Pour la version 12.1.0.4, en cas d'installation, ajoutez les paramètres suivants. Si vous faites une mise à niveau depuis la version 12.1.0 ou une version ultérieure, supprimez les paramètres mentionnés précédemment et ajoutez les paramètres suivants :
        • -Dlog4j.configuration=file:///<Plan_home>\conf\plan_log4j_1x.xml
        • -Dplan.log4j.config=<Plan_home>\conf\plan_log4j.xml
        • -Dplan.log4j.async=true (If not set, deafults to true)
      Remarque :
      • Pour les versions 12.1.0, 12.1.0.1, 12.1.0.2 et 12.1.0.3, si vous avez personnalisé le fichier plan_log4j.xml et effectué quelques modifications pour l'adapter à votre organisation, veillez à appliquer ces paramètres dans le fichier plan_log4j.xml spécifié ici conformément aux fichiers -Dlog4j2.configurationFile et -Dlog4j.configurationFile qui ont été déployés.
      • Pour la version 12.1.0.4, si vous avez personnalisé le fichier plan_log4j.xml et effectué quelques modifications pour l'adapter à votre organisation, veillez à appliquer ces paramètres dans le fichier plan_log4j.xml spécifié ici conformément au fichier -Dplan.log4j.config qui a été déployé.
      • Pour les versions 12.1.0, 12.1.0.1, 12.1.0.2 et 12.1.0.3, assurez-vous que le fichier xml vers lequel pointent log4j2.configurationFile et log4j.configurationFile est identique et respecte la syntaxe log4j2. Le fichier doit contenir les deux lignes suivantes en haut :
         <?xml version="1.0" encoding="UTF-8"?>
<Configuration packages="com.unica.afc.logger" monitorInterval="60">
      • Pour la version 12.1.0.4, assurez-vous que le fichier xml sur lequel pointe le fichier -Dplan.log4j.config respecte la syntaxe log4j2. Le fichier doit contenir les deux lignes suivantes en haut :
         <?xml version="1.0" encoding="UTF-8"?>
<Configuration packages="com.unica.afc.logger" monitorInterval="60">
      • Reportez-vous à la documentation log4j2 pour en savoir plus en cliquant sur ce lien : https://logging.apache.org/log4j/2.0/manual/configuration.html
      • Sous Windows, le chemin d'accès contient une barre oblique inversée, alors que sous UNIX, il doit contenir une barre oblique droite.
      • Le séparateur de chemin dans le nom du fichier de configuration log4j doit être défini en tant que style Windows () ou style UNIX (/) en fonction du système d'exploitation sous-jacent.
  7. Définissez le niveau de compilation JSP sur 18 dans WebSphere Application Server.

Déploiement du fichier WAR ou EAR

Lorsque vous déployez une nouvelle application d'entreprise, WebSphere Integrated Solutions Console affiche une série de formulaires. La procédure qui suit vous guide dans la configuration des contrôles spécifiques de ces formulaires. Les contrôles de l'interface de WebSphere peuvent s'afficher dans une séquence et sous des dénominations différentes selon la version du produit.

Pourquoi et quand exécuter cette tâche

Procédez comme suit pour déployer le fichier WAR ou EAR :

Procédure

  1. Sélectionnez Applications > Nouvelle Application > Nouvelle application d'entreprise.
  2. Sur le formulaire initial, sélectionnez le système de fichiers éloigné, puis dans la zone Parcourir, naviguez jusqu'au fichier plan.war ou jusqu'à votre fichier EAR.
  3. Dans la fenêtre Préparation de l'installation de l'application :
    • Sélectionnez Détaillée.
    • Sélectionnez Générer des liaisons par défaut.
    • Sélectionnez Remplacer les liaisons existantes.
  4. Dans la fenêtre Sélection des options d'installation, effectuez les opérations suivantes :
    • Sélectionnez Précompiler les fichiers JavaServer Pages.
    • Dans la zone Nom de l'application, entrez plan.
    • Sélectionnez Remplacer les paramètres de rechargement de classe des modules Web et EJB.
    • Dans la zone Intervalle de rechargement en secondes, entrez un nombre entier, 4 par exemple.
  5. Dans la fenêtre Mapper les Modules vers les serveurs, sélectionnez le Module. Si vous avez déployé un fichier EAR, sélectionnez tous les fichiers WAR.
  6. Dans la fenêtre Fournir des Options pour compiler les JSP, sélectionnez le Module Web. Si vous avez déployé un fichier EAR, sélectionnez tous les fichiers WAR.
  7. Définissez le Niveau de source de kit JDK à 18.
  8. Dans le formulaire Options de rechargement JSP pour les modules Web, sélectionnez Activation du rechargement de classe JSP et dans la zone Intervalle de rechargement JSP en secondes, entrez 5.
  9. Dans la fenêtre Mappage de bibliothèques partagées, sélectionnez l'Application et le Module.
  10. Dans la fenêtre Mappage de relations de bibliothèque partagée, sélectionnez l'Application et le Module.
  11. Dans la fenêtre Mappage des références de ressources vers les ressources, sélectionnez le module et entrez plands dans la zone Nom JNDI de ressource cible.
  12. Dans la fenêtre Mappage des racines de contexte des modules Web, entrez /plan dans la zone Racine du contexte.
  13. Passez en revue et enregistrez vos paramètres.

Définition des règles de chargeur de classe

Les règles de chargeur de classe définissent la manière dont l'application est configurée sur WAS. Vous devez modifier certains paramètres par défaut de WAS avant de déployer Unica Plan.

Pourquoi et quand exécuter cette tâche

Procédez comme suit pour définir les règles de chargeur de classe :

Procédure

  1. Dans le menu Applications d'entreprise > plan > Chargeur de classes, sélectionnez Remplacer les paramètres de rechargement de classe des modules Web et EJB.
  2. Pour l'ordre de chargeur de classes, sélectionnez Classes chargées en premier avec un chargeur de classe local (parent en dernier).
  3. Pour Règles de chargeur de classes WAR, sélectionnez Chargeur de classes unique pour l'application.
  4. Cliquez sur Appliquer et sur Enregistrer les paramètres.

Définition des paramètres pour les cookies

Vous devez définir et paramétrer les cookies via l'option Gestion de session des Applications d'entreprise Websphere.

Pourquoi et quand exécuter cette tâche

Procédez comme suit pour définir les paramètres pour les cookies :

Procédure

  1. Accédez à Applications d'entreprise > plan > Gestion de session.
  2. Sélectionnez Remplacer la gestion de session.
  3. Sélectionnez Activer les cookies.
  4. Cliquez sur Appliquer, puis accédez à Applications d'entreprise > plan > Gestion de session > Cookies.
  5. Changez le Unica Plan Nom du cookie , JSESSIONID, par UMOSESSIONID.
  6. Cliquez sur Appliquer et sur Enregistrer les paramètres.

Définition des paramètres de module EAR

Si vous déployez un fichier EAR, vous devez définir les paramètres des fichiers WAR individuels contenus dans le fichier EAR.

Pourquoi et quand exécuter cette tâche

Procédez comme suit pour définir les paramètres de module du fichier EAR :

Procédure

  1. Accédez à Applications d'entreprise et sélectionnez le fichier EAR.
  2. Dans le formulaire Gestion des modules, sélectionnez l'un des fichiers WAR, par exemple MktOps.war.
  3. Dans le formulaire Applications d'entreprise > EAR > Gestion des modules > WAR, procédez comme suit :
    1. Dans la zone Pondération de démarrage, entrez 10000.
    2. Dans la zone Ordre du chargeur de classes, sélectionnez Les classes chargées avec une classe d'application sont chargées en premier.
  4. Dans Applications d'entreprise > EAR > Gestion des modules > WAR > Gestion de sessions, sélectionnez Activer les cookies.
  5. Dans Applications d'entreprise > EAR > Gestion des modules > WAR > Gestion de sessions > Cookies, procédez comme suit :
    1. Dans la zone Nom du cookie, entrez CMPJSESSIONID.
    2. Dans la zone Age maximal des cookies, sélectionnez Session de navigateur en cours.
  6. Dans Applications d'entreprise > EAR > Gestion des modules > WAR > Gestion de sessions, entrez les informations suivantes :
    1. Sélectionnez Autoriser le dépassement.
    2. Dans la zone Nombre maximal de sessions en mémoire, entrez 1000.
    3. Dans la zone Délai d'attente de la session, sélectionnez Définir le délai d'expiration et entrez 30.
  7. Définissez les mêmes paramètres pour chacun des autres fichiers WAR, y compris unica.war et plan.war.
    Remarque : Si le fichier Campaign.war existe également dans le fichier EAR et que vous prévoyez d'intégrer Unica Plan à Unica Campaign, définissez les mêmes paramètres pour le fichier Campaign.war.