Connecting to Your Enterprise Server Workspace
Connect to your Enterprise Server Workspace from within Altium Designer by clicking the Current User control, at the top-right of the main application window (e.g. ). This will be the user that is currently signed into AltiumLive through this instance of Altium Designer. In the subsequent menu choose the Custom connection command. The Sign in dialog will appear, with which to connect to the target Workspace. Enter the URL for the Workspace and your Workspace access credentials, then click the button.
It can be a good idea to enable the Sign in automatically option so that the entered URL and access credentials are stored and you don't have to repeatedly enter them to access the Workspace when starting Altium Designer.
Connecting to your Enterprise Server Workspace from within Altium Designer.
The Enterprise Server Workspace's URL (Server Address) will be in the format http://<ComputerName>:<PortNumber>
(e.g. http://impala:9780
for an Enterprise Server installed using the default port assignment). If the Workspace is being accessed from an instance of Altium Designer that is running on the same computer on which the Enterprise Server is installed, you may also use http://localhost:9780
. If you want to connect using your Windows login credentials – taking advantage of the Workspace's support for Windows Authentication – enable the Use Windows Session credentials option.
The Altium On-Prem Enterprise Server relies on a number of Microsoft runtime components for successful operation and access, in some situations these may not be present on the target machine. If you receive an error message about a missing library (DLL) when you attempt to connect to your Enterprise Server Workspace, it indicates that there are missing Microsoft runtime components. Obtain and install the relevant Microsoft Visual C++ Redistributable Package for your OS.
Connecting to a 'Known' Enterprise Server Workspace
If you have previously connected to your Enterprise Server Workspace from within the same instance of Altium Designer, it will become a Known Server. If this is the case, you can connect to that Workspace from within Altium Designer in a more streamlined fashion. To do so, click on the control at the top-right of the main application window. In the subsequent menu, choose the entry for your Workspace, in the CUSTOM CONNECTIONS grouping. If you enabled the Sign in automatically option when accessing that Workspace previously, you will be connected straight away. If this option was not enabled, the Sign in dialog will appear, with which to connect to the target Workspace. Enter the URL for the Workspace, and your Workspace access credentials, then click the button.
Connecting to your Enterprise Server Workspace from within Altium Designer, when that Workspace is already known.
Note that when the
Sign in automatically option is enabled, you will be connected to the Workspace as the user that last connected through the
Sign in dialog. If you need to connect as a different user, you will need to use the
Custom connection command in the menu associated with the Current User control, at the top-right of the main application window (e.g.
).
You can also access your 'known' Workspace from the
Open Project and
Create Project dialogs, when wanting to open an existing project, or create a new project, respectively. In either case, select the
entry in the
Locations region of the dialog, then click the button relevant to that Workspace on the right-hand side. Again, if you need to connect as a different user, you will need to use the
Custom connection command in the menu associated with the Current User control, at the top-right of the main application window (e.g.
).
Connecting to an Enterprise Server Workspace from Different Computers
Support is provided for connecting to your Enterprise Server Workspace using the same credentials but from different computers (other than the computer on which the Enterprise Server is installed). If you attempt to connect to a Workspace that you are already connected to from another computer – either through Altium Designer or the Workspace's browser-based interface – a pop-up dialog will alert you to this. You can choose from two options offered in the dialog:
- Terminate existing session – close the existing session that you have on the other computer and continue to login to the Workspace from the current computer.
- Start new session – login to the Workspace from the current computer by using an additional connection license and thereby keep logged into the Workspace from the other computer as well.
The same user can be accessing an Enterprise Server Workspace concurrently in different ways (e.g. connected through Altium Designer AND signed-in through an external Browser) and it only counts as a single connection from the licensing perspective, when access is made from the same PC. If the same user accesses that Enterprise Server Workspace from different PCs, each different PC access will require a separate connection (so extra seat of a Client Access License). You will therefore only be able to log in from the current computer as well, provided you have enough Client Access Licenses (CAL) remaining.