254 lines
16 KiB
HTML
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><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="/survey/*"></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> |