Using license reservation or share

You have several options to have users, applications, or Genero installations use a specific reservation or share.

This page uses examples to illustrate some typical uses of reservation or share, such as:

users accessing web services
users accessing a specific application running on the GAS
user groups, such as developers, testers, and so on, accessing specific Genero product versions
users accessing applications by direct connection

For an example of configuring a license controller, go to Configure the license controller for reserved or shared license. Shared licenses are also supported with reserved licenses; for details, go to Reserve shared licenses.

Specify a reservation or share for web services

To specify a reservation or share for users who use your web services, do the following:

Create a separate license controller configuration file; for details, go to Create license controller configuration file. For example, you could create the file fgllicense.ws, and set the license as follows:
- If configuring a license reservation, under license add reservation= and the name of your reservation ("wsRes" in the example)
```
# fgllicense.ws 
[server]
host=localhost
port=6800

[license]
reservation="wsRes"
```
- If configuring a license share, under license add number= and the name of your license share ("wsShare" in the example).
```
# fgllicense.ws
[server]
host=localhost
port=6800

[license]
number="wsShare"
```
In the GAS configuration file (as.xcf), configure an environment variable element, FGLLICENSE or GRELICENSE, in the SERVICE_APPLICATION_EXECUTION_COMPONENT used by service applications. For example, if you saved your license controller configuration file in the $FGLDIR/etc directory, you would set the ENVIRONMENT_VARIABLE as shown:
```
<SERVICE_APPLICATION_EXECUTION_COMPONENT Id="cpn.ws.execution.local">
   #...
    <ENVIRONMENT_VARIABLE Id="FGLLICENSE">$(res.fgldir)/etc/fgllicense.ws</ENVIRONMENT_VARIABLE>
   #...
</SERVICE_APPLICATION_EXECUTION_COMPONENT>
```

Specify a reservation or share for a specific GAS application

To specify a license reservation or share for users who use a specific application running on the GAS, do the following:

Create a separate license controller configuration file; for details, go to Create license controller configuration file. For example, you could create the file fgllicense.mygasapp, and set the license as follows:
- If configuring a license reservation, under license add reservation= and the name of your reservation ("myAppRes" in the example)
```
# fgllicense.mygasapp 
[server]
host=localhost
port=6800

[license]
reservation="myAppRes"
```
- If configuring a license share, under license add number= and the name of your license share ("myAppShare" in the example).
```
# fgllicense.mygasapp
[server]
host=localhost
port=6800

[license]
number="myAppShare"
```

In the application configuration file (.xcf), configure an environment variable, FGLLICENSE or GRELICENSE. For example, if you saved the file in the $FGLDIR/etc directory, you would set the FGLLICENSE ENVIRONMENT_VARIABLE as shown:

<APPLICATION Parent="defaultwa"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/4.00/cfextwa.xsd">
  <EXECUTION>
    <ENVIRONMENT_VARIABLE Id="FGLLICENSE">$(res.fgldir)/etc/fgllicense.mygasapp</ENVIRONMENT_VARIABLE>
    <MODULE>myApp</MODULE>
  </EXECUTION>
</APPLICATION>

Specify a reservation or share for a user group

To specify a reservation or share for users who use specific product installations, do one of two things:

Configure the Genero product's default license controller configuration file; for details, go to Configure the license controller for reserved or shared license.
- If configuring a license reservation, under license add reservation= and the name of your reservation ("qaRes" in the example)
```
# fgllicense or grelicense configuration file
# ...
[license]
reservation="qaRes"
```
- If configuring a license share, under license add number= and the name of your license share ("qaShare" in the example).
```
# fgllicense or grelicense configuration file
# ...
[license]
number="qaShare"
```
Alternatively:
1. Create a separate license controller configuration file; for details, go to Create license controller configuration file. For example, you could create the file fgllicense.qa, and set the license as follows:
  - If configuring a license reservation, under license add reservation= and the name of your reservation ("qaRes" in the example).
```
# fgllicense.qa 
[server]
host=localhost
port=6800

[license]
reservation="qaRes"
```
  - If configuring a license share, under license add number= and the name of your license share ("qaShare" in the example).
```
# fgllicense.qa
[server]
host=localhost
port=6800

[license]
number="qaShare"
```
2. Set an environment variable, FGLLICENSE or GRELICENSE, in the user's environment that specifies the path to your license controller configuration file. If you saved the file in the $FGLDIR/etc directory, type one of the following commands:
  - On Linux®/UNIX™/macOS™:
```
export FGLLICENSE=$FGLDIR/etc/fgllicense.qa
```
  - On Windows®:
```
set FGLLICENSE=%FGLDIR%\etc\fgllicense.qa
```

Specify a reservation or share for a direct connection application

To specify a license reservation or share for users who run an application in direct connection mode without using the GAS, do the following:

Create a separate license controller configuration file; for details, go to Create license controller configuration file. For example, you could create the file fgllicense.mydirectusers, and set the license as follows:
- If configuring a license reservation, under license add reservation= and the name of your reservation ("myDirectRes" in the example).
```
# fgllicense.mydirectusers 
[server]
host=localhost
port=6800

[license]
reservation="myDirectRes"
```
- If configuring a license share, under license add number= and the name of your license share ("myDirectShare" in the example).
```
# fgllicense.mydirectusers
[server]
host=localhost
port=6800

[license]
number="myDirectShare"
```
In the script that configures the user's environment and launches the application, set an environment variable, FGLLICENSE or GRELICENSE, that specifies the path to your license controller configuration file. If you saved the file in the $FGLDIR/etc directory, type one of the following commands:
- On Linux/UNIX/macOS:
```
export FGLLICENSE=$FGLDIR/etc/fgllicense.mydirectusers
```
- On Windows:
```
set FGLLICENSE=%FGLDIR%\etc\fgllicense.mydirectusers
```

For details of running an application in direct connection mode, go to the step to test license reservation or share in the Configure the license controller for reserved or shared license page.