Informazioni per i reparti IT

Sebbene l'installazione e l'uso di Altium On-Prem Enterprise Server e dei relativi servizi siano descritti in dettaglio in altre pagine di questo sito di documentazione, lo scopo di questa pagina è fornire una singola risorsa dettagliata per il reparto IT di un'organizzazione. Un punto di riferimento in cui trovare risposte alle domande più frequenti relative a questa tecnologia, tra cui:

• What are the hardware requirements to install the Enterprise Server?

• What is installed?

• What programs and processes are running?

• Where is the data stored?

• What ports are used?

• What protocol is used for communications?

• How is data backed up?

Le sezioni seguenti forniscono risposte dettagliate a queste e ad altre domande, incluso una panoramica di alto livello dell'architettura e dei flussi di dati.

Configurazione di IIS

Come parte della configurazione di IIS, viene abilitata la funzionalità ISAPI Extensions. Questa funzionalità si trova nella sezione \Internet Information Services\World Wide Web Services\Application Development Features della finestra di dialogo Windows Features, accessibile dalla finestra Programs and Features di Windows.

L'installazione di Enterprise Server abilita la funzionalità Windows ISAPI Extensions, parte della configurazione di IIS.

Supporto del protocollo HTTPS

Enterprise Server fornisce comunicazioni sicure sulle reti utilizzando il protocollo HTTPS per proteggere la riservatezza e l'integrità dei dati.

Configurazione di un certificato

Per una nuova installazione, Enterprise Server offre un certificato autofirmato generato e configurato in IIS. Per motivi di sicurezza, si consiglia di generare un proprio certificato (utilizzando gli strumenti standard/preferiti) e quindi configurarlo in IIS. È possibile creare una richiesta di certificato e inviarla a un'autorità di certificazione (CA) nota come VeriSign o GeoTrust, oppure ottenere un certificato da una CA online nel dominio intranet. Fare riferimento alla pagina How to Set Up SSL on IIS 7 or later nella documentazione Microsoft per saperne di più.

Configurazione di HTTPS

La configurazione e i binding del server per Enterprise Server sono accessibili dal pannello Windows Internet Information Services (IIS) Manager, disponibile dalla finestra Administration Tools (Control Panel\System and Security\Administrative Tools). Selezionare la voce 'Altium On-Prem Enterprise Server' nell'elenco Connections del pannello e scegliere la scheda Features View.

Accedere alle impostazioni di configurazione e di binding del server per Enterprise Server.

Le porte disponibili e i nomi server per Enterprise Server sono mostrati come collegamenti selezionabili nel riquadro Actions. Utilizzare i collegamenti per annotare e testare i protocolli di connessione del server, oppure accedere agli attuali binding nome/porta selezionando il collegamento Bindings nella sezione Edit Site del riquadro.

Un Binding, incluso il numero di porta del protocollo, può essere modificato dalla finestra di dialogo Site Bindings tramite il pulsante Edit .

Configurare i binding tramite la finestra di dialogo Site Bindings.

Si noti che il nome server localhost si applica solo al computer locale, quindi i PC other diversi da quello che ospita Enterprise Server devono utilizzare il nome effettivo (del server) di quel computer host per connettersi.

Per confermare il nome del PC host su cui Enterprise Server è installato e in esecuzione, su quel computer andare in Control Panel\System and Security\System e annotare sia Computer name sia Full computer name (il relativo nome di dominio completo) — quest'ultimo sarà quello utilizzato da Enterprise Server per le connessioni sicure sulla rete.

Se sono stati modificati i binding del sito di Enterprise Server per utilizzare un numero di porta diverso dal valore predefinito, tale modifica dovrà essere riportata anche nel file LocalVault.ini di Enterprise Server. Questo perché i riferimenti alla porta vengono utilizzati quando Altium Designer stabilisce connessioni con Enterprise Server. Il file LocalVault.ini si trova nella cartella radice dell'installazione di Enterprise Server, in genere Program Files (x86)\Altium\Altium365.

Ad esempio, se è stato modificato il binding del sito di Enterprise Server per utilizzare la porta standard 443 per le connessioni HTTPS, aggiornare la riga HttpsPort=9785 corrispondente nel file LocalVault.ini in HttpsPort=443.

Quando si riconfigurano i Site Binding

Se è stato aggiunto un nuovo Site Binding IIS per Enterprise Server, oppure è stata modificata una voce Site Binding esistente (vedere sopra), il PC server deve essere riavviato per stabilire correttamente la nuova configurazione. Modifiche tipiche ai Site Binding possono includere la modifica del numero di porta per una voce host, oppure l'aggiunta di un nuovo binding per un alias di dominio.

Quando non è pratico riavviare il computer host del server, il processo alternativo consiste nel riavviare il servizio server sulla piattaforma IIS – Restart in Manage Website – e riavviare anche il servizio Altium DXP App Server Pinger (un servizio Windows).

Accesso tramite HTTPS

Per stabilire una connessione sicura a Enterprise Server:

• Da Altium Designer – utilizzare un indirizzo server con prefisso HTTPS e la porta HTTPS configurata. Per impostazione predefinita, è https://<computername>:9785 (dove [computername] è il Nome computer o il nome di dominio completo del computer host).

  Altium Designer include il supporto di sicurezza necessario per accettare una connessione HTTPS a Enterprise Server senza interventi.

• Da un browser – immettere l'indirizzo del servizio nome del computer host (https://<computername>:9785).

  Se si è scelto di mantenere il certificato di identità autofirmato generato per Enterprise Server, il browser avviserà che la connessione non è sicura/privata. È possibile scegliere di accettarla nel browser per procedere. Alcuni browser (ad esempio Firefox) offrono l'opzione di accettare il certificato in modo permanente, così da non richiedere ulteriori azioni.

Rete

Porte predefinite

I seguenti numeri di porta di comunicazione predefiniti vengono utilizzati da Enterprise Server:

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

  La porta del servizio LDAP non viene, di fatto, utilizzata. Per LDAP standard (con URL ldap://), viene utilizzata la porta di questo URL. Per LDAP sicuro (con URL ldaps://), viene utilizzata la porta 636.

• Websocket Port – 4649

  Si noti che /websocket/WebService.asmx è un endpoint SOAP HTTP per chiamate API, quindi, come altri endpoint API, utilizza la porta HTTPS (9785 per impostazione predefinita).

• Firebird Server Port – 3050

• SVN Port – 3690

• Elasticsearch Ports – 9200 e 9300

I primi tre nell'elenco possono essere configurati durante l'installazione iniziale, nella pagina Altium On-Prem Enterprise Server Configuration del programma di installazione.

Quando si sceglie una porta, tenere presente che non deve entrare in conflitto con eventuali porte utilizzate da altre applicazioni – se una porta è attualmente in uso, il programma di installazione lo segnalerà.

Vedere le informazioni su porte e indirizzi IP per il software Altium Design.

Protocollo utilizzato per le comunicazioni service-to-service

SOAP su HTTP.

Connessione al sottosistema di identità AltiumLive

Le connessioni al sottosistema di identità AltiumLive vengono effettuate tramite HTTPS per impostazione predefinita, e la voce IdentityCloudServiceUrl nel file LocalVault.ini (situato nella cartella C:\Program Files (x86)\Altium\Altium365 per l'installazione predefinita) è https://ids.api.altium.com/ids?cls=soap per impostazione predefinita.

Configurazione di Platform API

Alcune risposte della Platform API restituiscono URL basati sul WebsiteDomain impostato durante la configurazione iniziale. In rari casi (ad esempio, se il server è dietro un load balancer o un proxy), questi URL potrebbero non funzionare. Per risolvere il problema, aggiornare la voce FilesServiceUrl nella sezione [PublicServices] del file LocalVault.ini (che, nell'installazione predefinita, si trova nella cartella C:\Program Files (x86)\Altium\Altium365). Il valore della voce deve essere impostato su <PubliclyAccessibleUrl>/napi/files, dove <PubliclyAccessibleUrl> è l'URL esterno raggiungibile dall'esterno dell'Enterprise Server.

Percorsi di installazione predefiniti

Di seguito è riportato un elenco dei percorsi di installazione predefiniti durante l'installazione dell'Enterprise Server:

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.

• Firebird Installation Folder – \Program Files\Firebird\Firebird_3_0.

• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.

• Revision Files Folder – \ProgramData\Altium\Altium365Data\Revisions.

• Search Index Data Folder – \ProgramData\Altium\Altium365Data\SearchData.

Architettura dei servizi – Panoramica

L'Enterprise Server installa una serie di servizi principali, oltre a console di gestione basate su browser e un Explorer (anch'esso basato su browser). Per poter accedere a uno qualsiasi di questi servizi, l'identità dell'utente deve essere riconosciuta e autenticata. L'Enterprise Server include un utente predefinito (Username: admin, Password: admin). La pagina Users dell'interfaccia basata su browser del Workspace di Enterprise Server può essere utilizzata per aggiungere e gestire altri utenti. Non esiste alcun limite al numero di utenti che possono essere registrati per accedere e utilizzare l'Enterprise Server, ma esiste un limite alle connessioni simultanee, determinato e applicato dalle licenze richieste.

Altium Designer utilizza un canale non crittografato (SOAP su HTTP) per comunicare con i seguenti servizi:

• Applications Registry Service (quando il Network Installation Service viene utilizzato come sorgente per estensioni/aggiornamenti)

• Collaboration Service

• Comments Service

• Data Acquisition Service

• Data Storage Service (DSS)

• Identity Service (IDS)

• Notifications Service

• Part Catalog Service

• Projects Service

• Simple Lock Service (SLS)

• SVN (tramite il protocollo SVN://)

• Tasks Service

• Team Configuration Service (TC2)

• Vault Service

Tutti gli altri servizi comunicano tra loro.

La maggior parte dei servizi richiede l'accesso allo stesso database dell'Enterprise Server, nel quale memorizzare i dati a essi applicabili. Di seguito alcuni esempi dei dati memorizzati da alcuni di questi servizi:

• Part Catalog Service – memorizza articoli di fornitori e produttori, variazioni della cronologia di prezzi e quantità, ecc...

• Identity Service – memorizza utenti, gruppi, configurazione delle licenze e informazioni di sessione.

• Vault Service – memorizza la propria struttura (cartelle, elementi, revisioni, tipi di contenuto, stati del ciclo di vita, ecc...).

I documenti effettivi sono memorizzati nel file system, nella cartella Revision (\ProgramData\Altium\Altium365Data\Revisions).

Le seguenti applicazioni basate su browser utilizzano la SOAP API per comunicare con i servizi applicabili: non richiedono accesso al database dell'Enterprise Server, né sono necessari altri file per il loro funzionamento:

• User Management – l'applicazione dietro la pagina Users e le relative sottopagine nell'interfaccia browser del Workspace di Enterprise Server.

• Vault Explorer – l'applicazione dietro la pagina Explorer dell'interfaccia browser del Workspace di Enterprise Server.

• Catalog Management – l'applicazione dietro la pagina Part Providers dell'interfaccia browser del Workspace di Enterprise Server.

• Projects Management – l'applicazione dietro la pagina Projects dell'interfaccia browser del Workspace di Enterprise Server.

• TC2 Console – l'applicazione dietro la pagina Configurations dell'interfaccia browser del Workspace di Enterprise Server.

Operazioni

Backup/Ripristino dei dati del server

Il backup e il ripristino dei dati dell'Enterprise Server vengono eseguiti dalla riga di comando, in modo automatizzato, utilizzando lo strumento dedicato Backup & Restore Tool. Questo strumento – avbackup.exe – si trova nella cartella \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (per un'installazione predefinita dell'Enterprise Server).

Fare riferimento alla pagina Backing up & Restoring Your Installation per ulteriori informazioni.

Reindicizzazione del contenuto del server dopo la migrazione dei dati

Per reindicizzare il contenuto dell'Enterprise Server, ad esempio dopo una migrazione dei dati:

1. Arrestare tutti gli application pool IIS associati all'Enterprise Server.

2. Arrestare il servizio Elasticsearch (AltiumElasticSearch). Questa operazione viene eseguita dal pannello Windows Services – accessibile dalla finestra Administrative Tools di Windows.

3. Eliminare il contenuto della cartella SearchData, che contiene i dati di indicizzazione della ricerca (\ProgramData\Altium\Altium365Data\SearchData per un'installazione predefinita).

4. Riavviare il servizio Elasticsearch (AltiumElasticSearch).

5. Riavviare gli application pool IIS associati all'Enterprise Server.

Se rileva la cartella SearchData vuota, l'Enterprise Server reindicizzerà il proprio contenuto all'avvio.

Aumento della dimensione dell'heap Java

Una dimensione insufficiente dell'heap Java può compromettere l'indice di ricerca dei componenti e rendere i dati dei componenti non disponibili in Altium Designer. Se si riscontrano problemi con l'indice di ricerca (il Health Monitor Status Report presenta errori SearchService Schema not found: 'vault1ex2_04 nei log), valutare l'aumento della dimensione dell'heap Java.

La dimensione attuale dell'heap Java può essere verificata aprendo http://localhost:9200/_cat/nodes?h=heap*&v sulla macchina che ospita l'Enterprise Server. Se il valore heap.max è intorno a 1 GB, aumentarlo come descritto di seguito.

1. Eseguire il Prompt dei comandi in modalità amministratore.

2. Eseguire il seguente comando:

   "C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch

3. Nella scheda Java della finestra di dialogo che si apre, apportare le seguenti modifiche:

   • Nel campo Java Options, rimuovere le voci -Xms1g e -Xmx1g.

   • Aggiornare i valori nei campi Initial memory pool e Maximum memory pool con 4096.

     Quando si aumenta la dimensione dell'heap Java a un valore diverso da 4 GB, modificare di conseguenza le opzioni Initial memory pool e Maximum memory pool (ad esempio, specificare 6144 se si sta aumentando la dimensione a 6 GB).

   

4. Fare clic su Apply e OK nella finestra di dialogo.

5. Dal pannello Windows Services (accessibile dalla finestra Administrative Tools di Windows), riavviare il servizio AltiumElasticsearch .

6. Verificare che le modifiche siano state applicate aprendo http://localhost:9200/_cat/nodes?h=heap*&v e controllando il valore del parametro heap.max.

Configurazione del numero massimo di valori dei parametri dei componenti per categoria di filtro

È possibile aggiungere l'opzione di configurazione MaxHitsPerFacet alla sezione [Search] del file LocalVault.ini. Il valore specificato limita il numero di voci singole (con caselle di controllo) visualizzate per categoria nel riquadro Filters del pannello Components di Altium Designer, durante la ricerca di un componente. In qualità di amministratore, riducendo questo valore si diminuisce il numero di risultati per categoria di filtro, riducendo significativamente il carico sul servizio di ricerca e aumentando le prestazioni della ricerca.

Aumento della lunghezza consentita del segmento URL

Per utilizzare la funzionalità Release & Publish to PLM in Altium Designer (scopri di più), è necessario aggiornare il registro di Windows sul computer in cui è installato Enterprise Server. In una finestra del Prompt dei comandi di Windows (CMD) con privilegi di amministratore, eseguire quanto segue:

reg add "HKLM\SYSTEM\CurrentControlSet\Services\HTTP\Parameters" /v UrlSegmentMaxLength /t REG_DWORD /d 2048

Questa modifica aumenta la lunghezza consentita del segmento URL, necessaria per supportare le funzionalità del sistema. Si noti che, dopo aver applicato questa modifica, è necessario riavviare il computer affinché la modifica abbia effetto.