Altium Designer Documentation

Private License Service

Modified by Rob Evans on Jul 14, 2017

Parent page: Altium Infrastructure Server

For organizations that require their Altium software installations to remain offline – isolated from the internet – the convenience and flexibly of on-demand software licensing can be provided by a localized Altium Infrastructure Server (AIS), rather than from the internet-based Altium Licensing Service. The freely downloadable AIS provides a Private License Service (PLS) that becomes accessible over the local or company-wide network system.

The Infrastructure Server, installed on a PC connected to the company LAN/WAN, is set up by an administrator to acquire the company's Altium licenses and then using its PLS, serve these over the network to Altium software installations. When initially acquired from Altium's web-based license service, the licenses are converted to Private Licenses for localized access.

In a similar arrangement to using a license from the Altium License Service portal, a seat (instance) of a PLS-hosted Altium license can be 'leased' by workstation software when it is in use, and then 'revoked' (returned to the available pool of licenses) when no longer required. With the Altium PLS, licenses can also be served on a Roaming basis, where the license seat is leased to the target machine for a specified time – this allows the software's host PC, say a laptop, to 'roam' freely while isolated from the network. Also, Altium Vaults connected to the network may be licensed by the AIS.

The Altium Infrastructure Server (AIS) and its PLS offer the flexibility required by companies that host multiple Altium software installations, with the bonus that the license and seat usage can be configured, monitored and controlled from a centralized AIS – which in turn is hosted on a local LAN/WAN that may be isolated from the internet.

Note that the AIS does not offer design data storage or management capabilities, such as the advanced Data Management features available in the Altium Vault. Multiple Altium Vaults however, such as departmental Vaults, may be licensed by the AIS while remaining offline.

Preliminaries

If it's not already in place, the first step in using the Private License Service is installing and licensing the Altium Infrastructure Server.

– See Installing the Infrastructure Server

The Altium Infrastructure Server's functionality, including its Private License Service capabilities, becomes available when the AIS has been licensed by the addition of a suitable Infrastructure Server License. This is done by signing in to the AIS using the default admin/admin credentials, accessing the Licenses page (ADMIN » LICENSING) and adding the license files supplied with the AIS installation download. The server is 'self' licensed from imported alf license files, or AIS licenses acquired from the Cloud, if available – in both cases, it licenses itself.

– See Licensing the Infrastructure Server

Once installed and licensed, the AIS can acquire licenses for Altium software from the online AltiumLive License server via the AltiumLive portal. This is performed through the server's License Manager page (ADMIN » LICENSES), by selecting the From Cloud option of the

button menu.

Note that the AIS needs to be configured to connect and sign in to the Altium License service portal, so that the licenses purchased by your organization can be initially acquired – it may be offline once this is complete. Alternatively, all the required licenses could be acquired via a separate Server, which is connected to the internet, and then transferred to the local AIS as individual license files.

– See Acquire software Licenses from the Cloud

Using the License Service

Once the Altium Infrastructure Server (AIS) and its Private License Service (PLS) has been installed and licensed (as above), licenses that are acquired from the AltiumLive Licensing service such as Server, Client Access (CAL) and other Altium software licenses, can then be served over the local network by the PLS.

Local PLS setup

In the default PLS configuration, acquired licenses, which are set for All Users access by default, will be made available to Altium software installations hosted on the network. The Infrastructure Server itself is 'self licensed' as outlined above, through imported alf license files.


The PLS serves licenses to an Altium software installation (client) on the network when it connects the AIS License Service.

For the default PLS settings and acquired license configurations, any connection to the PLS from Altium software will be granted access to the available licenses. The simple arrangement is ideal for a using a central licensing server (the AIS) to license several Altium software workstations that have identical licensing requirements – say, from a single multi-seat license. See below for how Altium software, such as Altium Designer, connects to the PLS.

To access the PLS settings, select the License Manager options page in the AIS browser interface – ADMIN » SETTINGS – License Manager.


The License Manager options will affect how licenses are configured and leased.

The License Manager options on the browser Settings page are as follows:

  • Cloud license service url – Preset by the AIS installation to the correct web address for access to the AltiumLive License Service, which allows license acquisition based on your entered AltiumLive sign in credentials. The credentials may be added or edited in the General – Altium Live Credentials page under ADMIN » SETTINGS.
  • Automatic user creation – When checked, the PLS will automatically generate an AIS user account (set to the workstation's Windows Account Name) when Altium software connects to the AIS. In Altium Designer, this is instigated when the Setup Private License Server feature is enabled (see below). The generated AIS user profile is then used for Role membership, and therefore to determine license distribution for that Altium software workstation. If the option is unchecked, no user account will be created.
  • Seat return timeout interval – Specifies the period of client (a connected workstation) inactivity before the current license lease will expire and be returned to the available pool of license seats. The PLS regularly queries a client over the network and expects a response, and will cancel the license lease if this has not been returned for the specified number of hours. When client software disconnects from a license in the normal 'clean' way (Exit, Disconnect from PLS, etc) a leased license seat is automatically returned.
  • Automatically create assignment for All Users group – When checked, newly acquired licenses will be assigned to the All Users group. The served license will be accessible to all workstations that connect to the AIS, regardless of any Role group a workstation's User profile is assigned to. Note that license assignments may be edited, as described below. When the option is unchecked, an acquired license is not assigned to any user group and therefore not accessible over the network.

The default setup, in practice, means that when an Altium software workstation connects to the AIS License Server (PLS):

  1. Suitable licenses are made available to Altium software from the AIS. All compatible licenses are available to all workstations, since the PLS is set to Automatically create assignment for All Users group for acquired licenses.
  2. A new user profile, based on the workstation's Windows Account Name, is created in the AIS – even if the workstation software does not lease a license. This is due to the default Automatic User Creation setting.

From a software users perspective, it simply means that suitable licenses are available and may be used (leased).

License Altium software

Licenses that have been configured and exposed by the Private License Server can be accessed by Altium software installations on the network, which act as clients to the PLS.

To access an Altium Designer license provided by the PLS for example, use the Setup private license server option on the License Management page (DXP » My Account) to first establish the connection. Set the Server name and Server port fields to match those of the AIS in the Private License Server Setup dialog.  Once Altium Designer is connected to the Infrastructure Server and its PLS, the 'Available Licenses' area of the License Management page (DXP » My Account) will be populated with the list of private licenses provided by the PLS connection, under the category Private Server – Connected to xxx, where 'xxx' indicates the name of the AIS that is serving the licenses.

To lease a license for the Altium Designer installation, select the desired license from the list and click the Use button. Alternatively, a license hosted by the AIS may be set to Automatic Leasing mode, so that no user intervention is required in the client software – beyond establishing the initial connection to the AIS. Note that Altium Designer will retain the PLS connection settings and attempt to re-establish the connection when starting.


Private Licenses are made available when signing in to the AIS. In this case, the AIS admin has signed in.

The status of the selected license will then change to indicate that it is used by you. Note that its Assigned Seat Count field will change to reflect that a seat of the license has been taken.

Altium Designer users are not required to sign in to an online Altium Account to use a private license, and the local LAN/WAN connection may be isolated from the internet. If required, go to the System – Account Management page in Preferences (DXP » Preferences) to disable the Altium Account connection, and use the System – Network Activity preferences page to select specific network connection services that will be allowed.

When the license has been leased, by either automatic or manual selection in the client software, the Infrastructure Server's Licensing page (ADMIN » LICENSES) will indicate that a seat of the License is in use – shown as an incremented User Count for that license. The license is immediately released if the workstation disconnects from the PLS, the user closes the software, or the license lease is forcibly revoked by the AIS admin using the associated

button.

The default, and recommended, PLS setup option is to set Automatic user creation as enabled. In the example shown here, the workstation ENGINEERING-2 with an active Windows user account Bruce has leased an Altium Designer license. This causes a matching User account (Bruce) to be created in the AIS, which can be added to a Role that is assigned to a particular license. In this way, license access can be managed for individual workstations.

Manage license access

To control license availability for Altium software users, the Altium Infrastructure Server (AIS) can be configured to associate specific licenses with defined user Roles (groups of Users). In practice, when a workstation connects to the AIS, the License Server (PLS) will offer only licenses that are assigned to Roles that include the workstation's User profile as a member.

Licenses acquired by the AIS are assigned to 'All Users' by default, but can be reassigned to any available Role. Similarly, Users can be added to any available Role.

– See Users and Roles for an overview of working with Users and Roles in the AIS, or Managing Users for more detailed information.

Before managing license distribution in this more specific way (by user Role membership), there are a number of Infrastructure Server conditions that should be in place:

  • User profiles have been added for the relevant software workstations. These are automatically generated when a workstation has connected to the AIS.
  • Suitable user Roles have been added to the AIS, and the above User profiles have been included as members of those Roles.
  • Licenses that apply to the workstation software have been acquired to the AIS.  The licenses must be active and have sufficient seats available.
  • The default admin/admin account in the AIS has been changed to a correctly configured (not default) administrator account profile. This is highly recommended, regardless of how the AIS is used.

License assignments

With the AIS User accounts and Roles established, acquired software licenses can be assigned to Roles as needed.

In the case shown in the below image, two workstations (ENGINEERING-2 and ENGINEERING-3) have connected to generate matching User profiles (Bruce and Narelle). Two Roles have been added (Engineering and QA), and the users added as members of those Roles (Bruce is a member of Engineering, and Narelle is a member of both Engineering and QA).

Select the licensing list (ADMIN » LICENSES) to access the licenses that have been acquired by the AIS, which can then be assigned to the desired Roles. In the example shown below, two Altium Designer licenses have been added to the AIS, and are initially assigned to the default All Users role.

To change a license assignment to a more suitable Role, select its 

button to open the License Edit page, and then the License assignments edit button (
) to access the Assign to role menu options in the Edit Assignment dialog. In this example, the license has been reassigned to the QA role.

The license assignment options include:

  • Automatic leasing: Forces Altium software on a workstation to automatically lease (use) this license when it is available. In Altium Designer's License Manager (DXP » My Account) for example, the normal process of choosing the license from the list and selecting Use is performed automatically, for this license.
  • Seat availability: Specify the number of License seats (up to its total seats rating) that will be made available for the associated Role, or simply check the All available seats option to enable the total number of seats for that License (its User Count attribute)
  • Roaming: Allow a License to be 'roamed' (used by Altium software when its host PC is not connected to the network) by selecting the Allow Roaming option. The Max roam duration setting will configure the license to disable a 'roamed' seat after the nominated period. See On-Demand Licensing for more information about Altium license Roaming.
  • Notifications: Notifications are messages that will be sent to Users in response to specific events, such as when almost all of the assigned License seats have been leased – the Notify for 90% seat count option. Select the Reject notifications option and a message users role target (optional) to enable alert messages for Users that have been disconnected from the assigned License (seat revoked).

When the new license assignment configuration is complete, click 

to commit the assignment to the selected Role. To delete an existing license assignment use the 
button associated with its entry.

License Roles view

To collectively view and edit the existing license Role assignments, select the Roles view in the License Manager (ADMIN » LICENSES Roles tab). Click on a Role name in the Roles column to see its User members, and on the right, its assigned licenses. For the Users, Roles and License assignment in this example, this aggregate view shows that user Narelle is a member of the QA role, which has access to the 15-seat Altium Designer license, as assigned above.

This view also allows license assignments to be added to Roles, via the 

button. To assign a license to the Engineering role in this case, and therefore to the user profiles Bruce and Narelle, select a suitable license from the License drop down menu in the Add Assignment dialog, and 
the change.

Here, a 5-seat Altium Designer license has been added to the Engineering Role and its member workstations. For details about the assigned license, select the expand option (

) associated with its entry.

Note that in this case a new license assignment has been added to a Role, rather than an existing assignment being reassigned from All Users to a specific Role (as outlined above). This means that, as in the example shown here, while a 5-seat Altium Designer license has been added to the Engineering Role, the license is still assigned to the default All Users Role as well – and therefore, exposed to all workstations that connect to the License Server.

Deleting the license's additional All Users Role assignment will leave the license only assigned to the Engineering Role, rather than both, and thereby exclusively available to the Engineering group of Users. To delete an existing license assignment use the 

button associated with its entry.

As a result of these example license assignments:

  • The software workstation with the Windows Account Name Bruce on PC ENGINEERING-2 will be offered the 15-seat Altium Designer license. This is because in the AIS:
    • The connected User profile is Bruce (Bruce/ENGINEERING-2)
    • The User profile Bruce is a member of the Engineering Role group.
    • The Engineering Role has the 15-seat Altium Designer license assigned to it.
  • The software workstation with the Windows Account Name Narelle on PC ENGINEERING-3 will be offered the 15-seat Altium Designer and the 5-seat Altium Designer license. This is because in the AIS:
    • The connected User profile is Narelle (Narelle/ENGINEERING-3)
    • The User profile Narelle is a member of the Engineering and QA Role groups.
    • The Engineering Role has the 15-seat Altium Designer license assigned to it, and the QA Role has the 5-seat Altium Designer license assigned to it.

Working with licenses

The AIS based Private License Server offers a range of administration features for managing license allocation and usage, including the ability to forcibly release a leased license and closely monitor how licenses are used.

Release a license in use

For situations where a license has been in use by an Altium software installation but not correctly released, the PLS provides a means of terminating that lease and returning the seat to the pool of available license seats. This can occur when the user's PC has lapsed into standby while software is active, or through some form of software crash that has prevented a clean exit. In practice, that license seat is still registered as being in use and therefore denied to another user.

To locate the license of concern in this situation, go to the Licenses list in the AIS web interface by selecting ADMIN » LICENSES. Within the list of licenses shown under the Licenses tab, the leasing information for each entry is available by expanding the license entry with the 

button – use this to find the user that still retains the license seat.

The license leased to that user can be terminated, and the seat returned to the license pool, by clicking the

button associated with the user entry and then confirming the action in the Release seat dialog. Altium Designer, for example, will notify the user that the license has been forcibly released by an administrator.

Note that the notification will only apply to network-based user clients, and not to a software user that has leased a license on the machine that also hosts the AIS – that is, when using Altium software that is installed on the same PC as the Infrastructure Server.

Monitor license usage

The Altium Infrastructure Server (AIS) includes a range of license usage monitoring and reporting features that can be used to audit how Altium software licenses are used within an organization. This is useful for ensuring that the best use is being made of the available license seats, for anticipating future license requirements and to determine the usage of individual Users.

The AIS license usage features are accessed through the administrator menu under the Reports tab on the License Manager page (ADMIN » LICENSES). This offers a range of reporting options that are accessed by specific tabs within the Reports view. Depending upon the type of information that's required for each report, the associated reporting filters can be applied to tailor the results to include specific Licenses, Roles, Users and time periods.

To filter the usage reporting results to show the license activity of a particular set of Licenses for example, select the licenses of interest from the Licenses drop down menu and click

. The filtering action of the options remains in effect while each reporting style tab is selected, allowing you to see usage reports that are constrained to those licenses.

The Report page also offers the option to export the current report to disk in CSV format – compatible with Microsoft Excel and other spreadsheet applications – for administration and accounting purposes. Select the desired report results using the appropriate tab and filtering for your needs, click the 

button and nominate a location to save the file to disk.

Custom Error messages

When working with Altium software, a user can receive a range of pop up Error dialogs from the Infrastructure Server in response to User Account, License and Seat allocation issues.

The text for the error codes presented in the dialogs can be modified by editing the contents of the errors.xml file, which is located in the LicenseManagerService directory of the AIS installation – typically C:\Program Files (x86)\Altium\Altium Infrastructure Server\LicenseManagerService.


A modified Error dialog message for a 'code 2' condition.

By default, the errors file includes error codes and default messages such as:

<Error code="1" text="User %USERNAME% not found. Please contact License Administrator."/>
– A user has attempted to connect to the License Server but there is no suitable User account – the user does not exist.

<Error code="2" text="No available licenses. Please contact License Administrator."/>
A user has successfully connected to the server PLS, but there are no Licenses assigned to that User Account (as determined by Role membership).

Licensing a remote Altium Vault

Along with licensing Altium design software such as Altium Designer, the Altium Infrastructure Server (AIS) can also be used to license an Altium Vault. In this configuration of servers, the AIS acts as a central licensing manager to all Altium products including any Vaults on the network, such as those used for design data management in individual engineering departments.

This type of installation is suited to a large enterprise, where each company department (Engineering, QA etc) might use multiple Altium software installations, and a local department Vault for design data management purposes. Both the Altium Vaults and Altium software installations are licensed by a central, dedicated Licensing Server such as the License Manager (PLS) in the Altium Infrastructure Server (AIS).

Assuming that a departmental Vault already has its local User accounts set up, all licensing for the department can be managed by the central AIS when:

  • The AIS has acquired valid Altium Vault and Altium Vault CAL licenses.
  • The remote Vault has been configured to use its External PLS Mode to access the central AIS, and the Vault's local 'self-licensing' manager is disabled (see below).

Add Altium Vault licenses

Vault licenses are added to the AIS, like any other license, by selecting the From cloud option from the 

button menu and selecting available licenses from the ALtiumLive License Service.

When correctly setup, a Vault will automatically lease an available license over the network, so no further configuration is needed in the AIS – the licenses can remain assigned to the default All Users group, and the assignment's Auto leasing option does not need to be selected.

Configure the remote Vault PLS

While the Altium Vault is generally licensed through its own self-licensing capabilities, in a similar way to the AIS, in this case the central Licensing Server (the AIS) will be providing the Vault license. To change the Vault setup so that it will lease an available license over the network, first select the External PLS mode in the Vault License Manager setup (ADMIN » SETTINGS – License Manager).

In this mode, the Vault will attempt to obtain its licenses from the server PLS address and port specified in the PLS url and PLS Port fields. Enter the network address/port of the AIS that is acting as a central Licensing Server. The network address of the 'external' AIS in the above image, and therefore the target for the Vault's external PLS service connection, is http://sydpc016. This is the computer_name of the AIS-based license server's host PC – note that the http:// prefix is optional.

The Vault also needs to be switched over from seeking its own licenses from its internal PLS, to accessing these from the specified external PLS service – the AIS Licensing Service. This is achieved by simply unchecking the Use local license manager for vault licensing option, as shown above.

Confirm the changes made in the License Manager by saving the new configuration (

).

Note that when a server has been licensed in a different way, such as from an alternative source, it may need to be restarted to enable its functions.

The configured department Vault will now lease its licenses from the central AIS, which will show (at a minimum) that a Vault license seat User Count has incremented, and the occupied seat is registered to the remote Vault's internal System user. In this example case, the remote Vault is hosted on a PC named SONY.

If the Automatic user creation option is enabled in the AIS License Manager set up as recommended, a User profile will be created for the Vault system connection – which is SONY:System in the example shown here. See ADMIN » SETTINGS – License manager for the relevant settings.

Licensing Vault Users

In larger multi-server systems, as described above, a remote Vault provides normal data management services to its local (department) workstations, but its internal licensing service (PLS) is 'switched over' to use the license service in the central AIS. This means that licensing for both the department Vault and the Altium software that uses it will be provided by the central PLS service.

With this arrangement the users of department workstations simply sign in to the Vault as normal, using their existing Vault User accounts. Since the Vault is set to External PLS mode, signed in Users will have access to licenses that have been 'redirected' from the central Licensing Server (the AIS). When signed in from Altium Designer for example, its License Management page will automatically list any compatible licenses offered by the central AIS.

Vault User synchronization

Part of the mechanism involved in granting a User access to remote licenses via the local Vault, is the creation of a 'synchronized' user name in the central Licensing Server (the AIS). This is a function of the Automatic user creation option in the AIS License Manager (PLS), which must be enabled to successfully license software workstations that sign in to a local (department) Vault.

If Automatic user creation is not enabled in the central licensing AIS, the local Vault will not be able to connect to a valid User account in the AIS License Manager. This will result in a Vault sign in error.

By way of example, the below image shows a department Vault (SONY) with two registered User accounts; Keith and Stan. These represent accounts for local users that sign in to the Vault to access its data management services. This Vault represents one of the department Vaults illustrated in the above multiple server image, where all licenses are sourced from the central Licensing Server AIS.

If the licenses offered by the central AIS are set for the default All User access, these will be redirected through the Vault to all Users that sign in. In the below image, user Keith has signed in to his account in the local Vault SONY, which is set to source licenses from the central licensing AIS (sydpc016). Here, Altium Designer is using a seat of a license offered by central AIS, which is regarded as leased by Keith:SONY (User_name:Vault_name).

Once a Vault user has signed in, even if a license has not been leased, the License Service in the central AIS will automatically create a 'synchronized' User account. As shown below, two AIS accounts that match the Vault accounts have been automatically created – Vault account Stan becomes AIS account SONY:Stan, and Vault user Keith becomes SONY:Keith in the central AIS. Note that the Vault name is SONY.

Manage Vault User licenses

User names that have been synchronized to the central Licensing Server in a multi-server setup can be added to Roles, just like any other user profile in the AIS. When a User then signs in to a local (department) Vault, the licenses that are available from the central AIS will be determined by the Roles and License assignments configured for that synchronized User profile in the central Licensing Service.

For the examples used here, the synced user SONY:Stan (the Stan user synced from the local department vault, SONY) in the Licensing Server might be added to a QA Role, which has a particular Altium software license assigned to it. When user Stan signs in to his local Vault, the specified 15-seat license will become available by virtue of the associated user Role and License assignment configuration in the Licensing Server (the central AIS).

These user Role and License assignments would generally be implemented by the Licensing Server administrator, once a local Vault user has signed in for the first time (thereby instigating the User sync process in the AIS).

Troubleshoot license access

If your software is not able to connect to the Infrastructure Server's PLS, or licenses that you have acquired and configured in the AIS are not seen as available by the software, there may be system or server settings that are preventing access.

When troubleshooting any issues, consider the following:

  • Host PC  Firewall – The Altium server PLS uses port 9780 by default when transferring licensing data on the network. Check that this port has been opened in the host PC's firewall during the AIS installation.
  • Allowed network connections – Altium Designer, for example, offers a Network Activity selection page in the System area of the Preferences dialog (DXP » Preferences). Check that the 'License Server' entry is checked, so the AIS can communicate with Altium Designer over the network.
  • Try basic tests:
    • Check locally – If the AIS is set up on a PC that also hosts an Altium software installation, confirm that the server's PLS is accessible to that local installation before troubleshooting any remote PCs. If the PLS and private licenses are available locally, this indicates that PCs elsewhere on the network that cannot connect have a network or software (rather than a server PLS) configuration issue.
    • Assign license to All Users – If a license that has been assigned correctly in the AIS is not available for lease in Altium software installation, temporarily change its Role assignment to All Users (or simply create a new All Users assignment for that license). See License Assignments, above. If it then becomes available to the software, this indicates there was a problem with the user Role or license assignment in the server.
  • Refresh the server PLS – After making changes to the PLS license setup in the AIS, particularly when adding or removing server licenses, you may need to sign out then back in again to see the changes. In some situations it may be necessary to restart the AIS, by either rebooting the PC or using the server Restart feature in Windows' IIS Manager.
  • Refresh the software's PLS connection – After making changes to license access in the server PLS or the Altium software, try refreshing the software connection to detect the change. In Altium Designer for example, click the Refresh button on the Licensing Management page and/or the Disconnect/Reconnect... private license server link. To force a full connection refresh, select the Setup private license server link and click OK in the Private License Server Setup dialog.
  • Use the Automatic user creation mode – if this option is turned off in the AIS, a User profile will not be created when software has connected to the PLS. Therefore a related user account is not available, and cannot be made a member of a Role that has particular licenses assigned to it. In a multi-server arrangement, as described above, an automatically created AIS User profile is required for Vault Users to sign in and access licenses.
English
If you'd like to comment on the content on this page, use the Ctrl+Enter keyboard shortcut to send us your feedback. To include a section of the page in your comment (a typo, missing/wrong info, or incorrect imagery), highlight the text (max. 200 chars) and/or image first. Please restrict your feedback to documentation issues - for technical assistance refer to the Altium Forums.

Contact Us

Contact our corporate or local offices directly.

You are reporting an issue with the following selected text and/or image within the active document:
Request Free Trial

Complete this form to request a free 15 day trial of Altium Designer: