Déploiement de Unica Plan sur Apache Tomcat

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

Assurez-vous que la version d'Apache Tomcat répond aux conditions requises décrites dans le document Unica Recommended Software Environments and Minimum System Requirements. Suivez les instructions décrites ci-dessous lorsque vous déployez Unica Plan sur Apache Tomcat :

Depuis le répertoire bin sous votre directoire d'installation Apache Tomcat, localisez ou créez le script setenv.sh ou setenv.bat approprié à votre système d'exploitation dans un éditeur de texte, et ajoutez ou modifiez la propriété JAVA_OPTIONS, puis ajoutez les entrées suivantes. Utilisez un espace pour séparer les entrées.

-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. Généralement, ce répertoire est HCL_Unica/Plan.
-Dfile.encoding=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é.
- 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.
- Vérifiez que le paramètre relaxQueryChars est présent dans la balise de connecteur dans conf/server.xml dans Tomcat.
  <Connector port="7002" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" relaxedQueryChars="|,[,],\,`,{,},^" />

Déployez le fichier plan.war HCL en tant qu'application d'entreprise sur le serveur Apache Tomcat.
Remarque : Le déploiement du fichier EAR HCL n'est pas pris en charge dans Tomcat.
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 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.
2. Redémarrez Tomcat.
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.