Online license activation for JEE

<< Click to Display Table of Contents >>

Navigation:  Bizagi Engine > Licensing Explained > License activation >

Online license activation for JEE




The following are prerequisites to activate the license for the Production environment in the JEE Application server:


Having JRE installed in the server to license.

Having the environment variable JAVA_HOME properly configured.

If you are using WebSphere, ensure that the JAVA_HOME variable is set to that one used by the Java Virtual Machine embedded in WebSphere.

Having installed Bizagi's JEEConsoleManager. Installation of the JEE administration console is done by uncompressing the .rar file delivered by Bizagi into a local path. This local path will be referred to as from now as: <JEECONSOLE_HOME>.

Ensure you have already set your JEE Application Server (WebSphere, Weblogic or JBoss).

For more information refer to Configuring a JEE Application Server to work with Bizagi.

If you have a clustered environment, then make sure all of your nodes have been set up.


Cluster consideration

Before you continue, ensure that your license supports activations for any additional nodes of a clustered set up.

Contact us if you have doubts about your license for the JEE edition.



The following procedure needs to be done for each of the servers in your Production environment.

Keep in mind that in order to activate the license for a clustered setup, you will need to carry out the following procedure in each of the nodes of your cluster.


Run the JEEConsoleManager as ROOT

Run as the administrator user "ROOT", the JEEConsoleManager 's service in the server to license.

To start up the service, execute the console manager (according to your operating system).


For a Unix-like OS such as Linux, execute the file located as



For a Windows OS, execute the file located as




This service used for the license activation will use TCP 5680 port. It is recommended to ensure that no other service uses this port and that there is no firewall that blocks this port's request for remote activations.







If you are using WebSphere, make sure you previously configure your JAVA_HOME variable to reference the internal JVM used by WebSphere.

For this, it is recommended to use a command prompt and first set the JAVA_HOME variable by executing the appropriate command (you may use set JAVA_HOME=[path_to_WebSPhere_JVM] in a Windows OS, or env in  a Unix-like OS such as Linux).

In this way and with the variable temporarily set to the local JVM path, you may run startconsole in this console.



Enter the license

Launch Bizagi Studio or Bizagi Management Console from a machine which has: network access to the JEE Application server to license, and internet connection.

The activation of the key and the license renewal requires an Internet connection, but the web application itself doesn't.




Click on the License Administration option:





First time License

Type the server's name or IP address and click Connect.




The first time you enter the key there will be no license information available, it will just say: "Server licensed for development and testing purposes only".




Click on Enter License key button and type or paste the license key in the space provided. Click OK to save changes. The license information for the installation will be shown.





After a year from the initial purchase of your licenses, you may wish to renew your maintenance. While your licenses are active you may also buy additional users for current installations.


Please be aware that you will not receive license keys after purchasing renewals or additional users. After completing the purchase process (either for .NET or JEE Edition) you need to activate your renewal or additional users. Go to License Administration and click the Update License button.




Stop the JEEConsoleManager service

Now that the license has been activated, this service started with the ROOT administrator user can be stopped.

To stop the service, execute the "stopconsole.bat" or "" (according to your operating system).


For a Unix-like OS such as Linux, execute the file located as



For a Windows OS, execute the file located as



If the web application is already started and running while the license was activated, you will need to restart the application server in order to update the license activation.