Licensing on Windows

www.altova.com Expand/Collapse All Print this Topic Previous Page Up One Level Next page

Home >  Setting Up RaptorXML > Setup on Windows >

Licensing on Windows

RaptorXML Server must be licensed with an Altova LicenseServer in order to run it. Licensing is a two-step process:

 

1.Register RaptorXML Server with LicenseServer. Registration is done from RaptorXML Server.
2.Assign a license to RaptorXML Server. License-assigning is done from LicenseServer, which you must install on your local machine or a machine on your network.

 

Be sure to install the latest version of LicenseServer from the Altova website. For detailed information about using LicenseServer, see its user manual at the Altova website.

 

The steps you need to carry out are given below.

 

Click to expand/collapseStart ServiceController

Altova ServiceController is started in order to start Altova LicenseServer and Altova RaptorXML Server.

 

Altova ServiceController (ServiceController for short) is an application for conveniently starting, stopping and configuring Altova services on Windows systems.

 

ServiceController is installed with Altova LicenseServer and with Altova server products that are installed as services  (FlowForce Server, RaptorXML(+XBRL) Server, and Mobile Together Server). It can be started by clicking Start | Altova <%LICSERVER%> | Altova ServiceController. (This command is also available in the Start menu folders of Altova server products that are installed as services  (FlowForce Server, RaptorXML(+XBRL) Server, and Mobile Together Server).) After ServiceController has been started, it can be accessed via the system tray (screenshot below).

inc-LSServiceControllerTrayIcon

To specify that ServiceController starts automatically on logging in to the system, click the ServiceController icon in the system tray to display the ServiceController menu (screenshot below), and then toggle on the command Run Altova ServiceController at Startup. (This command is toggled on by default.) To exit ServiceController, click the ServiceController icon in the system tray and, in the menu that appears (see screenshot below), click Exit Altova ServiceController.

inc-LSServiceControllerStart

 

 

Click to expand/collapseStart LicenseServer

To start LicenseServer, click the ServiceController icon in the system tray, hover over Altova LicenseServer in the menu that pops up (see screenshot below), and then select Start Service from the LicenseServer submenu. If LicenseServer is already running, the Start Service option will be disabled.

LSServiceControllerStart

 

Click to expand/collapseStart RaptorXML Server

To start RaptorXML Server, click the ServiceController icon in the system tray, hover over Altova RaptorXML Server in the menu that pops up (see screenshot below), and then select Start Service from the RaptorXML Server submenu. If RaptorXML Server is already running, the Start Service option will be disabled.

LSRXStart

Note:If RaptorXML Server has been licensed to run only single-thread executions (typically because your machine is multiple-core, but your license is single-core), then you can use only one instance of RaptorXML Server at a time: either as a service or from the command line. This is because the single-core license will be assigned automatically to the first instance that is started and is currently running; a second instance cannot be started till the first instance stops running.

 

If you wish to use RaptorXML Server from the command line but the service is already running, then you must stop the service before using the command line.
If you wish to start RaptorXML Server as a service, make sure that no command line action is currently being executed. Otherwise, you will not be able to start the service.

 

 

Click to expand/collapseRegister RaptorXML Server

To register RaptorXML Server from the command line interface, use the licenseserver command:

RaptorXML licenseserver [options] ServerName-Or-IP-Address

 

For example, if localhost is the name of the server on which LicenseServer is installed:

RaptorXML licenseserver localhost

 

If RaptorXML Server was installed as part of a FlowForce Server installation, registering FlowForce Server with LicenseServer will automatically also register RaptorXML Server. Essentially: (i) Start Altova FlowForce Web as a service via ServiceController (see previous point); (ii) Enter your password to access the Setup page; (iii) Select the LicenseServer name or address and click Register with LicenseServer. For more information, see Register FlowForce Server.

 

After successful registration, go to the Server Management tab of LicenseServer's configuration page to assign a license to RaptorXML Server.

 

 

Click to expand/collapseAssign a license

After successfully registering RaptorXML Server, it will be listed in the Server Management tab of the configuration page of LicenseServer. Go there and assign a license to RaptorXML Server.

 

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.

 

 


© 2019 Altova GmbH