Informations pour les services informatiques

Parent page: Sujets avancés

Bien que l’installation et l’utilisation de Altium On-Prem Enterprise Server et de ses services associés soient détaillées sur d’autres pages de cette documentation, cette page a pour objectif de fournir une ressource unique et détaillée pour le service informatique d’une organisation. Un endroit où trouver des réponses aux questions fréquemment posées concernant cette technologie, notamment :

• 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?

Les sections suivantes apportent des réponses détaillées à ces questions et à d’autres, y compris une vue d’ensemble de haut niveau de l’architecture et des flux de données.

Configuration matérielle requise

Enterprise Server doit être installé sur un PC exécutant l’un des systèmes d’exploitation officiellement pris en charge suivants :

• Windows Server 2022 Standard Edition (64-bit)
• Windows Server 2019 Standard Edition (64-bit)
• Windows Server 2016 Standard Edition (64-bit)

Configuration requise pour Altium Designer 

Installation et autres logiciels

En raison du comportement imprévisible observé avec les logiciels antivirus, il est recommandé de désactiver ces logiciels pendant l’installation de Enterprise Server.

Si l’ordinateur exécute également Microsoft Exchange Server, vous pouvez recevoir une erreur HTTP Error 503 lors de votre première tentative de connexion. L’installation de Exchange Server peut modifier la configuration d’Internet Information Services (IIS) d’une manière qui entre en conflit avec Enterprise Server. Pour résoudre ce problème, les modifications suivantes doivent être apportées au fichier applicationHost.config :

<handlers accessPolicy="Read, Script">
...

<add name="kerbauth" image="C:\Program Files\Microsoft\Exchange Server\V15\Bin\kerbauth.dll" preCondition="bitness64" />
<add name="WSMan" image="C:\Windows\system32\wsmsvc.dll" preCondition="bitness64" />
<add name="exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\ClientAccess\Owa\auth\exppw.dll" preCondition="bitness64" />
<add name="cafe_exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\FrontEnd\HttpProxy\bin\exppw.dll" preCondition="bitness64" />

...
</handlers>

Logiciels supplémentaires installés ou configurés

• Internet Information Services (IIS). Pour fonctionner correctement, Enterprise Server nécessite au minimum la version 8.0 (IIS 8.0) installée. L’installation de Enterprise Server installera simplement la version d’IIS native de votre système d’exploitation :
  • IIS 10.0 – Windows Server 2022 Standard Edition (64-bit), Windows Server 2019 Standard Edition (64-bit), Windows Server 2016 Standard Edition (64-bit), Windows 10 (64-bit)
  • IIS 8.5 – Windows 8.1 (64-bit)
• Moteur de base de données Firebird 3.0 (lorsque l’option d’installation avec une base de données Firebird est choisie). Assurez-vous que l’adressage réseau IPv4 est activé – pour vérifier les adresses IPv4 actives, exécutez ipconfig /all dans une invite de commande.
• Plateforme logicielle Microsoft .NET 6 (inclut les composants .NET Runtime, .NET Server Hosting et ASP.NET Framework).

Configuration IIS

Dans le cadre de la configuration d’IIS, la fonctionnalité ISAPI Extensions est activée. Cette fonctionnalité se trouve dans la section \Internet Information Services\World Wide Web Services\Application Development Features de la boîte de dialogue Windows Features – accessible depuis la fenêtre Programs and Features de Windows.

L’installation de Enterprise Server active la fonctionnalité Windows ISAPI Extensions, qui fait partie de la configuration IIS.

Chemins d’installation par défaut

Voici une liste des chemins d’installation par défaut lors de l’installation de Enterprise Server :

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.
• Firebird Installation Folder – \Program Files (x86)\Firebird\Firebird_3_0.
• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.
• Revision Files Folder – \Altium\Altium365Data\Revisions. \ProgramData
• Search Index Data Folder – \Altium\Altium365Data\SearchData. \ProgramData

Ports par défaut

Les numéros de port de communication par défaut suivants sont utilisés par Enterprise Server :

• HTTP Port – 9780
• HTTPS Port – 9785
• LDAP Service Port – 9791

• Websocket Port – 4649
• Firebird Server Port – 3050
• SVN Port – 3690

Les trois premiers de la liste peuvent être configurés lors de l’installation initiale, sur la page Altium On-Prem Enterprise Server Configuration de l’installateur.

Lors du choix d’un port, notez qu’il ne doit pas entrer en conflit avec les ports utilisés par d’autres applications – si un port est actuellement utilisé, le programme d’installation vous en informera.

► Voir les informations sur les ports et adresses IP pour les logiciels de conception Altium.

Prise en charge du protocole HTTPS

Pour ceux qui ont besoin d’une couche de sécurité supplémentaire pour l’échange de données avec Enterprise Server, Enterprise Server permet une communication sécurisée sur les réseaux à l’aide du protocole HTTPS afin de protéger la confidentialité et l’intégrité des données.

La configuration et les liaisons serveur de Enterprise Server sont accessibles depuis le panneau Windows Internet Information Services (IIS) Manager – disponible depuis la fenêtre Administration Tools (Control Panel\System and Security\Administrative Tools). Sélectionnez l’entrée 'Altium On-Prem Enterprise Server' dans la liste Connections du panneau, puis choisissez l’onglet Features View.

Accédez aux paramètres de configuration et de liaison serveur pour Enterprise Server.

Les ports disponibles et les noms de serveur pour Enterprise Server sont affichés sous forme de liens sélectionnables dans le volet Actions. Utilisez ces liens pour noter et tester les protocoles de connexion au serveur, ou accéder aux liaisons nom/port actuelles en sélectionnant le lien Bindings dans la section Edit Site du volet.

Une liaison, y compris son numéro de port de protocole, peut être modifiée depuis la boîte de dialogue Site Bindings via le bouton Edit .

Configurez les liaisons via la boîte de dialogue Site Bindings.

Notez que le nom du serveur localhost s’applique uniquement à la machine locale ; les PC other que celui qui héberge l’Enterprise Server doivent donc utiliser le nom réel (du serveur) de cette machine hôte pour se connecter.

Pour confirmer le nom du PC hôte sur lequel l’Enterprise Server est installé et en cours d’exécution, sur cette machine accédez à Control Panel\System and Security\System et notez à la fois le Computer name et le Full computer name (son nom de domaine pleinement qualifié) – ce dernier sera celui utilisé par l’Enterprise Server pour les connexions sécurisées sur le réseau.

Si vous avez modifié les liaisons de site de l’Enterprise Server afin d’utiliser un numéro de port différent de la valeur par défaut, cette modification devra également être répercutée dans le fichier LocalVault.ini de l’Enterprise Server. En effet, ses références de port sont utilisées lorsque des connexions sont établies à l’Enterprise Server par Altium Designer. Le fichier LocalVault.ini se trouve dans le dossier racine de l’installation de l’Enterprise Server – généralement Program Files (x86)\Altium\Altium365.

Par exemple, si vous avez modifié la liaison de site de l’Enterprise Server pour utiliser le port 443 standard pour les connexions HTTPS, mettez à jour la ligne HttpsPort=9785 correspondante dans le fichier LocalVault.ini en HttpsPort=443.

Pour établir une connexion sécurisée à l’Enterprise Server :

• Depuis Altium Designer – utilisez une adresse de serveur préfixée par HTTPS et le port HTTPS configuré. Par défaut, il s’agit de https://localhost:9785 lorsque vous utilisez le PC qui héberge l’Enterprise Server, ou de https://<computername>:9785 pour une connexion distante (où [computername] correspond au nom de l’ordinateur de la machine hôte ou à son nom de domaine pleinement qualifié).

• Depuis un navigateur – saisissez l’adresse du service local (https://localhost:9785) ou l’équivalent avec le nom de l’ordinateur hôte (https://<computername>:9785).

Lors de la reconfiguration des liaisons de site

Si vous avez ajouté une nouvelle liaison de site IIS pour l’Enterprise Server, ou modifié une entrée de liaison de site existante (voir ci-dessus), le PC serveur doit être redémarré afin d’établir correctement la nouvelle configuration. Les modifications typiques des liaisons de site peuvent consister à modifier le numéro de port d’une entrée hôte, ou à ajouter une nouvelle liaison pour un alias de domaine.

Lorsqu’il n’est pas pratique de redémarrer la machine hôte du serveur, la procédure alternative consiste à redémarrer le service serveur sur la plateforme IIS – Restart sous Manage Website – et également à redémarrer le service Altium DXP App Server Pinger (un service Windows).

Protocole utilisé pour les communications de service à service

SOAP sur HTTP.

Architecture des services – Vue d’ensemble

L’Enterprise Server installe un certain nombre de services principaux, ainsi que des consoles de gestion basées sur navigateur et un Explorer (également basé sur navigateur). Pour accéder à l’un de ces services, l’identité d’un utilisateur doit être reconnue et authentifiée. L’Enterprise Server est fourni avec un utilisateur prédéfini (Username : admin, Password : admin). La page Users de l’interface navigateur du Workspace Enterprise Server peut être utilisée pour ajouter et gérer d’autres utilisateurs. Il n’y a pas de limite au nombre d’utilisateurs pouvant être enregistrés pour accéder à l’Enterprise Server et l’utiliser, mais il existe une limite sur les connexions simultanées, déterminée et appliquée par la licence requise.

Altium Designer utilise un canal non chiffré (SOAP sur HTTP) pour communiquer avec les services suivants :

• Applications Registry Service (lorsque le Network Installation Service est utilisé comme source pour les extensions/mises à jour)
• 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 (via le protocole SVN://)
• Tasks Service
• Team Configuration Service (TC2)
• Vault Service

Tous les autres services communiquent entre eux.

La majorité des services nécessitent l’accès à la même base de données Enterprise Server, afin d’y stocker les données qui leur sont applicables. Voici quelques exemples des données stockées par certains de ces services :

• Part Catalog Service – stocke les articles fournisseurs et fabricants, l’historique des changements de prix et de quantités, etc.
• Identity Service – stocke les utilisateurs, les rôles, la configuration des licences et les informations de session.
• Vault Service – stocke sa structure (dossiers, éléments, révisions, types de contenu, états de cycle de vie, etc.).

Les documents réels sont stockés sur le système de fichiers, dans le dossier Revisions (\Altium\Altium365Data\Revisions). \ProgramData

Les applications suivantes basées sur navigateur utilisent l’API SOAP pour communiquer avec les services applicables – elles ne nécessitent pas d’accès à la base de données Enterprise Server, et aucun autre fichier n’est requis pour leur fonctionnement :

• User Management – l’application derrière la page Users et les sous-pages de l’interface navigateur du Workspace Enterprise Server.
• Vault Explorer – l’application derrière la page Explorer de l’interface navigateur du Workspace Enterprise Server.
• Catalog Management – l’application derrière la page Part Providers de l’interface navigateur du Workspace Enterprise Server.
• Projects Management – l’application derrière la page Projects de l’interface navigateur du Workspace Enterprise Server.
• TC2 Console – l’application derrière la page Configurations de l’interface navigateur du Workspace Enterprise Server.

Fichiers de licence

Related page: Licences

La gestion des licences de l’Enterprise Server se compose essentiellement des deux éléments suivants, qui constituent ensemble un système de licence à deux niveaux :

• Server License – cette licence rend disponibles à l’organisation les fonctionnalités et services de l’installation Enterprise Server.
• Client Access License – cette licence permet aux utilisateurs d’une organisation d’accéder à l’Enterprise Server de l’organisation.

La gestion des licences de l’Enterprise Server peut être effectuée via le cloud, ou localement au moyen de fichiers de licence (*.alf). L’acquisition de ces derniers s’effectue via le Company Dashboard (accessible à l’aide de l’entrée Company Dashboard du menu du compte AltiumLive, en haut à droite du site Altium). Depuis l’onglet Licenses , localisez la licence applicable (dans le groupe de licences Server Applications) puis cliquez pour accéder à la page détaillée de gestion de la licence. Une fois sur place, cliquez sur le bouton Activate pour générer et télécharger le fichier de licence associé.

Sauvegarde/restauration des données du serveur

La sauvegarde et la restauration de vos données Enterprise Server s’effectuent en ligne de commande, de manière automatisée, à l’aide de l’outil dédié Backup & Restore Tool. Cet outil – avbackup.exe – se trouve dans le dossier \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (pour une installation par défaut de l’Enterprise Server).

Réindexation du contenu du serveur après migration des données

Pour réindexer le contenu de l’Enterprise Server, par exemple après une migration des données :

1. Arrêtez tous les pools d’applications IIS associés à l’Enterprise Server.
2. Arrêtez le service Elasticsearch (AltiumElasticSearch). Cette opération s’effectue depuis le panneau Windows Services — accessible depuis la fenêtre Administrative Tools de Windows.
3. Supprimez le contenu du dossier SearchData, qui contient les données d’indexation de recherche ( \Altium\Altium365Data\SearchData pour une installation par défaut). \ProgramData
4. Redémarrez le service Elasticsearch (AltiumElasticSearch).
5. Redémarrez les pools d’applications IIS associés à l’Enterprise Server.

Lorsque le dossier SearchData est détecté comme vide, l’Enterprise Server réindexe son contenu au démarrage.

Dépôt de conception SVN local – Stockage

Un Design Repository créé via le service local de contrôle de version voit ses données internes stockées dans un sous-dossier correspondant du dossier \ProgramData\Altium\Altium365Data\Repository (pour une installation par défaut de l’Enterprise Server).

Utilisation d’Oracle pour la base de données Enterprise Server

Related page: Enterprise Server avec backend Oracle

Lors de l’installation de l’Enterprise Server, le type de base de données Oracle facilite une installation rationalisée de l’Enterprise Server au sein des organisations utilisant déjà ce type de base de données comme backend pour leurs systèmes existants. L’hébergement de l’Enterprise Server sur leur infrastructure existante réduit la complexité de l’installation et de l’administration.

L’installation et la mise en service de l’Enterprise Server avec Oracle comme base de données backend se déroulent essentiellement en deux étapes :

1. Configuration de la base de données Oracle
2. Configuration de l’Enterprise Server.

Préparation de l’Enterprise Server

Pour être installé et exécuté correctement, l’Enterprise Server nécessite non seulement le client OCI, mais aussi les connecteurs .Net appropriés. Il est recommandé d’installer les 32-bit Oracle Data Access Components (ODAC) with Oracle Developer Tools for Visual Studio appropriés, conformément à la version d’Oracle que vous utilisez. Le téléchargement ODAC 12c Release 1 and Oracle Developer Tools for Visual Studio (12.1.0.1.0) est recommandé comme minimum à installer sur la machine dédiée utilisée pour héberger l’Enterprise Server.