Before you assign a license to an Altova product, make sure that:
|•||The relevant license has been uploaded to the license pool of LicenseServer and that the license is active.|
|•||Your Altova product has been registered with LicenseServer.|
Licenses are assigned in the Client Management tab of the LicenseServer Configuration page (screenshot below). The screenshot shows, in the left pane, that there is one client machine, which has three Altova products that have been registered with LicenseServer.
Note the following points about the Client Management tab:
|•||In the left pane, each product is listed under the name of its client machine. In the screenshot above, one client machine is listed. This client machine has three Altova products registered with LicenseServer. If an Altova product on a different client machine is registered with this LicenseServer, then that client machine, with its registered products, will also be listed in the left pane.|
|•||When you select a client machine in the left pane, the licensing details of that machine's registered products are displayed in the right-hand pane. Here, you can edit the license assignments of each product.|
|•||Each registered Altova product on a client machine has its own Key Code entry, which takes the key code of a license. A registered product is assigned a license by clicking its Edit Assigned Licenses button (see icon list below) and selecting the required license from those available for that product in the license pool. This procedure is explained in more detail below.|
|•||Server products also have a line stating how many CPU cores need to be licensed to run that product on that client. If the number of licensed cores is less than the number required, then the information is marked in red (see screenshot below). (The number of CPU cores that need to be licensed is the number of CPU cores on that client and is obtained from the client machine by LicenseServer.)|
|•||If multiple versions of a single product (for example, StyleVision Server 2013 and StyleVision Server 2014) have been installed on one machine and if each of these installations has been registered with a single LicenseServer, then the multiple registrations are consolidated in a single registration in the Client Management tab and displayed as a single registration. When a license is assigned to this single registration, all the installations indicated by that registration will be licensed. However, multiple instances of only one installation can be run simultaneously on the client machine. For example, multiple instances of StyleVision Server 2013 or multiple instances of StyleVision Server 2014 can be run simultaneously, but not one instance of StyleVision Server 2013 and one instance of StyleVision Server 2014. Note that newly installed versions must be registered for them to run.|
|•||New versions of Altova server products can only be licensed with the version of LicenseServer that is the latest at the time of the product's release. Older Altova server products will work with newer versions of LicenseServer. So, if you are installing a new version of an Altova server product and if your current LicenseServer version is not the latest, de-install the older version of LicenseServer and install the latest version. All registration and licensing information held in your older version of LicenseServer will be saved, at the time of de-installation, to a database on the client machine, and will be imported automatically into the newer version. (The version number of the LicenseServer that is appropriate for any particular version of a server product is displayed during the installation of that server product. You can choose to install this version along with the server product. The version of the currently installed LicenseServer is given at the bottom of the LicenseServer configuration page.)|
Edit Assigned Licenses. Available with each product listing. Pops up the Edit Assigned Licenses dialog, in which new licenses can be assigned and already assigned licenses can be edited.
Show Licenses. Appears with each license listing. Switches to the License Pool tab and highlights the selected license. Details of the license can be read here.
Unregister Product. The selected product will be unregistered from LicenseServer.
Note on cores and licenses
The licensing of Altova server products is based on the number of processor cores available on the product machine. For example, a dual-core processor has two cores, a quad-core processor four cores, a hexa-core processor six cores, and so on. The number of cores licensed for a product must be greater than or equal to the number of cores available on that server machine, whether the server is a physical or virtual machine. For example, if a server has eight cores (an octa-core processor), you must purchase at least one 8-core license. You can also combine licenses to achieve the core count. So, two 4-core licenses can also be used for an octa-core server instead of one 8-core license.
If you are using a computer server with a large number of CPU cores but only have a low volume to process, you may also create a virtual machine that is allocated a smaller number of cores, and purchase a license for that number. Such a deployment, of course, will have less processing speed than if all available cores on the server were utilized.
|Note:||Each Altova server product license can be used for only one client machine—the machine on which the Altova server product is installed—at a time, even if the license has unused licensing capacity. For example, if a 10-core license is used for a client machine that has 6 CPU cores, then the remaining 4 cores of licensing capacity cannot be used simultaneously for another client machine.|
MobileTogether Server licenses
MobileTogether Server licenses are based on the number of CPU cores on the MobileTogether Server machine. Core licenses allow an unlimited number of MobileTogether Client devices to connect to the server. However, if you check the Limit to single thread execution check box, then only one mobile device will be able to connect to the MobileTogether Server at any time. This is useful for evaluation and small-scale testing. Note that, if, in this case, a second device connects to MobileTogether Sever, then it will take over the license. The first device will not be able to connect any more and will receive an error message to this effect.
To assign a license to a registered product, click the Edit Assigned Licenses button of that product. This pops up the Manage Licenses dialog (screenshot below).
Note the following points about the licenses displayed in the Manage Licenses dialog:
|•||The product to be licensed is listed at the top left of the dialog. In the screenshot above the product is Altova RaptorXML+XBRL Server.|
|•||The machine on which the server is installed (doc-aab in the screenshot above) is listed next.|
|•||The dialog displays all the currently active licenses for that product that are in the license pool. In our screenshot, there is one currently active RaptorXML+XBRL Server license in the license pool. (LicenseServer will automatically detect from each license in the pool the product for which it has been issued.)|
|•||The license type can be either Cores (all Altova server products, including MobileTogether Server) or Users (MobileTogether Server only). The license type is shown in the License Type column. The license in the screenshot above has been licensed for 16 CPU cores.|
|•||You need to know the number of processor cores on the server on which the Altova server product has been installed. If the machine has a dual-core processor, you need a two-core (the CPU Cores count) license. How many cores the registered server product requires is listed below the machine name. The license you assign to this server must be valid for a sufficient number of cores. Note that you can combine licenses to reach the required number of cores. So, if the machine's processor is octa-core (eight-core), you can combine two 4-core licenses.|
|•||The Edit Assigned Licenses dialog will list only currently active licenses for that product. Licenses for other Altova products will not be listed.|
|•||Licenses that have been assigned already—for example, to another installation of the product on the network—will have their check boxes checked. So only unchecked licenses may be selected.|
|•||The CPU Cores (or # for MobileTogether Server users) column indicates for how many CPU cores (or MobileTogether Clients) a license is valid.|
|•||If you wish to make modifications to the license pool—for example, to upload, activate, deactivate, or delete a license—click the Go to License Pool button.|
Select the license you wish to assign. The license's check box will be checked. Also, the total number of CPU cores licensed for that product on that client is listed near the top left of the dialog as Max licensed CPU cores (see screenshot above). You can select more licenses if you wish to increase the number of licensed CPU cores for that product on that client. The Max licensed CPU cores in this case will be the sum of the CPU cores of all the selected licenses.
After selecting the license/s, click Apply Changes. The license/s will be assigned to that product and displayed in the Client Management tab (see screenshot below). The screenshot shows that a 16-CPU-core license for Altova RaptorXML+XBRL has been assigned to the client machine.
Each Altova product registered with LicenseServer is listed in the right-hand (Product licensing) pane under its client machine name and has an Unregister Product button at the bottom of its entry (see screenshot above). Click this button to unregister the product from LicenseServer. If a license was assigned to the product, the assignment will be terminated when the product is unregistered. To unregister all products, click the Unregister client and all products button at the top of the right-hand (Product licensing) pane (see first screenshot in this section).
To re-register a product with LicenseServer, do the following:
|•||Server products: Go to the Settings page in the server product's Web UI. If the server product has no Web UI, open a command prompt window and use the product's CLI to register it. The steps for each server product. are described here: Register FlowForce Server, Register MapForce Server, Register MobileTogether Server, Register StyleVision Server, and Register RaptorXML(+XBRL) Server.|
|•||Desktop products: Open the product's Software Activation dialog (Help | Software Activation), switch to Activation via LicenseServer mode, and, in the Altova LicenseServer field, select the LicenseServer you want to register the product with. The product will be registered, and it will appear in LicenseServer's Client Management tab, in that client's registered-product list.|
© 2018 Altova GmbH