huber 02/01/11 15:09:44
Modified: src/documentation/xdocs/installing index.xml
Log:
Added installing description for WLS6.1sp1, and WLS6.1sp2.
Revision Changes Path
1.3 +81 -0 xml-cocoon2/src/documentation/xdocs/installing/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/installing/index.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index.xml 10 Jan 2002 17:00:03 -0000 1.2
+++ index.xml 11 Jan 2002 23:09:44 -0000 1.3
@@ -11,6 +11,7 @@
<person name="Chris Stevenson" email="[EMAIL PROTECTED]"/>
<person name="Carsten Ziegeler" email="[EMAIL PROTECTED]"/>
<person name="Vadim Gritsenko" email="[EMAIL PROTECTED]"/>
+ <person name="Bernhard Huber" email="[EMAIL PROTECTED]"/>
</authors>
</header>
@@ -375,6 +376,86 @@
<br/>
<code>set
CLASSPATH=.;c:\bea\jdk130\jre\lib\xerces-XXX.jar;.\lib\weblogic_sp.jar;.\lib\weblogic.jar</code>
<br/>
+ </note>
+ </s2>
+
+ <s2 title="Installing on BEA WLS6.1sp1, WLS6.1sp2">
+
+ <p>This section describes installing Cocoon in a "directory configuration".
+ This was successfully installed under Windows 2000.
+ Unix users will need to adjust appropriately. If you haven't done so
already,
+ build a domain and a server. In this discussion, the name of the domain
+ is 'mydomain' and the name of the server is 'myserver'.
+ These are the BEA default names.
+ </p>
+ <ol>
+ <li>Compile and build Cocoon. Launch <code>build compile</code>,
+ <code>build -Dinclude.webapp.libs webapp webapp-local</code>.
+ </li>
+ <li>You should have a webapplication directory in
+ <code>{cocoon-dir}/build/cocoon/webapp</code>.
+ </li>
+ <li>Modify <code>{cocoon-dir}/build/cocoon/webapp/cocoon.xconf</code>.
+ Replace xslt-processor definition using TRAX XSLT transformer factory by
+ xslt-processor definition using Xalan transformer factory explicitly.
+ Your xslt-processor definition should look like the code snippet below.
+ </li>
+ <li>
+ Configure your WebLogic server, launch your WebLogic console.
+ Use <code>Configure a new Web Application...</code>,
+ and enter in field "Path URI" full path name of Cocoon
+ webapplication directory,
+ like <code>d:\xml-cocoon2\build\cocoon\webapp</code>,
+ enter in field "Name" the servlet name
+ eg. <code>cocoon</code>.
+ Check the "Deployed" checkbox, and click "Apply".
+ At last be sure that you assign the servlet to a target server.
+ </li>
+ <li>
+ You might try to avoid the configuration step by copying
+ the whole Cocoon webapp directory into the <code>applications</code>
+ directory of your WLS6.1 server. In this case you might have
+ to restart your WLS6.1 server in order to activate Cococoon servlet in
WLS 6.1.
+ </li>
+ <li>
+ Using a browser, you might want to check WLS6.1 configuration
+ link to your WLS6.1 console
+ http://<your machine name>:<port number>/console.
+ </li>
+ <li>
+ Using a browser, link to your web site's cocoon page:
+ http://<your machine name>:<port number>/cocoon/
+ (Don't forget the final / in the link.)
+ </li>
+ <li>
+ Congratulations! (hopefully) you should see the Cocoon welcome page.
+ </li>
+ </ol>
+ <p>
+ Snippet of modified <code>cocoon.xconf</code>. The effect of this
+ change is that Cocoon will not try to use a TRAX XSLT transformer factory.
+ Using the TRAX XSLT transformer factory under WLS6.1sp1 lead to empty
+ <code>sitemap_xmap.java</code> files, indicating that the XSLT processor
+ used did not work properly. WLS6.1 has a built-in TRAX XSLT which seems
+ not to work properly for Cocoon.
+ </p>
+ <p>
+ The code snippet below configures the xslt processor to use the XALAN
transformer
+ factory explictly.
+ Forcing Cocoon using Xalan XSLT lead to correct
<code>sitemap_xmap.java</code>
+ files.
+ </p>
+ <source><![CDATA[
+<xslt-processor class="org.apache.cocoon.components.xslt.XSLTProcessorImpl"
+ logger="root.xslt">
+ <parameter name="use-store" value="true"/>
+ <parameter name="transformer-factory"
+ value="org.apache.xalan.processor.TransformerFactoryImpl"/>
+</xslt-processor>]]></source>
+ <note>
+ The above description does not change any WLS6.1 startup script. Moreover
+ other applications will still use the WLS6.1 shipped XSLT processor.
+ All changes described above are locally to the Cocoon webapplication.
</note>
</s2>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
