vgritsenko 2004/01/01 13:39:56
Modified: targets/xindice news.html news.pdf
targets/xindice/1.0 guide-user.html guide-user.pdf
targets/xindice/community/howto/installation tomcat.html
tomcat.pdf
targets/xindice/dev doc-contributing.html
doc-contributing.pdf news.html news.pdf
Log:
Add release news. Update install doc.
Revision Changes Path
1.5 +8 -0 xml-site/targets/xindice/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xindice/news.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- news.html 31 Dec 2003 03:58:34 -0000 1.4
+++ news.html 1 Jan 2004 21:39:56 -0000 1.5
@@ -287,6 +287,14 @@
<li>
+<strong>31 December 2003</strong>:
+ The Apache Xindice team is pleased to <a
href="http://marc.theaimsgroup.com/?l=xindice-dev&m=107289430732328";>announce</a>
+ the release of the next version of the Xindice native XML database,
+ Apache Xindice 1.1b3.
+ </li>
+
+<li>
+
<strong>23 November 2003</strong>: Jan Metzner
<a
href="http://marc.theaimsgroup.com/?l=xindice-dev&m=106963645226780&w=2";>announced
availability</a>
of new Web and WEBDAV Xindice administration tool. It is planned to
replace
1.5 +42 -29 xml-site/targets/xindice/news.pdf
<<Binary file>>
1.2 +12 -0 xml-site/targets/xindice/1.0/guide-user.html
Index: guide-user.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xindice/1.0/guide-user.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- guide-user.html 31 Dec 2003 03:58:35 -0000 1.1
+++ guide-user.html 1 Jan 2004 21:39:56 -0000 1.2
@@ -121,43 +121,55 @@
<li>
<font color="#CFDCED">Overview</font>
<ul>
+
<li>
<a href="../index.html">Back</a>
</li>
+
<li>
<a href="index.html">Overview</a>
</li>
+
<li>
<a href="changes.html">Changes</a>
</li>
+
</ul>
</li>
<li>
<font color="#CFDCED">Documentation</font>
<ul>
+
<li>
<a href="guide-administrator.html">Administrator Guide</a>
</li>
+
<li>
<span class="sel"><font color="#ffcc00">User Guide</font></span>
</li>
+
<li>
<a href="guide-developer.html">Developer Guide</a>
</li>
+
<li>
<a href="guide-tools.html">Tool Guide</a>
</li>
+
<li>
<a href="faq.html">FAQ</a>
</li>
+
</ul>
</li>
<li>
<font color="#CFDCED">Resources</font>
<ul>
+
<li>
<a href="http://www.xmldb.org";>XML:DB Initiative</a>
</li>
+
</ul>
</li>
</ul>
1.2 +11 -11 xml-site/targets/xindice/1.0/guide-user.pdf
<<Binary file>>
1.5 +135 -82
xml-site/targets/xindice/community/howto/installation/tomcat.html
Index: tomcat.html
===================================================================
RCS file:
/home/cvs/xml-site/targets/xindice/community/howto/installation/tomcat.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- tomcat.html 31 Dec 2003 03:58:35 -0000 1.4
+++ tomcat.html 1 Jan 2004 21:39:56 -0000 1.5
@@ -200,10 +200,10 @@
<a href="#Steps">Steps</a>
<ul class="minitoc">
<li>
-<a href="#Copy+the+war+file">Copy the war file</a>
+<a href="#Copy+the+WAR+file">Copy the WAR file</a>
</li>
<li>
-<a href="#Edit+the+Tomcat+">Edit the Tomcat server.xml File</a>
+<a href="#Edit+the+Tomcat%27s+server.xml+File+%28Optional%29">Edit the
Tomcat's server.xml File (Optional)</a>
</li>
<li>
<a href="#Restart+Tomcat">Restart Tomcat</a>
@@ -217,34 +217,62 @@
<a href="#revisions">Revisions</a>
</li>
</ul>
-<a name="N10016"></a><a name="Intended audience"></a>
+<a name="N1001A"></a><a name="Intended audience"></a>
<h3>Intended audience</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>This How-to is aimed at developers or administrators who want to install
Xindice with Tomcat.</p>
+<p>
+ This How-to is aimed at developers or administrators who want to
install
+ Xindice with Tomcat.
+ </p>
</div>
-<a name="N1001E"></a><a name="Prerequisites"></a>
+<a name="N10022"></a><a name="Prerequisites"></a>
<h3>Prerequisites</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>The most important prerequisite is patience. Take lots of deep breaths.
It will work. It just might take some time.</p>
+<p>
+ The most important prerequisite is patience. Take lots of deep breaths.
+ It will work. It just might take some time.
+ </p>
<ul>
-
-<li>You should have already compiled <a
href="../compilation/index.html">Xindice</a>.</li>
-
-<li>You must have an existing installation of Tomcat. You should use
version 4.1.12 or higher. You can install <a target="_blank"
href="http://jakarta.apache.org/tomcat/";>Tomcat</a> from the Jakarta website.
- </li>
-
-<li>Be sure to set the CATALINA_HOME environmental variable to point to the
location of your Tomcat installation.</li>
-
+
+<li>
+ You should have already compiled <a
href="../compilation/index.html">Xindice</a>.
+ </li>
+
+<li>
+ You must have an existing installation of Tomcat. You should use
version
+ 4.1.12 or higher. You can download
+ <a target="_blank"
href="http://jakarta.apache.org/tomcat/";>Tomcat</a> from the
+ Jakarta website.
+ </li>
+
+<li>
+ Be sure to set the <span class="codefrag">CATALINA_HOME</span>
environmental variable to point
+ to the location of your Tomcat installation.
+ </li>
+
</ul>
</div>
-<a name="N1003A"></a><a name="Steps"></a>
+<a name="N10041"></a><a name="Steps"></a>
<h3>Steps</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1003F"></a><a name="Copy+the+war+file"></a>
-<h4>Copy the war file</h4>
+<a name="N10046"></a><a name="Copy+the+WAR+file"></a>
+<h4>Copy the WAR file</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>If you've followed the prerequisites, then you will have a working
version of Tomcat installed, and the sources of Xindice compiled. Now, copy
the xindice*.war file from dist to %CATALINA_HOME%/webapps</p>
-<p>Here's what that looks like in Windows</p>
+<p>
+ If you've followed the prerequisites, then you will have a working
version
+ of Tomcat installed, and the sources of Xindice compiled. Now, copy
the
+ <span class="codefrag">xindice-*.war</span> file from dist to the
+ <span class="codefrag">%CATALINA_HOME%/webapps</span>.
+ </p>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">
+ It is important to rename the file while copying to the <span
class="codefrag">xindice.war</span>,
+ as name of the file defines context name, and Xindice clients and
tools use
+ <span class="codefrag">xindice</span> context name by default.
+ </div>
+</div>
+<p>Here's what that looks like in Windows:</p>
<pre class="code">
D:\xindice\current\xml-xindice>dir dist
Volume in drive D is Data
@@ -252,62 +280,68 @@
Directory of D:\xindice\current\xml-xindice\dist
-11/18/2002 01:55p <DIR> .
-11/18/2002 01:55p <DIR> ..
-11/18/2002 01:55p 9,467 xindice-1.1b-examples.jar
-11/20/2002 03:57p 392,842 xindice-1.1b.jar
-11/20/2002 03:57p 2,421,719 xindice-1.1b.war
- 3 File(s) 2,824,028 bytes
- 2 Dir(s) 6,087,331,840 bytes free
+01/01/2004 03:34 PM <DIR> .
+01/01/2004 03:34 PM <DIR> ..
+01/01/2004 03:34 PM 464,594 xindice-1.1b3.jar
+01/01/2004 03:35 PM 4,313,587 xindice-1.1b3.war
+01/01/2004 03:34 PM 253 xindice-1.1b3.xml
+ 3 File(s) 4,778,434 bytes
+ 2 Dir(s) 42,307,837,952 bytes free
-D:\xindice\current\xml-xindice>copy dist\xindice-1.1b.war
%CATALINA_HOME%\webapp
-s\
+D:\xindice\current\xml-xindice>copy dist\xindice-1.1b3.war
%CATALINA_HOME%\webapp
+s\xindice.war
1 file(s) copied.
D:\xindice\current\xml-xindice>
- </pre>
+ </pre>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">In this example, I have built Xindice in
D:\xindice\current. If you compile the source in another location, just
substitute that path for D:\xindice\current.</div>
+<div class="content">
+ In this example, I have built Xindice in <span
class="codefrag">D:\xindice\current</span>.
+ If you compile the source in another location, just substitute that
path for
+ <span class="codefrag">D:\xindice\current</span>.
+ </div>
</div>
<p> </p>
<p>If you are using Linux, your session might resemble:</p>
<pre class="code">
[EMAIL PROTECTED]:/local/xml-xindice# ls -oat dist
-total 2760
[EMAIL PROTECTED]:/local/xml-xindice# ls -oa dist
+total 4668
drwxr-xr-x 2 root 4096 Nov 25 20:10 .
--rw-r--r-- 1 root 247 Nov 25 20:10 xindice-1.1b.xml
drwxr-xr-x 13 root 4096 Nov 25 00:01 ..
--rw-r--r-- 1 root 9504 Nov 23 15:27 xindice-1.1b-examples.jar
--rw-r--r-- 1 root 2408531 Nov 23 15:27 xindice-1.1b.war
--rw-r--r-- 1 root 379794 Nov 23 15:27 xindice-1.1b.jar
[EMAIL PROTECTED]:/local/xml-xindice# cp dist/xindice-1.1b.war
$CATALINA_HOME/webapps
+-rw-r--r-- 1 root 464594 Jan 1 15:34 xindice-1.1b3.jar
+-rw-r--r-- 1 root 4313587 Jan 1 15:35 xindice-1.1b3.war
+-rw-r--r-- 1 root 253 Jan 1 15:34 xindice-1.1b3.xml
[EMAIL PROTECTED]:/local/xml-xindice# cp dist/xindice-1.1b3.war
$CATALINA_HOME/webapps/xindice.war
[EMAIL PROTECTED]:/local/xml-xindice#
- </pre>
+ </pre>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">In this Linux session, the Xindice root directory
- is in <span class="codefrag">/local/xml-xindice</span>.
You should
- substitute your actual <span
class="codefrag">XINDICE_HOME</span>
- path for <span class="codefrag">/local/xml-xindice</span>.
- </div>
+<div class="content">
+ In this Linux session, the Xindice root directory is in
+ <span class="codefrag">/local/xml-xindice</span>. You should
substitute your actual
+ <span class="codefrag">XINDICE_HOME</span> path for <span
class="codefrag">/local/xml-xindice</span>.
+ </div>
</div>
</div>
-<a name="N1006B"></a><a name="Edit+the+Tomcat+"></a>
-<h4>Edit the Tomcat server.xml File</h4>
+<a name="N10087"></a><a
name="Edit+the+Tomcat%27s+server.xml+File+%28Optional%29"></a>
+<h4>Edit the Tomcat's server.xml File (Optional)</h4>
<div style="margin-left: 0 ; border: 2px">
-<div class="frame fixme">
-<div class="label">Fixme (jcarroll)</div>
-<div class="content">Need section on inserting
- XINDICE_HOME/dist/xindice-1.1b.xml entry into the
- CATALINA_HOME/conf/server.xml file here.
- </div>
-</div>
+<p>
+ Tomcat will automatically deploy copied war file with the default
settings.
+ To modify those defaults, <span
class="codefrag">CATALINA_HOME/conf/server.xml</span> file
+ should be edited. Suggested changes for the server.xml file are
contained
+ in the <span
class="codefrag">XINDICE_HOME/dist/xindice-1.1b3.xml</span> file.
+ </p>
</div>
-<a name="N10079"></a><a name="Restart+Tomcat"></a>
+<a name="N10097"></a><a name="Restart+Tomcat"></a>
<h4>Restart Tomcat</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>Restart your Tomcat server to be certain that it picks up the Xindice
servlet.</p>
+<p>
+ Restart your Tomcat server to be certain that it picks up the
Xindice servlet.
+ This step is required if you have edited <span
class="codefrag">CATALINA_HOME/conf/server.xml</span>
+ file. In other cases, it is usually not required.
+ </p>
<p>Here's what that looks like in Windows</p>
<pre class="code">
D:\xindice\current\xml-xindice>cd %CATALINA_HOME%\bin
@@ -318,10 +352,17 @@
Using CATALINA_TMPDIR: D:\jakarta-tomcat-4.1.12\temp
Using JAVA_HOME: C:\j2sdk1.4.1_01
D:\jakarta-tomcat-4.1.12\bin>
- </pre>
+ </pre>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">In this example, I have installed Tomcat in
D:\jakarta-tomcat-4.1.12. If you've installed it in another location, just
ensure that the CATALINA_HOME environmental variable points to your Tomcat
installation directory, or substitute that path for
D:\jakarta-tomcat-4.1.12.</div>
+<div class="content">
+ In this example, I have installed Tomcat in <span
class="codefrag">D:\jakarta-tomcat-4.1.12</span>.
+ If you've installed it in another location, just ensure that the
+ <span class="codefrag">CATALINA_HOME</span> environmental variable
points to your Tomcat
+ installation directory, or substitute that path for
+ <span class="codefrag">D:\jakarta-tomcat-4.1.12.</span>
+
+</div>
</div>
<p> </p>
<p>Here's what that might look like on Linux</p>
@@ -332,32 +373,35 @@
Using CATALINA_TMPDIR: /var/tomcat4/temp
Using JAVA_HOME: /usr/java/jdk1.3.1_06
[EMAIL PROTECTED]:/var/tomcat4/bin#
- </pre>
+ </pre>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">The name of the Tomcat installation directory may
- differ for your Linux platform. The default
- location is <span class="codefrag">/var/tomcat4</span>.
If you
- are unsure of the location, check the
- <span class="codefrag">tomcat4.conf</span> file in your
- <span class="codefrag">/etc/tomcat4</span> directory.
- </div>
+<div class="content">
+ The name of the Tomcat installation directory may differ for your
Linux
+ platform. The default location is <span
class="codefrag">/var/tomcat4</span>. If you
+ are unsure of the location, check the <span
class="codefrag">tomcat4.conf</span> file in your
+ <span class="codefrag">/etc/tomcat4</span> directory.
+ </div>
</div>
<p> </p>
<div class="frame warning">
<div class="label">Warning</div>
-<div class="content">If you installed the RPM version of Tomcat v4.x,
- you may need to enter "<span class="codefrag">tomcat4
start</span>"
- to invoke the Tomcat server. The FreeBSD version
- of Tomcat may be using <span
class="codefrag">tomcat41ctl</span>.
- </div>
+<div class="content">
+ If you installed the RPM version of Tomcat v4.x, you may need to
enter
+ "<span class="codefrag">tomcat4 start</span>" to invoke the Tomcat
server. The FreeBSD
+ version of Tomcat may be using <span
class="codefrag">tomcat41ctl</span>.
+ </div>
</div>
<p> </p>
</div>
-<a name="N100B4"></a><a name="Verify+the+installation"></a>
+<a name="N100DE"></a><a name="Verify+the+installation"></a>
<h4>Verify the installation</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>When Tomcat restarts on Windows, you should see a new window open
entitled 'Tomcat', and it should look something like this. (Note the xindice
classes loading.)</p>
+<p>
+ When Tomcat restarts on Windows, you should see a new window open
entitled
+ 'Tomcat', and it should look something like this. (Note the xindice
classes
+ loading.)
+ </p>
<pre class="code">
Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry loadRegistry
INFO: Loading registry information
@@ -379,10 +423,12 @@
INFO: JK2: ajp13 listening on tcp port 8009
Nov 21, 2002 1:42:24 PM org.apache.jk.server.JkMain start
INFO: Jk running ID=0 time=20/70
config=D:\jakarta-tomcat-4.1.12\conf\jk2.properties
- </pre>
+ </pre>
<p> </p>
-<p>Here's what the <span
class="codefrag">$CATALINA_HOME/logs/catalina.out</span>
- output looks like on Linux</p>
+<p>
+ Here's what the <span
class="codefrag">$CATALINA_HOME/logs/catalina.out</span> output looks
+ like on Linux
+ </p>
<pre class="code">
[INFO] Registry - -Loading registry information
[INFO] Registry - -Creating new Registry instance
@@ -396,19 +442,26 @@
[INFO] ChannelSocket - -JK2: ajp13 listening on tcp port 8009
[INFO] JkMain - -Jk running ID=0 time=4/168
config=/var/tomcat4/conf/jk2.properties
- </pre>
-<p>In addition, you should be able to verify that xindice is running by
loading this URL in your browser http://localhost:8080/xindice-1.1b
- If it works, you should see something that says "THIS
IS AN UGLY DEBUG TOOL!".
- </p>
-</div>
-<p>If you run into problems, don't worry. Be sure to send <a
href="../../../mail.html">feedback</a> so that we can improve these documents
for the next person.</p>
+ </pre>
+<p>
+ In addition, you should be able to verify that xindice is running by
+ loading this URL in your browser <span
class="codefrag">http://localhost:8080/xindice</span>.
+ If it works, you should see something that says
+ "<span class="codefrag">THIS IS AN UGLY DEBUG TOOL!</span>".
+ </p>
+</div>
+<p>
+ If you run into problems, don't worry. Be sure to send
+ <a href="../../../mail.html">feedback</a> so that we can improve these
+ documents for the next person.
+ </p>
</div>
-<a name="N100DB"></a><a name="revisions"></a>
+<a name="N1010B"></a><a name="revisions"></a>
<h3>Revisions</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Find a problem with this document? Consider contacting the mailing lists
or submitting your own revision. For instructions, read the How To Submit a
Revision.</p>
</div>
-<div class="attribution">by Dave Viner; <span class="version">1.0</span>
+<div class="attribution">by Dave Viner, Vadim Gritsenko; <span
class="version">$Revision$</span>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../../../skin/images/spacer.gif" class="spacer"></td>
1.7 +125 -108
xml-site/targets/xindice/community/howto/installation/tomcat.pdf
<<Binary file>>
1.5 +0 -7 xml-site/targets/xindice/dev/doc-contributing.html
Index: doc-contributing.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xindice/dev/doc-contributing.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- doc-contributing.html 31 Dec 2003 03:58:35 -0000 1.4
+++ doc-contributing.html 1 Jan 2004 21:39:56 -0000 1.5
@@ -121,33 +121,26 @@
<li>
<font color="#CFDCED">Project</font>
<ul>
-
<li>
<a href="index.html">Overview</a>
</li>
-
<li>
<a href="news.html">News</a>
</li>
-
<li>
<a href="todo.html">Todo</a>
</li>
-
</ul>
</li>
<li>
<font color="#CFDCED">Developer documentation</font>
<ul>
-
<li>
<span class="sel"><font color="#ffcc00">How to contribute</font></span>
</li>
-
<li>
<a href="guide-internals.html">Xindice internals</a>
</li>
-
</ul>
</li>
</ul>
1.5 +11 -11 xml-site/targets/xindice/dev/doc-contributing.pdf
<<Binary file>>
1.5 +8 -0 xml-site/targets/xindice/dev/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xindice/dev/news.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- news.html 31 Dec 2003 03:58:36 -0000 1.4
+++ news.html 1 Jan 2004 21:39:56 -0000 1.5
@@ -218,6 +218,14 @@
<li>
+<strong>31 December 2003</strong>:
+ The Apache Xindice team is pleased to <a
href="http://marc.theaimsgroup.com/?l=xindice-dev&m=107289430732328";>announce</a>
+ the release of the next version of the Xindice native XML database,
+ Apache Xindice 1.1b3.
+ </li>
+
+<li>
+
<strong>23 November 2003</strong>: Jan Metzner
<a
href="http://marc.theaimsgroup.com/?l=xindice-dev&m=106963645226780&w=2";>announced
availability</a>
of new Web and WEBDAV Xindice administration tool. It is planned to
replace
1.5 +42 -29 xml-site/targets/xindice/dev/news.pdf
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
