ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzau5_5.4.0.1/survts.htm

254 lines
16 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 Survey Creator V1.0" />
<meta name="abstract" content="Provides troubleshooting information on the IBM Survey Creator application." />
<meta name="description" content="Provides troubleshooting information on the IBM Survey Creator application." />
<meta name="DC.Relation" scheme="URI" content="surv.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="survts" />
<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 Survey Creator V1.0</title>
</head>
<body id="survts"><a name="survts"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Troubleshoot IBM Survey Creator V1.0</h1>
<div><p>Provides troubleshooting information on the IBM<sup>®</sup> Survey Creator
application.</p>
<div class="section"><p>Before you begin to troubleshoot problems with the IBM Survey Creator
V1.0 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 Survey
Creator 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="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 ">Your installation failed with the following message: ldap_search:
Insufficient access</td>
<td align="left" valign="top" headers="d0e65 ">You entered the wrong LDAP server administrator password.</td>
<td align="left" valign="top" headers="d0e67 ">Obtain the correct password or reset the password.</td>
</tr>
<tr valign="top"><td align="left" valign="top" headers="d0e63 ">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="d0e65 ">There might be a problem with the base DN not existing
on the LDAP server.</td>
<td align="left" valign="top" headers="d0e67 ">There might be a problem with the base LDAP server configuration.</td>
</tr>
<tr valign="top"><td align="left" valign="top" headers="d0e63 ">Product 5722-BZ1 is listed when the GO LICPGM command
is run for a preinstalled and preconfigured <span class="keyword">iSeries™ server</span>,
but the option to install the IBM Survey Creator 1.0 application does not
show up when creating a new WebSphere<sup>®</sup> Application Server using the wizards
of the Admin HTTP Server.</td>
<td align="left" valign="top" headers="d0e65 ">IBM Survey Creator V1.0 is not installed on your server.</td>
<td align="left" valign="top" headers="d0e67 ">Install the IBM Survey Creator V1.0 application. The initial
offering of the IBM Survey Creator V1.0 application is being delivered
as a PTF. The HTTP Server for <span class="keyword">i5/OS™</span> group
PTF includes fixes for HTTP Server and other <span class="keyword">i5/OS</span> products
such as IBM Telephone
Directory V5.2 and IBM Welcome Page V1.1. To determine which group PTF you
must obtain and install, see both: <ul><li> <a href="http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm" target="_blank">HTTP Server: PTFs and Support</a> <img src="www.gif" alt="Link outside Information Center" /> <p>(http://www.ibm.com/servers/<br />
eserver/iseries/software/<br />
http/services/service.htm)</p>
</li>
<li><a href="http://www.ibm.com/servers/eserver/iseries/software/bizapps/ptfs.html" target="_blank">IBM Business Solutions PTFs and Support</a> <img src="www.gif" alt="Link outside Information Center" /><p>(http://www.ibm.com/servers/<br />
eserver/iseries/software/<br />
bizapps/ptfs.html)</p>
</li>
</ul>
</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="d0e155">Problem</th>
<th align="left" valign="top" id="d0e157">Cause</th>
<th align="left" valign="top" id="d0e159">Solution</th>
</tr>
</thead>
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e155 ">Log in fails</td>
<td align="left" valign="top" headers="d0e157 ">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="d0e159 ">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 the 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="../rzaty/itdnotice.htm">Notices and limitations</a>.</td>
</tr>
<tr valign="top"><td align="left" valign="top" headers="d0e155 ">URL fails or the application does not appear</td>
<td align="left" valign="top" headers="d0e157 ">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 Survey
Creator application. If the IBM Survey Creator application is not running,
the Welcome Page application does not have links to it.</td>
<td align="left" valign="top" headers="d0e159 ">Start the IBM Welcome Page application and the IBM Survey Creator
application.</td>
</tr>
<tr valign="top"><td align="left" valign="top" headers="d0e155 ">Requests to the application fail</td>
<td align="left" valign="top" headers="d0e157 ">If you used the internal HTTP server included with WebSphere Application
Server to reference the IBM Survey Creator V1.0 application, certain requests to
the application fail.</td>
<td align="left" valign="top" headers="d0e159 ">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 Survey Creator 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="survoverhttp.htm">Interaction
with IBM HTTP
server for <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="rows"><thead align="left"><tr valign="top"><th align="left" valign="top" id="d0e250">Problem</th>
<th align="left" valign="top" id="d0e252">Cause</th>
<th align="left" valign="top" id="d0e254">Solution</th>
</tr>
</thead>
<tbody><tr valign="top"><td align="left" valign="top" headers="d0e250 ">Missing link to the application</td>
<td align="left" valign="top" headers="d0e252 ">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 Survey Creator
V1.0 application.</td>
<td align="left" valign="top" headers="d0e254 ">If the link to the IBM Survey Creator V1.0 application is missing,
check to ensure that both the IBM Welcome Page application and the IBM Survey Creator
application are started.</td>
</tr>
<tr valign="top"><td align="left" valign="top" headers="d0e250 ">Object not found error</td>
<td align="left" valign="top" headers="d0e252 ">If you receive a 404 - Object not found error in the IBM Survey
Creator application, it might be because your plugin-cfg.xml file is corrupt.</td>
<td align="left" valign="top" headers="d0e254 ">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>&lt;VirtualHostGroup Name=
"default_host"&gt;
&lt;VirtualHost Name=
"80"/&gt;</pre>
</li>
<li>Check to see if the following URI affinity cookies are in your file: <pre>&lt;URI AffinityCookie=
"JSESSIONID"
Name="/bizApps/*"/&gt;
&lt;URI AffinityCookie=
"JSESSIONID"
Name="/survey/*"&gt;</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>
</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 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 through the administrative console of the WebSphere Application
Server by enabling the trace service.</p>
<p>The application does not need
to be restarted after enabling the trace service. After enabling the trace
service, recreate the problem. The trace statements should be written out
to the trace log file. After capturing trace information for the recreated
problem, disable the tracing service to prevent unwanted or extraneous information
from written to the trace 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 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> <img src="www.gif" alt="Link outside Information Center" /> topic.</li>
<li>For WebSphere Application
Server 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 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> <img src="www.gif" alt="Link outside Information Center" /> topic.</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/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/docs/docws60.htm#ReleaseNotes" target="_blank">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/express/docs/relnotesexp502.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/relnotes511.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/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="surv.htm" title="The IBM Survey Creator V1.0 application is a part of the IBM Business Solutions Version 1.0 (5722-BZ1) product.">IBM Survey Creator V1.0</a></div>
</div>
</div>
</body>
</html>