license [-<option> . . .]

Calls the License Server to get a valid GN4 license. The 'url' and 'name' parameters, if specified, are used and stored into global configuration; otherwise it uses the already configured parameters.

Options

-url <string>

An accessible web url where to send the request

-name <string>

A string code identifying this GN4 installation.

-show

Show the current licence

-in <string>

Path of the xml file containing the license data to import

-clear

Clear the current licenses.

To be executed only on cloned databases because when you use it, it creates a new GUID that requires a new self source. If you forget to create the new self source, archiving will fail with the error:missing source GN4:12987bc3-5343 ...

-recycle

Use it to specify the IIS application pools to recycle after having successfully updated the database. It is a comma-separated list of application pool names in the format 'server name'/'pool name' or just 'pool name' (local server). Note that, after having updated the new licenses into the database, you MUST to recycle the application pool (or run a IISRESET command) to make GN4 reding the new license data. Now Srv4 displays the following warning if the 'srv4 license' command is performed without the '-recycle' option: 'PLEASE RECYCLE THE APPLICATION POOL TO APPLY NEW LICENSES'.

Available since the version 2.0.

Notes

•After using srv license, recycle the application pool.

•In case that ISA proxy prevents srv4 to renew license, see Using proxy for license renewal.

•The combination of -clear and -name options in the same command e.g.

srv4 license -clear -name DEALER:CUSTOMER:TYPE

will have two different outcomes, depending on the license status

▪If the license status for DEALER:CUSTOMER:TYPE on the license server is not "toActivate", it will create a new default license (just for one user) with the specified name

▪If the license status for DEALER:CUSTOMER:TYPE exists on the license server, and it is "toActivate", it will hook to that license.