Altium NEXUS Server

Licensing Altium NEXUS Server

Created: July 3, 2018 | Updated: November 6, 2019
Now reading version 1.1. For the latest, read: Licensing for version 4.1
All Contents

Parent page: Installing, Licensing & Managing the Altium NEXUS Server

Licensing for the Altium NEXUS Server consists of the following two components, that together comprise a two-tiered licensing system:

  • Server License - this license makes the features and services of the Altium NEXUS Server installation available to the organization.
  • Client Access License - this license enables users within an organization to access, and sign-in to that organization's Altium NEXUS Server.

Licensing for the Altium NEXUS Server can be handled through the cloud, or locally through license files (*.alf).

Since the Client Access License controls the ability for individual users to connect to the Altium NEXUS Server, it is often referred to as a Connector License.
Both Server and Client Access Licenses are timed licenses, lasting 12 months. Subscription must be renewed on an annual basis in order to provide continued access to the Altium NEXUS Server for the users in an organization, as well as to access new features and functionality developed by Altium as part of the Altium NEXUS Server. If this annual subscription renewal lapses, a single Server and CAL license will be provided to access your data for backup and configuration purposes.

Both Server and Client Access license types are available in a single distinct license package - Altium NEXUS Server - giving an organization, and its users, access to installed server technologies supported by that licensing. The following list summarizes the key features and services included:

Standard

  • Backup & Restore

Component Management

  • Component Management
  • Supply Chain

Document Management

  • Integrated Version Control (SVN)
  • Design Document Management
  • Design Re-use
  • Release Management

Team Configuration Management

  • Team Configuration Center (TC2)
  • Network Installation Service

Collaboration

  • Managed Projects
  • Markup System (Document Commenting)
  • Concurrent Design
Note that while a Client Access License allows a user to connect to the Altium NEXUS Server and use its features and services, certain features or services will only be available to administrative users of the Altium NEXUS Server.

Getting Licensed

The Altium NEXUS Server's functionality becomes available when the Server has been licensed by the addition of a suitable Altium NEXUS Server License. In summary, the Altium NEXUS Server and its client connections can be licensed in one of the following ways:

  • Acquiring Server and Client Access (CAL) licenses from the Altium License service portal.
    This uses the From cloud option of the NEXUS Server's self-licensing facility. Sign out then back in to the NEXUS Server to enable its newly licensed features.
     
  • Connecting to the PLS service in another Altium NEXUS Server, or Altium Infrastructure Server (such as a central license server) that offers acquired Altium NEXUS Server licenses with available seats.
    See the External PLS mode for details on this licensing option.
     
  • Importing existing license files (*.alf) from disk.
    This uses the From file option of the NEXUS Server's self-licensing facility, and effectively 'acquires' NEXUS Server licenses that you already have locally. Sign out then back in to the NEXUS Server to enable its newly licensed features.
     
  • Placing license files (*.alf) in the root directory of the Altium NEXUS Server installation (normally \Program Files (x86)\Altium\Altium NEXUS Server). The NEXUS Server will automatically import the license files when it restarts - a reboot may be required.
For more information on acquiring the license files needed for the last two methods listed above, see Obtaining License Files.
The software checks every hour for the presence of valid license files. Without a valid Server License, access to the Altium NEXUS Server will not be possible. If there is a valid Server License, but no valid Client Access Licenses (no available connections), a single administrative connection is permitted for backup and configuration purposes.

Self-Licensing

The Altium NEXUS Server provides a flexible 'self licensing' method for adding or acquiring Altium licenses, available though its Licenses page (Admin - Licenses). With a fresh installation of the Altium NEXUS Server, you will be guided through the licensing process by a sequence of hint instructions.

  1. Begin the licensing process for a newly installed Altium NEXUS Server by logging in to its web interface from the PC that's hosting the NEXUS Server. You must be signed in as an administrator, using the default name/password (admin/admin) credentials, or those of a configured admin account.

Note that a newly installed Altium NEXUS Server is unlicensed and not accessible from the network, so the initial browser connection must be made using the local machine - the PC that hosts the NEXUS Server. To connect, use the NEXUS Server's internal address (http://localhost:9780, using the default port number) or its network address (http://<computername>:9780 - where <computername> is the NEXUS Server host PC's network name, and using the default port number). To confirm a PC's network name, go to Control Panel\System and Security\System and note the 'Computer Name' entry. In Windows 10, see Settings » System » About.

When subsequently licensed, the NEXUS Server can be reached from all computers on the network using the <computername> address.

Sign in to your Altium NEXUS Server through its browser-based interface.
Sign in to your Altium NEXUS Server through its browser-based interface.

  1. When signed in, the NEXUS Server's web interface will provide an alert indicating that the NEXUS Server is unlicensed. Select the Add License link to proceed to the Licenses page. Once there, to add a license click the  button, and select from the cloud or file options. The From cloud option will load a list of licenses available to your company from the Altium portal, whereas the From file option will open a file browser for selecting and importing existing alf license files from disk.

The Altium NEXUS Server will prompt that licensing is required. Choose whether to add licensing from the cloud, or from existing alf licensing files available locally.
The Altium NEXUS Server will prompt that licensing is required. Choose whether to add licensing from the cloud, or from existing alf licensing files available locally.

  1. Altium Account credentials are required to connect to the web-based Altium Licensing portal when using the From Cloud option. Note that these credentials allow the License Server to communicate directly with your Altium Live account for the initial acquisition of your company licenses, so the host machine - on which the Altium NEXUS Server is installed and running - needs access to the internet at this time.

As the NEXUS Server is not yet configured to connect to an account, an AltiumLive Sign in dialog will automatically open to request your account credentials. Note that this is a one-off process - once the account credentials have been validated, they will be saved as part of the NEXUS Server's configuration (see Admin - Settings - General - AltiumLive Credentials).

When using cloud-based licensing, you will need to supply your AltiumLive login credentials.
When using cloud-based licensing, you will need to supply your AltiumLive login credentials.

When using cloud-based licensing, you will need to supply your AltiumLive login credentials.
When using cloud-based licensing, you will need to supply your AltiumLive login credentials.

To check that the Cloud license service portal URL is correctly configured, so that the available licenses can be acquired from the Altium License service, see the Cloud license service url setting on the License manager settings page - (see Admin - Settings - License manager). The entry should be: http://portal2.altium.com/?cls=soap.
  1. The Add Licenses dialog will appear, listing all Altium licenses available to your company, including those for Altium NEXUS and other Altium software. To activate the NEXUS Server features, choose a valid Altium Nexus Server server license. To enable users to sign in to the NEXUS Server from Altium NEXUS, also select a valid Altium Nexus Server CAL license (Client Access License).
These same licenses are used, regardless of the backend database (Firebird or Oracle).

Select the required Altium NEXUS Server licensing - consisting of a Server Licence and at least one Client Access License (CAL).
Select the required Altium NEXUS Server licensing - consisting of a Server Licence and at least one Client Access License (CAL).

When a large number of licenses are listed in the Altium account (the From Cloud option), use the filter options (Product Name field and Show Valid only checkboxes) to locate and select the required type of license(s).
  1. Instigate the process of acquiring (or 'retrieving') those licenses from the remote Altium License Server to the local Altium NEXUS Server by clicking the  button. When the process is complete, the Licenses page will show the acquired licenses, along with an instruction to sign in/out to activate the NEXUS Server features. One seat of the Altium Nexus Server license will be used, as indicated by the User Count field associated with that license.

Acquired NEXUS Server licensing - the fastest, and most streamlined method, by which to get your Altium NEXUS Server licensed.
Acquired NEXUS Server licensing - the fastest, and most streamlined method, by which to get your Altium NEXUS Server licensed.

  1. Once you have signed out and back in to your Altium NEXUS Server, its enabled features will become fully available on the main navigation tree on the left.

Once fully licensed, the full set of features become available on the navigation

tree of the NEXUS Server's browser-based interface.
Once fully licensed, the full set of features become available on the navigation
tree of the NEXUS Server's browser-based interface.

Once fully licensed, the full set of features become available on the navigation

tree of the NEXUS Server's browser-based interface.
Once fully licensed, the full set of features become available on the navigation
tree of the NEXUS Server's browser-based interface.

Obtaining License Files

Acquiring licenses for your Altium NEXUS Server - through the cloud-based Altium License service - is the quickest, and most streamlined approach. But, should you wish, NEXUS Server licensing can also be handled locally through license files (*.alf). Manual acquisition of the required license files is performed through the Altium Dashboard (accessed using the Dashboard control at the top of the Altium website). From the Licenses page, locate the applicable license (typically in the NEXUS SERVER grouping of licenses) then click through to the detailed license management page. Once there, click the Activate link to generate and download the associated license file.

Activate the applicable licenses to acquire the license files needed. In the image above, two licenses are being activated - the Server License (Altium Nexus Server) and Client Access

License (Altium Nexus Server CAL) for a standard installation of the Altium NEXUS Server, with a Firebird database back end.
Activate the applicable licenses to acquire the license files needed. In the image above, two licenses are being activated - the Server License (Altium Nexus Server) and Client Access
License (Altium Nexus Server CAL) for a standard installation of the Altium NEXUS Server, with a Firebird database back end.

The number of license files will depend on the needs of the organization, but a minimum of two files are required:

  • Altium Nexus Server License - this license makes the features and services of the Altium NEXUS Server installation available to the organization. The license obtained is the same, irrespective of the type of back end database used for the NEXUS Server data: Altium Nexus Server License <LicenseActivationCode>.alf.
  • Altium Nexus Server Client Access License (CAL) - this license enables users within an organization to access, and sign-in to the organization's Altium NEXUS Server, and also determines how many users can simultaneously be connected to the NEXUS Server. Although any number of users may be registered to access and use the NEXUS Server, only that licensed number will be allowed to connect to it simultaneously. Each license provides a purchased number of seats, n, giving simultaneous connection to up to n different users. The license obtained is the same, irrespective of the type of back end database used for the NEXUS Server data: Altium Nexus Server CAL License <LicenseActivationCode>.alf.

Once the license files are downloaded, they can be used in the following ways:

  • Import them, one at a time, through the NEXUS Server's self-service licensing. From the Libraries page of the NEXUS Server's browser-based interface click the  button, and select the From file option. A file browser dialog will open, from which to select and import the alf files (one at a time).

Import your license files through the NEXUS Server's self-serve licensing interface.
Import your license files through the NEXUS Server's self-serve licensing interface.

  • Drop them into the root installation folder for the Altium NEXUS Server (the default for which is \Program Files (x86)\Altium\Altium NEXUS Server). The NEXUS Server will automatically import the license files when it restarts - a reboot may be required.
Additional licensing can also be purchased as needed, to allow a higher number of simultaneous connections to the Altium NEXUS Server. Simply purchase the relevant Client Access License with the number of additional seats required.

Exceeding the Licensing Limit for an Altium NEXUS Server

By default, the seats of all Client Access Licenses are gathered into a floating license pool. In other words, one big bucket of potential NEXUS Server connections. When a user within an organization attempts to connect to the Altium NEXUS Server, they will automatically be served a seat from this pool. This assignment continues for subsequent user access.

The same user can be accessing the Altium NEXUS Server concurrently in different ways (e.g. connected through Altium NEXUS AND signed-in through an external Web 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 the NEXUS Server from different PCs, each different PC access will require a separate connection (so extra seat of a Client Access License).

If you try to connect to/access an Altium NEXUS Server from within Altium NEXUS, or an external Web Browser, and the limit on the number of simultaneous connections - determined by the licensing - has already been reached, sign-in will fail. In this case, you will be presented with a dialog alerting you to this fact, stating how many users are currently (and concurrently) logged in, and listing those users by Username.

Through the NEXUS Server's browser interface, an administrative user can kill the session for a user, to forcibly free up a connection. This can be performed from the Sessions page, within the Team area of the interface.

 

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: