205 lines
13 KiB
HTML
205 lines
13 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 Welcome Page V1.1" />
|
||
|
|
<meta name="abstract" content="Provides troubleshooting information on the IBM Welcome Page V1.1 application." />
|
||
|
|
<meta name="description" content="Provides troubleshooting information on the IBM Welcome Page V1.1 application." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="welpg.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="wpts" />
|
||
|
|
<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 Welcome Page V1.1</title>
|
||
|
|
</head>
|
||
|
|
<body id="wpts"><a name="wpts"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Troubleshoot IBM Welcome Page V1.1</h1>
|
||
|
|
<div><p>Provides troubleshooting information on the IBM<sup>®</sup> Welcome Page V1.1 application.</p>
|
||
|
|
<div class="section"><p>Before you begin to troubleshoot problems with the IBM Welcome Page
|
||
|
|
V1.1 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="wpinstallprereq.htm">Verify
|
||
|
|
the prerequisites</a> for more information.</li>
|
||
|
|
<li>Is your LDAP server started?</li>
|
||
|
|
<li>Is your IBM Welcome
|
||
|
|
Page 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="rows"><thead align="left"><tr valign="top"><th align="left" valign="top" id="d0e53">Problem</th>
|
||
|
|
<th align="left" valign="top" id="d0e55">Cause</th>
|
||
|
|
<th align="left" valign="top" id="d0e57">Solution</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e53 ">Your installation failed with the following message: ldap_search:
|
||
|
|
Insufficient access</td>
|
||
|
|
<td align="left" valign="top" headers="d0e55 ">You entered the wrong LDAP server administrator password.</td>
|
||
|
|
<td align="left" valign="top" headers="d0e57 ">Obtain the correct password or reset the password.</td>
|
||
|
|
</tr>
|
||
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e53 ">Your setup script failed with the following messages: <samp class="codeph">ldap_search:
|
||
|
|
No such object Error 32 verifying LDAP settings</samp></td>
|
||
|
|
<td align="left" valign="top" headers="d0e55 ">There might be a problem with the base DN not existing
|
||
|
|
on the LDAP server.</td>
|
||
|
|
<td align="left" valign="top" headers="d0e57 ">There is a problem with the base LDAP server configuration.
|
||
|
|
See <a href="../rzahy/rzahytsh-po.htm">Troubleshoot
|
||
|
|
Directory Server</a> in the <em>Directory Server (LDAP)</em> topic for more
|
||
|
|
information.</td>
|
||
|
|
</tr>
|
||
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e53 ">IBM Business Solutions (5722-BZ1) is not listed when
|
||
|
|
the RSTLICPGM command is run for a preinstalled and preconfigured <span class="keyword">iSeries™ server</span></td>
|
||
|
|
<td align="left" valign="top" headers="d0e55 ">IBM Business Solutions is not installed on your server.</td>
|
||
|
|
<td align="left" valign="top" headers="d0e57 ">Reinstall both the IBM Telephone Directory V5.2 application
|
||
|
|
and the IBM Welcome
|
||
|
|
Page V1.1 application.</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="rows"><thead align="left"><tr valign="top"><th align="left" valign="top" id="d0e113">Problem</th>
|
||
|
|
<th align="left" valign="top" id="d0e115">Cause</th>
|
||
|
|
<th align="left" valign="top" id="d0e117">Solution</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e113 ">Log in fails</td>
|
||
|
|
<td align="left" valign="top" headers="d0e115 ">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="d0e117 ">Make sure that your characters map to the job CCSID that
|
||
|
|
is used by the HTTP server. For more information, see <a href="../rzaty/itdnotice.htm">Notices and limitations</a> in
|
||
|
|
the <em>IBM Telephone
|
||
|
|
Directory V5.2</em> topic.</td>
|
||
|
|
</tr>
|
||
|
|
<tr valign="top"><td align="left" valign="top" headers="d0e113 ">URL fails or the application does not appear</td>
|
||
|
|
<td align="left" valign="top" headers="d0e115 ">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>).</td>
|
||
|
|
<td align="left" valign="top" headers="d0e117 ">Start the IBM Welcome Page application.</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="rows"><thead align="left"><tr valign="bottom"><th valign="bottom" id="d0e164">Problem</th>
|
||
|
|
<th valign="bottom" id="d0e166">Cause</th>
|
||
|
|
<th valign="bottom" id="d0e168">Solution</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e164 ">Administration user ID confusion</td>
|
||
|
|
<td align="left" valign="top" headers="d0e166 ">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="d0e168 ">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="d0e164 ">Special characters (such as ", &, <, or >) not
|
||
|
|
handled correctly</td>
|
||
|
|
<td align="left" valign="top" headers="d0e166 ">The IBM Welcome Page V1.1 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="d0e168 ">There are known cases when the IBM Welcome Page V1.1 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><span class="uicontrol">Error logs</span> <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><span class="uicontrol">Trace statements</span> <p>Application trace statements
|
||
|
|
can be enabled for the purpose of debugging problems. If problems persist,
|
||
|
|
and you have to 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><span class="uicontrol">LDAP and HTTP server trace</span> <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<sup>®</sup> Application
|
||
|
|
Server - Express V5, see the associated <a href="../rzamy/50/trb/trb.htm">Troubleshooting</a> topic.</li>
|
||
|
|
<li>For WebSphere Application
|
||
|
|
Server - Express for <span class="keyword">iSeries</span> V5.1,
|
||
|
|
see the associated <a href="../rzatz/51/trb/trb.htm">Troubleshooting</a> topic.</li>
|
||
|
|
<li>For WebSphere Application
|
||
|
|
Server for <span class="keyword">iSeries</span> V5, see
|
||
|
|
the associated <a href="http://publib.boulder.ibm.com/iseries/v1r1m0/websphere/ic2924/index.htm?info/rzaiz/50/trb/trb.htm" target="_blank">Troubleshooting</a> topic.</li>
|
||
|
|
<li>For WebSphere Application
|
||
|
|
Server for <span class="keyword">iSeries</span> 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 for <span class="keyword">OS/400<sup>®</sup></span> V6 (including
|
||
|
|
Express), 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.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.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://www.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/docs/docws60.htm" target="_blank">WebSphere Application Server and WebSphere Application
|
||
|
|
Server - Express V6 Release Notes</a> <img src="www.gif" alt="Link
outside Information Center" /></li>
|
||
|
|
<li>Read the <a href="http://www.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/docs/docws51.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.ibm.com/servers/eserver/iseries/software/websphere/wsappserver/docs/docws50.html" target="_blank">WebSphere Application Server V5 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="welpg.htm" title="IBM Welcome Page Version 1.1 is a Web-based business application with several purposes.">IBM Welcome Page V1.1</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|