dims 01/05/16 03:35:10
Modified: xdocs installing.xml
Log:
Patch for installing on BEA Weblogic 6.0
from "Scott N. Smith" <[EMAIL PROTECTED]>
Revision Changes Path
1.4 +162 -78 xml-cocoon2/xdocs/installing.xml
Index: installing.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/xdocs/installing.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- installing.xml 2001/05/10 06:54:09 1.3
+++ installing.xml 2001/05/16 10:35:06 1.4
@@ -7,8 +7,8 @@
<authors>
<person name="Stefano Mazzocchi" email="[EMAIL PROTECTED]"/>
<person name="Giacomo Pati" email="[EMAIL PROTECTED]"/>
- <person name="Tom Klaasen" email="[EMAIL PROTECTED]"/>
- <person name="Chris Stevenson" email="[EMAIL PROTECTED]"/>
+ <person name="Tom Klaasen" email="[EMAIL PROTECTED]"/>
+ <person name="Chris Stevenson" email="[EMAIL PROTECTED]"/>
</authors>
</header>
@@ -25,16 +25,16 @@
require a JVM to run so if you are already using servlets you already
have
one installed.
</p>
-
+
<p><strong>Servlet Engine</strong>
A Servlet 2.2 compliant servlet engine must be present in order to
support
servlet operation and dynamic request handling. Note that this
requirement
is optional for command line operation.
</p>
-
- <p>If you don't have a servlet engine installed, well, stop right here and
- go to the Apache Tomcat project
- <link
href="http://jakarta.apache.org/tomcat/";>http://jakarta.apache.org/tomcat/</link>
+
+ <p>If you don't have a servlet engine installed, well, stop right here and
+ go to the Apache Tomcat project
+ <link
href="http://jakarta.apache.org/tomcat/";>http://jakarta.apache.org/tomcat/</link>
then come back when you are done.</p>
</s1>
@@ -42,29 +42,29 @@
<s1 title="Getting Apache Cocoon 2">
<s2 title="Step-by-step installation instructions for Windows">
- <ol>
+ <ol>
<li>Download
<link
href="ftp://cvsgui.sourceforge.net/pub/cvsgui/WinCvs120.zip";>WinCVS
(v1.2)</link> (homepage is <link
href="http://www.wincvs.org/";>http://www.wincvs.org/</link>);
</li>
- <li>Install it;</li>
- <li>Start it;</li>
- <li>Click on admin->preferences;</li>
+ <li>Install it;</li>
+ <li>Start it;</li>
+ <li>Click on admin->preferences;</li>
<li> In "Enter the CVSROOT:" enter
- ":pserver:[EMAIL PROTECTED]:/home/cvspublic" (without
quotes);</li>
- <li>In "Authentication:" choose ""passwd" file on the cvs
server";</li>
- <li>Click "Ok";</li>
- <li>Click admin->login;</li>
- <li> When asked for the password: anwer "anoncvs" (without
quotes);</li>
- <li> Click "create->checkout module";</li>
+ ":pserver:[EMAIL PROTECTED]:/home/cvspublic" (without
quotes);</li>
+ <li>In "Authentication:" choose ""passwd" file on the cvs
server";</li>
+ <li>Click "Ok";</li>
+ <li>Click admin->login;</li>
+ <li> When asked for the password: anwer "anoncvs" (without
quotes);</li>
+ <li> Click "create->checkout module";</li>
<li>Module name and path on the server is "xml-cocoon2" (no
quotes);</li>
- <li>Choose a dir to put the source code in;</li>
+ <li>Choose a dir to put the source code in;</li>
<li>Click "Ok";</li>
<li>If everything goes well, messages will start to appear in the
log
- window;</li>
+ window;</li>
<li>Wait until you see "*****CVS exited normally with code 0*****"
in the
- log window;</li>
- <li>The Cocoon2 source is now on your HD.</li>
+ log window;</li>
+ <li>The Cocoon2 source is now on your HD.</li>
</ol>
</s2>
<s2 title="Step-by-step instructions for Unix">
@@ -74,7 +74,7 @@
<li>When asked for the password: anwer "anoncvs".</li>
<li>Enter "cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic -z3
checkout xml-cocoon2". This will create a directory called "xml-cocoon2" where
the Cocoon2 source will be stored.</li>
<li>Wait until cvs has finished.</li>
- <li>The Cocoon2 source is now on your HD.</li>
+ <li>The Cocoon2 source is now on your HD.</li>
</ol>
<p>In case you want to update your Cocoon2 source tree to the
current version, change to the "xml-cocoon2" directory and
@@ -85,68 +85,68 @@
<s1 title="Building Cocoon2">
<s2 title="Set JAVA_HOME enviornment variable">
-
+
<p>Set the JAVA_HOME enviornment variable to point to the root
directory of
the Java Development Kit installed on your machine. To do this simply
type:</p>
-
+
<source>
[unix] JAVA_HOME=/path/to/java/
[win32] SET JAVA_HOME=c:\path\to\java
- </source>
+ </source>
<p>Your mileage may vary, but you know how to setup environments,
right?</p>
</s2>
-
+
<s2 title="Create the Cocoon WAR package">
-
+
<p>To do this you simply have to type:</p>
-
+
<source>
[unix] ./build.sh -Dinclude.webapp.libs=yes webapp
[win32] .\build.bat -Dinclude.webapp.libs=yes webapp
</source>
-
- <p>this will create the "cocoon.war" file in the
+
+ <p>this will create the "cocoon.war" file in the
'./build/cocoon' directory.</p>
-
+
</s2>
-
+
</s1>
-
+
<s1 title="Installing Cocoon2">
-
- <p>In most servlet engines, this is just a matter of copying
- the war file in a specific directory and the engine will take
+
+ <p>In most servlet engines, this is just a matter of copying
+ the war file in a specific directory and the engine will take
care of installing it when restarted.</p>
-
+
<s2 title="Installing on Tomcat 3.X">
-
- <p>Tomcat currently uses a different version of the XML parser
- than Cocoon. To get Cocoon to work, you need to perform the
+
+ <p>Tomcat currently uses a different version of the XML parser
+ than Cocoon. To get Cocoon to work, you need to perform the
following steps:</p>
-
- <ol>
-
+
+ <ol>
+
<li>
<strong>Stop Tomcat</strong>
Go to the tomcat/bin directory, and run the shutdown script.
</li>
-
+
<li>
- <strong>Delete tomcat/lib/jaxp.jar</strong>
- Tomcat's jaxp.jar is 'sealed', and since xerces contains its
+ <strong>Delete tomcat/lib/jaxp.jar</strong>
+ Tomcat's jaxp.jar is 'sealed', and since xerces contains its
own implementation of the JAXP standard extension, Java
- will fail to load xerces and report a 'Package Sealing Violation'
+ will fail to load xerces and report a 'Package Sealing Violation'
if both are in the classpath.
</li>
-
+
<li>
- <strong>Rename tomcat/lib/parser.jar to
tomcat/lib/zparser.jar</strong>
+ <strong>Rename tomcat/lib/parser.jar to
tomcat/lib/zparser.jar</strong>
Tomcat's parser.jar contains older versions of some the same
- XML APIS that Xerces uses, and these will prevent Xerces from
- functioning properly if they appear before Xerces in the
classpath.
- Since Tomcat's startup scripts automatically load all the jar
files
+ XML APIS that Xerces uses, and these will prevent Xerces from
+ functioning properly if they appear before Xerces in the classpath.
+ Since Tomcat's startup scripts automatically load all the jar files
in tomcat/lib in name order, changing the name of the file causes
it
to be loaded last in the classpath.
</li>
@@ -155,7 +155,7 @@
<strong>Copy cocoon/lib/xerces-XXX.jar file to cocoon\lib</strong>
Cocoon will now be able to see and use the correct XML libraries.
</li>
-
+
<li>
<strong>Copy cocoon/build/cocoon.war into tomcat/webapps</strong>
</li>
@@ -164,36 +164,36 @@
<strong>Start Tomcat</strong>
Go to the tomcat/bin directory, and run the startup script.
</li>
-
+
<li>
<strong>Start using Cocoon</strong>
- Access the URI
+ Access the URI
<link
href="http://localhost:8080/cocoon/";>http://localhost:8080/cocoon/</link>
- with your favorite browser and start to enjoy the world of Cocoon.
- Note that the first time you access Cocoon, it will take a few
+ with your favorite browser and start to enjoy the world of Cocoon.
+ Note that the first time you access Cocoon, it will take a few
seconds to start, since Cocoon needs to compile parts of itself.
</li>
-
+
</ol>
</s2>
-
+
<s2 title="Installing on Tomcat 4.X">
-
+
<p>Note that Tomcat-4.0 beta1 will not work with Cocoon2. You
- must use Tomcat-4.0 beta3 or a nightly build from
+ must use Tomcat-4.0 beta3 or a nightly build from
<link
href="http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/";>http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/</link>
</p>
<p>Recent builds of Tomcat 4 have largely solved the xml library
problem
- described above. However Tomcat 4.X is not currently released, and the
+ described above. However Tomcat 4.X is not currently released, and the
flip side of easier installation is alpha code. It is not recommended
- that you use Tomcat 4.X for production servers yet.
+ that you use Tomcat 4.X for production servers yet.
(Having said that, I do :-)</p>
-
-
- <p>Tomcat 4.0 does not expose the servlet.jar file to Cocoon by
default,
- so <strong>before you build the cocoon webapp</strong> you will need
to
+
+
+ <p>Tomcat 4.0 does not expose the servlet.jar file to Cocoon by
default,
+ so <strong>before you build the cocoon webapp</strong> you will need to
add the following to the cocoon servlet definition in the web.xml
file:</p>
<source>
@@ -203,9 +203,9 @@
<param-value>path\to\tomcat\common\lib\servlet.jar</param-value>
</init-param>
</source>
+
+ <ol>
- <ol>
-
<li>
<strong>Modify cocoon/webapp/WEB-INF/web.xml</strong>
Add the code shown above to the cocoon web.xml file
@@ -213,10 +213,10 @@
<li>
<strong>Build the cocoon webapp</strong>
- Build the webapp as described above. This will now include
+ Build the webapp as described above. This will now include
the corrected web.xml file.
</li>
-
+
<li>
<strong>Copy cocoon/build/cocoon.war into tomcat/webapps</strong>
</li>
@@ -225,21 +225,105 @@
<strong>Start Tomcat</strong>
Go to the tomcat/bin directory, and run the startup script.
</li>
-
+
<li>
<strong>Start using Cocoon</strong>
- Access the URI
+ Access the URI
<link
href="http://localhost:8080/cocoon/";>http://localhost:8080/cocoon/</link>
- with your favorite browser and start to enjoy the world of Cocoon.
- Note that the first time you access Cocoon, it will take a few
+ with your favorite browser and start to enjoy the world of Cocoon.
+ Note that the first time you access Cocoon, it will take a few
seconds to start, since Cocoon needs to compile parts of itself.
</li>
-
+
</ol>
+ </s2>
+
+ <s2 title="Installing on BEA Weblogic 6.0">
+
+ <p>This installs Cocoon 2 in an "open" configuration (that is, without
+ the <em>war</em> file). This was successfully installed under
Windows 2000;
+ unix users will need to adjust appropriately.</p>
+
+ <p>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>
+ In Windows Explorer, drag <em>COPY</em> (i.e. hold the ctrl key
down) the directory
+
+ <em>C:\xml-cocoon2\webapp</em>
+
+ to
+
+ <em>c:\bea\wlserver6.0sp1\config\mydomain\applications</em>.
+
+ (if in Unix, do the Unix equivalent.)
+ </li>
+ <li>
+ Rename the newly created folder
+
+
<em>c:\bea\wlserver6.0sp1\config\mydomain\applications\webapp</em>
+
+ to
+
+
<em>c:\bea\wlserver6.0sp1\config\mydomain\applications\cocoon</em>.
+ </li>
+ <li>
+ Edit the file
+
+ <em>C:\bea\wlserver6.0sp1\config\mydomain\startWebLogic.cmd</em>
+
+ to modify the classpath with the following lines:
+ <br/>
+ set COCOON_ROOT=c:\xml-cocoon2
+ <br/>
+ set
COCOONCLASSPATH="%COCOON_ROOT%\lib\xerces_1_3_1.jar;%COCOON_ROOT%\lib\xalan-2.0.1.jar;%JA
VA_HOME%\lib\tools.jar;%COCOON_ROOT%\build\cocoon\cocoon.jar;%COCOON_ROOT%\lib\logkit.jar
;%COCOON_ROOT%\lib\w3c.jar;%COCOON_ROOT%\lib\fop-0_18_1.jar;%COCOON_ROOT%\lib\avalon-fram
ework.jar;%COCOON_ROOT%\lib\avalon-excalibur.jar;%COCOON_ROOT%\lib\bsf.jar;%COCOON_ROOT%\
lib\batik-all.jar;%COCOON_ROOT%\lib\hsqldb.jar;%COCOON_ROOT%\lib\jakarta-regexp-1.2.jar;%
COCOON_ROOT%\lib\javac.jar;%COCOON_ROOT%\lib\jimi-1.0.jar;%COCOON_ROOT%\lib\jstyle.jar;%C
OCOON_ROOT%\lib\xt.jar;%COCOON_ROOT%\lib\maybeupload.jar;%COCOON_ROOT%\lib\rhino.jar;%COC
OON_ROOT%\lib\Tidy.jar;%COCOON_ROOT%\lib\velocity-1.0.1-rc1.jar"
+ <br/>
+ set CLASSPATH=.;.\lib\weblogic_sp.jar;.\lib\weblogic.jar
+ <br/>
+ set CLASSPATH=%COCOONCLASSPATH%;%CLASSPATH%
+ </li>
+
+ <li>
+ Continue to edit the same file by inserting the following system
property into
+ the java run command for Weblogic:
+ <br/>
+
-Dorg.apache.cocoon.components.parser.Parser=org.apache.cocoon.components.parser.XercesPa
rser
+ <br/>
+ In other words, after you modify the java run command, it should
look something like this:
+ <br/>
+ "%JAVA_HOME%\bin\java" -hotspot -ms64m -mx64m -classpath
%CLASSPATH%
-Dorg.apache.cocoon.components.parser.Parser=org.apache.cocoon.components.parser.XercesPa
rser -Dweblogic.Domain=mydomain -Dweblogic.Name=myserver "-Dbea.home=C:\bea"
"-Djava.security.policy=C:\bea\wlserver6.0sp1/lib/weblogic.policy"
-Dweblogic.management.password=%WLS_PW% weblogic.Server
+ <br/>
+ </li>
+
+ <li>
+ Save <em>the startWebLogic.cmd</em> file.
+ </li>
+
+ <li>
+ Run the <em>startWebLogic.cmd</em> file.
+ </li>
+
+ <li>
+ Using a browser, link to your web site's cocoon page:
+
+ <br/>
+ http://<your machine name>:<port number>/cocoon/
+ <br/>
+
+ (Don't forget the final / in the link.)
+ </li>
+
+ <li>
+ Congratulations! (hopefully) you should see the Cocoon welcome
page.
+ </li>
+ </ol>
</s2>
-
+
</s1>
-</body>
+</body>
</document>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
