Table of contents

Official Content

This document helps you to set up a GXflow Application (that runs on Linux) to use licenses from a GeneXus Protection Server (that runs on Windows). As stated in this document, this protection method is used primarily for prototyping purposes; for production purposes a Native protection method is the most (or only) suitable. 

So to configure a GXflow Application that runs in Linux to use the protection system from a Windows server, follow these steps:

Step 1 – Install GeneXus Protection Server

Install the latest GeneXus Protection Server version on a Windows Server. This server will centralize GeneXus licenses products.

Step 2 – Configure the GeneXus License Manager

Download the files from here.
On the Linux server where the application is running install the GeneXus License Manager. You need to unzip the file (located in Packages\Gxpm\Protection\Linux under GeneXus installation folder) into a directory, for example, gxprot. The License Manager must be configured via command line options; check Annex I for further detail on License Manager Options. The location for the Protection server is stored in a file called (same as Protect.ini in Windows environments); which is used by the Web application and License Manager to locate the Protection Server.

To set the Protection Server location, execute the following:

java -Dgxprotect.dir=/gxprot/license –jar licmgr.jar -s user.domain=localhost user.pwd=test123


  • -Dgxprotect.dir: System Property to set the path where the file will be generated.
  • IP or hostname where the GeneXus Protection server is executing.
  • user.domain: Windows domain to be used to authenticate with.
  • User to be used to authenticate with.
  • user.pwd: Password to be used to authenticate with.

You don't need to set all properties at once; you can execute the same command several times with different parameters. The specified user to access the server must have security permissions to access the server via DCOM.

Step 3 – Configure the application to use the Windows Protection Server

Open GXflow license manager and configure the Remote location settings.

Annex I – License Manager Options

Whenever you run the License Manager you must reference a System Property as a parameter, for example:

java –Dgxprotect.dir=”gxprot” –jar licmgr.jar

It is recommended to explicitly set the directory that will be used to save the properties file. When using the license manager it is advisable to use a system property "gxprotect.dir". License Manager available options are:


Last update: April 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant