Plug-in Windchill AI Assistant > Installazione e configurazione del plug-in Windchill AI Assistant nell'ambiente locale > Configurazione necessaria prima dell'installazione del plug-in Windchill AI Assistant per l'ambiente locale
Configurazione necessaria prima dell'installazione del plug-in Windchill AI Assistant per l'ambiente locale
* 
I destinatari del presente argomento sono gli amministratori che configurano il sistema Windchill locale.
Gli amministratori devono completare i seguenti prerequisiti prima di installare il plug-in.
Configurare il server Windchill
Prima di installare il plug-in AI nell'ambiente Windchill, assicurarsi che il sistema soddisfi i requisiti di configurazione descritti in Versioni supportate e requisiti. Il rispetto di questi requisiti è essenziale per garantire la compatibilità, le prestazioni e la stabilità del plug-in all'interno dell'ecosistema Windchill.
Per ulteriori informazioni sulla configurazione del server Windchill, vedere Installing Windchill and the Installation Process Flow.
Poiché il plug-in è ospitato sullo stesso computer del method server, è necessaria memoria aggiuntiva per garantire un funzionamento corretto.
Configurazione del server Apache - Il plug-in utilizza i seguenti metodi di autenticazione tramite Apache:
• Autenticazione di base - Accesso semplice con nome utente e password
• SSO SAML
• CAC-PKI (certificato client) - Autenticazione avanzata tramite certificati SSL
Aggiornare manualmente le impostazioni di Apache
Quando si installa l'ultima versione di CPS che supporta la funzionalità Gestione plug-in con Mantieni impostazioni Apache, il server Apache non viene aggiornato durante il processo di aggiornamento. Ciò significa che la configurazione esistente di Apache rimane invariata e le nuove modifiche alla configurazione introdotte nell'aggiornamento non vengono applicate automaticamente. Per applicare manualmente le modifiche richieste alla configurazione di Apache, attenersi alla procedura descritta di seguito.
Eseguire i passi riportati di seguito, che sono in genere applicabili a tutti i tipi di autenticazione (SSO SAML o autenticazione di base).
1. Caricare i moduli necessari - Aggiornare il file modules-load.conf.template situato in <Windchill_Home>\HTTPServer\conf\templates includendo il codice seguente:
<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>
In base al tipo di autenticazione, sono necessari passi aggiuntivi.
2. SSO SAML:
a. Assicurarsi che la direttiva ShibUseHeaders On sia presente negli elementi LocationMatch in /apache/conf/conf.d/30-app-Windchill-1Auth.conf per REMOTE_USER. Qualora non sia presente, aggiungerla.
b. Riconfigurare Apache. Prima di procedere, assicurarsi di eseguire un backup della directory di Apache. Eseguire quindi il comando seguente per riconfigurare Apache:
ant -f config.xml reconfigure
3. Autenticazione di base:
a. Aggiornare il file webAppAuthResToConf.xsl situato in <Windchill_Home>\HTTPServer\conf\templates\xsl includendo il seguente codice dopo la riga 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. Modificare il file app-Windchill-AuthRes.xml - Aggiornare il file app-Windchill-AuthRes.xml situato in <Windchill_Home>\HTTPServer\conf includendo la seguente riga subito dopo il tag di apertura <resources>, prima di qualsiasi voce esistente <resource>:
<resource>WCPlugins</resource>
c. Riconfigurare Apache. Prima di procedere, assicurarsi di eseguire un backup della directory di Apache. Eseguire quindi i comandi seguenti per riconfigurare Apache:
ant -f webAppConfig.xml regenAllWebApps
ant -f config.xml reconfigure
* 
Verificare che Windchill sia configurato per HTTPS. Per ulteriori informazioni, vedere Configuring HTTPS for PTC HTTP Server and Windchill.
Impostare la directory di installazione del plug-in
Una proprietà dedicata, wt.plugins.installed.dir, è disponibile per impostazione predefinita per definire la directory in cui i file di plug-in vengono decompressi e installati. Per default, questa proprietà viene lasciata vuota, ovvero non è predefinito alcun percorso di installazione.
Un amministratore che installa Windchill deve creare manualmente una directory sicura esterna alla home directory di Windchill, con permessi di lettura, scrittura ed esecuzione, quindi procedere alla configurazione di questa proprietà.
Per aggiungere e propagare la proprietà wt.plugins.installed.dir nel file wt.properties tramite xconfmanager, utilizzare il comando seguente: Esempio:
xconfmanager -s wt.plugins.installed.dir=<your_custom_path> -t codebase/wt.properties && xconfmanager -pF
Assicurarsi che l'accesso alla directory di installazione sia concesso solo agli utenti amministratori. Questo permesso non deve essere concesso ad altri utenti.
* 
Se la directory di installazione del plug-in non viene creata nel modo descritto, l'installazione del plug-in non procederà.
Dopo aver creato una directory e averla definita utilizzando la proprietà, è possibile installare il plug-in senza richiedere un riavvio del server Windchill.
File di log nella directory di installazione del plug-in
La directory di installazione del plug-in contiene una cartella logs con i file generati dal plug-in, ad esempio /opt/ptc/plugins/logs. Gli amministratori possono fare riferimento a questi log dettagliati per risolvere problemi o verificare operazioni. Questi log includono data e ora, dettagli della richiesta e messaggi di errore.
Assicurarsi che l'accesso alla directory di log sia concesso solo agli utenti amministratori. Questo permesso non deve essere concesso ad altri utenti.
Viene fornita una proprietà wt.plugins.logs.dir dedicata per specificare la posizione personalizzata per la generazione dei log del plug-in.
• Se la proprietà non è impostata, i log del plug-in vengono generati nella directory di installazione del plug-in, ad esempio /opt/ptc/plugins/logs.
• Se la proprietà è impostata, i log del plug-in vengono generati nella directory specificata dalla proprietà.
* 
I log relativi a Windchill sono disponibili nei log di Apache e del method server all'interno delle directory di registrazione dell'installazione di Windchill.
Impostare la directory temporanea del plug-in
È stata introdotta una nuova proprietà, wt.plugins.temp.dir. Si tratta di una proprietà facoltativa che definisce la directory in cui memorizzare i file temporanei del plug-in. Per default, il percorso della directory è impostato su ${wt.temp}/<pluginId>. wt.temp è la proprietà wt esistente che definisce la posizione temporanea di Windchill. È importante assicurarsi che l'accesso in scrittura a questa directory sia concesso solo agli utenti amministratori. Questo permesso non deve essere concesso ad altri utenti.
Per impostare questa proprietà, utilizzare il comando seguente:
xconfmanager -s wt.plugins.temp.dir=<your_custom_path> -t codebase/wt.properties && xconfmanager -pF
Conservare i certificati Java
Il plug-in viene installato da una posizione ospitata da PTC in Azure. Assicurarsi che vengano conservati i certificati CA Java; in caso contrario, le connessioni TLS dal server Windchill a Internet avranno esito negativo. Prima di installare il plug-in, eseguire il seguente comando in una finestra della riga di comando con diritti di amministratore:
"%JAVA_HOME%\bin\keytool.exe" -importkeystore -srckeystore "%JAVA_HOME%\lib\security\cacerts" -srcstorepass changeit -destkeystore
"%JAVA_HOME%\lib\security\jssecacerts" -deststoretype jks -deststorepass changeit
Configurare una directory condivisa per l'installazione del plug-in in ambienti cluster Windchill
In un ambiente cluster Windchill, l'installazione del plug-in richiede una directory condivisa accessibile da tutti i nodi del cluster. Questa posizione condivisa garantisce una distribuzione e una disponibilità omogenee dei plug-in nell'ambiente.
* 
L'installazione del plug-in in ambienti cluster è supportata solo tramite una directory condivisa. Le directory locali non sono supportate. Se la directory condivisa non è configurata correttamente o non è accessibile ad alcun nodo, il processo di installazione del plug-in avrà esito negativo.
Per configurare e proteggere correttamente la directory condivisa, gli amministratori devono seguire le linee guida seguenti:
• Creare una cartella condivisa in rete da utilizzare come directory comune di installazione dei plug-in, accessibile da tutti i nodi di Windchill.
• Specificare un percorso di rete valido:
◦ \\shared\plugins (per sistemi Windows che utilizzano percorsi in formato UNC)
◦ /mnt/shared/plugins (per sistemi Linux che utilizzano percorsi di rete montati)
• Assicurarsi che tutti i nodi abbiano accesso in lettura e scrittura alla cartella condivisa e concedere i permessi di esecuzione all'utente che esegue il programma di installazione di Windchill. In una configurazione cluster Windows, i server plug-in funzionano sempre in modalità headless.
• Utilizzare l'utilità xconfmanager per impostare la proprietà wt.plugins.installed.dir su ogni nodo e assicurarsi che punti alla directory condivisa.
• Assicurarsi che la directory condivisa disponga di spazio libero sufficiente per ospitare tutti i plug-in dopo l'installazione. Ad esempio, se si prevede di installare 10 plug-in e ogni plug-in ha dimensioni diverse, calcolare lo spazio totale necessario aggiungendo le dimensioni di tutti i plug-in.
* 
In una configurazione cluster, se uno dei nodi è inattivo durante l'installazione del plug-in, il plug-in viene installato solo nel nodo in esecuzione. Quando il nodo che era inattivo torna online, il plug-in viene installato automaticamente in tale nodo e le modifiche della configurazione di Apache vengono aggiornate di conseguenza.
Si consideri, ad esempio, un'impostazione con un Nodo 1 e un altro Nodo 2. Se Nodo 2 è inattivo o passa in modalità offline durante l'installazione del plug-in, il plug-in non verrà installato in Nodo 2 in quel momento. Dopo il riavvio del server e dei servizi Apache, quando Nodo 2 torna online, tutti i file di installazione necessari vengono aggiornati automaticamente su Nodo 2. Non sono necessari passi manuali.
È stato utile?