Start/notes.ini Parameters/DEBUG_NRPC

DEBUG_NRPC

🛠️
Parameter: DEBUG_NRPC
Short description: Enables protocol debugging on the NRPC transport layer (Notes Remote Procedure Call) – shows session setup, keepalives, and auth handshakes between Notes client and server.

Profile

Parameter
DEBUG_NRPC
Category
Logging / Debug
Component
Server, Client
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off (default), 1 = basic, 2 = verbose, 3 = trace (very large logs)

Description

NRPC is the native Notes protocol over TCP/IP between the Notes client and the Domino server, and between Domino servers. DEBUG_NRPC writes trace output for all phases of an NRPC connection – connect/bind, authentication (Notes ID, cross-cert, anonymous), session pooling, keepalive behavior, and disconnect reasons.
Ideal for topics such as user is repeatedly prompted for a password, server-to-server replication aborts, connection documents don't take effect, cross-certificate issues, intermittent timeouts over 1352/TCP.

Example configuration

DEBUG_NRPC=2
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/nrpc_debug.log

Notes & pitfalls

  • Level 3 produces a lot of entries – enable only briefly and in a targeted way.
  • Takes effect immediately via set config DEBUG_NRPC=...; a restart is not strictly required.
  • Entries appear in console.log and in Debug_Outfile.
  • Complementary to DEBUG_NAMELOOKUP, DEBUG_THREADID, connection documents, and port configuration.
  • On the client, enable via the notes.ini entry and a client restart.