Plug-in Windchill AI Assistant > Installation et configuration du plug-in Windchill AI Assistant dans un environnement sur site > Configuration requise avant l'installation du plug-in Windchill AI Assistant pour un environnement sur site
Configuration requise avant l'installation du plug-in Windchill AI Assistant pour un environnement sur site
* 
Cette rubrique est destinée aux administrateurs configurant le système Windchill sur site.
Les administrateurs doivent remplir les conditions requises suivantes avant d'installer le plug-in :
Configurer le serveur Windchill
Avant d'installer le plug-in IA dans votre environnement Windchill, assurez-vous que votre système satisfait aux exigences de configuration énoncées dans la rubrique Versions prises en charge et exigences. Le respect de ces exigences est essentiel pour garantir la compatibilité, les performances et la stabilité du plug-in au sein de l'écosystème Windchill.
Pour plus d'informations sur la configuration du serveur Windchill, consultez la rubrique Installing Windchill and the Installation Process Flow.
Le plug-in étant hébergé sur la même machine que le serveur de méthodes, son bon fonctionnement nécessite un supplément de mémoire.
Configuration du serveur Apache : le plug-in utilise les méthodes d'authentification suivantes via Apache :
• Authentification de base : accès simple par nom d'utilisateur/mot de passe
• Authentification unique SAML
• CAC-PKI (certificat client) : authentification forte à l'aide de certificats SSL
Mettre à jour les paramètres Apache manuellement
Lors de l'installation de la dernière version du groupe de correctifs critiques (CPS) prenant en charge la fonctionnalité Gestionnaire de plug-in avec Conserver les paramètres Apache, le serveur Apache n'est pas mis à jour pendant le processus de mise à niveau. Cela signifie que la configuration Apache existante reste inchangée, et que les modifications apportées à la configuration dans la mise à jour ne sont pas appliquées automatiquement. Pour appliquer manuellement les modifications de configuration Apache requises, procédez comme suit.
Exécutez ces étapes, qui sont généralement applicables à tous les types d'authentification (authentification unique (SSO) SAML ou authentification de base) :
1. Chargez les modules requis : mettez à jour le fichier modules-load.conf.template situé dans <Windchill_Home>\HTTPServer\conf\templates en y incluant le code suivant :
<IfModule !rewrite_module>
LoadModule rewrite_module modules/mod_rewrite.so
</IfModule>
<IfModule !proxy_module>
LoadModule proxy_module modules/mod_proxy.so
</IfModule>
<IfModule !proxy_http_module>
LoadModule proxy_http_module modules/mod_proxy_http.so
</IfModule>
<IfModule !proxy_hcheck_module>
LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so
</IfModule>
<IfModule !proxy_balancer_module>
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
</IfModule>
<IfModule !slotmem_shm_module>
LoadModule slotmem_shm_module modules/mod_slotmem_shm.so
</IfModule>
<IfModule !watchdog_module>
LoadModule watchdog_module modules/mod_watchdog.so
</IfModule>
<IfModule !lbmethod_byrequests_module>
LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so
</IfModule>
Selon votre type d'authentification, des étapes supplémentaires sont requises.
2. Authentification unique (SSO) SAML :
a. Assurez-vous que l'instruction ShibUseHeaders On est présente dans les éléments LocationMatch de /apache/conf/conf.d/30-app-Windchill-1Auth.conf pour REMOTE_USER. Si ce n'est pas le cas, ajoutez-la.
b. Reconfigurez Apache. Avant de continuer, veillez à effectuer une sauvegarde du répertoire Apache. Ensuite, exécutez la commande suivante pour reconfigurer Apache :
ant -f config.xml reconfigure
3. Authentification de base :
a. Mettez à jour le fichier webAppAuthResToConf.xsl situé dans <Windchill_Home>\HTTPServer\conf\templates\xsl en y insérant le code suivant après la ligne Require valid-user :
<xsl:if test="$resource='WCPlugins'">
RewriteRule .* - [E=PROXY_USER:%{LA-U:REMOTE_USER}]
RequestHeader set REMOTE_USER %{PROXY_USER}e
</xsl:if>
b. Modifiez app-Windchill-AuthRes.xml : mettez à jour le fichier app-Windchill-AuthRes.xml situé dans <Windchill_Home>\HTTPServer\conf en y intégrant la ligne suivante immédiatement après la balise d'ouverture <resources>, avant toute entrée <resource> existante :
<resource>WCPlugins</resource>
c. Reconfigurez Apache. Avant de continuer, veillez à effectuer une sauvegarde du répertoire Apache. Ensuite, exécutez les commandes suivantes pour reconfigurer Apache :
ant -f webAppConfig.xml regenAllWebApps
ant -f config.xml reconfigure
* 
Vérifiez que Windchill est configuré pour HTTPS. Pour plus d'informations, consultez la rubrique Configuring HTTPS for PTC HTTP Server and Windchill.
Définir le répertoire d'installation du plug-in
Une propriété dédiée, wt.plugins.installed.dir, est fournie en standard pour définir le répertoire dans lequel les fichiers du plug-in sont décompressés et installés. Par défaut, cette propriété est laissée vide, ce qui signifie qu'aucun chemin d'installation n'est prédéfini.
Un administrateur installant Windchill doit créer manuellement un répertoire sécurisé à l'extérieur du répertoire de base Windchill avec des permissions de lecture, d'écriture et d'exécution, puis configurer cette propriété en conséquence.
Pour ajouter et propager la propriété wt.plugins.installed.dir dans le fichier wt.properties à l'aide de xconfmanager, utilisez la commande suivante. Par exemple :
xconfmanager -s wt.plugins.installed.dir=<your_custom_path> -t codebase/wt.properties && xconfmanager -pF
Assurez-vous que l'accès au répertoire d'installation est accordé uniquement aux utilisateurs administrateurs. Aucun autre utilisateur ne doit bénéficier de cette permission.
* 
Si le répertoire d'installation du plug-in n'est pas créé conformément aux instructions, l'installation du plug-in ne s'effectuera pas.
Après avoir créé un répertoire et l'avoir défini à l'aide de la propriété, vous pouvez installer le plug-in sans avoir à redémarrer le serveur Windchill.
Fichiers journaux dans le répertoire d'installation du plug-in
Le répertoire d'installation du plug-in comporte un dossier contenant les fichiers journaux générés par le plug-in, par exemple /opt/ptc/plugins/logs. Les administrateurs peuvent se référer à ces journaux détaillés pour résoudre les problèmes ou vérifier les opérations. Ces journaux incluent des horodatages, les détails des demandes et les messages d'erreur.
Assurez-vous que l'accès au répertoire de journaux est accordé uniquement aux utilisateurs administrateurs. Aucun autre utilisateur ne doit bénéficier de cette permission.
Une propriété dédiée, wt.plugins.logs.dir, est fournie pour spécifier l'emplacement personnalisé pour la génération des journaux du plug-in.
• Si la propriété n'est pas définie, les journaux du plug-in sont générés dans le répertoire d'installation du plug-in, par exemple /opt/ptc/plugins/logs.
• Si la propriété est définie, les journaux du plug-in sont générés dans le répertoire spécifié par la propriété.
* 
Les journaux associés à Windchill sont disponibles dans Apache et les journaux du serveur de méthodes stockés dans les répertoires de journalisation de l'installation Windchill.
Définir le répertoire temporaire du plug-in
Une nouvelle propriété, wt.plugins.temp.dir, a été introduite. Il s'agit d'une propriété facultative qui définit le répertoire de stockage des fichiers temporaires du plug-in. Par défaut, le chemin du répertoire est défini sur ${wt.temp}/<pluginId>. wt.temp est la propriété wt existante qui définit l'emplacement temporaire de Windchill. Il est important de veiller à ce que seuls les utilisateurs administrateurs disposent d'un accès en écriture à ce répertoire. Aucun autre utilisateur ne doit bénéficier de cette permission.
Pour définir cette propriété, utilisez la commande suivante :
xconfmanager -s wt.plugins.temp.dir=<your_custom_path> -t codebase/wt.properties && xconfmanager -pF
Conserver les certificats Java
Le plug-in est installé à partir d'un emplacement hébergé par PTC sur Azure. Assurez-vous que les certificats d'autorité de certification Java sont conservés ; dans le cas contraire, les connexions TLS entre votre serveur Windchill et Internet échoueront. Avant d'installer le plug-in, exécutez la commande suivante dans une fenêtre de ligne de commande avec des droits d'administrateur :
"%JAVA_HOME%\bin\keytool.exe" -importkeystore -srckeystore "%JAVA_HOME%\lib\security\cacerts" -srcstorepass changeit -destkeystore
"%JAVA_HOME%\lib\security\jssecacerts" -deststoretype jks -deststorepass changeit
Configurer un répertoire partagé pour l'installation du plug-in dans les environnements Windchill en grappe
Dans un environnement Windchill en grappe, l'installation du plug-in nécessite un répertoire partagé accessible à partir de tous les noeuds de la grappe. Cet emplacement partagé garantit une cohérence de déploiement et de disponibilité des plug-ins dans l'environnement.
* 
L'installation du plug-in dans les environnements en grappe est uniquement prise en charge par le biais d'un répertoire partagé. Les répertoires locaux ne sont pas pris en charge. Si le répertoire partagé n'est pas configuré correctement ou est inaccessible sur un noeud, le processus d'installation du plug-in échoue.
Les administrateurs doivent respecter les consignes suivantes pour configurer et sécuriser correctement le répertoire partagé :
• Créez un dossier partagé en réseau qui servira de répertoire commun d'installation du plug-in, accessible à partir de tous les noeuds Windchill.
• Spécifiez un chemin de réseau valide :
◦ \\shared\plugins (pour les systèmes Windows utilisant le format de chemin UNC)
◦ /mnt/shared/plugins (pour les systèmes Linux utilisant des chemins de réseau montés)
• Assurez-vous que tous les noeuds disposent d'un accès en lecture et en écriture au dossier partagé, et accordez des permissions d'exécution à l'utilisateur du programme d'installation Windchill. Dans une configuration en grappe Windows, les serveurs de plug-ins fonctionnent toujours en mode administré à distance.
• Utilisez l'utilitaire xconfmanager pour définir la propriété wt.plugins.installed.dir sur chaque noeud, et assurez-vous qu'elle pointe continuellement vers le répertoire partagé.
• Assurez-vous que le répertoire partagé dispose d'un espace libre suffisant pour accueillir tous les plug-ins après l'installation. Par exemple, si vous prévoyez d'installer 10 plug-ins de différentes tailles, calculez l'espace total requis en additionnant les tailles de tous les plug-ins.
* 
Dans une configuration en grappe, si l'un des noeuds est à l'arrêt pendant l'installation du plug-in, le plug-in n'est installé que sur le noeud en cours d'exécution. Lorsque le noeud à l'arrêt est remis en ligne, le plug-in y est automatiquement installé, et les modifications de configuration Apache sont mises à jour en conséquence.
Prenons l'exemple d'une configuration impliquant un Noeud 1 et un Noeud 2. Si le Noeud 2 est à l'arrêt ou est mis hors ligne pendant l'installation du plug-in, le plug-in n'est pas installé sur le Noeud 2 à ce stade. Une fois que le serveur et les services Apache ont été redémarrés et que le Noeud 2 est remis en ligne, tous les fichiers d'installation requis sont automatiquement mis à jour sur le Noeud 2. Aucune étape manuelle n'est requise.
Est-ce que cela a été utile ?