-
Notifications
You must be signed in to change notification settings - Fork 1
Licensing Steps
These steps apply if you are NOT using FourJs License Manager (FLM). Refer here for differences if using FLM
If using Genero Studio, there is a GUI tool that does the equivalent of these steps. You should still be familiar with these steps as you will need to use them at end-user sites where you do not install Genero Studio. Having an understanding of these steps will also help you trouble-shoot the GUI tool if required.
Before executing any licensing steps, you should follow the Setting the Environment step below to ensure that the environment is set correctly and you are licensing the installation you think you are.
You should do all steps as the user that you use to install the Genero FGL product. I suggest you have a user named "fourjs" or "genero" and use that to install and license the Genero products on your server(s)
Before you do any licensing steps, you should have the Genero FGL product installed and know the directory it is in. You should cd to that directory
From this directory you should see a file named envcomp or similar (e.g.envcomp.bat, envcomp.csh). Execute this file to set the minimum environment necessary. This will ensure that the environment variable FGLDIR is set and add FGLDIR/bin to PATH etc, so that you can execute commands in FGLDIR/bin and any licensing information is written to files beneath FGLDIR.
Your screen output should be similar (directory product is installed in may vary, and different O/S will have slightly different syntax) to...
>$ echo $FGLDIR
>$ cd /opt/fourjs/fgl/3.00.03
>$ . ./envcomp
>$ echo $FGLDIR
/opt/fourjs/fgl/3.00.03
Set the minimum environment
Execute the following command
fglWrt -l <LICENSE NUMBER>
This will prompt you to enter the LICENSE KEY. Enter the license key.
This will output the INSTALLATION NUMBER and prompt you do you want to enter the INSTALLATION KEY now. Answer n. By answering n, the license is installed temporarily for 30 days.
Your screen output should be similar to ...
>$ fglWrt -l TAB#ABCD1234
Four Js License Manager Program
This program must be run by root or by the user installing the software.`
Enter your license number (e.g., XXX#AAAAAAAA) > TAB#ABCD1234
Enter your license KEY > ABCDEFGHIJKL
Your installation NUMBER is 'MNOPQRSTUV (X)'.
Do you want to give the installation KEY now (y/n)? n
A 30 day temporary license is now activated.
You must now transmit the installation NUMBER to your vendor.
They will give you the definitive installation KEY.
Press RETURN to continue.
You have two steps remaining.
Before you can run a program, you will need to enter the maintenance key
Within the next 30 days you will also need to formally activate the license
When you first purchase a Genero license, you will receive the maintenance key in the initial e-mail
After that, every year, sometime after you have received and paid the maintenance invoice, goto the following link https://www.4js.com/en/support/registration#maintenance and enter your details into the "Online Maintenance" form. The web form will output your new maintenance key
Set the minimum environment
Enter the following command
fglWrt -m <MAINTENANCE KEY>
Alternatively if your server is connected to the internet you can enter the following command and it will look up the maintenance key from our servers
fgWrt -m auto
(One tip is to set up a cron job to run fglWrt -m auto twice a month)
You should have previously installed the license temporarily and be given an INSTALLATION NUMBER
Goto the following website https://www.4js.com/en/support/registration#online_registration, enter your LICENSE NUMBER, LICENSE KEY, INSTALLATION NUMBER, and receive in return the INSTALLATION KEY.
Set the minimum environment
Enter the following command to activate your license.
fglWrt -k INSTALLATION KEY
Alternatively if your server is connected to the internet you can enter the following command...
fglWrt -k
.... answer y to the question and it will look up the maintenance key from our servers. Screen output will be similar to ...
>$ fglWrt -k
The installation key can be automatically retrieved from Four Js.
This feature requires an HTTP connection.
Do you want to obtain the installation key using HTTP ? (y/n) y
Set the minimum environment and run the following script to check the license
fglWrt -a info license
You will get output similar to the following ....
License : TAB#ABCD1234
Product : Four Js Universal Compiler
Type : Development version
Users : 10
Extension(s) :
- Open Database Interface
Warning! This is a temporary license, installation number is 'MNOPQRSTUVWX'.
This temporary installation will expire in 22 day(s).
End of maintenance date: 2016/12/31 (Year/Month/Day).
If you are using FourJs License Manager, the steps to license a license are very similar. The main differences are
- The product will be installed in a different directory
- It will contain the script envflm and not envcomp to set the minimum environment
- The command used is flmprg and not fglWrt
- When using the -m argument to enter maintenance key, you have to specify the license number so that the maintenance key is assigned to the correct license
- There is no auto option to enter the installation key and maintenance key
-
A license may only be formally activated a limited number of times. You will get a message similar to "The number of licensing requests is over". You will need to apply for a new activation key request (the form at the bottom of this page https://www.4js.com/en/support/registration)
-
You do not activate the license within 30 days. You will see a message similar to ...
$ fglWrt -a info license ERROR(-6031):Temporary license 'TAB#ABCD1234' has expired.
... you will need to reenter the license details for a temporary license and start the 30 days again.
-
Wrong user. You should use the same user (ideally named fourjs or genero or similar) to install and license your Genero products
-
Environment not set correctly. From support desk, one of the more common things is to not have the environment set correctly, and so you are not licensing the product you think you are. Look at FGLDIR, PATH, LD_LIBRARY_PATH, and verify that these are pointing where you think they are, and are not pointing at another installation of Genero.
-
If trying to use the automatic options to read maintenance key and installation key from our servers, you may need to enter proxy details if you are behind a proxy