Allowing administrators to define a custom message when the session limit is reached

ID: FR10Q03884 Priority: Configuration
Products: NoMachine Server Target: 6
Status: Approved  

Administrators should be able to configure a custom message to be sent to users when the maximum number of concurrent virtual desktops, or connections or users is reached.

The default message is for example:  "Error: Reached the maximum number of concurrent virtual sessions on this server." and administrators should be able to specify an additional string, e.g.

"Error: Reached the maximum number of concurrent virtual sessions on this server. Please try to connect to server xyz."

 

A new key in the server configuration file, server.cfg, will allow to execute a specific script in which administrators can specify the custom message to be added to a set of default error messages. A template provides the list of default error messages which support this kind of customization and provides instructions about how to use the script.

Key description:

#
# Specify path and name to the script to be executed for displaying
# a custom message to users in addition to the default error message.
# To create your own script, use the nxcustomerrormessages template
# stored in scripts/env under the NoMachine installation directory.
#
#CustomErrorMessages ""


 

How to use the nxcustomerrormessages template

This script accepts any of the following IDs as input parameters.

The custom message specified in the script will be displayed at the end of the NoMachine default message and will be not translated.

The list of the customizable messages and their ID is:

1  - Reached the maximum number of concurrent virtual sessions on all nodes.
2  - Reached the maximum number of concurrent virtual sessions on this server.
3  - Maximum number of virtual sessions reached for user: <user>.
4  - Reached the maximum number of concurrent virtual sessions on node <node>.
5  - Reached the maximum number of concurrent sessions on this server.
6  - Reached the maximum number of concurrent sessions on node <node>.
7  - Reached the maximum number of allowed users on this server.
8  - Not enough X resources.
9  - Reached the maximum number of concurrent guest users on this server.
10 - Reached the maximum number of allowed guests.
11 - Reached the maximum number of sessions for this guest user.