Installing the Software

Now reading version 5.5. For the latest, read: Installing the Software for version 7.0
 

Parent page: Installation, Licensing & Management

The Enterprise Server cannot be installed on the same PC as another server offering from Altium (e.g. Altium Infrastructure Server, Altium NEXUS Server, Altium Concord Pro, Altium Vault (3.0 and earlier)). In the case of Altium NEXUS Server, Altium Concord Pro and Altium Vault, you can upgrade to the Enterprise Server (as though updating to a later version of that entity).

The Enterprise Server delivers high integrity, smart design and product data management by providing storage, formal revision management, supply chain intelligence, and lifecycle state management. It also facilitates a wide range of additional technologies and capabilities by providing a centralized platform from which other related services can be served, including: Team Configuration Management, Project Management, Network Installation, and Centralized Design Collaboration. Installation of the Enterprise Server is both intuitive and fast, courtesy of the Altium On-Prem Enterprise Server Setup wizard.

This article takes a look at the procedure for installing the Enterprise Server for the first time on a computer. If you are upgrading an existing installation, see Updating to a Later Version.

The Enterprise Server cannot be installed on a PC running a 32-bit OS, nor a 64-bit OS that does not support Windows Authentication (Core, Home, Starter, and Base editions). The following is a summary of supported Operating Systems:

  • Officially Supported: Windows Server 2019 Standard Edition 64-bit (Recommended), Windows Server 2016 Standard Edition 64-bit (Minimum).
  • Recommended only for Evaluation: Windows 10 64-bit, Windows 8.1 64-bit - Ultimate or Professional versions in each case. Limited to 10 concurrent websockets in use through the Enterprise Server Workspace's browser interface on such an OS.
For additional system requirements, see System Requirements.
While the Enterprise Server installer includes automated backup of your existing server, it is always a good idea to make a pre-update backup of your data yourself - taking a redundancy copy off to one side as it were. This provides additional safety, should any unforeseen technical difficulties arise (see Backing up & Restoring Your Installation). It is advised to test out a new release of the Enterprise Server on a different machine, before updating your production instance. Use of Virtual Machines can be invaluable in this respect.

Pre-Install Preparation

To access the Altium On-Prem Enterprise Server Setup wizard, you need to first acquire and run an executable – Altium On-Prem Enterprise Server <VersionNumber>.exe. This executable is downloaded from the Downloads page of the Altium site and can be saved anywhere on your hard disk.

  • Some users have experienced issues with the installation of Microsoft .NET Core apps when running the Enterprise Server installer.
    ► See the Install on a New Operating System section in the Possible Installation Issues page for a workaround install and optional repair information.
  • Due to the observed unpredictable behavior of antivirus software, it is recommended to disable such software during the installation of the Enterprise Server.

Running the Setup Wizard

Double-click the Altium On-Prem Enterprise Server <Version Number>.exe file. The Enterprise Server requires .NET Framework 4.8 and .NET Core 3.1.2 be installed on the hosting computer. If these are present, the Altium On-Prem Enterprise Server Setup wizard will appear directly. If not, the following procedure is followed:

  1. .NET Framework 4.8 installation - if this is not currently installed, you will be offered the chance to install it at this time. Click Yes - the installer will appear.

  1. Once installation is complete, you will need to restart your computer, after which you will need to run the Altium On-Prem Enterprise Server <Version Number>.exe file again.
  2. .NET Core 3.1.2 installation - if this is not currently installed, you will be offered the chance to install it at this time. Installation happens in the background, after which the Altium On-Prem Enterprise Server Setup wizard will appear.

Initial welcome page for the Altium On-Prem Enterprise Server Setup wizard.
Initial welcome page for the Altium On-Prem Enterprise Server Setup wizard.

The installation wizard provides a set of progressive (and intuitive) pages that collectively gather the information to effectively install the Enterprise Server.

Click Next to continue. The following sections provide a summary of the various pages you will encounter.

License Agreement

This page of the wizard presents you with the Altium End-User License Agreement (EULA).

Read and accept Altium's End-User License Agreement.
Read and accept Altium's End-User License Agreement.

The agreement is available post-installation in RTF format - Eula.rtf - in the main install folder (set on the next page of the Wizard, and by default: \Program Files (x86)\Altium\Altium365).

With the EULA read, continue with the install by enabling the I accept the agreement option and clicking the Next button.

Select Destination Location

This next page of the wizard allows you to specify the destination in which to install the Enterprise Server. The default installation path is \Program Files (x86)\Altium\Altium365. The Enterprise Server requires at least 5.3GB of free disk space for installation.

To specify an alternate location, simply type the location directly into the field, or click the Browse button at the right of the field, and browse for the required destination folder (or create it on-the-fly).

Determine install location for the Enterprise Server.
Determine install location for the Enterprise Server.

The Enterprise Server doesn't just provide you with a repository for your Workspace content. It also provides the base platform from which additional services are 'plugged' and served. These services include the Vault Service (the Enterprise Server itself), Identification Service, Search Service, Comments Service, Data Acquisition Service, Part Catalog Service, and Projects Service.

Once the install location is specified, click Next to continue.

Select Altium On-Prem Enterprise Server Data Directory

Use this page of the wizard to specify the destination folders in which to store the database and revision files respectively. The default installation paths are:

  • Database Folder\ProgramData\Altium\Altium365Data
  • Revision Files Folder\ProgramData\Altium\Altium365Data\Revisions

To specify an alternate location, simply type the location directly into a field, or click the Browse button at the right of a field, and browse for the required destination folder (or create it on-the-fly).

When installing the server and using Firebird for the database, you also have the option to install sample data - including Workspace projects and Workspace components. This can be very handy if you are new to the server technology, because it gives you something to explore, right out of the box. To make use of this, leave the Install sample data option enabled. Disable this option to install with just the data structure of server folders in which to start creating your various data Items, along with some defined component templates.

Determine install locations for server data.
Determine install locations for server data.

Once the data folder locations are specified, click Next to continue.

Altium On-Prem Enterprise Server Configuration

Use this next page of the wizard to specify the port numbers to be used by the Enterprise Server for network connections. The defaults are:

  • HTTP Port (default 9780)
  • HTTPS Port (default 9785)
  • LDAP Service Port (default 9791)
If a port is already used, the Installer will search for the next available, and use that instead.

When choosing a port, note that it must not clash with any ports used by other applications - if a port is currently in use, you will be notified by the installer.

Set the port numbers for server communications.
Set the port numbers for server communications.

Once the port numbers are specified as required, click Next to continue.

Select Altium On-Prem Enterprise Server Database

Use this page of the wizard to specify the type of database used for the Enterprise Server. Two database types are available:

  • Firebird
  • Oracle
Firebird is the default database option. The Firebird 3.0 engine is used, on port 3050, creating a new database for the server with native support and no additional options. If you have an earlier version of Firebird installed, it will be updated automatically with v3.0. The Oracle database type facilitates streamlined installation of the Enterprise Server within organizations already utilizing this type of database as the back-end for their existing systems. Hosting the server on their existing infrastructure reduces installation and management complexity.

Select the type of database for the Enterprise Server's back-end.
Select the type of database for the Enterprise Server's back-end.

Once the type of database is specified, click Next to continue.

Altium On-Prem Enterprise Server Database Configuration

With the default Firebird database, there are no additional options to define. If the Oracle database type is chosen, this page will be presented. Use it to specify the following information:

  • TNS Alias - the TNS (Transparent Network Substrate) alias name assigned for the database.
  • Username - username portion of your database login credentials.
  • Password - password portion of your database login credentials.

Specify access to your company's Oracle database, which will be used by the Enterprise Server.
Specify access to your company's Oracle database, which will be used by the Enterprise Server.

All database parameters, including the user's password (in encrypted form), are saved to the LocalVault.ini file (located in the \Program Files (x86)\Altium\Altium365 folder for a default Enterprise Server installation).

Once the database option are specified, click Next to continue.

Ready to Install

The Installer now has all the information it requires to proceed with the installation. If you need to change anything, click the Back button. If you want to cancel out of the install, click Cancel. To go ahead and proceed with the installation, click Install. The page will change from "Ready to Install" to "Installing" and the installation will proceed. Once complete, simply click Finish to exit the wizard.

The Enterprise Server runs on top of the Microsoft Internet Information Services package (IIS). If this is not installed on the PC, you will be prompted to install it after the installation process begins.

Kick off the installation by clicking Install. Click Finish once installation is complete.
Kick off the installation by clicking Install. Click Finish once installation is complete.

For your convenience, the final page of the Installer also presents URLs (HTTP and HTTPS) for accessing the Enterprise Server - either when connecting to it through Altium Designer, or when accessing it through its browser-based interface.

For information on how to access your Enterprise Server from within Altium Designer, and working with it from a design perspective, see Access from within Altium Designer, and Designing with a Connected Workspace, respectively.

Verifying the Enterprise Server is Running

Verification that the Enterprise Server is running can be performed from the Windows Internet Information Services (IIS) Manager panel – accessed from the Administrative Tools window. Simply check to confirm the Enterprise Server-related Application Pools are in the Started state. For more information, see Application Pools Installed on IIS.

Installation from the Command Line

The Enterprise Server can also be installed from the command line, using the following entries:

  • DatabaseName - name of the database (the database filename). Specify the path within double quotes, for example "C:\ProgramData\Altium\Altium365Data\DXPSERVER.DAT", for the default install.
  • DataFolder - destination database folder. Specify the path within double quotes, for example "C:\ProgramData\Altium\Altium365Data", for the default install.
  • DBPassword - password portion of your database login credentials, for example MyPassword.
  • DBServer - the location of the database, in the format Host:Port. For example localhost:3050, for the default Firebird database install.
  • DBType - the type of database to be used. Enter one of the following values: Firebird, or Oracle.
  • DBUserName - username portion of your database login credentials, for example MyName.
  • InstallFolder - the location in which to install the Enterprise Server. Specify the path within double quotes, for example "C:\Program Files (x86)\Altium\Altium365\", for the default install.
  • InstallSampleSnapshot - control whether sample data is installed into the server (set value to 1) or a clean server install without data is made (set value to 0).
  • Log - use this parameter to change the location and filename of the installation log file. Specify the path within double quotes. If omitted, the default install location will be used (\Program Files (x86)\Altium\Altium365\install.log).
  • Port - the communications port, for example 9780 for the default install.
  • RevisionFolder - destination revision files folder. Specify the path within double quotes, for example "C:\ProgramData\Altium\Altium365Data\Revisions", for the default install.
  • VERYSILENT - use this parameter to run the installation without any dialogs popping up.

When entering the information on the command line, observe the following:

  • Start with the name of the installer executable, for example "Altium On-Prem Enterprise Server <VersionNumber>.exe".
  • Enter each parameter, followed by the equals symbol (=), and then its value.
  • Separate subsequent parametric entries with a space followed by the forward slash character ( /).
  • To run without any dialogs popping up, be sure to add the entry VERYSILENT at the end.

An example command line entry might therefore be:

"Altium On-Prem Enterprise Server <VersionNumber>.exe" /InstallFolder="C:\Program Files (x86)\Altium\Altium365\" /Port=9780 /DBType=Firebird /DBServer=localhost:3050 /DBUserName=MyName /DBPassword=MyPassword /DatabaseName="C:\ProgramData\Altium\Altium365Data\DXPSERVER.DAT" /DataFolder="C:\ProgramData\Altium\Altium365Data" /RevisionFolder="C:\ProgramData\Altium\Altium365Data\Revisions" /VERYSILENT

The majority of the parameters above are not applicable when updating the Enterprise Server. For a command line approach to updating, it is recommended to use the following:

"Altium On-Prem Enterprise Server <VersionNumber>.exe" /VERYSILENT

If you want additional control over whether a backup of your existing server is created, and where, the following can be added to the command line entry:

  • BackupFile - path to the backup file, when updating the current server to a later version. Specify the path within double quotes, for example "C:\Enterprise Server\Backups\EnterpriseServerBackup30082022.zip".
  • IgnoreBackup - use this parameter to not create a backup of the current server, when updating to a later version. This can be very useful when the backup is failing for some reason.

Post-Installation Management

For information on how to manage your instance of Enterprise Server after initial installation, use the following links:

Licensing Your Enterprise Server

Updating to a Later Version of the Enterprise Server

Backing up and Restoring Your Enterprise Server

Uninstalling Your Enterprise Server

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content