IBM Support

IBM Navigator for i - Service Availability (Troubleshooting)



This page contains general tips that affect service & availability for IBM Navigator for i. Look here for questions that come up using IBM Navigator for i, and solutions to some specific errors.


You are in: IBM i Technology Updates  > IBM Navigator for i > Service Availability
Following are some general help pages as well as specific errors listed with potential fixes

  • Connection to node that the GUI is running on is not available or host servers cannot be connected...
    • The host server jobs need to be running on all the servers you want to connect to.  Run on the server:
  • Java Message Service Error Because of Port Restrictions on Certain IBM i Systems Network -> TCP configuration
  • New Navigator for i shows logon screen but presents blank screen after logging in. Confirm the WebSocket Protocol is open on your network Firewall. 
  • Errors in messages.log: Read timed out while executing QNEWNAVSRV.NEWNAV query.
    • also Communication link failure. (Read timed out)
    • Navigator will time out if SQL queries take longer than 6 minutes. 
  • Failed to get users list
    • This error can be seen in Navigator on IBM i 7.5 while opening the Users table if there are tens-of-thousands of users and you attempt to display all users.  Changes to the query have caused it to take longer than the connection time allowed for Navigator as the number of users increases (see Read timed out above).  A filter was added to allow you to display the users you are interested in and not have to display all users.  We recommend using this filter to avoid time-out and connection issues.
    • The SQL service used for the Users table is QSYS2.USER_INFO.  Starting in IBM i 7.5, additional security features were added that affect the performance of this view.  It can take several minutes and a significant amount of CPU time when there are many thousand users and all are attempted to be displayed.  This causes the full user table to not display within the time-out limit defined for Navigator.

Report to Development
If debugging is necessary, log files for Navigator for i are here:
  • /QIBM/UserData/OS/AdminInst/admin1/wlp/usr/servers/admin1/logs/messages.log

The log files for Monitor job QNAVMNSRV are located here:
  •  /QIBM/UserData/Os400/Navigator/config/MONITOR

All of the pertinent log files can be gathered and sent in to service with the QMGTOOLS HTTP Admin collector:

You may also be asked to Generate a browser console log file for service

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CH1AAM","label":"IBM Navigator for i"}],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;and future releases"}]

Document Information

Modified date:
06 September 2023