146 lines
7.5 KiB
HTML
146 lines
7.5 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="dc.language" scheme="rfc1766" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow"/>
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<title>Troubleshoot the IPP server</title>
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
|
</head>
|
|
<body>
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
|
|
|
|
|
<a name="rzalutrobipp"></a>
|
|
<h3 id="rzalutrobipp">Troubleshoot the IPP server</h3>
|
|
<p>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 <span class="bold">Error Logs</span> form.
|
|
Then, select a logging level below <span class="bold">Critical</span>. Selecting
|
|
a logging level of <span class="bold">Debug</span> 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.</p>
|
|
<p>The trace log containing detailed information on the operation of the IPP
|
|
server is located in file /QIBM/UserData/OS400/Ipp/Logs/qippsvr.log.</p>
|
|
<p>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 <span class="bold">Error Logs</span> form and click <span class="bold">Apply</span> .
|
|
</p>
|
|
<a name="wq261"></a>
|
|
<div class="notetitle" id="wq261">Note:</div>
|
|
<div class="notebody">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.</div>
|
|
<p>Use the following table to help troubleshoot other problems you might encounter
|
|
working with the IBM IPP Server Administrator or the IBM IPP Server.</p>
|
|
<a name="wq262"></a>
|
|
<table id="wq262" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
|
|
<thead valign="bottom">
|
|
<tr class="tablemainheaderbar">
|
|
<th id="wq263" align="left" valign="top">Symptom</th>
|
|
<th id="wq264" align="left" valign="top">Action</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr>
|
|
<td headers="wq263">You do not have the correct authority to a file.</td>
|
|
<td headers="wq264">To change any configuration files, IBM IPP Server Administrator
|
|
browser interface users require at least *IOSYSCFG authority. Verify that
|
|
you have the correct authority.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">File does not exist or is corrupt.</td>
|
|
<td headers="wq264">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
|
|
<p>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.</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">The log file name is not valid.</td>
|
|
<td headers="wq264">Click <span class="bold">Help</span> for the <span class="bold">Log file name</span> field for more information on valid log file names.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">You made changes to the IPP server configuration, but
|
|
they do not appear to be recognized.</td>
|
|
<td headers="wq264">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.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">The browser interface is not being displayed in the
|
|
language specified.</td>
|
|
<td headers="wq264">The language specified in the browser is not supported
|
|
by the IBM IPP Server Administrator browser interface application.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">You cannot find help for a field.</td>
|
|
<td headers="wq264">Click <span class="bold">Help</span> for information. You
|
|
can also activate verbose for the form, which provides a more detailed overview
|
|
of the entire form.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">An internal error occurred using the browser interface.</td>
|
|
<td headers="wq264">Turn on tracing and examine the trace file to help locate
|
|
the problem.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">The IPP server does not start or stay running after
|
|
you attempt to start it.</td>
|
|
<td headers="wq264">
|
|
<p>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</p>
|
|
<p>If the
|
|
IPP server fails to start, do the following: </p>
|
|
<ol type="1">
|
|
<li>Log on to the iSeries server.</li>
|
|
<li>WRKJOB JOB(JobNumber/JobUser/JobName) .</li>
|
|
<li>Select option 4, (Work with Spooled Files).</li>
|
|
<li>Using display option 5, view any spooled files to help locate the cause
|
|
of the problem.</li></ol>
|
|
<p>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.</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">The IPP server does not stop after you attempt to stop
|
|
it.</td>
|
|
<td headers="wq264">An error has occurred on the iSeries server. To stop the
|
|
IPP server manually:
|
|
<ol type="1">
|
|
<li>Log on to the iSeries server.</li>
|
|
<li>WRKACTJOB SBS(QHTTPSVR).</li>
|
|
<li>Find the QIPPSVR jobs.</li>
|
|
<li>Use option 4 and end the jobs immediately.</li></ol></td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq263">When SSL is enabled, the IPP server does not stay running.</td>
|
|
<td headers="wq264">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 <tt class="xph">QIBM_IPP_QIPPSVR</tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
|
</body>
|
|
</html>
|