This article describes algorithms of processing ISPsystem licenses ordered in combination with Dedicated server.
License order
Algorithm of license ordering:
The system searches for available licenses. The license is considered available in the pool of available licenses if all of the following criteria are met:
- License status is Active or Suspended.
- License name is "free.lic".
- IP-address of the license is "0.0.0.0".
- Expiry date of the license is later than the current date.
- Date of the last IP change of the license is more than 1 month.
- Date of the last key change of the license is more than 1 month.
If the available license is found, the system will do the following actions:
- License name is changed to "Item #<id_dedicated server>" addon <name_dedicated_server>"
- IP-address of the license is changed to IP-address of the main service.
- New license key is generated;
- The system remembers the ID of the resource "Control panel license" for the service ordered. It creates a link between the license in BILLmanager as a license server and BILLmanager of the provider.
- License is activated and prolonged if needed.
If there is an error on any of the above steps, the license goes back to the pool. Its name is changed to "free.lic", IP-address is changed to "0.0.0.0".
If there is no appropriate license found in the pool, the system will order a new license in BILLmanager license server. The license name will be created per the following template: "Item #<id_dedicated_server>" addon <name_dedicated_server>"
Renewal
The renewal process depends on the renewal policy of the main service. When a license is going to expire, the system checks the status of the main service:
If the service is active, the license will be renewed. To define a renewal period, the order period of the main license is compared with the "Periods comparison" settings. The license will be renewed for the period specified in the configuration form. If the settings are not specified for the main service, the license will be renewed for the minimum period - 1 month.
Example: the server with ISPmanager is ordered for 2 years. In the "Periods comparison" form we can see that when the service is ordered for 2 years, a license should be ordered for 1 year. The license will expire soon, but the main service is still active. Since we have configured a comparison of order periods, ISPmanager will be renewed for 1 year.
If the main service is not active, the license won't be renewed.
Modification
All the operations performed with the main service in the provider's BILLmanager will be performed with the license in BILLmanager - licensing server:
- Service suspension will suspend the license (if this function is available to service provider).
- Service activation will activate the license.
- Service deletion will delete the license.
Changing parameters of the main service may influence the license:
- Changing the main IP address of the service will re-order the license. The existing license will be deleted, and a new one will be ordered for a new IP address.
- Canceling the license. If the "Control panel license" addon was changed into "Without control panel" or the selected control panel is not bound to the ISPsystem license tariff plan via its id, the existing license will be deleted.
- Ordering a new license. If a client orders a control panel bound to the ISPsystem license tariff (the license was never ordered before), a new license will be ordered.
- Editing the license. When the license is modified (if the control panel bound to the ISPsystem license tariff was selected in the "Control panel license" addon, but another license had been ordered earlier), the existing license will be deleted, and a new one will be ordered.
Deletion
Deleting the license in BILLmanager - licensing server will put it back into the pool. The license name will change into "free.lic" and its IP address will change into "0.0.0.0".