Während die Installation und Nutzung des Altium On-Prem Enterprise Server und der zugehörigen Dienste auf anderen Seiten dieser Dokumentationswebsite beschrieben werden, ist das Ziel dieser Seite, eine einzelne, detaillierte Ressource für die IT-Abteilung eines Unternehmens bereitzustellen. Ein Ort, an dem Antworten auf häufig gestellte Fragen zu dieser Technologie zu finden sind, darunter:
-
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?
Die folgenden Abschnitte liefern detaillierte Antworten auf diese und weitere Fragen, einschließlich einer allgemeinen Übersicht über Architektur und Datenflüsse.
Informationen zu Systemanforderungen, Installation und Lizenzierung finden Sie auf den folgenden Seiten:
IIS-Konfiguration
Im Rahmen der IIS-Konfiguration wird das Feature ISAPI Extensions aktiviert. Dieses Feature befindet sich im Abschnitt \Internet Information Services\World Wide Web Services\Application Development Features des Dialogfelds Windows Features – aufrufbar über das Fenster Programs and Features von Windows.
Bei der Installation des Enterprise Server wird das Windows-Feature ISAPI Extensions aktiviert, das Teil der IIS-Konfiguration ist.
Application Pools Installed on IIS
Die Überprüfung, ob der Enterprise Server ausgeführt wird, kann über die Windows-Systemsteuerung Internet Information Services (IIS) Manager erfolgen – aufrufbar über das Fenster Administrative Tools von Windows. Prüfen Sie einfach, ob sich alle serverbezogenen Anwendungspools im Status Started befinden (wie im folgenden Bild hervorgehoben).
Mit dem Enterprise Server verbundene Anwendungspools, die auf dem IIS-Server ausgeführt werden.
Unterstützung des HTTPS-Protokolls
Der Enterprise Server ermöglicht sichere Kommunikation über Netzwerke mithilfe des HTTPS-Protokolls, um Datenschutz und Integrität der Daten zu gewährleisten.
Die für sichere Serververbindungen verwendete Portnummer wird während des Installationsvorgangs auf der Seite Altium On-Prem Enterprise Server Configuration des Installers festgelegt. Verwenden Sie den Standardport (9785) oder geben Sie einen alternativen Port ein.
Konfigurieren eines Zertifikats
Bei einer Neuinstallation bietet der Enterprise Server ein selbstsigniertes Zertifikat, das in IIS erzeugt und konfiguriert wird. Aus Sicherheitsgründen wird empfohlen, ein eigenes Zertifikat zu erzeugen (mit Ihren üblichen/bevorzugten Tools) und dieses anschließend in IIS zu konfigurieren. Sie können entweder eine Zertifikatsanforderung erstellen und diese an eine bekannte Zertifizierungsstelle (CA) wie VeriSign oder GeoTrust senden oder ein Zertifikat von einer Online-CA in Ihrer Intranet-Domäne beziehen. Weitere Informationen finden Sie auf der Seite How to Set Up SSL on IIS 7 or later in der Microsoft-Dokumentation.
Beachten Sie beim Aktualisieren des Enterprise Server auf eine spätere Version, dass die Zertifikatskonfiguration beibehalten wird.
HTTPS konfigurieren
Die Konfiguration und Serverbindungen für den Enterprise Server können über die Windows-Systemsteuerung Internet Information Services (IIS) Manager aufgerufen werden – verfügbar über das Fenster Administration Tools (Control Panel\System and Security\Administrative Tools). Wählen Sie in der Liste Connections des Bereichs den Eintrag „Altium On-Prem Enterprise Server“ aus und öffnen Sie die Registerkarte Features View.
Zugriff auf Konfigurations- und Serverbindungseinstellungen für den Enterprise Server.
Die verfügbaren Ports und Servernamen für den Enterprise Server werden im Bereich Actions als auswählbare Links angezeigt. Verwenden Sie diese Links, um die Serververbindungsprotokolle zu prüfen und zu testen, oder greifen Sie auf die aktuellen Namens-/Portbindungen zu, indem Sie den Link Bindings im Abschnitt Edit Site des Bereichs auswählen.
Eine Bindung einschließlich ihrer Protokoll-Portnummer kann im Dialogfeld Site Bindings über die Schaltfläche Edit bearbeitet werden.
Konfigurieren Sie Bindungen über das Dialogfeld Site Bindings.
Beachten Sie, dass der Servername localhost nur für den lokalen Rechner gilt. PCs other als derjenige, auf dem der Enterprise Server gehostet wird, müssen daher den tatsächlichen (Server-)Namen dieses Host-Rechners verwenden, um eine Verbindung herzustellen.
Um den Namen des Host-PCs zu bestätigen, auf dem der Enterprise Server installiert ist und ausgeführt wird, gehen Sie auf diesem Rechner zu Control Panel\System and Security\System und notieren Sie sowohl den Computer name als auch den Full computer name (dessen vollqualifizierten Domänennamen) – letzterer wird vom Enterprise Server für sichere Verbindungen über das Netzwerk verwendet.
Für PCs, die nicht Teil einer Domäne sind (als normale Workgroup-PCs konfiguriert), sind Computer name und Full computer name identisch.
Wenn Sie die Site-Bindungen des Enterprise Server so bearbeitet haben, dass eine andere Portnummer als der Standardwert verwendet wird, muss diese Änderung auch in der Datei LocalVault.ini des Enterprise Server berücksichtigt werden. Der Grund dafür ist, dass auf deren Portreferenzen zugegriffen wird, wenn Verbindungen von Altium Designer zum Enterprise Server hergestellt werden. Die Datei LocalVault.ini befindet sich im Stammordner der Enterprise-Server-Installation – normalerweise Program Files (x86)\Altium\Altium365.
Wenn Sie beispielsweise die Site-Bindung des Enterprise Server so geändert haben, dass der Standardport 443 für HTTPS-Verbindungen verwendet wird, aktualisieren Sie die entsprechende Zeile HttpsPort=9785 in der Datei LocalVault.ini auf HttpsPort=443.
Beim Neukonfigurieren von Site-Bindungen
Wenn Sie eine neue IIS-Site-Bindung für den Enterprise Server hinzugefügt oder einen vorhandenen Site-Bindungseintrag bearbeitet haben (siehe oben), sollte der Server-PC neu gestartet werden, damit die neue Konfiguration korrekt übernommen wird. Typische Änderungen an Site-Bindungen sind das Bearbeiten der Portnummer für einen Host-Eintrag oder das Hinzufügen einer neuen Bindung für einen Domänenalias.
Wenn es nicht praktikabel ist, den Server-Host-Rechner neu zu starten, besteht der alternative Prozess darin, den Serverdienst auf der IIS-Plattform neu zu starten – Restart unter Manage Website – und außerdem den Dienst Altium DXP App Server Pinger (einen Windows-Dienst) neu zu starten.
Führen Sie den oben genannten Startvorgang aus, wenn Sie beim Versuch, das Feature Health Monitor des Enterprise Server auszuführen, eine Fehlermeldung SignalR Hub "healthmonitorHub" not found! erhalten.
Zugriff über HTTPS
So stellen Sie eine sichere Verbindung zum Enterprise Server her:
-
Aus Altium Designer – verwenden Sie eine Serveradresse mit HTTPS-Präfix und den konfigurierten HTTPS-Port. Standardmäßig ist dies https://<computername>:9785 (wobei [computername] der Computername oder der vollqualifizierte Domänenname des Host-Rechners ist).
Altium Designer enthält die erforderliche Sicherheitsunterstützung, um eine HTTPS-Verbindung zum Enterprise Server ohne weiteres Eingreifen zu akzeptieren.
-
Aus einem Browser – geben Sie die Adresse des Namensdienstes des Host-Computers ein (https://<computername>:9785).
Wenn Sie sich dafür entschieden haben, das für den Enterprise Server erzeugte selbstsignierte Identitätszertifikat beizubehalten, wird Ihr Browser warnen, dass die Verbindung nicht sicher/privat ist. Sie können in Ihrem Browser auswählen, die Verbindung dennoch zu akzeptieren und fortzufahren. Einige Browser (zum Beispiel Firefox) bieten die Möglichkeit, das Zertifikat dauerhaft zu akzeptieren, sodass keine weiteren Maßnahmen erforderlich sind.
Netzwerk
Standardports
Die folgenden Standard-Kommunikationsportnummern werden vom Enterprise Server verwendet:
-
HTTP Port – 9780
-
HTTPS Port – 9785
-
LDAP Synchronisation Service Port – 9791
Der LDAP-Service-Port wird tatsächlich nicht verwendet. Für Standard-LDAP (mit URL ldap://) wird der Port aus dieser URL verwendet. Für sicheres LDAP (mit URL ldaps://) wird Port 636 verwendet.
-
Websocket Port – 4649
Beachten Sie, dass /websocket/WebService.asmx ein HTTP-SOAP-Endpunkt für API-Aufrufe ist und daher wie andere API-Endpunkte den HTTPS-Port verwendet (standardmäßig 9785).
-
Firebird Server Port – 3050
-
SVN Port – 3690
-
Elasticsearch Ports – 9200 und 9300
Die ersten drei in der Liste können während der Erstinstallation auf der Seite Altium On-Prem Enterprise Server Configuration des Installers konfiguriert werden.
Wenn ein Port bereits verwendet wird, sucht der Installer nach dem nächsten verfügbaren Port und verwendet stattdessen diesen.
Beachten Sie bei der Auswahl eines Ports, dass er nicht mit Ports kollidieren darf, die von anderen Anwendungen verwendet werden – wenn ein Port derzeit verwendet wird, werden Sie vom Installer benachrichtigt.
Der HTTP Port wird von IIS bereitgestellt und von Enterprise-Server-Anwendungen verwendet. Er ist der Hauptport und sollte immer offen sein. Der Firebird Server Port wird für das Firebird-RDBMS verwendet. Standardmäßig ist er nur an localhost gebunden. Er SHOULD NOT aus Sicherheitsgründen nicht extern verfügbar gemacht werden. Benutzer interagieren nicht direkt mit diesem Port. Beide Ports ermöglichen reguläre HTTP-Interaktion (Anfrage/Antwort). Beide Ports können angepasst werden. Der HTTP Port kann während der Installation geändert werden. Obwohl der Firebird Server Port manuell geändert werden kann, wird davon abgeraten.
In Bezug auf den HTTP-Kommunikationsport gilt: Wenn auf demselben PC ältere Vault-Technologie (Altium Personal Vault oder Altium Satellite Vault) ausgeführt wird, stellen Sie sicher, dass die Kommunikationsports eindeutig sind. Ein älteres Altium Personal Vault verwendet Port 9680, während ein älteres Altium Satellite Vault Port 9880 verwendet. Der Enterprise Server kann nicht zusammen mit einem älteren Altium Vault (3.0 und früher), Altium Concord Pro, Altium NEXUS Server oder einem Altium Infrastructure Server installiert werden (d. h. auf demselben PC). Bei den ersten drei können Sie auf den Enterprise Server aktualisieren (so, als würden Sie auf eine spätere Version dieser Instanz aktualisieren).
Siehe die Informationen zu Ports und IP-Adressen für Altium-Designsoftware.
Für die Kommunikation zwischen Diensten verwendetes Protokoll
SOAP über HTTP.
Verbindung zum AltiumLive Identity-Subsystem
Verbindungen zum AltiumLive Identity-Subsystem werden standardmäßig über HTTPS hergestellt, und der Eintrag IdentityCloudServiceUrl in der Datei LocalVault.ini (die sich bei der Standardinstallation im Ordner C:\Program Files (x86)\Altium\Altium365 befindet) ist standardmäßig https://ids.api.altium.com/ids?cls=soap.
Standard-Installationspfade
Nachfolgend finden Sie eine Liste der Standard-Installationspfade bei der Installation des 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.
Servicearchitektur – Überblick
Der Enterprise Server installiert eine Reihe von Kerndiensten sowie browserbasierte Verwaltungskonsolen und einen Explorer (ebenfalls browserbasiert). Um auf einen dieser Dienste zugreifen zu können, muss die Identität eines Benutzers erkannt und authentifiziert werden. Der Enterprise Server wird mit einem vordefinierten Benutzer geliefert (Username: admin, Password: admin). Die Seite Users in der browserbasierten Oberfläche des Enterprise Server Workspace kann verwendet werden, um weitere Benutzer hinzuzufügen und zu verwalten. Es gibt keine Begrenzung für die Anzahl der Benutzer, die für den Zugriff auf den Enterprise Server registriert werden können, jedoch gibt es eine Begrenzung für gleichzeitige Verbindungen, wie durch die erforderliche Lizenzierung festgelegt und durchgesetzt.
Derselbe Benutzer kann gleichzeitig auf unterschiedliche Weise auf den Enterprise Server zugreifen (z. B. verbunden über Altium Designer AND aufgerufen über einen externen Browser), und dies zählt aus Lizenzsicht nur als eine einzige Verbindung, wenn der Zugriff vom selben PC erfolgt. Wenn derselbe Benutzer vom unterschiedlichen PCs auf den Enterprise Server zugreift, erfordert jeder Zugriff von einem anderen PC eine separate Verbindung (also einen zusätzlichen Sitz einer Connector Access License).
Altium Designer verwendet einen unverschlüsselten Kanal (SOAP über HTTP) für die Kommunikation mit den folgenden Diensten:
-
Applications Registry Service (wenn der Network Installation Service als Quelle für Erweiterungen/Updates verwendet wird)
-
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 (über das Protokoll SVN://)
-
Tasks Service
-
Team Configuration Service (TC2)
-
Vault Service
Alle anderen Dienste kommunizieren miteinander.
Die meisten Dienste benötigen Zugriff auf dieselbe Enterprise Server-Datenbank, um für sie relevante Daten zu speichern. Im Folgenden einige Beispiele für Daten, die von einigen dieser Dienste gespeichert werden:
-
Part Catalog Service – speichert Lieferanten- und Herstellerartikel, Preis- und Mengenverlaufsänderungen usw.
-
Identity Service – speichert Benutzer, Gruppen, Lizenzierungskonfiguration und Sitzungsinformationen.
-
Vault Service – speichert seine Struktur (Ordner, Elemente, Revisionen, Inhaltstypen, Lifecycle-Status usw.).
Tatsächliche Dokumente werden im Dateisystem im Ordner Revision gespeichert (\ProgramData\Altium\Altium365Data\Revisions).
-
Der Part Catalog Service benötigt außerdem eine direkte Verbindung (ohne Proxy) zum Internet für Preisaktualisierungen in Echtzeit.
-
Die Datei LocalVault.ini (bei der Standardinstallation im Ordner C:\Program Files (x86)\Altium\Altium365) enthält den Eintrag AllowLogin im Abschnitt [PartCatalog:CloudIds] (standardmäßig true). Wenn der Wert dieser Option auf false geändert wird, wird verhindert, dass sich der Part Catalog Service mit dem cloudbasierten Altium Identity-Dienst verbindet, um sich beim Online-Ciiva-Dienst für den Abruf von Komponentendaten zu authentifizieren. Während anonymer Zugriff die Nutzung personalisierter Dienste (wie IHS) verhindert, kann dies in Umgebungen mit eingeschränkter Internetverbindung vorteilhaft sein (kein Warten mehr auf Verbindungs-Timeouts) oder wenn Sie solche zusätzlichen Dienste nicht abonniert haben. Wenn diese Option auf false gesetzt ist, werden die Proxy-Einstellungen vom Part Catalog berücksichtigt.
Die folgenden browserbasierten Anwendungen verwenden die SOAP-API zur Kommunikation mit den jeweiligen Diensten – sie benötigen keinen Zugriff auf die Enterprise Server-Datenbank, und es sind auch keine weiteren Dateien für ihre Funktion erforderlich:
-
User Management – die Anwendung hinter der Seite Users und den Unterseiten in der Browseroberfläche des Enterprise Server Workspace.
-
Vault Explorer – die Anwendung hinter der Seite Explorer der Browseroberfläche des Enterprise Server Workspace.
-
Catalog Management – die Anwendung hinter der Seite Part Providers der Browseroberfläche des Enterprise Server Workspace.
-
Projects Management – die Anwendung hinter der Seite Projects der Browseroberfläche des Enterprise Server Workspace.
-
TC2 Console – die Anwendung hinter der Seite Configurations der Browseroberfläche des Enterprise Server Workspace.
Vorgänge
Sichern/Wiederherstellen von Serverdaten
Die Sicherung und Wiederherstellung Ihrer Enterprise Server-Daten erfolgt automatisiert über die Befehlszeile mit dem dedizierten Backup & Restore Tool. Dieses Tool – avbackup.exe – befindet sich im Ordner \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (bei einer Standardinstallation des Enterprise Server).
Weitere Informationen finden Sie auf der Seite Sichern & Wiederherstellen Ihrer Installation.
Neuindizierung von Serverinhalten nach der Datenmigration
So indizieren Sie Enterprise Server-Inhalte neu, zum Beispiel nach einer Datenmigration:
-
Beenden Sie alle dem Enterprise Server zugeordneten IIS-Anwendungspools.
-
Beenden Sie den Dienst Elasticsearch (AltiumElasticSearch). Dies erfolgt über das Windows-Bedienfeld Services – aufgerufen über das Fenster Administrative Tools von Windows.
-
Löschen Sie den Inhalt des Ordners SearchData, der die Suchindexierungsdaten enthält (\ProgramData\Altium\Altium365Data\SearchData bei einer Standardinstallation).
-
Starten Sie den Dienst Elasticsearch (AltiumElasticSearch) neu.
-
Starten Sie die dem Enterprise Server zugeordneten IIS-Anwendungspools neu.
Wenn der Enterprise Server feststellt, dass der Ordner SearchData leer ist, indiziert er seine Inhalte beim Start neu.
Erhöhen der Java-Heap-Größe
Eine unzureichende Java-Heap-Größe kann den Komponentensuchindex beschädigen und dazu führen, dass Komponentendaten in Altium Designer nicht verfügbar sind. Wenn Sie Probleme mit dem Suchindex haben (der Health Monitor Status Report enthält SearchService-Fehler in den Protokollen), sollten Sie eine Erhöhung der Java-Heap-Größe in Betracht ziehen.
Die aktuelle Java-Heap-Größe kann überprüft werden, indem Sie http://localhost:9200/_cat/nodes?h=heap*&v auf dem Rechner öffnen, auf dem der Enterprise Server gehostet wird. Wenn der Wert heap.max bei etwa 1 GB liegt, erhöhen Sie diesen Wert wie unten beschrieben.
-
Der Wert, auf den die Java-Heap-Größe erhöht werden sollte, hängt von der Größe der Enterprise Server-Datenbank ab. Die folgende Beschreibung zeigt ein Beispiel für eine Erhöhung auf 4 GB.
-
Bevor Sie mit der Erhöhung der Java-Heap-Größe fortfahren, stellen Sie sicher, dass der Rechner über die entsprechende zusätzliche Menge an physischem Speicher verfügt.
-
Führen Sie die Eingabeaufforderung im Administratormodus aus.
-
Führen Sie die folgende Eingabe aus:
"C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch
-
Nehmen Sie auf der Registerkarte Java des sich öffnenden Dialogs die folgenden Änderungen vor:
-
Klicken Sie im Dialog auf Apply und OK.
-
Starten Sie im Windows-Bedienfeld Services (aufgerufen über das Fenster Administrative Tools von Windows) den Dienst AltiumElasticsearch neu.
-
Überprüfen Sie, ob die Änderungen übernommen wurden, indem Sie http://localhost:9200/_cat/nodes?h=heap*&v öffnen und den Wert des Parameters heap.max prüfen.
AI-localized