286 lines
18 KiB
HTML
286 lines
18 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 lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<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))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="Troubleshoot IBM Telephone Directory V5.2" />
|
|
<meta name="abstract" content="Find troubleshooting information on the IBM Telephone Directory V5.2 application." />
|
|
<meta name="description" content="Find troubleshooting information on the IBM Telephone Directory V5.2 application." />
|
|
<meta name="DC.Relation" scheme="URI" content="itd.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="itdts" />
|
|
<meta name="DC.Language" 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. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Troubleshoot IBM Telephone Directory V5.2</title>
|
|
</head>
|
|
<body id="itdts"><a name="itdts"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Troubleshoot IBM Telephone Directory V5.2</h1>
|
|
<div><p>Find troubleshooting information on the IBM<sup>®</sup> Telephone Directory V5.2 application.</p>
|
|
<div class="section"><p>Before you begin to troubleshoot problems with the IBM Telephone
|
|
Directory V5.2 application, answer the following questions to help solve some
|
|
common problems when using the application:</p>
|
|
<ul><li>Are all of the product prerequisites installed? See <a href="../rzau4/wpinstallprereq.htm">Verify the prerequisites</a> in
|
|
the <em>IBM Welcome
|
|
Page V1.1</em> topic for more information.</li>
|
|
<li>Is your LDAP server started?</li>
|
|
<li>Is your IBM Welcome
|
|
Page application started?</li>
|
|
<li>Is your IBM Telephone
|
|
Directory application started?</li>
|
|
<li>Is your application server started?</li>
|
|
<li>Is your HTTP server started?</li>
|
|
</ul>
|
|
<p>Use the following information if you are still having problems with
|
|
your application:</p>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Troubleshoot setup</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr valign="top"><th align="left" valign="top" id="d0e63">Problem</th>
|
|
<th align="left" valign="top" id="d0e65">Cause</th>
|
|
<th align="left" valign="top" id="d0e67">Solution</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e63 ">IBM Business Solutions (5722-BZ1) is not listed when
|
|
the GO LICPGM command is run for a preinstalled and preconfigured <span class="keyword">iSeries™ server</span>.</td>
|
|
<td align="left" valign="top" headers="d0e65 ">IBM Telephone Directory V5.2 is not installed on your
|
|
server.</td>
|
|
<td align="left" valign="top" headers="d0e67 ">Install the 5722-BZ1 product.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Troubleshoot authentication</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr valign="top"><th align="left" valign="top" id="d0e96">Problem</th>
|
|
<th align="left" valign="top" id="d0e98">Cause</th>
|
|
<th align="left" valign="top" id="d0e100">Solution</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e96 ">Log in fails</td>
|
|
<td align="left" valign="top" headers="d0e98 ">In the application, user IDs and passwords must contain
|
|
characters that map to the job CCSID that is used by the HTTP server. Otherwise,
|
|
authentication fails.</td>
|
|
<td align="left" valign="top" headers="d0e100 ">Make sure that your characters map to the job CCSID that
|
|
is used by the HTTP server. To determine the job CCSID for the HTTP server,
|
|
enter WRKACTJOB on a CL command line and select <span class="uicontrol">Display job definition
|
|
attributes</span>. The HTTP server CCSID is determined by the HTTP server
|
|
defaultFSCCSID directive. For more information, see <a href="itdnotice.htm">Notices
|
|
and limitations</a>.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e96 ">URL fails or the application does not appear</td>
|
|
<td align="left" valign="top" headers="d0e98 ">If you did not start the IBM Welcome Page application, the URL fails
|
|
(<em>http://your.server.name:port/ibm-bizApps/welcome-home.do</em> or <em>http://your.server.name:port/ibm-bizApps/welcome-admin.do</em>).
|
|
Problems also occur if you start the IBM Welcome Page application but do not
|
|
start the IBM Telephone
|
|
Directory application. If the IBM Telephone Directory application is not
|
|
running, the Welcome Page application does not have links to it.</td>
|
|
<td align="left" valign="top" headers="d0e100 ">Start the IBM Welcome Page application and the IBM Telephone
|
|
Directory application.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e96 ">Requests to the application fail</td>
|
|
<td align="left" valign="top" headers="d0e98 ">If you used the internal HTTP server included with WebSphere<sup>®</sup> Application
|
|
Server to reference the IBM Telephone Directory V5.2 application, certain requests
|
|
to the application fail.</td>
|
|
<td align="left" valign="top" headers="d0e100 ">You <span class="uicontrol">must</span> use the associated IBM HTTP
|
|
server to reference the application. Security directives for LDAP server authentication
|
|
are set up and required by the IBM Telephone Directory application during
|
|
the creation of a new application server instance. WebSphere Application Server's internal
|
|
HTTP server is not set up with the necessary security directives, and certain
|
|
requests to the application fail if the internal HTTP server is used. See <a href="itdoverhttp.htm">Interaction with IBM HTTP server<span class="keyword">i5/OS™</span></a> for
|
|
more information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Troubleshoot usage</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr valign="top"><th align="left" valign="top" id="d0e191">Problem</th>
|
|
<th align="left" valign="top" id="d0e193">Cause</th>
|
|
<th align="left" valign="top" id="d0e195">Solution</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e191 ">Missing link to the application</td>
|
|
<td align="left" valign="top" headers="d0e193 ">The URL <em>http://your.server.name:port/ibm-bizApps/welcome/home.do</em> takes
|
|
you to the entry point for IBM Business Solutions, including the IBM Telephone
|
|
Directory V5.2 application.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">If the link to the IBM Telephone Directory V5.2 application
|
|
is missing, check to ensure that both the IBM Welcome Page application and the IBM Telephone
|
|
Directory application are started.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Administration user ID confusion</td>
|
|
<td align="left" valign="top" headers="d0e193 ">It might be confusing as to which user ID you should input
|
|
for authentication to the application when you (the administrator) need to
|
|
update or register a user in a closed enrollment environment.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">The default user ID is <span class="uicontrol">Administrator</span>,
|
|
and the password is set up during installation. Do not enter your personal
|
|
user ID and password. Application user IDs are always viewable to everyone.
|
|
If you do not know the user ID for an entry, use the application's search
|
|
page to find the entry. The user ID is displayed under the picture.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Internal server error during search or registration</td>
|
|
<td align="left" valign="top" headers="d0e193 ">If you try to search on a user or register a user and
|
|
get an HTTP 500 - Internal Server Error, this might mean that your setup files
|
|
have been corrupted. The IBM Telephone Directory V5.2 application might not be
|
|
able to find the associated configuration files for the application.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">Reinstall the IBM Telephone Directory V5.2 application.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">System error during search</td>
|
|
<td align="left" valign="top" headers="d0e193 ">If you try to search on a user and get the following error:
|
|
<em>A system error has occurred! Try again later</em>, this generally means
|
|
that your LDAP server has not been started.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">Start the LDAP server, and try your search again.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Operation failed error during registration</td>
|
|
<td align="left" valign="top" headers="d0e193 ">If you try to register a user and get the following error:
|
|
<em>ERROR: Operation failed. Contact your IBM Telephone Directory application administrator</em>,
|
|
this generally means that your LDAP server has not been started.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">Start the LDAP server, and try your registration again.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Operation failed error during entry updates or deletes</td>
|
|
<td align="left" valign="top" headers="d0e193 ">If you try to update or delete a profile and get the following
|
|
error: <em>ERROR: Operation failed. Contact your IBM Telephone Directory application administrator</em>,
|
|
you might not have the appropriate directives configured in the HTTP server.
|
|
A symptom of this problem is the lack of the authentication dialog to input
|
|
your user ID and password before making changes.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">Manually add the missing LDAP configuration directives
|
|
to the HTTP server configuration or reinstall the IBM Telephone Directory V5.2 application.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Object not found error</td>
|
|
<td align="left" valign="top" headers="d0e193 ">If you receive a 404 - Object not found error in the IBM Telephone
|
|
Directory application, it might be because your plugin-cfg.xml file is corrupt.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">Perform the following steps to check this file and fix
|
|
it, if necessary: <ol><li>Open the plugin-cfg.xml file, which is located at: <pre>/QIBM/UserData/.../config/
|
|
cells/plugin-cfg.xml</pre>
|
|
</li>
|
|
<li>Check to see if the following virtual host specifications are in your
|
|
file (assuming a virtual host of <em>default_host</em> and a port of <em>80</em>: <pre><VirtualHostGroup Name=
|
|
"default_host">
|
|
<VirtualHost Name=
|
|
"80"/></pre>
|
|
</li>
|
|
<li>Check to see if the following URI affinity cookies are in your file: <pre><URI AffinityCookie=
|
|
"JSESSIONID"
|
|
Name="/bizApps/*"/>
|
|
|
|
<URI AffinityCookie=
|
|
"JSESSIONID"
|
|
Name="/itd/*"></pre>
|
|
</li>
|
|
<li>If these specifications are not in your file, open the WebSphere Application
|
|
Server administration console.</li>
|
|
<li>Expand <span class="uicontrol">Environment</span>.</li>
|
|
<li>Click <span class="uicontrol">Update WebServer plugin</span>.</li>
|
|
<li>Click <span class="uicontrol">OK</span>.</li>
|
|
<li>Stop and restart the application server.</li>
|
|
<li>Stop and restart the HTTP server.</li>
|
|
</ol>
|
|
</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Some values were not saved</td>
|
|
<td align="left" valign="top" headers="d0e193 ">If you do not have the authority to add, change, or remove
|
|
a particular field, and try to do so in the application, you will receive
|
|
a message that states that some values were not saved because the directory
|
|
does not allow you to add them to your profile, and to contact the application
|
|
administrator for details.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">If you receive this error, it means that authentication
|
|
required has been configured on the IBM Telephone Directory V5.2 application.</td>
|
|
</tr>
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e191 ">Special characters (such as ", &, <, or >) not
|
|
handled correctly</td>
|
|
<td align="left" valign="top" headers="d0e193 ">The IBM Telephone Directory V5.2 application has been written
|
|
to accept and handle all characters correctly, even those identified as special
|
|
characters (or metacharacters) for HTML, JavaScript™, and LDAP filters and attribute
|
|
values.</td>
|
|
<td align="left" valign="top" headers="d0e195 ">There are known cases when the IBM Telephone Directory application handles
|
|
special characters for LDAP attribute values correctly, according to the RFC
|
|
2253 standard. However, the <span class="keyword">iSeries</span> Directory
|
|
Services (LDAP) directory server does not fully support the standard. For
|
|
these cases, there is nothing that can be done other than to avoid the use
|
|
of such characters.<p>The quote (") character is an example of this problem.
|
|
The RFC 2253 standard specifies that the character must be escaped by preceding
|
|
it with a backslash (\) to be accepted as a literal character in an LDAP attribute
|
|
value. Since the current version of <span class="keyword">iSeries</span> Directory
|
|
Services (LDAP) does not fully support RFC 2253, the server saves both the
|
|
backslash character as well as the quote character.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Error logging and debugging</h4><ul><li><strong>Error logs</strong> <p>The application server has a variety of logs to which
|
|
messages are written. For example, system message, which can be written by
|
|
any application server component or application are written to general purpose
|
|
logs such as the JAVA Virtual Machine (JVM) logs and the IBM Service logs.
|
|
Other logs are very specific in nature and are scoped to a particular component
|
|
or activity. For example, the HTTP Server plugin maintains a component-specific
|
|
plugin log.</p>
|
|
<p>The general purpose logs, such as JVM and IBM Service, are
|
|
used to monitor the health of the application server and assist in troubleshooting.
|
|
Troubleshooting for specific components might require additional log analysis,
|
|
such as component or product specific log files.</p>
|
|
</li>
|
|
<li><strong>Trace statements</strong> <p>Application trace statements can be enabled
|
|
for the purpose of debugging problems. If problems persist, and you must call IBM Service
|
|
for help, one of the first thing they might ask you for is a copy of the application's
|
|
trace output. Trace statements are enabled by adding a line to the application's
|
|
configuration file and restarting the application.</p>
|
|
<p>The application will
|
|
read the new configuration when it is started. Application trace statement
|
|
will be enabled at that time. When enabled, trace statements are written to
|
|
the server's SystemOut.log file.</p>
|
|
</li>
|
|
<li><strong>LDAP and HTTP server trace</strong> <p>See the following information for
|
|
details on LDAP and HTTP server trace:</p>
|
|
<ul><li><a href="../rzahy/rzahytsh-po.htm">Troubleshoot
|
|
Directory Server</a></li>
|
|
<li><a href="../rzaie/rzaietrouble.htm">Troubleshoot
|
|
HTTP server</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">General troubleshooting information</h4><p>These resources
|
|
provide general troubleshooting assistance.</p>
|
|
<ul><li>For WebSphere Application
|
|
Server - Express V5, see the associated <a href="../rzamy/50/trb/trb.htm">Troubleshooting</a> topic.</li>
|
|
<li>For WebSphere Application
|
|
Server - Express V5.1, see the associated <a href="../rzatz/51/trb/trb.htm">Troubleshooting</a> topic.</li>
|
|
<li>For WebSphere Application
|
|
Server - Express V6, see the associated <a href="http://publib.boulder.ibm.com/infocenter/wsdoc400/topic/com.ibm.websphere.iseries.doc/info/ae/ae/welc6toptroubleshooting.html" target="_blank">Troubleshooting</a> topic.</li>
|
|
<li>For WebSphere Application
|
|
Server V5, see the associated <a href="http://publib.boulder.ibm.com/was400/50/ic2924/index.htm?info/rzaiz/50/trb/trb.htm" target="_blank">Troubleshooting</a> topic.</li>
|
|
<li>For WebSphere Application
|
|
Server V5.1, see the associated <a href="http://publib.boulder.ibm.com/was400/51/english/index.htm?info/rzaiz/51/trb/trb.htm" target="_blank">Troubleshooting</a> topic.</li>
|
|
<li>For WebSphere Application
|
|
Server V6, see the associated <a href="http://publib.boulder.ibm.com/infocenter/wsdoc400/topic/com.ibm.websphere.iseries.doc/info/ae/ae/welc6toptroubleshooting.html" target="_blank">Troubleshooting</a> topic.</li>
|
|
<li>Read the <a href="http://www-1.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/express/docs/relnotesexp51.html" target="_blank">WebSphere Application Server - Express V5.1 Release
|
|
Notes</a> <img src="www.gif" alt="Link outside Information Center" /> </li>
|
|
<li>Read the <a href="http://www-1.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/express/docs/relnotesexp50.html" target="_blank">WebSphere Application Server - Express V5 Release
|
|
Notes</a> <img src="www.gif" alt="Link outside Information Center" /> </li>
|
|
<li>Read the <a href="http://publib.boulder.ibm.com/was400/docs/relnotes50.html" target="_blank">WebSphere Application Server V5 Release Notes</a> <img src="www.gif" alt="Link outside Information Center" /></li>
|
|
<li>Read the <a href="http://publib.boulder.ibm.com/was400/docs/relnotes51.html" target="_blank">WebSphere Application Server V5.1 Release Notes</a> <img src="www.gif" alt="Link outside Information Center" /></li>
|
|
<li>Read the <a href="http://www-1.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/docs/docws60.htm#ReleaseNotes" target="_blank">WebSphere Application Server V6 Release
|
|
Notes</a> <img src="www.gif" alt="Link outside Information Center" /></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="itd.htm" title="The IBM Telephone Directory V5.2 application is a part of IBM Business Solutions Version 1.0 (5722-BZ1) and is a Web-based application that provides the ability to search, view, and manage entries in an LDAP directory.">IBM Telephone Directory V5.2</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |