Online license activation for JEE

<< Click to Display Table of Contents >>

Navigation:  Bizagi Engine > Licensing Explained > License activation >

Online license activation for JEE

applies_JEE

 

Prerequisites

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.

 

Procedure

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

<JEECONSOLE_HOME>\bin\startconsole.sh

 

For a Windows OS, execute the file located as

<JEECONSOLE_HOME>\bin\startconsole.bat

 

note_pin

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.

 

Licenses5

 

 

 

note_pin

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.

 

Licenses16_a

 

Click on the License Administration option:

 

Licenses1

 

 

First time License

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

 

Licenses2

 

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".

 

Licenses3

 

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.

 

Licenses4

 

Renewals

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.

 

Licenses14

 

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 "stopconsole.sh" (according to your operating system).

 

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

<JEECONSOLE_HOME>\bin\stopconsole.sh

 

For a Windows OS, execute the file located as

<JEECONSOLE_HOME>\bin\stopconsole.bat

 

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.

 

Licenses7