Déploiement d'Unica Insights

Vous devez suivre un ensemble d'instructions lorsque vous déployez Unica Insights dans votre serveur d'applications Web. Il existe un ensemble d'instructions spécifique pour le déploiement d'Unica Insights sur WebLogic et sur WebSphere.

Lorsque vous avez exécuté le programme d'installation d'Unica, vous avez exécuté les actions suivantes :

• Vous avez créé le fichier WAR d'Unica Insights (Insights.war).

Nous supposons que vous disposez d'informations sur la manière d'utiliser votre serveur d'applications Web. Pour plus d'informations sur la navigation dans la console d'administration, voir la documentation de votre serveur d'applications Web.

NOTE

Dans les rapports Unica Insights, si vous accédez à Unica à l'aide d'un équilibreur de charge, d'un proxy inverse ou d'un logiciel de gestion d'accès Web, configurez les URL de proxy inverse dans le fichier viewer.properties en procédant comme suit :
  • Ouvrez Insights.war.
  • Accédez au dossier WEB-INF et au fichier viewer.properties.
  • Désactivez la mise en commentaires de la propriété base_url en supprimant « # ».
  • Configurez la propriété base_url avec l'URL du proxy inverse d'Unica Insights.
  • Redéployez le fichier Insights.war.

Instructions de déploiement d'Unica Insights sur WebLogic

Vous devez suivre un ensemble d'instructions lorsque vous déployez Unica Insights sur l'application WebLogic.

Utilisez les instructions suivantes lorsque vous déployez les produits Unica Insights sur une version prise en charge de WebLogic :
  • Les produits Unica personnalisent la machine virtuelle Java (JVM) utilisée par WebLogic. Si vous rencontrez des erreurs liées à la machine virtuelle Java, vous pouvez créer une instance WebLogic dédiée aux produits Unica.
  • Ouvrez le fichier startWebLogic.cmd et vérifiez que le SDK qui est sélectionné pour le domaine WebLogic que vous utilisez est le SDK Sun pour la variable JAVA_VENDOR. La variable JAVA_VENDOR doit avoir la valeur Sun (JAVA_VENDOR=Sun).

    Si la variable JAVA_VENDOR a pour valeur JAVA_VENDOR, cela signifie que JRockit est sélectionné. Vous devez modifier le SDK sélectionné, car JRockit n'est pas pris en charge. Pour modifier le SDK sélectionné, voir la documentation BEA WebLogic.

  • Déployez Unica Insights en tant qu'application Web.
  • Si vous configurez WebLogic pour qu'il utilise dans le plug-in IIS, consultez la documentation BEA WebLogic.
  • Exécutez les tâches suivantes si votre installation doit prendre en charge les caractères non-ASCII, par exemple, pour le portugais ou pour les paramètres régionaux qui exigent des caractères multi-octets :
    1. Editez le script setDomainEnv dans le répertoire bin sous le répertoire de domaine WebLogic afin d'ajouter -Dfile.encoding=UTF-8 à JAVA_VENDOR.
    2. Dans la console WebLogic, cliquez sur le lien Domaine sur la page d'accueil.
    3. Dans l'onglet Applications Web, cochez la case Chemin réel archivé activé.
    4. Redémarrez WebLogic.
    5. Déployez et démarrez le fichier Insights.war.
  • Si vous effectuez le déploiement dans un environnement de production, spécifiez une valeur de 1024 comme paramètres de taille du segment de mémoire JVM en ajoutant la ligne suivante dans le script setDomainEnv :

    Set MEM_ARGS=-Xms1024m -Xmx1024m -XX:MaxPermSize=256m

Instructions de déploiement d'Unica Insights sur WebSphere

Vous devez suivre un ensemble d'instructions lorsque vous déployez Unica Insights sur WebSphere. Assurez-vous que la version de WebSphere répond aux conditions requises décrites dans le document Environnements logiciels recommandés et configuration minimum requise qui précise les groupes de correctifs nécessaires. Suivez les instructions décrites ci-dessous lorsque vous déployez Unica Insights sur WebSphere :
  1. Spécifiez la propriété personnalisée suivante dans le serveur :
    • Nom : com.ibm.ws.webcontainer.invokefilterscompatibility
    • Valeur : true
  2. Définissez une propriété personnalisée dans WebSphere.
  3. Déployez le fichier Insights.war en tant qu'application d'entreprise. Lorsque vous déployez le fichier Insights.war, vérifiez que la valeur Java 17 pour SDK 1.7 et 18 pour SDK 1.8 est affectée au niveau source du kit JDK du compilateur JSP et que les pages JSP sont précompilées comme suit :
    • Dans le formulaire dans lequel vous recherchez et sélectionnez le fichier WAR, sélectionnez Afficher tous les paramètres et options d'installation afin que l'assistant Sélection des options d'installation s'exécute.
    • A l'étape 1 de l'assistant Sélection des options d'installation, sélectionnez Précompilation des fichiers JSP.
    • A l'étape 3 de l'assistant de sélection des options d'installation, vérifiez que le paramètre Niveau de source JDK a pour valeur 17 pour SDK 1.7 ou 18 pour SDK 1.8.
    • A l'étape 8 de l'assistant de sélection des options d'installation, sélectionnez UnicaPlatformDS comme ressource cible correspondante.
    • A l'étape 10 de l'assistant Sélectionner des options d'installation, la racine de contexte doit êre définie sur /Insights.
  4. Dans la section Paramètres de conteneur Web > Conteneur Web > Gestion de session du serveur, activez les cookies. Spécifiez un autre nom de cookie de session pour chaque application déployée. Utilisez l'une des procédures suivantes pour spécifier un nom de cookie :
    • Cochez la case Remplacer la gestion de session sous Gestion de session. Si vous avez déployé des fichiers WAR séparés pour vos produits Unica, dans la console WebSphere, dans la section Applications > Applications d'entreprise > [application_déployée] > Gestion de session > Activer les cookies > Nom de cookie du serveur, spécifiez un nom de cookie de session unique.
    • Si votre installation doit prendre en charge les caractères non-ASCII, par exemple pour le portugais ou pour les paramètres régionaux qui exigent des caractères multi-octets, ajoutez la ligne suivante aux arguments JVM génériques au niveau du serveur :

      -Dfile.encoding=UTF-8

      -Dclient.encoding.override=UTF-8

  5. Conseil de navigation : Conseil de navigation : sélectionnez Serveurs > Serveurs d'applications > Gestion de processus et Java > Définition de processus > Machine virtuelle Java > Arguments JVM génériques. Voir la documentation WebSphere pour obtenir plus de détails.
  6. Dans la section Applications > Applications d'entreprise du serveur, sélectionnez le fichier WAR que vous avez déployé, puis sélectionnez Chargement de classes et détection de mise à jour et définissez les propriétés ci-dessous. Si vous déployez un fichier WAR :
    • Pour Ordre du chargeur de classes, sélectionnez Classes chargées en premier avec un chargeur de classes local (dernier parent).
    • Pour Règles de chargeur de classes WAR, sélectionnez Chargeur de classes unique pour l'application.
  7. Commencez le déploiement. Si votre instance de WebSphere est configurée pour utiliser une machine virtuelle Java version 1.7 ou plus récente, procédez comme suit pour résoudre un problème avec la base de données de fuseau horaire.
    • Arrêtez WebSphere.
    • Téléchargez l'utilitaire Time Zone Update Utility for Java (JTZU).
    • Suivez les étapes indiquées par IBM (JTZU) pour mettre à jour les données de fuseau horaire dans votre machine virtuelle Java.
    • Redémarrez WebSphere.
  8. Dans Applications d'entreprise WebSphere, sélectionnez Application > Gestion des modules > Votre application > Ordre du chargeur de classes > Classes chargées en premier avec un chargeur de classe local (dernier parent).
    • La taille de segment de mémoire minimale recommandée pour le fonctionnement de base de l'application est 512 et la taille de segment de mémoire maximale recommandée est 1024. Pour spécifier la taille de segment de mémoire, procédez comme suit :
      • Dans Applications d'entreprise WebSphere, sélectionnez Serveurs > Serveurs d'applications WebSphere > serveur1 > Infrastructure du serveur > Gestion des processus et Java > Définition des processus > Machine virtuelle Java.
      • Affectez la valeur 512 à la taille du segment de mémoire initial.
      • Affectez la valeur 1024 à la taille de segment de mémoire maximale. Pour plus d'informations sur la définition de la taille, voir la documentation WebSphere. Pour DB2, définissez progressiveStreaming = 2 dans la console WebSphere au chemin suivant : JDBC > Sources de données > UnicaPlatformDS > Propriétés personnalisées.

Instructions de déploiement d'Unica Insights sur JBoss

Avant de déployer Insights.war dans le serveur d'applications JBoss, mettez à jour le fichier Insights.war.

Vous devez suivre un ensemble d'instructions lorsque vous déployez Unica Insights sur JBoss. Assurez-vous que la version de JBoss répond aux conditions requises décrites dans le document Environnements logiciels recommandés et configuration minimum requise. Suivez les instructions décrites ci-dessous lorsque vous déployez Unica Insights sur JBoss :
Remarque : Si vous ne parvenez pas à afficher les rapports Unica Insights avec le serveur d'applications JBOSS sous UNIX, assurez-vous de définir toutes les autorisations (777) sur le fichier Platform/Insights/Reports/Insights.war file avant le déploiement Insights.war.
Utilisez les instructions suivantes lorsque vous déployez les produits Unica Insights sur une version prise en charge de JBoss :
  1. Déployez le fichier Insights.war en tant qu'application d'entreprise. Par exemple : déployez <Platform_Install>\ Insights.war.

    Voir https://docs.jboss.org/jbossweb/3.0.x/deployer-howto.html pour de plus amples instructions sur le déploiement de serveur d'applications Web dans JBoss.

  2. Exécutez les tâches suivantes si votre installation doit prendre en charge les caractères non-ASCII, par exemple, pour le portugais ou pour les paramètres régionaux qui exigent des caractères multi-octets :
    • Modifiez le script standalone.conf dans le répertoire bin sous JBOSS/bin pour ajouter -Dfile.encoding=UTF-8.

      -Dclient.encoding.override=UTF-8

      -Djboss.as.management.blocking.timeout=3600

      à JAVA_VENDOR.
    • Redémarrez le serveur JBoss.

Instructions de déploiement d'Unica Insights sur Apache Tomcat

Vous devez suivre un ensemble d'instructions lorsque vous déployez Unica Insights sur Apache Tomcat.

Assurez-vous que la version d'Apache Tomcat répond aux conditions requises décrites dans le document Environnements logiciels recommandés et configuration minimum requise de produits HCL Enterprise. Suivez les instructions décrites ci-dessous lorsque vous déployez Unica Insights sur Apache Tomcat :
  1. Déployez le fichier Insights.war en tant qu'application d'entreprise sur le serveur Apache Tomcat.
  2. Exécutez les tâches suivantes si votre installation doit prendre en charge les caractères non-ASCII, par exemple, pour le portugais ou pour les paramètres régionaux qui exigent des caractères multi-octets :
    • Editez le fichier setenv.sh pour le script des instances du produit respectif dans le répertoire bin sous le répertoire de vos instances Tomcat afin d'ajouter -Dfile.encoding=UTF-8 - Dclient.encoding.override=UTF-8 to JAVA_VENDOR.
    • Editez le fichier setenv.sh pour le script des instances du produit respectif dans le répertoire bin sous le répertoire de vos instances Tomcat afin d'ajouter -Dfile.encoding=UTF-8 - Dclient.encoding.override=UTF-8 to JAVA_VENDOR.
    • Editez le fichier setenv.sh pour le script des instances du produit respectif dans le répertoire bin sous le répertoire de vos instances Tomcat afin d'ajouter -Dfile.encoding=UTF-8 - Dclient.encoding.override=UTF-8 to JAVA_VENDOR.
    • Editez le fichier setenv.sh pour le script des instances du produit respectif dans le répertoire bin sous le répertoire de vos instances Tomcat afin d'ajouter -Dfile.encoding=UTF-8 - Dclient.encoding.override=UTF-8 to JAVA_VENDOR.
    • Redémarrez Tomcat.
  3. En cas de déploiement dans un environnement de production, vous pouvez ajouter un paramètre correspondant au segment JVM pour cette instance Tomcat dans le fichier app-one/bin/setenv.sh respectivement pour toutes les instances.