Start/notes.ini Parameters/DEBUG_RUN_ON_SERVER

DEBUG_RUN_ON_SERVER

🛠️
Parameter: DEBUG_RUN_ON_SERVER
Short description: Turns on debug output for agents executed via "Run on server" actions or server-side triggers.

Profile

Parameter
DEBUG_RUN_ON_SERVER
Category
Logging / Debug
Component
Server
Available since
9.0
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off, 1 = on

Description

DEBUG_RUN_ON_SERVER enables detailed diagnostic output for agents started in Run on server mode – typically agents triggered from the Notes client via an action or menu, which the server executes under its own identity. The invocation, signer resolution, ECL/security checks, AMgr handoff, and result are logged. The parameter complements logs from other Agent Manager diagnostic switches such as DEBUG_AMGR or Debug_Agentmanager.

Example configuration

DEBUG_RUN_ON_SERVER=1

Notes & pitfalls

  • Only takes effect for agents that explicitly run On server – not for regular scheduled agents.
  • Produces additional output in the AMgr log; with frequent invocations, the server log can grow quickly.
  • Useful in combination with DEBUG_AMGR=1 and DEBUG_AMGR_VERBOSE=1 to see the complete lifecycle of an agent.
  • Set back to 0 after diagnosis; not suitable for permanent operation.