The ReqView Floating License Server is a web service providing floating licenses for ReqView products. It communicates with client applications using secure HTTPS connections, so it must be started with a TLS/SSL certificate and its private key.
The ReqView Floating License Server comes with a set of certificates so that it is easily started out of the box. However, you may wish to use existing certificates or generate your own. For more information on using existing certificates or generating your own, see TLS/SSL Certificates.
Note: The license server must run at the exact address and port for which the ReqView floating licenses were generated. The server’s TLS certificate must be issued for this address. Multiple DNS names and wildcards are not permitted.
Basic Usage and Arguments:
reqview_license_server [-h] [--host HOST [HOST ...]] --port PORT --certfile CERTFILE [--adminpwfile ADMINPWFILE] [--license LICENSE [LICENSE ...]]
||Show help message and exit|
||optional||Host(s) to bind to; defaults to 0.0.0.0 (all interfaces)|
||required||Port to serve on|
||required||File in PEM format containing the server TLS/SSL certificate|
||optional||File containing the password that protects the admin site (username is always
||optional||ReqView floating server license file(s) to serve; licenses will be stored until expiration|
Start the ReqView Floating License Server on port 8000 with a TLS/SSL certificate stored in file server.pem:
$ reqview_license_server --port 8000 --certfile server.pem --license server-license.key
Run the ReqView Floating License Server as a Windows service using NSSM (the Non-S***ing Service Manager).
Windows Service Configuration
reqview_license_server.exebinary and files needed by it.
The arguments present on the 3rd line will be used when the server is started or restarted. Do not move or delete the directory or any files in it after the service is installed. The file
nssm.exe must also be kept as it is the executable registered for the service.
Note: Quotes must be used when paths containing spaces are involved. Moreover, the quotes themselves must be quoted to be preserved for the
AppParameters setting — we do not recommend using paths with spaces for this reason. Standard output and error streams are appended to the files given by
As the service is started under the NetworkService account by default (a predefined account with minimum privileges), you must ensure that this account has read, write, and execute permissions for the directory containing the
reqview_license_server.exe binary; this account cannot access the C:\Program Files directory unless it is explicitly allowed. Alternatively, you can make the service run under the LocalSystem account (which has extensive privileges) by removing the line
nssm set reqview-license-server ObjectName NetworkService from the
service.cmd file. For more information, see Service User Accounts.
To review or edit the service configuration using the NSSM GUI, run the
nssm edit reqview-license-server command.
Windows Service Management
The service starts automatically after system boot. Afterwards, you can manage the service (start, restart, stop, or query its status) using the following commands:
nssm start reqview-license-server nssm restart reqview-license-server nssm stop reqview-license-server nssm status reqview-license-server
If necessary, stop the service and then uninstall it using the
nssm remove reqview-license-server confirm command.
If you already have Docker and Docker Compose all set up, run a console with sufficient privileges and change the directory to the location of the
reqview_license_server binary, certificate, and license files needed by it.
Docker Service Configuration
The service configuration is defined in the
docker-compose.yml file. Change it based on your needs, if necessary. To start the service:
$ docker-compose up -d
Docker Service Management
$ docker-compose start reqview-license-server $ docker-compose restart reqview-license-server $ docker-compose stop reqview-license-server $ docker-compose logs reqview-license-server
Note: Do not forget to restart the service when you update the
reqview_license_server binary or the license file.
If necessary, you can stop the service and then uninstall it using the
docker-compose rm reqview-license-server command.
You can check the Floating License Server status using the administration web page located at
<license-server-url> address must be the full address and match the address present in the server certificate exactly.
The administration web page is protected by a login form where the only correct username is
admin and the password is taken from the file supplied by the
--adminpwfile argument. The password is set to
admin if no password file is provided.
The Licenses page shows the served licenses and current checkouts/borrows by ReqView users. If a ReqView user cannot check in a floating license (in exceptional circumstances), the license administrator can manually cancel the checkout/borrow by clicking the Cancel button.
The Log page shows all server events that have occurred during the last two weeks. The most recent event is listed at the top.
To refresh the website for updated information, press F5.
You can query the server status in the console using
curl tool on the
$ curl -k https://reqviewlicense.intranet.mycompany.com:8000/status
which will produce the following output in JSON format:
You can easily implement a script processing the JSON output and run it periodically. For example, the following Python script
status.py outputs a message stating the currently available number of licenses:
You can run the
status.py script and
curl command in a pipe:
$ curl -s -k https://reqviewlicense.intranet.mycompany.com:8000/status | python status.py
which will print:
Total 10 issued, 3 in use