Files
raven/docs/8.0/ayanova/docs/adm-license.md
2022-03-15 21:27:20 +00:00

11 KiB

License

The license form is used to view the AyaNova license and perform license related activities such as requesting an evaluation trial license, purchasing a license or use an existing license.

The AyaNova license is stored inside the database so as long as you have a backup of the database you have the license backed up as well.

Trying out AyaNova

If you are trying out AyaNova for the first time this is the form the request an evaluation license key. See the Trying out AyaNova page for details.

Authorization Roles required

This form is available to User's with the following roles:

Full access

  • Business administration

Read only access

  • Business administration - restricted

How to access License

From the Administration navigation pane select License navigation item.

License form

Unlicensed display

If the server can't find a license in the database then links are shown to begin a trial evaluation, fetch a license key, purchase a license and a link to how to restore the database:

unlicensed display

Start trial evaluation

An evaluation trial license is required to try out AyaNova:

request evaluation license

Enter you details here and click on Send Request. An automated email will be sent within 5 minutes to the address you provided to verify your email address. Check the inbox for the address provided and when you receive the email verification message click on the link contained within to verify your email.

Note that we will only contact the address you provide for licensing or support purposes.

See our privacy policy for details.

If you do not receive an email within 10 minutes something has gone wrong. Check your spam folder and if not found there it's possible we were unable to send to the address provided. Double check your email address you entered in the request form and try again one more time.

If you still do not receive the email verification after a second attempt and the address is correct, try requesting again with an alternate email account preferrably on another domain if possible; sometimes we are unable to email the address provided due to spam or other filtering or temporary issues.

Once you recieve the AyaNova trial request email verification message, click on the link contained within to confirm to our license server that your email address is valid.

We will be notified when the email address is verified and will generate a trial license for you during business hours. This part of the process is done manually as a "circuit breaker" in case of malicious requests.

Once approved, you will receive an AyaNova trial request approved email message and AyaNova will automatically install the license (or may have already done so) or you can click on "Install license" to trigger the server to check if there is a license available and install it immediately.

See the Trying out AyaNova to get started with your evaluation.

Purchase a license

The Purchase a license button will take you to our web site's license purchase page and automatically fill in your database ID so you can purchase an AyaNova license and options online. If you do not use this link you will need to provide your database id manually during purchase, it can be copied from the menu on this page using the Copy database id link.

Once you have received email verification that your purchase has been completed, you can use the Install license button to trigger the AyaNova server to check for any available new licenses and automatically install them.

Use existing license

The AyaNova license is stored in the AyaNova database so restoring your data from backup will restore your license automatically. Here we provide a link to the help documentation for restoring the database.

If you have already contacted support due to some other licensing issue and the issue has been corrected then the Install license button to trigger the AyaNova server to check for any available licenses and automatically install them.

licensed display

If the database is licensed, the license form displays the details of the current AyaNova license in effect:

licensed display

Licensed to

This is the name to which the AyaNova license is officially registered, typically your company name.

Database ID

This is the number that uniquely identifies a single AyaNova database for licensing and support purposes and will not change. If a company has multiple separate AyaNova databases each will have it's own unique ID.

This number allows the AyaNova server to match new licenses with the database so they can be installed automatically when available.

License serial number

This is the unique serial number of the active AyaNova license in use. When a new replacement license is installed it will have a new unique serial number.

License expiration date

If AyaNova is licensed for temporary time periods (e.g. monthly) this will show the upcoming expiration date of this particular license.

In the case of regular non temporary licenses this will be empty.

Support and updates expiration date

This is the date that the current support and updates agreement will expire. After this time AyaNova will not be upgradeable to the latest version and technical support will no longer be available if required.

Licensed options

This section shows the options selected for the current license include service technician user count and other options such as accounting integration.

Service technician Scheduleable users and licensing

In order to provide fair pricing that scales with the size of a company AyaNova is licensed by service technician (scheduleable user) count.

Service technician and sub-contractor type Users also known as "scheduleable users" in AyaNova are Users that have their "User Type" field set to "Service user" or "Sub-contractor user" in their their User record . Users set to this type are scheduleable and trackable for service in AyaNova and selectable on work orders, quotes and preventive maintenance orders.

Only scheduleable users that are set to Active in their User record will consume a Scheduleable User / service technician license from the total count available as licensed.

Non scheduleable users such as administrators or office staff and inactive Scheduleable users will not consume a license.

Purchase button

The Purchase a license button is provided as a direct link to the license purchasing page and will automatically include the database id required to allow AyaNova to automatically install the new license after purchase.

Install button

The Install license button will trigger the AyaNova server to contact the license server and check for a new replacement license, if found it will automatically be installed.

AyaNova will automatically check for replacement licenses on a regular schedule (if connected to the internet), this button just speeds up the process but is not necessary if a new license has been automatically issued when a purchase was made or a temporary license renewed.

Menu options

Copy database ID

This menu option will copy your database id to clipboard which may be required when communicated with technical support or sales to help identify your records in order to provide support.

Install license

This is a duplicate of the functionality of the Install license button.

Erase database

This option is provided to permanently erase most user entered data in the AyaNova database.

You will be prompted twice to make sure you really want to do this. This action can only be reversed by restoring from backup.

Everything is erased except the following items:

  • Global settings
  • Operations backup settings
  • Operations notification settings
  • Business logos
  • Reports (any missing stock report templates will be re-installed)
  • Tax codes

These items are kept as this feature is typically used when people are evaluating AyaNova and are ready to start using it for real but want to keep the non business data settings and reports to save having to re-enter them again.

Downgrading a license

If a replacement license is installed that has fewer service technicians that the prior license and the administrator has not disabled the extra service techncians first, AyaNova will automatically disable any excess service techs / scheduleable Users by setting their Active property to false in order to remain with the purchased license count. It tries to do this with the least disruptive way possible by favoring disabling in this order:

  1. disable subcontractors first over in-house service techs
  2. users that have no login records (have never logged in to AyaNova)
  3. oldest last login (users who haven't logged in for the longest time)

This attempts to not disable current active service technicians.

We recommend the administrator disable the excess service techs before downgrading the license to avoid any potential disruption. If a tech was automatically disabled that shouldn't be you can set another tech inactive and then set the de-activated tech back to active so they can continue working.

User count exceeded

If you receive an error message stating that the Server is locked due to exceeding licensed active scheduleable User limit this means that AyaNova has found there to be more Active Scheduleable Users than the license permits.

This is typically a sign that the database has been directly edited outside of AyaNova and needs to be fixed by restoring from backup made before the editing took place or, if it is absolutely certain this was the only change made, setting Scheduleable User's to Active=false to match the Licensed Active Schedulable user count.

Directly editing the database circumvents the many checks and balances for ensuring data integrity and can lead to breaking AyaNova completely or worse: problems that are not noticed for some time resulting in data damaged beyond reasonable repair requiring restarting with a new empty database.

Modifying the data outside of AyaNova itself should never be attempted unless directed by AyaNova technical support personnel.

Your support agreement does not cover damage caused by directly editing the database and if this is found to be the case it may lead to costly down time and hourly charges at our discretion to repair the damage.