4. Configuration and monitoring procedures
4.1. Must licence utility (Licensing.exe)
A utility Licensing.exe is available in the folder of the HAS instance
ex: C:\ProgramData\MEGA\Hopex Application Server\5000
Run Licensing.exe
• A path is requested
• Select the license folder path
• Licence is loaded.
4.2. Set a default licence
It is possible to specify a default licence if several Must licences exist.
In Licensing.exe
• Select the license in the left pane.
• Click on button Set as default licence in the top toolbar.
4.3. Manage users using a license
This is important in several situations:
• Several Must licences exist: users should be allocated in the different licences unless a default licence is specified.
• Shared licence: possible users should be specified beforehand.
• Dedicated licence: named users should be specified beforehand.
Users are identified by their login in HOPEX.
Ex: the HOPEX login of John Smith is 'U0001'
Add a user to a licence
In Licensing.exe
• Select the license in the left tree.
• Click on button Add user in the top toolbar.
A window Add user to a licence is displayed.
A window Add user to a licence is displayed.
• enter the login name (Ex: enter 'U0001' for the user 'John Smith is 'U0001') and click OK.
Remove a user from a licence
In Licensing.exe
• Select the license in the left tree.
• Select the user to remove in the left tree
• Click on button Remove user in the top toolbar.
4.4. Configure a user as a possible user of a product
Set a user as possible user
In Licensing.exe
• Select the license in the left tree.
• Select the product to be configured in the top right pane.
• Select the user to be set as a possible user of the product.
• Click on button Possible user or not.
A green checkmark is displayed in the column Poss. User.
A green checkmark is displayed in the column Poss. User.
This specification is saved by creating a file in a subfolder of the licence folder
ex: create file <licence folder>\Licence-Y9999\USERS\U0001.usr-APM-MEGA.
Remove a user as possible user
In Licensing.exe
• Select the license in the left tree.
• Select the product to be configured in the top right pane.
• Select the user to be set as a possible user of the product.
A green checkmark is displayed in the column Poss. User.
A green checkmark is displayed in the column Poss. User.
• Click on button Possible user or not.
The green checkmark is removed in the column Poss. User.
The green checkmark is removed in the column Poss. User.
4.5. Clean up licence tokens
In Licensing.exe
• Select the license in the left tree.
• Click on button Clean up.
This action purges unexpected token files.
4.6. Monitor licence use
The utility Licensing.exe displays several elements:
• A top menu (File, User, Administration) and a toolbar 'Add User, Remove User..)
• The left tree displays the Must licence available in the selected folder.
• The top right pane displays the products available for the selected licence.
• The bottom right pane displays the bundle definition, if any.
The licence status is displayed in the left tree:
|
Display
|
Status
|
Possible causes
|
 |
Valid
|
-
|
 |
Invalid
|
Licence has expired
Locking failed: the folder address containing the licence file does not match the expected UNC
|
The user status is displayed in the left tree:
|
Display
|
Status
|
 |
Connected
|
 |
Not connected
|
The top right pane has several columns. The list is different if a user or a licence is selected:
• Code: the code of the technical product.
• Product: the name of the technical product.
• Connected: the number of users currently logged in to the product (this figure changes over time).
• Used licences: the number of licence tokens currently used for the product (this figure changes over time).
• Remaining licences: the number of licence tokens currently available for the product (this figure changes over time).
• Total licences: the number of licence tokens programmed for the product (this figure does not changes over time).
• Poss. User: the number of users that are set as possible users of the product (this figure changes over time).
• Remaining Poss. Users: the number possible users currently available for the product (this figure changes over time).
• Total Poss. Users: the number possible users programmed for the product (this figure does not changes over time).