License Key/License Database File
Configuring Licensing Settings
Lock-based licensing may be used with the PSCAD Professional and Educational editions. Validation is achieved through the installation of a license database file and hardware lock. Licensing is managed using license manager software, which can be used in two different manners, either using the separate standalone service, or using the PSCAD embedded tool.
A lock-based license contains seats, which represent the number of instances of PSCAD that may be run simultaneously on one or more workstations. For example, a two-seat license will allow up to two instances of PSCAD to be run simultaneously. Each time PSCAD is opened or closed, a seat will be requested or relinquished, respectively.
Lock-based licenses may be used in two different manners: Network Licensing and Local Licensing. The style that is best for your purposes depends on how PSCAD is to be utilized. The following sections describe each licensing style in detail.
With network licensing, the license is installed on a server and shared with PSCAD client machines (including the host) over the facility networks. Licensing can also be shared over the internet with client machines, connected to the facility, through virtual private network (VPN).
Network licensing is set up by installing the standalone license manager software, the license database file and hardware lock on a server machine. When an instance of PSCAD is started somewhere on the network, licensing will be requested by the license manager. The license manager ensures that license is authorized according to the license file and lock, and if available, shares a PSCAD seat with the client machine. The seat will allow the user to run one instance of PSCAD. When PSCAD is closed, the seat is relinquished back to the license manager.
The number of users that can access PSCAD simultaneously depends on the number of seats on a license. For example, if a license contains two seats for the PSCAD Professional Edition, then two users may each use one instance of the Professional Edition at the same time, or one user may run up to two instances of PSCAD on his or her workstation. The following diagram illustrates how a two-seat network license can be shared with two users simultaneously.
NOTE: The number of licenses and seats owned does not limit the number of PSCAD installations in a facility. PSCAD can be installed on any number of workstations.
With local licensing, the license database file and hardware lock are installed directly on the PSCAD client machine. Two different types of management software are available for managing the license, depending on the number of seats on the license.
If the license contains only one seat, self-licensing is used, in which the embedded license manager in PSCAD is used to manage the license. Or, if the license contains more than one seat, the standalone license manager is installed and used to manage the license. When an instance of PSCAD is started, the license managing software ensures that the license is authorized according to the license file and lock, and if available, shares a PSCAD seat. The seat will allow the user to run one instance of PSCAD. When PSCAD is closed, the seat is relinquished back to the managing software.
The number of instances of PSCAD that may be run on the workstation simultaneously depends on the number of seats on the license. For example, if a license contains two seats for the Professional Edition, then up to two instances of the Professional Edition may be run at the same time.
EXAMPLE 1:
A license containing one seat for the Professional Edition is set up on a client machine. The diagram below illustrates how PSCAD would use self-licensing. Note the absence of the license manager as a separate program.
EXAMPLE 2:
A license containing two or more seats for the Professional Edition is set up on a client machine. The diagram below illustrates how PSCAD would be managed using the license manager.
NOTE: The number of seats on a license does not limit the number of PSCAD installations in a facility. PSCAD can be installed on any number of workstations. Simply, PSCAD and the license database file will be installed on each machine, but licensing will be authorized on the machine on which the hardware lock is currently plugged in.
The embedded and standalone license manager software for network and local licensing supports the following hardware lock (also known as a USB lock or dongle) for a lock-based license:
|
|
Sentinal SuperPro™ USB, USB Port Hardware Lock |
The USB hardware lock is compatible with all Windows platforms, on which PSCAD and the license manager are supported.
The license key is an ASCII text file named license.txt. The license key is used with both network and local licensing, and is required for both the Professional and Educational Editions. This file contains encrypted information designed to act as a key to adding or upgrading a license on a workstation, specifically by creating and updating a license database file. Together, the hardware lock and license database file are used directly by either the embedded or standalone license manager to validate a request for a license.
The upgrade key is an ASCII text file named upgrade.txt. It is used to renumber an existing license, due to specific changes to the license products. When applied, the products are modified, the hardware lock is renumbered to the new license number, and a new license database file, with the new license number, replaces the existing one.
When using a license for either local or network licensing, the corresponding license database file may be added as a new license, or a pre-existing license, and may be modified in the following circumstances:
Improving a License: Improvements may include adding a seat, updating a seat from the Educational to the Professional Edition, or converting a temporary license to a permanent one. The license database file will be replaced with a new file; there would be no change to the hardware lock. Please note that the license would not be renumbered in this case.
Renumbering a License: When a license is renumbered, the hardware lock is modified and the license database file is replaced. This is typically performed when removing products (e.g. a PSCAD seat), downgrading elements, or upgrading to a significant software update (e.g. upgrading from PSCAD X4 to V5).
The License Update Utility is used to install the license database file either on the license server, for network licensing, or on the client machine/s, for local licensing. This utility will be launched automatically during the installation of the license manager, or may be launched from the Windows Start menu if either PSCAD or the license manager is already installed.
Adding a new license or improving an existing license on the server or client machine may be performed as follows:
If applicable, any instances of PSCAD must be exited, and the License Manager service must be stopped (select Stop License Manager Service from the Windows Start menu).
It is optional to have the corresponding hardware lock plugged in.
You will be provided with a new license.txt file. Save this file to a convenient, local directory (e.g. C:\temp).
If launching the utility from the Windows Start menu, select Enter License Key. The License Update Utility will display.
If a license database file is already installed on this machine, remove the file by selecting Delete license databases from the Actions menu, and select the option to proceed when prompted.
Install the new license.txt file by selecting Enter license keys from the Actions menu, browsing to the license.txt file when prompted, and selecting Open.
The new or updated license database file will be installed.
PSCAD may be licensed by configuring then activating the license.
The License Update Utility is used when renumbering an existing license file and hardware lock either on the license server, for network licensing, or on the client machine, for local licensing. This utility, along with an upgrade key, a new license key, and a number of other files will be provided by the MHI Sales Team.
Renumbering an existing license on the server or client machine/s may be performed as follows:
If applicable, any instances of PSCAD must be exited, and the License Manager service must be stopped (select Stop License Manager Service from the Windows Start menu).
Ensure the hardware lock is plugged in.
Download the provided update files, and unzip them to a convenient, local directory (e.g. C:\temp).
From the unzipped files, select LicenseUpdate.exe.
When the License Update Utility displays, select Upgrade license keys and lock from the Actions menu.
When prompted, browse to the Update.txt file, then select Open.
When prompted, browse to the License.txt file, then select Open.
Both the license database file and the hardware lock will be updated.
PSCAD may be licensed by configuring then activating the license.
If you encounter any issues during this process, contact us at PSCAD Support Services.
NOTE: If using a standalone license manager, it is recommended to always use the latest version. Please contact PSCAD Support Services for a download, and this article for setup information.
License settings may be set or altered without the need to close and reopen PSCAD in a different mode. The settings may be configured directly from within PSCAD, in the Licensing Menu.
Select Switch to Lock-based (for lock-based licensing) or Switch to Certificate, as applicable from the Licensing menu.
|
To Switch to Lock-Based Licensing (Licensing is currently configured for Certificate Licensing) |
To Switch to Certificate Licensing (Licensing is currently configured for Lock-Based Licensing) |
|
|
|
To configure PSCAD to use local licensing, select Licensing Options from the Licensing menu, enter localhost 2053 in the License Host field, then select Ok to apply the selection and close the dialog.
|
|
|
|
Select Licensing Options |
Licencing Options Dialog |
To configure PSCAD to use network licensing from a server, select Licensing Options from the Licensing menu, enter the name or IP address of the server, followed by a space and 2053 in the License Host field, then select Ok to apply the selection and close the dialog.
|
|
|
|
Select Licensing Options |
Licencing Options Dialog |
A license to run PSCAD may be activated by launching PSCAD from the Windows Start menu, configuring the license, and selecting the Edition from the Activation menu.
The following requirements must be met to activate a license:
Requirements for Network Licensing:
The standalone License Manager is installed and configured on the server.
The hardware lock and license database file are set up on the server.
The PSCAD software has been installed on the client machines.
Requirements for Local Licensing:
The licensing requirements are met.
If the license contains multiple seats, the standalone License Manager is installed and configured on the client machine.
The hardware lock and license database file are set up on the client machine.
The PSCAD software has been installed on the client machine.
At any time, you can review the status of your active license. From the Licensing menu, select View | Current License:
Licensing information and activity are logged to help with licensing setup and diagnostics.
The Get Info Utility detects whether the license database file and hardware lock are properly installed.
It is recommended to always use the latest Get Info Utility, which may be downloaded from the following link:
http://updater.pscad.com/utilities/GetInfo32.zip
This utility is also installed alongside both PSCAD and the License Manager, and may be run from the Windows Start menu (select GetInfo).
The Get Info DOS-based window should appear, similar to that shown below. If detected, the associated license number of a license database file and/or hardware lock will be displayed.
The findings are summarized in a log file that can be forwarded to our support desk for evaluation. The location of the log file is listed in the bottom of the utility, as shown in the previous snapshot. This is an important file to include when contacting PSCAD Support Services.
On a client machine, all lock-based licensing activity is logged to the PscadLmgr.txt log file. The logged errors may be used to determine the cause of a licensing issue, or the log file may be forwarded to PSCAD Support Services for evaluation.
The PscadLmgr.txt file may be displayed as shown:
This file is maintained in the following path:
C:\ProgramData\Manitoba HVDC Research Centre\LicenseManager\
If the standalone license manager is installed, all activity pertaining to managing lock-based licensing is logged to the Lmgrd-log.txt log file. The logged errors may be used to determine the cause of a licensing issue, or the log file may be forwarded to the PSCAD Support Services for evaluation.
On the machine hosting the license manager, the Lmgrd-log.txt file may be displayed from the Windows Start menu by selecting View Licence Manager Log File.
This file is maintained in the following path:
C:\ProgramData\Manitoba HVDC Research Centre\LicenseManager\
If the standalone license manager is installed, the usage of lock-based licensing is logged to the PscadUsage.txt file. This file may be displayed from the Windows Start menu by selecting View PSCAD usage log file.
This file is maintained in the following path:
C:\ProgramData\Manitoba HVDC Research Centre\LicenseManager\
The following is a sample line from a PscadUsage.txt file:
Description:
User ID: This is the Windows login user ID of the PSCAD user.
Edition: Can be either Pro (Professional) or Edu (Educational).
Location: Local indicates the license is activated on the license host machine. Remote indicates the license is activated on a client machine.
Seat ID: This is the dynamic ID of the granted seat, and appears in the license manager log file (lmgrd-log.txt), and in the PSCAD usage log file (PscadLmgr.txt)
No. Seconds: The duration of the license activation (seconds).
Start time: When the seat was granted.
End Time: When the seat was returned.
