User:Jcreer/Aquaveo License Service: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(108 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOINDEX__
{{Future feature}}
{{Future feature}}
The new Aquaveo License Service protection (ALS protection) replaces the old Sentinel and password protection (SAP protection) with a design which:
{{TOCright}}
The Aquaveo License Service protection (ALService protection) replaces the old Sentinel and password protection (SAP protection) with a design which:
*Eliminates hardware locks and drivers.
*Eliminates hardware locks and drivers.
*Allows virtual machine and servers to be used without restriction.
*Allows virtual machine and servers to be used without restriction.
Line 12: Line 14:


==Single and Network User Configurations==
==Single and Network User Configurations==
[[File:ALS Overview.png|thumb|none|600 px]]
The following figure displays configuration option for the Aquaveo License Service.
[[File:ALService Overview.png|thumb|none|700 px|Aquaveo License Service Configuration Options]]
 
*ALManager – An Aquaveo service that distributes licenses to customers.
*ALService – The Windows service that authorizes the execution of the software.
*ALRegistration – The graphical user interface to the ALService.
 
==Accessing the Aquaveo License Service==
The ALService  can be accessed locally or over the network from the Register window.
 
*A '''''Flex''''' license is a license to SMS that can be accessed or shared over a local network. This type of license can also be moved by checking-in and checking-out the license to other locations. A Flex license code begins with the letter "F".
*A '''''Local''''' license enables SMS on a single computer and cannot be moved to another computer. A Local license codes begin with the letter "L".
*An '''''Evaluation''''' license enables SMS on a single computer and cannot be moved to another computer. This license will expire after two weeks. An Evalutation license code begins with the letter "E".
<!--
*Standalone Installation - is typically used for network N-code licenses and therefore by default opens the firewall to the ALService.
**Public Inbound Firewall Exception - required for networked ALService.
**AquaLicenseDNS - applications can be installed and run on any computer without opening their Register Window and setting up their licensing, if this DNS name is set to resolve to the ALService computer installed with a network license.  This supports classrooms, training, intercompany, etc.
*Application installation is typically for local P-code licensing and therefore by default does not open the firewall to the ALService.
-->
 
==Registration Dialog==
[[File:ALS-registration-start.png|thumb|400 px|The Aquaveo License Registration dialog when first seen.]]
This dialog opens when the ''Help'' | ''' Register''' command is used.
 
If the software has already been licensed, the license code, expiration date, and maintenance date will be shown.
 
If the software has not been licensed, a field will appear when the license code can be entered.
 
The dialog also has the following options:
*'''Request License''' &ndash; Opens a browser on the Aquaveo website where options for purchasing a license are available.
*'''Advanced Options''' &ndash; Opens a dialog with advanced options for registering the product.
 
==Advanced Registration Dialog==
[[File:ALS register1.png|thumb|450 px|Example of the ALS ''Registration'' dialog]]
The ''Aquaveo License Registration &ndash; Advanced'' dialog for advanced options gives a display of the current active license. It has the following options:
<!--
Specified License Service: Specifies the licensing pathway the application will use.
*''Default''
*''Other'' &ndash; Allows entering a user specified location.
**''IP or DNS Address'' &ndash; The default is "AquaLicenseDNS".
**''Port'' &ndash; Identifies the network port for the network license. The default is "56789".
*'''Apply''' &ndash; Populates or Refreshes the license list below.
-->
 
Available licenses: Specifies the licensing location the application will use.
*'''Change Location''' &ndash; Opens a dialog to change the location of the license.
 
License List: Displays all available licenses.
*''Sel'' &ndash; Selection box. Turning on this box attaches the license to the active product.
*''App'' &ndash; Shows which XMS application the license can activate.
*''Licenses'' &ndash; Shows number of licenses available with the license code.
*''License Expires'' &ndash; Shows expiration date for the license.
*''Maintenance Expires'' &ndash; Shows expiration date for Aquaveo maintenance agreement.
*''Code'' &ndash; Displays network or password code. Flex codes start with the letter F. Local codes start with the letter L.
*'''Details''' &ndash; Brings up the ''Aquaveo Add License'' dialog where details about the license are show.
 
Update License:
*'''Add License''' &ndash; Brings up the ''Aquaveo Add License'' dialog. Process where the service obtains seats (s) of a license form the database.
*'''Refresh License''' &ndash; Refreshes the license list.
*'''Remove License''' &ndash; Process where the seats (s) of a license are removed from the service and returned to the database.
*'''Request License''' &ndash; Opens a browser on the Aquaveo website where options for purchasing a license are available.
 
Version:
*'''Version''' &ndash; Brings up a dialog that displays the version number for RegWiz and the ALService.
 
==Change License Location==
[[File:ALS-ChangeLocation.png|thumb|300 px| The ''Aquaveo License Registration &ndash; Change License Location'' dialog]]
The ''Aquaveo License Serviece – Change License Location '' dialog is an advanced option that allows specifying the location of the license. The dialog has the following options:
 
The license location can be specified as one of the following:
*''Hostname'' &ndash; Allows entering the host name or IP address  of the license location.
*''IP Address'' &ndash; Allows entering the IP address of the license location.
 
The port number to communicate with the license location can also be specified.
*''Port'' &ndash; Identifies the network port for the network license. The default is "56789".
 
==Add License Dialog==
This dialog allows adding a license code and indicating the number of licenses included with the code. <!--Information for purchasing licenses is listed on the dialog as well as noting contact information for Aquaveo support.-->
[[File:ALService AddLicense.png|thumb|none|375 px|''Aquaveo Add License'' dialog]]
 
==Single User==
{{Future feature}}
When running XMS without a network license, do the following:
#Start XMS. The ''Welcome'' dialog should appear if the product has not already been registered.
#Select '''Register''' or '''Use Community Edition'''.
#In the ''Register'' dialog, enter the license code or click '''Advanced''' to being up the advanced ''Register'' dialog.
#In the advanced ''Register'' dialog, select ''Default Local address''.
#Check on ''Manage Licenses'' and click on '''Add License'''.
#In the ''Aquaveo Add License'' dialog, enter license code.
#Close the ''Aquaveo Add License'' dialog.
#Click '''Apply'''.
#Close the ''Register'' dialog.
 
==Network User==
When ALService is set up by an adminstator, XMS automatically gets a license from the default AquaLicenseDNS. Therefore, a new user only needs to do the following:
#Install XMS.
#Run XMS.
If the administrator has set up the ALService using a different DNS name, the ''Registration'' dialog will need to be used to point the XMS software to the correct DNS. Therefore the new user will need to do the following:
#Start XMS. The ''Welcome'' dialog should appear if the product has not already been registered.
#Select '''Register''' or '''Use Community Edition'''.
#In the ''Register'' dialog, click '''Advanced''' to being up the advanced ''Register'' dialog.
#In the advanced ''Register'' dialog, select ''Other''.
#Enter the DNS name in the ''IP or DNS Address'' field.
#Click '''Apply'''.
#Close the ''Register'' dialog.
 
==Network User Server Set Up==
Do this once on the network server:
#Install the Aquaveo License Service on a single network server.
#Open the Aquaveo License Service folder in Windows Start menu and run XMS License Setup, i.e. RegWiz.
#Add one or more XMS license codes to the Aquaveo License Service.
#Point DNS name AquaLicenseDNS to the Aquaveo License Service server.
#*Optionally skip this step but then manually point each client to the Aquaveo License Service.
 
==Evaluation User or Other Special User==
Same as Single or Network User except that:
*The Aquaveo License Service must initially connect to ALManager if it is restarted (due to a reboot for instance).  This requirement is enforced when the Custom1 module is disabled in the license.
**If the ALService is unable to connect to the ALManager, open the ''Register'' dialog to the ALService and re-Add the license code.  Registration Wizard will then prompt for a manual browser connection after which the newly started ALService will allow the license to be used.
**Alternatively, allow the ALService to access the ALManager through their firewall and onto the internet.*
*Evaluation codes start with the letter E.
 
==Moving a License==
#Reduce the number of licenses on one Aquaveo License Service.
#Add those licenses to another Aquaveo License Service. I.e. check them back out from the ALManager after having checked them in.
 
==Miscellaneous Features==
*Each user can select the ALService and code that they want to use on each computer for each XMS product.
*An ALService can store the licenses for all XMS products.
*Each computer runs only a single instance of the ALService.
*An installed ALService automatically starts when a computer starts the Windows OS.
*RegWiz is only allowed to change licenses on a local 127.0.0.1 ALService.
*Multiple instances of XMS which are started within a user’s account on one computer can share the same XMS license.
 
==Registration Wizard License Details==
This dialog is used to troubleshoot potential registration problems. It displays the current licenses details including registered modules, models, and expiration dates.
[[File:ALS register details.png|thumb|none|400 px|Aquaveo Add License details dialog]]
===Error Conditions===
*XMS cannot get a license because all licenses are in use.
**See RegWiz details of who is using the licenses.
*RegWiz cannot do add or remove for license code in use.
**See RegWiz details of who is using the licenses.
*ALService cannot connect to the ALManager.
**RegWiz cannot add or remove licenses.  RegWiz will instruct the user to use their browser for the add or remove.  Or first fix the connection and firewall to the ALManager.
**RegWiz cannot show some license details and shows those details as a ?.  Fix the firewall to allow ALService to communicate with ALManager.*
*RegWiz cannot connect to the ALService.
**Ensure that the firewall allows the connection.
**Or restart the ALService in Windows Services as administrator.
**Or try an IP port different than default 56789 on both the ALService and the clients.
*XMS cannot get a license. Check license selection in RegWiz.
*XMS cannot connect to the ALService, i.e. can no longer get a license from the ALService.
**Check the ALService address in RegWiz.
*XMS cannot use a password code license across the network.
**This is only allowed for an network code license.
*XMS cannot Add all password code licenses to an ALService.
**Two or more licenses can only be added for an network code license.
 
==Related Topics==
*[[GMS:GMS|GMS Main]]
*[[SMS:SMS|SMS Main]]
*[[WMS:WMS|WMS Main]]
 
 
[[Category:Support]]
[[Category:Set Up]]
[[Category:Licenses|Aquaveo]]
[[Category:Jcreer|Aquaveo]]

Latest revision as of 20:34, 27 July 2020


The Aquaveo License Service protection (ALService protection) replaces the old Sentinel and password protection (SAP protection) with a design which:

  • Eliminates hardware locks and drivers.
  • Allows virtual machine and servers to be used without restriction.
  • Enforces the expiration date of evaluation or checked licenses.
  • Detects the overuse of evaluation or checked licenses.
  • Still allows customers to share a license within a user session.
  • Still allows customers to move a license between computers.
  • Still allows customers to share a network license.
  • Still allows Aquaveo to create non-network licenses.
  • Could detect the overuse of non-checked licenses or warn user when not verified. (currently disabled)

Single and Network User Configurations

The following figure displays configuration option for the Aquaveo License Service.

Aquaveo License Service Configuration Options
  • ALManager – An Aquaveo service that distributes licenses to customers.
  • ALService – The Windows service that authorizes the execution of the software.
  • ALRegistration – The graphical user interface to the ALService.

Accessing the Aquaveo License Service

The ALService can be accessed locally or over the network from the Register window.

  • A Flex license is a license to SMS that can be accessed or shared over a local network. This type of license can also be moved by checking-in and checking-out the license to other locations. A Flex license code begins with the letter "F".
  • A Local license enables SMS on a single computer and cannot be moved to another computer. A Local license codes begin with the letter "L".
  • An Evaluation license enables SMS on a single computer and cannot be moved to another computer. This license will expire after two weeks. An Evalutation license code begins with the letter "E".

Registration Dialog

The Aquaveo License Registration dialog when first seen.

This dialog opens when the Help | Register command is used.

If the software has already been licensed, the license code, expiration date, and maintenance date will be shown.

If the software has not been licensed, a field will appear when the license code can be entered.

The dialog also has the following options:

  • Request License – Opens a browser on the Aquaveo website where options for purchasing a license are available.
  • Advanced Options – Opens a dialog with advanced options for registering the product.

Advanced Registration Dialog

Example of the ALS Registration dialog

The Aquaveo License Registration – Advanced dialog for advanced options gives a display of the current active license. It has the following options:

Available licenses: Specifies the licensing location the application will use.

  • Change Location – Opens a dialog to change the location of the license.

License List: Displays all available licenses.

  • Sel – Selection box. Turning on this box attaches the license to the active product.
  • App – Shows which XMS application the license can activate.
  • Licenses – Shows number of licenses available with the license code.
  • License Expires – Shows expiration date for the license.
  • Maintenance Expires – Shows expiration date for Aquaveo maintenance agreement.
  • Code – Displays network or password code. Flex codes start with the letter F. Local codes start with the letter L.
  • Details – Brings up the Aquaveo Add License dialog where details about the license are show.

Update License:

  • Add License – Brings up the Aquaveo Add License dialog. Process where the service obtains seats (s) of a license form the database.
  • Refresh License – Refreshes the license list.
  • Remove License – Process where the seats (s) of a license are removed from the service and returned to the database.
  • Request License – Opens a browser on the Aquaveo website where options for purchasing a license are available.

Version:

  • Version – Brings up a dialog that displays the version number for RegWiz and the ALService.

Change License Location

The Aquaveo License Registration – Change License Location dialog

The Aquaveo License Serviece – Change License Location dialog is an advanced option that allows specifying the location of the license. The dialog has the following options:

The license location can be specified as one of the following:

  • Hostname – Allows entering the host name or IP address of the license location.
  • IP Address – Allows entering the IP address of the license location.

The port number to communicate with the license location can also be specified.

  • Port – Identifies the network port for the network license. The default is "56789".

Add License Dialog

This dialog allows adding a license code and indicating the number of licenses included with the code.

Aquaveo Add License dialog

Single User

When running XMS without a network license, do the following:

  1. Start XMS. The Welcome dialog should appear if the product has not already been registered.
  2. Select Register or Use Community Edition.
  3. In the Register dialog, enter the license code or click Advanced to being up the advanced Register dialog.
  4. In the advanced Register dialog, select Default Local address.
  5. Check on Manage Licenses and click on Add License.
  6. In the Aquaveo Add License dialog, enter license code.
  7. Close the Aquaveo Add License dialog.
  8. Click Apply.
  9. Close the Register dialog.

Network User

When ALService is set up by an adminstator, XMS automatically gets a license from the default AquaLicenseDNS. Therefore, a new user only needs to do the following:

  1. Install XMS.
  2. Run XMS.

If the administrator has set up the ALService using a different DNS name, the Registration dialog will need to be used to point the XMS software to the correct DNS. Therefore the new user will need to do the following:

  1. Start XMS. The Welcome dialog should appear if the product has not already been registered.
  2. Select Register or Use Community Edition.
  3. In the Register dialog, click Advanced to being up the advanced Register dialog.
  4. In the advanced Register dialog, select Other.
  5. Enter the DNS name in the IP or DNS Address field.
  6. Click Apply.
  7. Close the Register dialog.

Network User Server Set Up

Do this once on the network server:

  1. Install the Aquaveo License Service on a single network server.
  2. Open the Aquaveo License Service folder in Windows Start menu and run XMS License Setup, i.e. RegWiz.
  3. Add one or more XMS license codes to the Aquaveo License Service.
  4. Point DNS name AquaLicenseDNS to the Aquaveo License Service server.
    • Optionally skip this step but then manually point each client to the Aquaveo License Service.

Evaluation User or Other Special User

Same as Single or Network User except that:

  • The Aquaveo License Service must initially connect to ALManager if it is restarted (due to a reboot for instance). This requirement is enforced when the Custom1 module is disabled in the license.
    • If the ALService is unable to connect to the ALManager, open the Register dialog to the ALService and re-Add the license code. Registration Wizard will then prompt for a manual browser connection after which the newly started ALService will allow the license to be used.
    • Alternatively, allow the ALService to access the ALManager through their firewall and onto the internet.*
  • Evaluation codes start with the letter E.

Moving a License

  1. Reduce the number of licenses on one Aquaveo License Service.
  2. Add those licenses to another Aquaveo License Service. I.e. check them back out from the ALManager after having checked them in.

Miscellaneous Features

  • Each user can select the ALService and code that they want to use on each computer for each XMS product.
  • An ALService can store the licenses for all XMS products.
  • Each computer runs only a single instance of the ALService.
  • An installed ALService automatically starts when a computer starts the Windows OS.
  • RegWiz is only allowed to change licenses on a local 127.0.0.1 ALService.
  • Multiple instances of XMS which are started within a user’s account on one computer can share the same XMS license.

Registration Wizard License Details

This dialog is used to troubleshoot potential registration problems. It displays the current licenses details including registered modules, models, and expiration dates.

Aquaveo Add License details dialog

Error Conditions

  • XMS cannot get a license because all licenses are in use.
    • See RegWiz details of who is using the licenses.
  • RegWiz cannot do add or remove for license code in use.
    • See RegWiz details of who is using the licenses.
  • ALService cannot connect to the ALManager.
    • RegWiz cannot add or remove licenses. RegWiz will instruct the user to use their browser for the add or remove. Or first fix the connection and firewall to the ALManager.
    • RegWiz cannot show some license details and shows those details as a ?. Fix the firewall to allow ALService to communicate with ALManager.*
  • RegWiz cannot connect to the ALService.
    • Ensure that the firewall allows the connection.
    • Or restart the ALService in Windows Services as administrator.
    • Or try an IP port different than default 56789 on both the ALService and the clients.
  • XMS cannot get a license. Check license selection in RegWiz.
  • XMS cannot connect to the ALService, i.e. can no longer get a license from the ALService.
    • Check the ALService address in RegWiz.
  • XMS cannot use a password code license across the network.
    • This is only allowed for an network code license.
  • XMS cannot Add all password code licenses to an ALService.
    • Two or more licenses can only be added for an network code license.

Related Topics