Aunque la instalación y el uso de Altium On-Prem Enterprise Server y sus servicios relacionados se detallan en otras páginas de este sitio de documentación, el objetivo de esta página es proporcionar un recurso único y detallado para el departamento de TI de una organización. Un lugar al que acudir para obtener respuestas a las preguntas habituales sobre esta tecnología, incluidas:
-
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?
Las siguientes secciones ofrecen respuestas detalladas a estas y otras preguntas, incluida una visión general de alto nivel de la arquitectura y de los flujos de datos.
Para obtener información sobre requisitos del sistema, instalación y licencias, consulte las siguientes páginas:
Configuración de IIS
Como parte de la configuración de IIS, la característica ISAPI Extensions está habilitada. Esta característica puede encontrarse en la sección \Internet Information Services\World Wide Web Services\Application Development Features del cuadro de diálogo Windows Features, al que se accede desde la ventana Programs and Features de Windows.
La instalación de Enterprise Server habilita la característica de Windows ISAPI Extensions, que forma parte de la configuración de IIS.
Application Pools Installed on IIS
La verificación de que Enterprise Server está en ejecución puede realizarse desde el panel Internet Information Services (IIS) Manager de Windows, al que se accede desde la ventana Administrative Tools de Windows. Simplemente compruebe que cada uno de los grupos de aplicaciones relacionados con el servidor esté en estado Started (como se resalta en la siguiente imagen).
Grupos de aplicaciones relacionados con Enterprise Server ejecutándose en el servidor IIS.
Compatibilidad con el protocolo HTTPS
Enterprise Server proporciona comunicación segura a través de redes mediante el protocolo HTTPS para proteger la privacidad e integridad de los datos.
El número de puerto utilizado para las conexiones seguras al servidor se define durante el proceso de instalación, en la página Altium On-Prem Enterprise Server Configuration del instalador. Use el puerto predeterminado (9785) o introduzca uno alternativo.
Configuración de un certificado
Para una instalación nueva, Enterprise Server ofrece un certificado autofirmado generado y configurado en IIS. Por motivos de seguridad, se recomienda generar su propio certificado (utilizando sus herramientas estándar o preferidas) y luego configurar este certificado en IIS. Puede crear una solicitud de certificado y enviar esa solicitud a una autoridad de certificación (CA) conocida, como VeriSign o GeoTrust, u obtener un certificado de una CA en línea dentro de su dominio de intranet. Consulte la página How to Set Up SSL on IIS 7 or later de la documentación de Microsoft para obtener más información.
Al actualizar Enterprise Server a una versión posterior, tenga en cuenta que la confi guración del certificado se conservará.
Configuración de HTTPS
La configuración y los enlaces del servidor para Enterprise Server pueden consultarse desde el panel Internet Information Services (IIS) Manager de Windows, disponible desde la ventana Administration Tools (Control Panel\System and Security\Administrative Tools). Seleccione la entrada 'Altium On-Prem Enterprise Server' en la lista Connections del panel y elija la pestaña Features View.
Acceda a la configuración y a los ajustes de enlaces del servidor para Enterprise Server.
Los puertos disponibles y los nombres de servidor para Enterprise Server se muestran como enlaces seleccionables en el panel Actions. Use los enlaces para anotar y probar los protocolos de conexión del servidor, o acceda a los enlaces actuales de nombre/puerto seleccionando el enlace Bindings en la sección Edit Site del panel.
Un Binding, incluido su número de puerto de protocolo, puede editarse desde el cuadro de diálogo Site Bindings mediante el botón Edit .
Configure los bindings mediante el cuadro de diálogo Site Bindings.
Tenga en cuenta que el nombre del servidor localhost solo se aplica a la máquina local, por lo que los PC other que el que aloja Enterprise Server deben utilizar el nombre real (del servidor) de esa máquina host para conectarse.
Para confirmar el nombre del PC host en el que Enterprise Server está instalado y en ejecución, en esa máquina vaya a Control Panel\System and Security\System y anote tanto Computer name como Full computer name (su nombre de dominio completo); este último será el que utilice Enterprise Server para conexiones seguras a través de la red.
Para los PC que no forman parte de un dominio (configurados como PC estándar de grupo de trabajo), Computer name y Full computer name serán el mismo.
Si ha editado los bindings del sitio de Enterprise Server para utilizar un número de puerto diferente del valor predeterminado, ese cambio también deberá reflejarse en el archivo LocalVault.ini de Enterprise Server. Esto se debe a que sus referencias de puerto se consultan cuando Altium Designer realiza conexiones a Enterprise Server. El archivo LocalVault.ini se encuentra en la carpeta raíz de la instalación de Enterprise Server, normalmente Program Files (x86)\Altium\Altium365.
Por ejemplo, si ha cambiado el binding del sitio de Enterprise Server para usar el puerto estándar 443 para conexiones HTTPS, actualice la línea HttpsPort=9785 correspondiente en el archivo LocalVault.ini a HttpsPort=443.
Al reconfigurar los bindings del sitio
Si ha agregado un nuevo Site Binding de IIS para Enterprise Server, o ha editado una entrada de Site Binding existente (vea arriba), deberá reiniciar el PC del servidor para establecer correctamente la nueva configuración. Los cambios típicos de Site Binding pueden incluir la edición del número de puerto de una entrada de host o la adición de un nuevo binding para un alias de dominio.
Cuando no sea práctico reiniciar la máquina host del servidor, el proceso alternativo consiste en reiniciar el servicio del servidor en la plataforma IIS: Restart en Manage Website, y también reiniciar el servicio Altium DXP App Server Pinger (un servicio de Windows).
Ejecute el proceso de inicio anterior si recibe un mensaje de error SignalR Hub "healthmonitorHub" not found! al intentar ejecutar la función Health Monitor de Enterprise Server.
Acceso mediante HTTPS
Para establecer una conexión segura con Enterprise Server:
-
Desde Altium Designer – use una dirección de servidor con el prefijo HTTPS y el puerto HTTPS configurado. De forma predeterminada, este es https://<computername>:9785 (donde [computername] es el nombre del equipo de la máquina host o el nombre de dominio completo).
Altium Designer incluye la compatibilidad de seguridad necesaria para aceptar una conexión HTTPS a Enterprise Server sin intervención.
-
Desde un navegador: introduzca la dirección del servicio de nombres del equipo host (https://<computername>:9785).
Si decidió conservar el certificado de identidad autofirmado generado para Enterprise Server, el navegador le advertirá que la conexión no es segura/privada. Puede optar por aceptarlo en su navegador para continuar. Algunos navegadores (por ejemplo, Firefox) ofrecen la opción de aceptar permanentemente el certificado para que no sea necesaria ninguna acción adicional.
Red
Puertos predeterminados
Los siguientes números de puerto de comunicación predeterminados son utilizados por Enterprise Server:
El puerto del servicio LDAP no se utiliza realmente. Para LDAP estándar (con la URL ldap://), se utiliza el puerto de esta URL. Para LDAP seguro (con la URL ldaps://), se utiliza el puerto 636.
Los tres primeros de la lista pueden configurarse durante la instalación inicial, en la página Altium On-Prem Enterprise Server Configuration del instalador.
Si un puerto ya está en uso, el instalador buscará el siguiente disponible y utilizará ese en su lugar.
Al elegir un puerto, tenga en cuenta que no debe entrar en conflicto con ningún puerto utilizado por otras aplicaciones; si un puerto está actualmente en uso, el instalador se lo notificará.
El HTTP Port es servido por IIS y utilizado por las aplicaciones de Enterprise Server. Es el puerto principal y siempre debe estar abierto. El Firebird Server Port es utilizado para, y por, Firebird RDBMS. De forma predeterminada, está enlazado solo a localhost. No SHOULD NOT debe exponerse externamente, por motivos de seguridad. Los usuarios no interactúan directamente con este puerto. Ambos puertos proporcionan interacción HTTP normal (solicitud/respuesta). Ambos puertos pueden personalizarse. El HTTP Port puede cambiarse durante la instalación. Aunque el Firebird Server Port puede cambiarse manualmente, no se recomienda hacerlo.
Con respecto al puerto de comunicaciones HTTP, si tiene tecnología Vault heredada (Altium Personal Vault o Altium Satellite Vault) ejecutándose en el mismo PC, asegúrese de que los puertos de comunicación sean únicos. Un Altium Personal Vault heredado utiliza el puerto 9680, mientras que un Altium Satellite Vault heredado utiliza el puerto 9880. Enterprise Server no puede instalarse junto a un Altium Vault heredado (3.0 y anteriores), Altium Concord Pro, Altium NEXUS Server, o un Altium Infrastructure Server (es decir, en el mismo PC). En el caso de los tres primeros, puede actualizar a Enterprise Server (como si actualizara a una versión posterior de esa entidad).
Consulte la información sobre puertos y direcciones IP para el software Altium Design.
Protocolo utilizado para las comunicaciones entre servicios
SOAP sobre HTTP.
Almacenamiento de datos
Rutas de instalación predeterminadas
La siguiente es una lista de rutas de instalación predeterminadas al instalar 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.
Repositorio de diseño SVN local – Almacenamiento
Un Design Repository que se crea a través del servicio local de control de versiones tiene sus datos internos almacenados en una subcarpeta correspondiente dentro de la carpeta \ProgramData\Altium\Altium365Data\Repository (para una instalación predeterminada de Enterprise Server).
-
Una nueva instalación de Enterprise Server proporciona un único repositorio de diseño basado en Git para alojar todos los proyectos de diseño de su Workspace, ¡y eso es todo! Esto evita cualquier configuración y complejidad relacionadas con el servicio local de control de versiones de Enterprise Server. Tiene un único repositorio de diseño, Versioned Storage, al que todos sus diseñadores pueden acceder y en el que pueden publicar versiones. Como tal, la página VCS de la interfaz del navegador del Workspace de Enterprise Server pasa a ser meramente informativa: no puede agregar un nuevo repositorio, y el único repositorio Git no puede modificarse de ninguna manera ni eliminarse.
-
La carpeta \ProgramData\Altium\Altium365Data\Repository no debe ser accedida de ninguna forma, salvo por el personal de TI para tareas de mantenimiento.
Arquitectura de servicios – Descripción general
Enterprise Server instala una serie de servicios principales, así como consolas de administración basadas en navegador y un Explorer (también basado en navegador). Para acceder a cualquiera de estos servicios, la identidad del usuario debe ser reconocida y autenticada. Enterprise Server incluye un usuario predefinido (Username: admin, Password: admin). La página Users de la interfaz basada en navegador del Workspace de Enterprise Server puede utilizarse para agregar y administrar más usuarios. No hay límite en la cantidad de usuarios que pueden registrarse para acceder y utilizar Enterprise Server, pero sí existe un límite en las conexiones simultáneas, determinado y aplicado por la licencia requerida.
El mismo usuario puede acceder a Enterprise Server simultáneamente de diferentes formas (por ejemplo, conectado a través de Altium Designer AND y accediendo mediante un navegador externo) y, desde la perspectiva de la licencia, solo cuenta como una única conexión cuando el acceso se realiza desde la misma PC. Si el mismo usuario accede a Enterprise Server desde distintas PC, cada acceso desde una PC diferente requerirá una conexión independiente (es decir, un asiento adicional de una Connector Access License).
Altium Designer utiliza un canal no cifrado (SOAP sobre HTTP) para comunicarse con los siguientes servicios:
-
Applications Registry Service (cuando se utiliza el Network Installation Service como origen para extensiones/actualizaciones)
-
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 (a través del protocolo SVN://)
-
Tasks Service
-
Team Configuration Service (TC2)
-
Vault Service
Todos los demás servicios se comunican entre sí.
La mayoría de los servicios requieren acceso a la misma base de datos de Enterprise Server, en la que almacenan los datos que les corresponden. A continuación se muestran ejemplos de los datos almacenados por algunos de estos servicios:
-
Part Catalog Service – almacena artículos de proveedores y fabricantes, historial de cambios de precios y cantidades, etc...
-
Identity Service – almacena usuarios, grupos, configuración de licencias e información de sesiones.
-
Vault Service – almacena su estructura (carpetas, elementos, revisiones, tipos de contenido, estados del ciclo de vida, etc...).
Los documentos reales se almacenan en el sistema de archivos, en la carpeta Revisions (\ProgramData\Altium\Altium365Data\Revisions).
El Part Catalog Service también requiere una conexión directa a Internet (sin proxy) para actualizaciones de precios en tiempo real.
Las siguientes aplicaciones basadas en navegador utilizan la API SOAP para comunicarse con los servicios correspondientes; no requieren acceso a la base de datos de Enterprise Server, ni necesitan otros archivos para funcionar:
-
User Management – la aplicación detrás de la página Users y sus subpáginas en la interfaz del navegador del Workspace de Enterprise Server.
-
Vault Explorer – la aplicación detrás de la página Explorer de la interfaz del navegador del Workspace de Enterprise Server.
-
Catalog Management – la aplicación detrás de la página Part Providers de la interfaz del navegador del Workspace de Enterprise Server.
-
Projects Management – la aplicación detrás de la página Projects de la interfaz del navegador del Workspace de Enterprise Server.
-
TC2 Console – la aplicación detrás de la página Configurations de la interfaz del navegador del Workspace de Enterprise Server.
Operaciones
Copia de seguridad/restauración de datos del servidor
La copia de seguridad y la restauración de los datos de su Enterprise Server se realizan desde la línea de comandos, de forma automatizada, mediante la herramienta dedicada Backup & Restore Tool. Esta herramienta, avbackup.exe, puede encontrarse en la carpeta \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (para una instalación predeterminada de Enterprise Server).
Consulte la página Backing up & Restoring Your Installation para obtener más información.
Reindexación del contenido del servidor después de la migración de datos
Para reindexar el contenido de Enterprise Server, por ejemplo después de una migración de datos:
-
Detenga todos los grupos de aplicaciones de IIS asociados con Enterprise Server.
-
Detenga el servicio Elasticsearch (AltiumElasticSearch). Esto se realiza desde el panel de Windows Services, al que se accede desde la ventana Administrative Tools de Windows.
-
Elimine el contenido de la carpeta SearchData, que contiene los datos de indexación de búsqueda (\ProgramData\Altium\Altium365Data\SearchData para una instalación predeterminada).
-
Reinicie el servicio Elasticsearch (AltiumElasticSearch).
-
Reinicie los grupos de aplicaciones de IIS asociados con Enterprise Server.
Al encontrar vacía la carpeta SearchData, Enterprise Server volverá a indexar su contenido una vez que se inicie.
Aumento del tamaño del montón de Java
Un tamaño insuficiente del montón de Java puede dañar el índice de búsqueda de componentes y hacer que los datos de componentes no estén disponibles desde Altium Designer. Si tiene problemas con el índice de búsqueda (el Health Monitor Status Report muestra errores de SearchService Schema not found: 'vault1ex2_04 en los registros), considere aumentar el tamaño del montón de Java.
El tamaño actual del montón de Java puede comprobarse abriendo http://localhost:9200/_cat/nodes?h=heap*&v en la máquina que aloja Enterprise Server. Si el valor heap.max es de alrededor de 1 GB, aumente este valor como se describe a continuación.
-
El valor al que debe aumentarse el tamaño del montón de Java depende del tamaño de la base de datos de Enterprise Server. La descripción a continuación muestra un ejemplo de cómo aumentar el tamaño a 4 GB.
-
Antes de continuar con el aumento del tamaño del montón de Java, asegúrese de que la máquina disponga de la cantidad adicional correspondiente de memoria física.
-
Ejecute el Símbolo del sistema en modo administrador.
-
Ejecute el siguiente comando:
"C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch
-
En la pestaña Java del cuadro de diálogo que se abre, realice los siguientes cambios:
-
En el campo Java Options, actualice -Xms1g por -Xms4g y actualice -Xmx1g por -Xmx4g.
-
Actualice los valores en los campos Initial memory pool y Maximum memory pool con 4096.
Al aumentar el tamaño del montón de Java a un valor distinto de 4 GB, cambie las opciones anteriores en consecuencia (por ejemplo, actualice las opciones de Java con -Xms6g y -Xmx6g y especifique 6144 para Initial memory pool y Maximum memory pool si está aumentando el tamaño a 6 GB).
-
Haga clic en Apply y OK en el cuadro de diálogo.
-
Desde el panel Services de Windows (al que se accede desde la ventana Administrative Tools de Windows), reinicie el servicio AltiumElasticsearch .
-
Verifique que los cambios se hayan aplicado abriendo http://localhost:9200/_cat/nodes?h=heap*&v y comprobando el valor del parámetro heap.max.
Localizado por IA