← Back to branch summary

~ubuntu-branches/ubuntu/trusty/libstruts1.2-java/trusty-proposed

« back to all changes in this revision

Viewing changes to xdocs/userGuide/installation-was352-x.xml

  • Committer: Bazaar Package Importer
  • Author(s): Arnaud Vandyck
  • Date: 2004-11-19 15:35:25 UTC
  • Revision ID: james.westby@ubuntu.com-20041119153525-mdu08a76z4zo67xt
Tags: upstream-1.2.4
Import upstream version 1.2.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
xdocs/userGuide/installation-was352-x.xml
 
1
<?xml version="1.0"?>
 
2
<document url="installation-was352-x.html">
 
3
 
 
4
  <properties>
 
5
  <author>Chris Assenza</author>
 
6
    <title>The Struts Framework Project - Installation - WebSphere 3.5.2</title>
 
7
  </properties>
 
8
 
 
9
  <body>
 
10
<section name="5.2 Installation" href="installation"/>
 
11
<section name="Installing Struts with your servlet container" href="Containers">
 
12
 
 
13
<h4 id="was352">WebSphere Application Server 3.5 and the Example Application</h4>
 
14
 
 
15
<p>Server: Windows 2000 Server with WebSphere 3.5.3 Advanced</p>
 
16
<ol>
 
17
<li>Start up the adminserver. </li>
 
18
<li>Start up Admin Console. </li>
 
19
<li>Use the Convert War file task to convert the struts-example.war from the
 
20
struts-b1 distrib as-is. </li>
 
21
<li>Convert to the default_server, default servlet engine and standard
 
22
install directory (c:\websphere\appserver\hosts\default_host). </li>
 
23
<li>Create a WEB-INF directory in the servlets dir and copy
 
24
struts-config.xml, database.xml AND web.xml into it (Keep WEB-INF with all
 
25
the TLD's under web - both WEB-INF directories must be present). </li>
 
26
<li>Copy jaxp 1.0.1's (NOT 1.1.1's) jaxp.jar and parser.jar to the servlets
 
27
directory of the strut-example webapp. </li>
 
28
<li>In the servlets directory, open struts.jar with WinZip.  Extract the
 
29
three DTD's (struts-config_1_0.dtd, web-app_2_2.dtd and web-app_2_3.dtd)
 
30
into the servlets directory making sure you use folder names (so the files
 
31
extract to servlets/org/apache/struts/resources). </li>
 
32
<li>Click on struts-example in the Admin Console under Default Server/Default
 
33
Servlet Engine and click the advanced tab on the right hand side of the
 
34
screen. </li>
 
35
<li>Down where it says Default Error Page, enter /ErrorReporter and then
 
36
click Apply. </li>
 
37
<li>Start the Default Server via the Admin Console. You should see a whole
 
38
bunch of ActionServlet messages in the default_host_stdout.log file with no
 
39
exceptions. </li>
 
40
<li>Via a browser accessed the app using
 
41
http://localhost/struts-example/index.jsp. </li>
 
42
<li>If it returns "Application not Available" then go back to the Admin
 
43
Console, right-click on struts-example and select Restart WebApp. </li>
 
44
<li>Once it reports success, go back to the URL above and try again - it
 
45
should work flawlessly. </li>
 
46
</ol>
 
47
<p>
 
48
For whatever reason, some installations do not like XML files that reference
 
49
PUBLIC DTD's - if in looking at the default_host_stdout.log file you see
 
50
errors about invalid public URL references during DTD registrations, or if
 
51
your pages say "cannot find //logon or //saveRegistration (ie. action
 
52
mappings) then do the following:</p>
 
53
<ol>
 
54
<li>Stop Default Server</li>
 
55
<li>Go to servlets\WEB-INF\ and edit web.xml and struts_config.xml.</li>
 
56
<li>In the DOCTYPE declaration, change the word PUBLIC to SYSTEM and
 
57
completely remove the line that reads "-//Sun Microsystems, Inc.//DTD Web
 
58
Application 2.2//EN" from web.xml and remove "-//Apache Software
 
59
Foundation//DTD Struts Configuration 1.0//EN" from struts-config.xml. </li>
 
60
<li>Save these changes and go back to step 10 above.</li>
 
61
</ol>
 
62
<p>Just as a troubleshooting guide - </p>
 
63
<p>If you are getting errors like "Cannot find ActionMappings, etc..." or
 
64
"Cannot find key org.apache.struts.MESSAGE"  then your application is most
 
65
likely still bombing on the struts-config issue that Richard discovered.
 
66
The above steps SHOULD correct that leaving nothing out.  If you are getting
 
67
404 errors about //logon or something not found, then you are still having
 
68
XML config troubles and it is not initializing the Action servlet properly.
 
69
Follow the steps above in regards to DTD's and it should work.</p>
 
70
<p>As a final thought, I obviously haven't gotten to test too much but I don't
 
71
believe that there are ANY coding changes that need to be made to the actual
 
72
struts source.  Everything about getting it to work in WebSphere has been a
 
73
WebSphere configuration issue thus far (and I don't think I'll be having any
 
74
more). </p>
 
75
<p>If changing the DTD's to SYSTEM, do so ONLY AFTER using the Convert a War
 
76
util.  Ant doesn't seem to like it the other way! :)</p>
 
77
  <hr/>
 
78
  <p>Back to <a href="installation.html#Containers">Installation</a></p>
 
79
</section>
 
80
 
 
81
</body>
 
82
</document>