Configure INI authentication for AdminServer and OpenEdge Management communication
- Last Updated: August 5, 2026
- 3 minute read
- OpenEdge
- Version 13.1
- Documentation
By default, the AdminServer, whether running locally or remotely, uses Operating System (OS)
authentication for establishing its connection with OpenEdge Management. To improve
performance, authenticated OS credentials are cached for a configurable duration,
reducing repeated authentication requests for the same user. You can configure the cache
duration by updating the activemqs.ini file.
As an alternative to OS-based authentication, you can configure INI authentication using either the default credentials or custom credentials defined in the activemqsRealm properties file. The INI authentication lets you control who can access the AdminServer without depending on OS user accounts.
Modify the cache duration for Operating System-based authentication
By default, the AdminServer caches Operating System (OS) authentication credentials for 600
seconds (10 minutes). This caching improves performance by reducing repeated
authentication requests for the same user. You can modify the cache duration by
updating the cacheMemoryCacheFactory.ttlSeconds property in the
activemqs.ini file.
- Stop the AdminServer. For details, see Stop the AdminServer.
- Open the activemqs.ini file.
- On Windows, go to %DLC%\properties\activemqs.ini
- On Linux, go to $DLC/properties/activemqs.ini
- Locate the cacheMemoryCacheFactory.ttlSeconds
property.
cacheMemoryCacheFactory.ttlSeconds=600 - Set the property value as required. This value determines how long, in seconds, the
authenticated OS credentials remain in the cache before they expire.
Value Description 0 Specifies that the cached credentials never expire. 600 (default) Specifies that the cached credentials expire after 10 minutes. Any other positive integer Specifies that the cached credentials expire after the specified number of seconds. Note:- If you set the property to a negative value, or remove the property from the file, the
value is reset to the default value of
600. - If you set the property to an invalid value (for example, a
non-numeric or alphanumeric), the value is reset to
0.
- If you set the property to a negative value, or remove the property from the file, the
value is reset to the default value of
- Save the file.
- Restart the AdminServer. For details, see Start the AdminServer
Configure INI authentication using default credentials
Use this procedure when you want to configure INI authentication using default credentials in the activemqsRealm properties file.
- Stop the AdminServer. For details, see Stop the AdminServer.
- Change OS authentication to INI authentication in the activemqs configuration settings file. For details, see Enable INI authentication for the AdminServer.
- Start the AdminServer. For details, see Start the AdminServer.
- Add or update AdminServer credentials in OpenEdge Management. For details, see Add or update the AdminServer credentials in OpenEdge Management.
Configure INI authentication using custom credentials
Use this procedure when you want to configure INI authentication using custom credentials in the activemqsRealm properties file.
- Stop the AdminServer. For details, see Stop the AdminServer.
- Generate an encrypted version of your plain-text custom password using the fathom command-line utility and place the encrypted password in the activemqsRealm file. For details, see Generate and apply Shiro-encrypted password for INI authentication.
- Change OS authentication to INI authentication in the activemqs configuration settings file. For details, see Enable INI authentication for the AdminServer.
- Start the AdminServer. For details, see Start the AdminServer.
- Add or update AdminServer credentials in OpenEdge Management. For details, see Add or update the AdminServer credentials in OpenEdge Management.