Installing Service License

An application service may require license installation in addition to or instead of end-user license agreement. Licensing of APS applications is performed by means of license keys. Getting license keys involves arranging communication between the Controller or Control Panel and license authority, for example Parallels License Administrator.

Generally the process of license installation is the following:

The Controller gets information about license requirement elements ("//service/requirements/l:license") by parsing the APP-META.xml file with the Package Metadata Parser.
The Controller gets information about license manipulation script definition ("//service/provision/license-script") by parsing the APP-META.xml file with the Package Metadata Parser.
The Controller process the requirement elements data and script definition with the Aspects Parser.
It may be declared that for license installation an application should be queried first to get activation data (l:need-query element is present). In this case, the Controller runs license script with the query argument, passing to it all required environment variables. Then checks whether script output matches activation data XML schema. If script output is correct, the Controller passes activation data to license authority directly or through Control Panel and proceeds with the application instance deployment.
It is not guaranteed that license will be provided to the application immediately after the installation. The Controller should ensure that access to application without license installed is set up according to policy provided in the license declaration. Policy access is defined by presence or lack of the l:optional element. If the element is present an application may be provided to end-user without valid license. Otherwise, an application becomes available to end-user only after the license installation.

For details on license installation terms and conditions, refer to the Licensing Aspect.