MES Module Licensing Checking Too Frequently

Configuring the MES Module License Check Frequency

Overview

By default, the Sepasoft MES modules check for licensing updates every minute. While this ensures that license changes are detected promptly, it may be more frequent than necessary for all environments. This guide provides detailed instructions on how to adjust this frequency by adding a specific Java Virtual Machine (JVM) argument to the Gateway's configuration file.

Adjusting the default one-minute interval can be strategically important for system optimization. In stable, long-running production environments where license changes are infrequent, increasing the time between checks can reduce a small but constant amount of CPU usage and network I/O, contributing to overall system resource optimization.

Before proceeding, it is important to confirm that your system meets the necessary software version requirements to support this configuration.

Prerequisites

This configuration option is only available from a specific software version onwards. Please ensure your system meets the following requirement before attempting to apply these changes.

  • Required Version: 3.81.10 SP1 or later.

 Step-by-Step Configuration Instructions

The following steps will guide you through locating the primary Gateway configuration file and adding the necessary JVM argument to modify the license check interval.
  • Locate and open the ignition.conf file in a text editor. In a standard installation, this file is located in the data subfolder of your Ignition installation directory.
  • Add the new JVM argument to the file. You must create a new wrapper.java.additional.X entry. To find the correct value for X, examine the existing wrapper.java.additional entries in the file and use the next integer in the sequence (e.g., if the last entry is wrapper.java.additional.7, you must use 8). Do not arbitrarily copy the number from the example below, as it may overwrite an existing, critical JVM argument. The example below sets the license check interval to 120 minutes.
  • Save the changes to the ignition.conf file.
  • Restart the Gateway. A full Gateway restart is mandatory for the new configuration setting to be loaded and applied.
After restarting, the Gateway will use the new interval. The following section details the specific rules that govern the value of the licenseCacheMinutes parameter.
  • Parameter Rules and Behavior
It is crucial to use a valid and appropriate value for the licenseCacheMinutes parameter. The system is designed with specific rules to handle various input values to ensure stability and predictable behavior.

The table below outlines the conditions and the corresponding system behavior for the license check frequency.

Condition
System Behavior
Value is set between 1 and 1440 (inclusive).
The license check frequency is set to the specified number of minutes.
Value is set to a number greater than 1440.
The frequency is automatically capped at the maximum value of 1440 minutes (24 hours).
The JVM argument is absent from ignition.conf.
The system uses the default frequency of 1 minute.
The value is set to a number less than 1.
The system uses the default frequency of 1 minute.
The value is invalid (e.g., non-numeric).
The system uses the default frequency of 1 minute.

Once the Gateway is restarted with a valid configuration, the MES module license check will operate at the newly defined frequency.
.