Configuring new call rejection when the audio or video port limit is exceeded

Last Updated : Jun 10, 2026 |

About this task

The Avaya Aura® Web Gateway license determines how many simultaneous audio or video calls Avaya Aura® Web Gateway supports. By default, if this limit is exceeded, Avaya Aura® Web Gateway raises an appropriate alarm but still allows establishing new calls. You can configure Avaya Aura® Web Gateway to reject new audio or video calls if the respective port limit is exceeded. For this purpose, Avaya Aura® Web Gateway uses the rejectUnlicensedCalls property in the mss.start.sh file.

When the call rejection functionality is enabled, Avaya Aura® Web Gateway displays the NOTE: Calls will be rejected if maximum ports usage is exceeded notification on the Licensing page.

Before you begin

Enable EASG functionality. EASG is required to obtain the sroot privileges required to run commands in this procedure.

Procedure

  1. Log in to the Avaya Aura® Web Gateway CLI as an administrator.
  2. To obtain sroot privileges, run the following command: 
    su - sroot
  3. To navigate to the location of the mss.start.sh settings file, run the following commands: 
    cdto cas
cd service.d
  4. Optional To make a backup of the mss.start.sh file, run the following command: 
    cp mss.start.sh <BACKUP_FILENAME>

    where <BACKUP_FILENAME> is a name for the backup file. You can use this backup to restore the original mss.start.sh file if you make any typos when editing it.

  5. To open the mss.start.sh file in the vi text editor, run the following command: 
    vi mss.start.sh
  6. Navigate to the section where CATALINA_OPTS parameters are configured.

    These entries use the CATALINA_OPTS="CATALINA_OPTS -D<VARIABLE>=<VALUE>" format.

  7. Configure the Avaya Aura® Web Gateway behavior when the limit for audio or video calls is exceeded as follows:

    • To reject new calls, add the following entry at the end of the section with CATALINA_OPTS variables:

      CATALINA_OPTS="CATALINA_OPTS -DrejectUnlicensedCalls=true"

    • To allow new calls, add the following entry at the end of the section with CATALINA_OPTS variables:

      CATALINA_OPTS="CATALINA_OPTS -DrejectUnlicensedCalls=false"

    Important:

    If the call rejection functionality is enabled and you want to disable it, you must change the rejectUnlicensedCalls parameter value to false. If you remove the CATALINA_OPTS="CATALINA_OPTS -DrejectUnlicensedCalls=true" entry from the mss.start.sh file, Avaya Aura® Web Gateway continues rejecting new calls if the port limit is exceeded.

  8. Save the mss.start.sh file.
  9. To restart services and apply the changes, run the following command: 
    svc telportal restart