Configuring license checkout settings for the dgaas application on IBM WebSphere Liberty

You can set the following environment variables for the document generation service application: com.ibm.rational.rpe.license.attempts.count and com.ibm.rational.rpe.license.retry.timeout.

About this task

If you do not configure these values, the default value of 5 is used. The license checkout will be attempted up to 5 times, at an interval of 5 seconds.

Table 1. Licensing flags
Flag	Value	Description
`-Dcom.ibm.rational.rpe.license.attempts.count`	A number Default value: 5 Example: `-Dcom.ibm.rational.rpe.license.attempts.count=7`	The number of times to check for an available license. If the value entered is less than 1, the value is ignored.
`-Dcom.ibm.rational.rpe.license.retry.timeout`	A number in seconds Default value: 5 seconds Example: `-Dcom.ibm.rational.rpe.license.retry.timeout=6`	The number of seconds to wait between attempts to check for an available license.

Procedure

Select one of the following options depending on whether you are administering IBM WebSphere Liberty with or without developer tools:
- If you are using developer tools:
  1. From the Servers view, right-click on your server to create a new server environment file.
  2. Create a jvm.options file, select New > Server Environment File > jvm.options. The jvm.options file opens in the editor.
- If you are manually administering the server:
  1. In the IBM WebSphere Liberty installation or configuration directory, create or open an existing jvm.options files in a text editor. See the next step for locations of the jvm.options file.
You can create multiple jvm.option files in the following locations:

${server.config.dir}

Creates the file in the server configuration directory.

${wlp.install.dir}/usr/shared

Creates the file in the usr/shared subdirectory of the Liberty installation directory. The file is only available for remote servers if the server is located in the default user directory, which is ${wlp.install.dir}/usr.

${server.config.dir}/configDropins/defaults

Creates the file in the configDropins/defaults subdirectory of the server configuration directory.

${server.config.dir}/configDropins/overrides

Creates the file in the configDropins/overrides subdirectory of the server configuration directory.
In the jvm.options file, enter the flag you selected and its corresponding value.
```
-Dcom.ibm.rational.rpe.flag=value
```
Save the changes.
Restart IBM WebSphere Liberty.