Start/notes.ini Parameters/EnableJavaAgent

EnableJavaAgent

🛠️
Parameter: EnableJavaAgent
Short description: Enables or disables the execution of Java agents on the server.

Profile

Parameter
EnableJavaAgent
Category
Security / TLS
Component
Server
Available since
R5
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5
GUI equivalent
Server document (Security → Programmability Restrictions)
Possible values
0 = disabled, 1 = enabled (default)

Description

EnableJavaAgent is a notes.ini-side security switch that can completely prevent the execution of Java agents (Agent Manager, scheduled & triggered). Useful on servers where only LotusScript/Formula agents should be allowed, or as an emergency brake in case of suspected security incidents.
The actual control of which users may run Java agents is configured in the Server document under Programmability Restrictions – this switch acts as an additional global override.

Example configuration

EnableJavaAgent=0

Notes & pitfalls

  • 0 disables all Java agents server-wide – check existing applications for Java dependencies beforehand (XPages backend, web agents, REST endpoints).
  • Server document restrictions are more granular and should usually be preferred.
  • Also affects runOnServer calls from LotusScript that target a Java agent.
  • Not relevant for the DOTS/HTTP Java subsystem.
  • The change only takes effect after a restart of the Agent Manager (restart task amgr).