Información para departamentos de TI

Parent page: Temas avanzados

Aunque la instalación y el uso de Altium On-Prem Enterprise Server y sus servicios relacionados se detallan en otras páginas dentro 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 encontrar respuestas a preguntas frecuentes sobre esta tecnología, entre ellas:

• 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 los flujos de datos.

Requisitos de hardware

Enterprise Server debe instalarse en un PC que ejecute uno de los siguientes sistemas operativos oficialmente compatibles:

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

Requisitos de Altium Designer

Instalación y otro software

Debido al comportamiento impredecible observado en el software antivirus, se recomienda deshabilitar dicho software durante la instalación de Enterprise Server.

Si el equipo también está ejecutando Microsoft Exchange Server, es posible que reciba un error HTTP Error 503 cuando intente iniciar sesión por primera vez. La instalación de Exchange Server puede cambiar la configuración de Internet Information Services (IIS) de una manera que entre en conflicto con Enterprise Server. Para resolverlo, deben realizarse los siguientes cambios en el archivo 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>

Software adicional instalado o configurado

• Internet Information Services (IIS). Para un funcionamiento correcto, Enterprise Server requiere, como mínimo, que esté instalada la versión 8.0 (IIS 8.0). La instalación de Enterprise Server simplemente instalará la versión de IIS nativa de su sistema operativo:
  • 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)
• Motor de base de datos Firebird 3.0 (cuando se elige la opción de instalar usando una base de datos Firebird). Asegúrese de que el direccionamiento de red IPv4 esté habilitado; para comprobar si hay direcciones IPv4 activas, ejecute ipconfig /all en un símbolo del sistema.
• .NET Framework 4.8 y .NET Core 3.1.2

Configuración de IIS

Como parte de la configuración de IIS, se habilita la función ISAPI Extensions. Esta función se encuentra 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 función de Windows ISAPI Extensions, que forma parte de la configuración de IIS.

Rutas de instalación predeterminadas

A continuación se muestra una lista de las rutas de instalación predeterminadas al instalar 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

Puertos predeterminados

Los siguientes números de puertos de comunicación predeterminados son utilizados por Enterprise Server:

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

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

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.

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á.

► Consulte la información sobre puertos y direcciones IP para el software de diseño de Altium.

Compatibilidad con el protocolo HTTPS

Para quienes requieran una capa adicional de seguridad para intercambiar datos con Enterprise Server, Enterprise Server proporciona comunicación segura a través de redes mediante el protocolo HTTPS para proteger la privacidad y la integridad de los datos.

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 y nombres de servidor disponibles 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 enlace, 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 enlaces mediante el cuadro de diálogo Site Bindings.

Tenga en cuenta que el nombre de servidor localhost solo se aplica a la máquina local, por lo que los PC other que aloja Enterprise Server necesitan usar el nombre real (del servidor) de esa máquina host para conectarse.

Para confirmar el nombre del PC host en el que el Enterprise Server está instalado y en ejecución, en ese equipo vaya a Control Panel\System and Security\System y anote tanto el Computer name como el Full computer name (su nombre de dominio completo); este último será el que utilice el Enterprise Server para conexiones seguras a través de la red.

Si ha editado los enlaces del sitio del Enterprise Server para usar un número de puerto distinto del valor predeterminado, ese cambio también deberá reflejarse en el archivo LocalVault.ini del Enterprise Server. Esto se debe a que sus referencias de puerto se consultan cuando Altium Designer establece conexiones con el Enterprise Server. El archivo LocalVault.ini se encuentra en la carpeta raíz de la instalación del Enterprise Server, normalmente Program Files (x86)\Altium\Altium365.

Por ejemplo, si ha cambiado el enlace del sitio del 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.

Para establecer una conexión segura con el Enterprise Server:

• Desde Altium Designer – use una dirección de servidor con prefijo HTTPS y el puerto HTTPS configurado. De forma predeterminada, este es https://localhost:9785 cuando se usa el PC que aloja el Enterprise Server, o https://<computername>:9785 para una conexión remota (donde [computername] es el nombre del equipo host o su nombre de dominio completo).

• Desde un navegador – introduzca la dirección del servicio local (https://localhost:9785) o el nombre equivalente del equipo host (https://<computername>:9785).

Al reconfigurar los enlaces del sitio

Si ha agregado un nuevo IIS Site Binding para el Enterprise Server, o ha editado una entrada existente de Site Binding (ver arriba), se debe reiniciar el PC servidor para establecer correctamente la nueva configuración. Los cambios típicos de Site Binding pueden ser editar el número de puerto de una entrada de host, o agregar un nuevo enlace para un alias de dominio.

Cuando no resulte práctico reiniciar la máquina host del servidor, el proceso alternativo es 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).

Protocolo usado para las comunicaciones entre servicios

SOAP sobre HTTP.

Arquitectura de servicios – Descripción general

El Enterprise Server instala varios 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. El Enterprise Server incluye un usuario predefinido (Username: admin, Password: admin). La página Users de la interfaz basada en navegador del Workspace del Enterprise Server puede utilizarse para agregar y gestionar más usuarios. No existe límite en el número de usuarios que pueden registrarse para acceder y usar el Enterprise Server, pero sí hay un límite en las conexiones simultáneas, según lo determine y aplique la licencia requerida.

Altium Designer utiliza un canal sin cifrar (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 del Enterprise Server, en la que almacenan los datos aplicables a ellos. Los siguientes son ejemplos de los datos almacenados por algunos de estos servicios:

• Part Catalog Service – almacena artículos de proveedores y fabricantes, cambios en el historial de precios y cantidades, etc...
• Identity Service – almacena usuarios, roles, configuración de licencias e información de sesión.
• 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 (\Altium\Altium365Data\Revisions). \ProgramData

Las siguientes aplicaciones basadas en navegador usan la API SOAP para comunicarse con los servicios correspondientes; no requieren acceso a la base de datos del Enterprise Server ni tampoco ningún otro archivo para funcionar:

• User Management – la aplicación detrás de la página Users y sus subpáginas en la interfaz de navegador del Workspace del Enterprise Server.
• Vault Explorer – la aplicación detrás de la página Explorer de la interfaz de navegador del Workspace del Enterprise Server.
• Catalog Management – la aplicación detrás de la página Part Providers de la interfaz de navegador del Workspace del Enterprise Server.
• Projects Management – la aplicación detrás de la página Projects de la interfaz de navegador del Workspace del Enterprise Server.
• TC2 Console – la aplicación detrás de la página Configurations de la interfaz de navegador del Workspace del Enterprise Server.

Archivos de licencia

Related page: Licencias

Las licencias del Enterprise Server constan esencialmente de los dos componentes siguientes, que juntos conforman un sistema de licencias de dos niveles:

• Server License – esta licencia pone a disposición de la organización las funciones y los servicios de la instalación del Enterprise Server.
• Client Access License – esta licencia permite a los usuarios dentro de una organización acceder al Enterprise Server de la organización.

Las licencias del Enterprise Server pueden gestionarse a través de la nube o localmente mediante archivos de licencia (*.alf). La obtención de estos últimos se realiza a través del Company Dashboard (al que se accede usando la entrada Company Dashboard del menú de la cuenta AltiumLive, en la parte superior derecha del sitio de Altium). En la pestaña Licenses , localice la licencia correspondiente (en el grupo de licencias Server Applications) y luego haga clic para acceder a la página detallada de gestión de licencias. Una vez allí, haga clic en el botón Activate para generar y descargar el archivo de licencia asociado.

Copia de seguridad/restauración de los 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, usando 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 del Enterprise Server).

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:

1. Detenga todos los grupos de aplicaciones de IIS asociados con Enterprise Server.
2. Detenga el servicio Elasticsearch (AltiumElasticSearch). Esto se realiza desde el panel Services de Windows, al que se accede desde la ventana Administrative Tools de Windows.
3. Elimine el contenido de la carpeta SearchData, que contiene los datos de indexación de búsqueda ( \Altium\Altium365Data\SearchData para una instalación predeterminada). \ProgramData
4. Reinicie el servicio Elasticsearch (AltiumElasticSearch).
5. 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.

Repositorio de diseño SVN local – Almacenamiento

Un repositorio de diseño creado mediante el 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).

Uso de Oracle para la base de datos de Enterprise Server

Related page: Enterprise Server con backend de Oracle

Al instalar Enterprise Server, el tipo de base de datos Oracle facilita una instalación optimizada de Enterprise Server dentro de organizaciones que ya utilizan este tipo de base de datos como backend de sus sistemas existentes. Alojar Enterprise Server en su infraestructura existente reduce la complejidad de instalación y administración.

Poner en funcionamiento Enterprise Server con Oracle como base de datos backend es esencialmente un proceso de dos partes:

1. Configurar la base de datos Oracle
2. Configurar Enterprise Server.

Preparación de Enterprise Server

Para instalarse y ejecutarse correctamente, Enterprise Server requiere no solo el cliente OCI, sino también los conectores .Net correspondientes. Se recomienda instalar los Oracle Data Access Components (ODAC) de 32 bits con Oracle Developer Tools for Visual Studio, de acuerdo con la versión de Oracle que esté utilizando. Se recomienda la descarga ODAC 12c Release 1 and Oracle Developer Tools for Visual Studio (12.1.0.1.0) como mínimo para instalar en la máquina dedicada utilizada para alojar Enterprise Server.