Troubleshoot the IPP server

If an error occurs using the IBM® IPP Server Administrator, the message frame box will usually contain the error data and provide information on how to correct the problem. For additional information, internal tracing can be used. Tracing provides a mechanism for retrieving state information during execution of the administrator and the IPP server. To activate tracing, specify a valid error log file name using the Error Logs form. Then, select a logging level below Critical. Selecting a logging level of Debug will provide the maximum amount of tracing information. The trace log containing detailed information on the operation of the administrator is located in file /QIBM/UserData/OS400/Ipp/Logs/qippcfg.log.

The trace log containing detailed information on the operation of the IPP server is located in file /QIBM/UserData/OS400/Ipp/Logs/qippsvr.log.

To stop internal tracing for the administrator and the IPP server, select a logging level above Error such as Critical, Alert, or Emergency) on the Error Logs form and click Apply .

Note:
The trace files /QIBM/UserData/OS400/Ipp/Logs/qippcfg.log and qippsvr.log are deleted every time tracing/error logging is started. If you want to trace, it is recommended that at regular intervals you stop tracing, archive the trace file, and start the tracing again.

Use the following table to help troubleshoot other problems you might encounter working with the IBM IPP Server Administrator or the IBM IPP Server.

Symptom Action
You do not have the correct authority to a file. To change any configuration files, IBM IPP Server Administrator browser interface users require at least *IOSYSCFG authority. Verify that you have the correct authority.
File does not exist or is corrupt. Always make sure the following files exist on your system: /QIBM/UserData/OS400/Ipp/conf/ qippsvr.conf /QIBM/UserData/OS400/Ipp/conf/ preferences.properties /QIBM/UserData/OS400/Ipp/conf/ printer.properties

You should not manually edit these files if you are not familiar with this task. If you change one file, you made also need to change additional files. If you change these files manually, the server might fail to initialize.
The log file name is not valid. Click Help for the Log file name field for more information on valid log file names.
You made changes to the IPP server configuration, but they do not appear to be recognized. Stop the IPP server and start it again. Whenever a change is made to the server's configuration, you need to restart the IPP server for the change to become effective.
The browser interface is not being displayed in the language specified. The language specified in the browser is not supported by the IBM IPP Server Administrator browser interface application.
You cannot find help for a field. Click Help for information. You can also activate verbose for the form, which provides a more detailed overview of the entire form.
An internal error occurred using the browser interface. Turn on tracing and examine the trace file to help locate the problem.
The IPP server does not start or stay running after you attempt to start it.

An error has probably occurred during initialization. Whenever the IPP server is started, an i5/OS® fully-qualified job name is displayed in the message frame, in the form: JobNumber/JobUser/JobName

If the IPP server fails to start, do the following:

  1. Log on to the iSeries server.
  2. WRKJOB JOB(JobNumber/JobUser/JobName) .
  3. Select option 4, (Work with Spooled Files).
  4. Using display option 5, view any spooled files to help locate the cause of the problem.

If you have manually edited the IPP server configuration file, a newly specified directive might be causing the IPP server to fail initialization. If this is the case, edit the configuration file and remove the directive in error.
The IPP server does not stop after you attempt to stop it. An error has occurred on the iSeries server. To stop the IPP server manually:
  1. Log on to the iSeries server.
  2. WRKACTJOB SBS(QHTTPSVR).
  3. Find the QIPPSVR jobs.
  4. Use option 4 and end the jobs immediately.
When SSL is enabled, the IPP server does not stay running. The IPP server might not have a valid certificate associated with it for SSL connections. Use Digital Certificate Manager for iSeries™ to create a certificate and associate it with the IPP server. (The IPP server itself should be registered with DCM automatically.) Associate the certificate with the application QIBM_IPP_QIPPSVR.