Installare e configurare Experience Service > Installazione > Installare Experience Service in un sistema Linux
  
Installare Experience Service in un sistema Linux
* 
Se si prevede di utilizzare SSO come metodo di autenticazione, vedere Operazioni preliminari per l'autenticazione Single Sign-On (SSO) per assicurarsi che siano stati soddisfatti tutti i prerequisiti prima di proseguire con l'installazione.
Il programma di installazione di Experience Service può essere eseguito in una delle seguenti modalità:
Modalità
Descrizione
xwindow
Esegue il programma di installazione con un'interfaccia utente grafica utilizzando X-Windows e i widget dell'interfaccia utente di default.
gtk
Esegue il programma di installazione con un'interfaccia utente grafica utilizzando X-Windows e i widget dell'interfaccia utente GTK.
text
Esegue il programma di installazione utilizzando un'interfaccia esclusivamente testuale.
unattended
Esegue il programma di installazione in una modalità che non richiede alcun input da parte dell'utente. Per ulteriori informazioni, vedere Modalità automatica.
In un ambiente grafico, fare doppio clic sul file del programma di installazione .run. In alternativa, per eseguire l'installazione dalla riga di comando, immettere il seguente comando:
$ <name of installer file>.run
Il programma di installazione seleziona automaticamente la modalità di esecuzione. Dopo un primo tentativo di eseguire il programma in una delle modalità grafiche, viene effettuato il passaggio alla modalità testuale se non è disponibile un programma di gestione della finestra grafica. Per fare in modo che il programma di installazione venga eseguito in una modalità specifica, eseguirlo dalla riga di comando e specificare la modalità di esecuzione come indicato di seguito:
$ <name of installer file>.run --mode <execution mode>
Per <execution mode> si intende una delle modalità elencate nella tabella.
Installare Experience Service come utente non root
È possibile installare Experience Service come utente non root senza utilizzare sudo in un sistema Linux. Tuttavia, per completare l'installazione è necessario innanzitutto disporre dei permessi indicati di seguito.
• Permessi di lettura, scrittura ed esecuzione per la directory padre della directory di installazione di destinazione. Ad esempio, se Experience Service viene installato nella directory di default /opt/ptc/studio-es, è necessario disporre dei permessi di lettura (r), scrittura (w) ed esecuzione (x) per la directory /opt/ptc.
• Qualora la directory di installazione sia già esistente, è necessario disporre dei permessi di lettura (r), scrittura (w) ed esecuzione (x) per la directory di installazione nonché essere proprietari della directory e dei relativi contenuti.
* 
Quando si esegue un aggiornamento, se l'installazione precedente è stata eseguita da un utente root o è stata eseguita utilizzando sudo e l'aggiornamento viene eseguito da un utente non root senza utilizzare sudo, è probabile che sia necessario aggiornare i permessi dei file e la proprietà della directory di installazione e della relativa directory padre prima di procedere con l'installazione.
Modalità interattive
Quando il programma di installazione viene eseguito in una delle modalità interattive (xwindow, gtk o text), attenersi alla procedura riportata di seguito per completare l'installazione.
* 
Questa procedura presuppone che il programma di installazione venga eseguito in una delle modalità di esecuzione grafica. Tuttavia, tutte le modalità sono equivalenti a livello funzionale.
1. Fare clic su Avanti nella finestra Installazione - Experience Service.
2. Selezionare Accetto contratto e fare clic su Avanti.
3. Nella finestra Directory di installazione accettare la directory di default o selezionare un'altra directory vuota. Fare clic su Avanti.
4. Immettere la porta e selezionare un'opzione dal campo Tipo di database nella finestra Configurazione Experience Service. Fare clic su Avanti.
5. Se si seleziona il tipo di database SQLite, viene visualizzata la finestra Database SQLite. Immettere il percorso del file di dati.
* 
Non è possibile selezionare un file già esistente.
Se si seleziona il tipo di database PostgreSQL, viene visualizzata la finestra Configurazione database. Immettere le seguenti informazioni di connessione PostgreSQL:
◦ Nome host database
◦ Porta database
◦ Nome database
◦ Nome utente database
◦ Password database
◦ Il server PostgreSQL richiede SSL (indica che il server PostgreSQL utilizza il protocollo TLS per le connessioni)
* 
Se si sta utilizzando la stessa istanza di PostgreSQL utilizzata dal server ThingWorx, il nome del database e il nome utente o di accesso utilizzati da Experience Service devono essere distinti dal nome del database e dal nome utente o di accesso utilizzati dal server ThingWorx.
Per ulteriori informazioni, vedere la sezione "Database" in Parametri di configurazione.
Fare clic su Avanti.
6. Nella finestra Configurazione TLS, selezionare Utilizza HTTPS (TLS) per configurare Experience Service in modo che venga utilizzato il protocollo HTTPS sicuro. In caso contrario, selezionare Utilizza HTTP (senza TLS) per utilizzare il protocollo HTTP non sicuro. Fare clic su Avanti.
Per ulteriori informazioni, vedere la sezione "Certificati TLS" in Parametri di configurazione e Certificati TLS (Transport Layer Security).
7. Se è stata selezionata l'opzione Utilizza HTTPS (TLS), selezionare il tipo di chiave e di certificati codificati in uso e fare clic su Avanti.
8. A seconda della selezione effettuata al passo precedente, eseguire una delle operazioni indicate di seguito.
◦ Se è stata selezionata l'opzione PEM, immettere le seguenti informazioni:
▪ Chiave privata PEM - Percorso del file che contiene la chiave privata.
▪ Crittografato - Selezionare questa casella di controllo se il file della chiave privata è crittografato e immettere la passphrase utilizzata per decrittografare il file.
▪ Certificato pubblico PEM - Percorso del file che contiene il certificato pubblico.
▪ Bundle di certificati CA intermedi PEM (facoltativo) - Percorso del file del bundle di certificati contenente i certificati delle autorità di certificazione intermedie.
* 
Non è il certificato dell'autorità di certificazione radice.
◦ Se è stata selezionata l'opzione PCKS12 (PFX), immettere le seguenti informazioni:
▪ File archivio PCKS12 (PFX) - Percorso del file archivio.
▪ Crittografato - Selezionare questa casella di controllo se il file PCKS12 (PFX) è crittografato e immettere la passphrase utilizzata per decrittografare il file.
Fare clic su Avanti.
* 
Se Experience Service viene distribuito in un cluster, assicurarsi che i percorsi dei file contenenti il certificato e la chiave siano accessibili da tutte le istanze in esecuzione nel cluster.
9. Nella finestra Archivi di dati, immettere le seguenti informazioni per configurare la posizione di archiviazione dei dati Experience Service.
◦ Archivio progetti - Percorso della directory in cui vengono memorizzati i contenuti dei progetti.
◦ Archivio rappresentazioni - Percorso della directory in cui vengono memorizzati i contenuti del repository delle rappresentazioni.
◦ Archivio aggiornamento - Percorso della directory in cui vengono memorizzati i file di corretta esecuzione dei programmi di migrazione.
* 
Se Experience Service viene distribuito in un cluster, assicurarsi che le directory di archiviazione dei dati siano accessibili da tutte le istanze in esecuzione nel cluster.
Per ulteriori informazioni, vedere la sezione "Archivi di contenuti" in Parametri di configurazione.
10. Nelle finestra Generazione model target, selezionare la casella di controllo Attiva la generazione di model target nel server se si desidera attivare la generazione di model target standard o avanzati. Per ulteriori informazioni, vedere Generazione di target. A questo punto, se non si desidera attivare la generazione di model target avanzati, è possibile continuare con l'installazione senza completare i campi riportati di seguito.
Facoltativamente, se si desidera invece attivare la generazione di model target avanzati, completare gli appositi campi dopo avere selezionato la casella di controllo Attiva la generazione di model target nel server.
Campo
Descrizione
URL base
URL del servizio Model target. Questo campo viene completato automaticamente. Il valore è:
https://vws.vuforia.com
Percorso token
Percorso della richiesta HTTP per l'autenticazione OAuth2. Questo campo viene completato automaticamente. Il valore è:
oauth2/token
Percorso GMTA
Percorso della richiesta HTTP per la generazione di model target avanzati. Questo campo viene completato automaticamente. Il valore è:
modeltargets/advancedDatasets
Chiave di accesso
Il valore di questo campo deve essere ottenuto dal supporto tecnico PTC. Per ulteriori informazioni, vedere Informazioni sulla richiesta per attivare la generazione di model target avanzati.
Chiave privata
Il valore di questo campo deve essere ottenuto dal supporto tecnico PTC. Per ulteriori informazioni, vedere Informazioni sulla richiesta per attivare la generazione di model target avanzati.
Fare clic su Avanti.
11. Immettere un nome nel campo Nome dominio di default e fare clic su Avanti. Se non si è sicuri del nome dominio di default da immettere, vedere la sezione "Nome dominio" in Parametri di configurazione.
12. Viene visualizzata la finestra Accesso a progetti. Se si desidera evitare che gli autori Vuforia Studio pubblichino progetti con Accesso impostato su Pubblico, selezionare la casella di controllo Disattivare la pubblicazione di progetti con accesso pubblico.
13. Viene visualizzata la finestra Download progetti per visualizzazione offline. Se si desidera evitare che gli autori Vuforia Studio pubblichino progetti con l'impostazione Consenti download per visualizzazione offline attivata, selezionare la casella di controllo Disattivare la pubblicazione di progetti scaricabili per la visualizzazione offline.
14. Nella finestra Autenticazione selezionare una delle opzioni seguenti:
◦ Autenticazione di base
◦ Single Sign-On (OpenID Connect)
* 
Se si seleziona l'opzione Autenticazione di base, procedere al passo 14.
15. Se si seleziona l'opzione Single Sign-On (OpenID Connect), immettere le informazioni seguenti:
Campo
Descrizione
URL autorità di certificazione
Impostare questa proprietà uguale al parametro <as-base-url> identificato nella sezione "Parametri di configurazione SSO" in Configurazione di PingFederate.
Client ID
Impostare questa proprietà uguale al parametro <es-client-id> identificato nella sezione "Parametri di configurazione SSO" in Configurazione di PingFederate.
Client Secret
Impostare questa proprietà uguale al parametro <es-client-secret> identificato nella sezione "Parametri di configurazione SSO" in Configurazione di PingFederate.
URL di reindirizzamento
Impostare questa proprietà uguale al parametro <es-redirect-uri> identificato nella sezione "Parametri di configurazione SSO" in Configurazione di PingFederate.
Ambito ES
Impostare questa proprietà uguale al parametro <es-scope> identificato nella sezione "Parametri di configurazione SSO" in Configurazione di PingFederate.
Accesso a ThingWorx
Selezionare una delle seguenti opzioni:
• Utilizza chiave di accesso - Selezionare questa opzione per utilizzare le chiavi di accesso in ThingWorx
• Utilizza credenziali - Selezionare questa opzione per utilizzare un account nell'IdP in uso
Per ulteriori informazioni, vedere Autenticazione ThingWorx.
Nome utente
Impostare questo parametro uguale al valore dell'attributo sub identificato nel criterio di OpenID Connect. Per ulteriori informazioni, vedere il passo 9 in Configurazione dei criteri OpenID.
Timeout (minuti)
Quando si esegue l'autenticazione di Experience Service tramite OpenID Connect, viene creata una sessione per l'utente che ne ha eseguito l'autenticazione. Questa proprietà specifica la quantità di tempo (in minuti) che deve trascorrere prima che la sessione venga invalidata e che l'utente debba eseguire nuovamente l'autenticazione.
Client ID
Immettere il nome dell'ID client Studio. Il valore di default per questo campo è PTC_Studio_Client_ID. Tuttavia, se è stato configurato un valore diverso, è necessario immetterlo qui.
16. Viene visualizzata la finestra Server ThingWorx. Immettere le informazioni appropriate. Al termine, fare clic su Avanti.
Campo o impostazione
Descrizione
URL server ThingWorx
Questo campo è obbligatorio.
Immettere l'URL dell'istanza di ThingWorx nel campo URL server ThingWorx. Ad esempio, https://twx.example.com:8443/Thingworx.
Configura l'accesso pubblico al server ThingWorx
Selezionare questa casella di controllo per consentire alle esperienze pubbliche di accedere ai dati ThingWorx.
Per ulteriori informazioni sulle esperienze pubbliche e sulla configurazione dell'accesso pubblico a ThingWorx, vedere Configurazione dell'accesso pubblico a ThingWorx.
Credenziali dell'amministratore del server ThingWorx
• Autenticazione di base - Specificare il nome utente e la password di un account con permessi di amministrazione per il server ThingWorx. Tali credenziali vengono utilizzate per configurare l'accesso al server ThingWorx richiesto da Experience Service.
• Single Sign-On (OpenID Connect) - Specificare il token di accesso acquisito in Ottenere un token di accesso OAuth per l'amministratore ThingWorx utilizzando Postman.
17. Fare clic su Avanti. Nella finestra Pronto all'installazione, fare clic su Avanti.
Per informazioni su come impostare manualmente i parametri di configurazione, vedere Parametri di configurazione.
Passi post-installazione (solo Single Sign-On)
Per informazioni sui passi post-installazione per l'autenticazione Single Sign-On, vedere Passi post-installazione per l'autenticazione Single Sign-On.
Modalità automatica
Quando il programma di installazione viene eseguito in modalità automatica, le scelte relative ai vari passi del programma di installazione devono essere specificate come argomenti della riga di comando o in un file di opzioni. La convalida dei valori specificati per le opzioni viene eseguita mediante la stessa logica utilizzata per convalidare i valori immessi manualmente. Nelle tabelle riportate di seguito vengono descritte le opzioni che è possibile specificare quando il programma di installazione viene eseguito in modalità automatica. Se non viene fornito un valore, viene utilizzato il valore di default. Per ulteriori informazioni, vedere Modalità automatica.