You are viewing a plain text version of this content. The canonical link for it is here.
Posted to xindice-dev@xml.apache.org by dv...@apache.org on 2002/11/21 23:39:51 UTC

cvs commit: xml-xindice/src/documentation/content/xdocs/community/howto/installation book.xml tomcat.xml

dviner      2002/11/21 14:39:51

  Modified:    src/documentation/content/xdocs/community/howto book.xml
                        index.xml
  Added:       src/documentation/content/xdocs/community/howto/compilation
                        book.xml index.xml prereqs.xml unix.xml windows.xml
               src/documentation/content/xdocs/community/howto/installation
                        book.xml tomcat.xml
  Log:
  Here are a bunch of docs that I've compiled tracing my experiences so far
  in Compiling and Installing xindice 1.1.  I don't have examples for the
  Unix versions, but I'm sure someone can provide the info there.
  
  --dviner
  
  Revision  Changes    Path
  1.2       +10 -13    xml-xindice/src/documentation/content/xdocs/community/howto/book.xml
  
  Index: book.xml
  ===================================================================
  RCS file: /home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/book.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- book.xml	17 Nov 2002 08:13:16 -0000	1.1
  +++ book.xml	21 Nov 2002 22:39:50 -0000	1.2
  @@ -1,18 +1,15 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "book-cocoon-v10.dtd">
  -
  +<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "http://localhost/forrest/dtd/book-cocoon-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
     - Author: Vladimir R. Bossicard (vladimir@apache.org)
     -->
  -
  -<book software="Xindice"
  -      title="Xindice installation HOWTOs"
  -      copyright="2002 The Apache Foundation"
  -      xmlns:xlink="http://www.w3.org/1999/xlink">
  -
  -   <menu label="Installation How-Tos">
  -      <menu-item label="Tomcat How-to" href="installation/tomcat.html"/>
  -   </menu>
  -
  +<book software="Xindice" title="Xindice installation HOWTOs" copyright="2002 The Apache Foundation" xmlns:xlink="http://www.w3.org/1999/xlink">
  +	<menu label="Compilation How-Tos">
  +		<menu-item label="Windows" href="compilation/windows.html"/>
  +		<menu-item label="Unix" href="compilation/unix.html"/>
  +	</menu>
  +	<menu label="Installation How-Tos">
  +		<menu-item label="Tomcat How-to" href="installation/tomcat.html"/>
  +	</menu>
   </book>
  
  
  
  1.2       +59 -29    xml-xindice/src/documentation/content/xdocs/community/howto/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml	17 Nov 2002 08:13:16 -0000	1.1
  +++ index.xml	21 Nov 2002 22:39:50 -0000	1.2
  @@ -1,33 +1,63 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
  -
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "http://localhost/forrest/dtd/document-v11.dtd">
   <!--
     - Version: $Revision$ $Date$
  -  - Author: Vladimir R. Bossicard (vladimir@apache.org)
  -  -->
  -
  +    -->
   <document>
  -
  -   <header>
  -      <title>Xindice How-Tos</title>
  -      <authors>
  -         <person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  -      </authors>
  -
  -   </header>
  -
  -   <body>
  -
  -      <section>
  -         <title>Overview</title>
  -         <p>This is a collection of How-tos. The Xindice project is actively
  -            seeking additional How-to contributors to expand this collection.</p>
  -
  -         <section><title>Installing Xindice</title>
  -            <ul><li><link href="installation/tomcat.html">Tomcat installation</link></li></ul>
  -         </section>
  -      </section>
  -
  -   </body>
  -
  +	<header>
  +		<title>Xindice Compilation How-Tos</title>
  +		<version>1.0</version>
  +		<authors>
  +			<person name="Dave Viner" email="dviner@apache.org"/>
  +			<person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  +		</authors>
  +	</header>
  +	<!--
  +	<audience title="Intended audience">
  +		<p>These How-tos are aimed at developers who want to compile Xindice sources on their local platform.</p>
  +	</audience>
  +	<prerequisites title="Prerequisites">
  +		<p>The most important prerequisite is patience.  Take lots of deep breaths.  It will work.  It just might take some time.</p>
  +	</prerequisites>
  +	<steps title="Steps">
  +		<p>Just choose your platform, and give it a try.</p>
  +		<ul>
  +			<li><link href="windows.html">Windows</link></li>
  +			<li><link href="unix.html">Unix</link></li>
  +		</ul>
  +		<p>If you run into problems, don't worry.  Be sure to send <link href="../../mail.html">feedback</link> so that we can improve these documents for the next person.</p>
  +	</steps>
  +-->
  +	<body>
  +		<section>
  +			<title>Overview</title>
  +			<p>This is a collection of How-tos. The Xindice project is actively
  +            seeking additional How-to contributors to expand this collection. Look for the fixme tables if you want to contribute, but don't know which parts are lacking.</p>
  +			<section>
  +				<title>Compiling Xindice</title>
  +				<ul>
  +					<li>
  +						<link href="compilation/index.html">Introduction</link>
  +					</li>
  +					<li>
  +						<link href="compilation/windows.html">Windows</link>
  +					</li>
  +					<li>
  +						<link href="compilation/unix.html">Unix</link>
  +					</li>
  +				</ul>
  +			</section>
  +			<section>
  +				<title>Installing Xindice</title>
  +				<ul>
  +					<li>
  +						<link href="installation/tomcat.html">Tomcat installation</link>
  +					</li>
  +				</ul>
  +			</section>
  +			<section>
  +				<title>Configuring Xindice</title>
  +			</section>
  +		</section>
  +	</body>
   </document>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/compilation/book.xml
  
  Index: book.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "http://localhost/forrest/dtd/book-cocoon-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:50 $
    - Author: Vladimir R. Bossicard (vladimir@apache.org)
    -->
  <book software="Xindice" title="Xindice compilation HOWTOs" copyright="2002 The Apache Foundation" xmlns:xlink="http://www.w3.org/1999/xlink">
  	<menu label="How-Tos">
  		<menu-item label="Index" href="../index.html"/>
  	</menu>
  	<menu label="Compilation How-Tos">
  		<menu-item label="Introduction" href="index.html"/>
  		<menu-item label="Prerequisites" href="prereqs.html"/>
  		<menu-item label="Windows" href="windows.html"/>
  		<menu-item label="Unix" href="unix.html"/>
  	</menu>
  </book>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/compilation/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "http://localhost/forrest/dtd/howto-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:50 $
      -->
  <howto>
  	<header>
  		<title>Xindice Compilation How-Tos</title>
  		<version>1.0</version>
  		<authors>
  			<person name="Dave Viner" email="dviner@apache.org"/>
  			<person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  		</authors>
  		<last-modified-content-date date="2002-11-21"/>
  	</header>
  	<audience title="Intended audience">
  		<p>These How-tos are aimed at developers who want to compile Xindice sources on their local platform.</p>
  	</audience>
  	<prerequisites title="Prerequisites">
  		<p>The most important prerequisite is patience.  Take lots of deep breaths.  It will work.  It just might take some time.</p>
  	</prerequisites>
  	<steps title="Steps">
  		<p>Just choose your platform, and give it a try.</p>
  		<ul>
  			<li><link href="windows.html">Windows</link></li>
  			<li><link href="unix.html">Unix</link></li>
  		</ul>
  		<p>If you run into problems, don't worry.  Be sure to send <link href="../../../mail.html">feedback</link> so that we can improve these documents for the next person.</p>
  	</steps>
  <!--
  	<body>
  		<section>
  			<title>Overview</title>
  			<p>This is a collection of How-tos. The Xindice project is actively
              seeking additional How-to contributors to expand this collection.</p>
  			<section>
  				<title>Compiling Xindice</title>
  				<ul>
  					<li>
  						<link href="compilation/index.html">Introduction</link>
  					</li>
  					<li>
  						<link href="compilation/windows.html">Windows</link>
  					</li>
  					<li>
  						<link href="compilation/unix.html">Unix</link>
  					</li>
  				</ul>
  			</section>
  			<section>
  				<title>Installing Xindice</title>
  				<ul>
  					<li>
  						<link href="installation/tomcat.html">Tomcat installation</link>
  					</li>
  					<li>
  						Obtain the Xindice release code.
  					</li>
  					<li>
  						Compile the Xindice source code
  					</li>
  					<li>
  						Copy the xindice*.war file from dist/xindice*.war to $CATALINA_HOME/webapps
  					</li>
  					<li>
  						Restart Tomcat
  					</li>
  				</ul>
  			</section>
  		</section>
  	</body>
  -->
  </howto>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/compilation/prereqs.xml
  
  Index: prereqs.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "http://localhost/forrest/dtd/howto-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:50 $
    -->
  <howto>
  	<header>
  		<title>Compilation Prerequisites</title>
  		<version>1.0</version>
  		<authors>
  			<person name="Dave Viner" email="dviner@apache.org"/>
  		</authors>
  		<last-modified-content-date date="2002-11-21"/>
  	</header>
  	<audience title="Intended audience">
  		<p>This How-to is aimed at developers who want to prepare for compiling the Xindice sources.</p>
  	</audience>
  	<purpose title="Purpose">
  		<p> Following the steps of this how-to should allow you to compile Xindice on windows.</p>
  	</purpose>
  	<prerequisites title="Prerequisites">
  		<p>All you need is an internet connection and some patience.</p>
  	</prerequisites>
  	<steps title="Steps">
  		<p>Obtain a working version of the JDK 1.3 or higher.  You can get the jdk from lots of places, one of which is <fork href="http://java.sun.com/j2se/downloads.html">Sun</fork>.</p>
  		<p>Obtain the Xindice <link href="../../../download.html">sources</link> from the download page.</p>
  	</steps>
  </howto>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/compilation/unix.xml
  
  Index: unix.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "http://localhost/forrest/dtd/howto-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:50 $
      -->
  <howto>
  	<header>
  		<title>Compiling Xindice on Unix</title>
  		<version>1.0</version>
  		<authors>
  			<person name="Dave Viner" email="dviner@apache.org"/>
  		</authors>
  		<last-modified-content-date date="2002-11-21"/>
  	</header>
  	
  	<audience title="Intended audience">
  		<p>This How-to is aimed at developers who want to compile Xindice on Unix.</p>
  	</audience>
  	<purpose title="Purpose">
  		<p>Following the steps of this how-to should allow you to compile Xindice on unix.</p>
  	</purpose>
  	<prerequisites title="Prerequisites">
  		<p>See the <link href="prereqs.html">prerequisites</link> page.</p>
  	</prerequisites>
  	<steps title="Steps">
  		<fixme author="dviner">Can someone verify these steps on a unix machine?</fixme>
  		<section>
  			<title>Don't skip the prerequisites</title>
  			<p>Be sure to follow the <link href="prereqs.html">prerequisites.</link>
  			</p>
  		</section>
  		<section>
  			<title>Verify your environment</title>
  			<p>Get a new xterm window</p>
  			<p>Make sure you have the JAVA_HOME environment variable set.</p>
  			<source>
  quintara:~&gt; echo $JAVA_HOME
  /usr/java/jdk1.3.1_02
  quintara:~&gt; 
  			</source>
  		</section>
  		<section>
  			<title>Compile</title>
  			<p>Navigate to your the location where you untarred your Xindice sources and run the compile.</p>
  			<fixme author="dviner">What does the compilation look like in Unix?</fixme>
  		</section>
  		<section>
  			<title>Verify the compilation</title>
  			<p>If the compile was succeeded, you will find the output files in the dist/ subdirectory.</p>
  			<source>
  quintara:~&gt;ls -l dist
  total 2778
  -rw-r--r--  1 dviner  users     9467 Nov 21 11:56 xindice-1.1b-examples.jar
  -rw-r--r--  1 dviner  users   392842 Nov 21 11:56 xindice-1.1b.jar
  -rw-r--r--  1 dviner  users  2421719 Nov 21 11:56 xindice-1.1b.war
  quintara:~&gt;
              		</source>
  		</section>
  		<section>
  			<title>Feedback</title>
  			<p>If you run into problems, don't worry.  Be sure to send <link href="../../../mail.html">feedback</link> so that we can improve these documents for the next person.</p>
  		</section>
  	</steps>
  </howto>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/compilation/windows.xml
  
  Index: windows.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "http://localhost/forrest/dtd/howto-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:50 $
      -->
  <howto>
  	<header>
  		<title>Compiling Xindice on Windows</title>
  		<version>1.0</version>
  		<authors>
  			<person name="Dave Viner" email="dviner@apache.org"/>
  		</authors>
  		<last-modified-content-date date="2002-11-21"/>
  	</header>
  	<audience title="Intended audience">
  		<p>This How-to is aimed at developers who want to compile Xindice on Windows.</p>
  	</audience>
  	<purpose title="Purpose">
  		<p> 
                Following the steps of this how-to should allow you to compile Xindice on windows.
          </p>
  	</purpose>
  	<prerequisites title="Prerequisites">
  		<p>See the <link href="prereqs.html">prerequisites</link> page.</p>
  	</prerequisites>
  	<steps title="Steps">
  		<section>
  			<title>Don't skip the prerequisites</title>
  			<p>Be sure to follow the <link href="prereqs.html">prerequisites.</link></p>
  		</section>
  		<section>
  			<title>Verify your environment</title>
  			<p>Open a new command window.  Click Start, choose Run.  Enter cmd and hit return.  A new command window should appear.</p>
  			<p>Make sure you have the JAVA_HOME environment variable set.</p>
  			<source>
  C:\&gt;echo %JAVA_HOME%
  C:\j2sdk1.4.1_01
  
  C:\&gt;			
  			</source>
  		</section>
  		<section>
  			<title>Compile</title>
  			<p>Navigate to your the location where you unzipped your Xindice sources and run the compile.</p>
  			<note>This example assumes that you unzip the Xindice sources into D:\xindice\current.  If you unzip the sources elsewhere, just substitute that path for D:\xindice\current.</note>
  			<source>
  C:\&gt;d:
  
  D:\&gt;cd xindice\current\xml-xindice
  D:\xindice\current\xml-xindice&gt;dir
   Volume in drive D is Data
   Volume Serial Number is A3EB-9689
  
   Directory of D:\xindice\current\xml-xindice
  
  11/20/2002  08:40p      &lt;DIR&gt;          .
  11/20/2002  08:40p      &lt;DIR&gt;          ..
  10/29/2002  11:59a               1,507 .classpath
  10/29/2002  11:59a                  64 .cvsignore
  10/29/2002  11:59a                 387 .project
  11/18/2002  01:41p      &lt;DIR&gt;          bin
  11/20/2002  10:20a      &lt;DIR&gt;          build
  12/06/2001  10:33a                 864 build.bat
  10/26/2002  05:06p                 431 build.properties.sample
  10/25/2002  01:18a                 753 build.sh
  11/18/2002  01:41p              14,109 build.xml
  11/20/2002  02:43p      &lt;DIR&gt;          classes
  11/18/2002  01:41p      &lt;DIR&gt;          config
  10/25/2002  12:33a                 348 contributor.properties.sample
  10/25/2002  12:33a               2,268 contributor.xml
  11/20/2002  03:51p      &lt;DIR&gt;          CVS
  11/01/2002  03:53p      &lt;DIR&gt;          deploy
  11/18/2002  01:55p      &lt;DIR&gt;          dist
  11/20/2002  03:51p      &lt;DIR&gt;          docs
  11/20/2002  08:40p                  15 fclean.bat
  11/01/2002  01:52p               1,026 forrest.properties
  11/20/2002  03:51p      &lt;DIR&gt;          java
  12/06/2001  11:22a               2,743 LICENSE
  12/06/2001  10:33a                 230 README
  11/18/2002  01:42p      &lt;DIR&gt;          src
  11/01/2002  01:52p               3,668 status.xml
                15 File(s)         28,797 bytes
                12 Dir(s)   6,087,512,064 bytes free
  
  D:\xindice\current\xml-xindice&gt;build
  
  Xindice Build System
  
  Building with classpath C:\j2sdk1.4.1_01\lib\tools.jar;.\java\lib\ant-1.5.1.jar;
  .\java\lib\commons-logging-1.0.1.jar;.\java\lib\infozone-tools.jar;.\java\lib\ja
  karta-oro-2.0.6.jar;.\java\lib\junit-3.8.1.jar;.\java\lib\junit-addons-1.1.jar;.
  \java\lib\junitperf-1.8.jar;.\java\lib\servlet.jar;.\java\lib\xalan-2.4.0.jar;.\
  java\lib\xercesImpl-2.1.0.jar;.\java\lib\xindice.jar;.\java\lib\xml-apis-1.0b3.j
  ar;.\java\lib\xmldb-api-20021118.jar;.\java\lib\xmldb-api-sdk-20021118.jar;.\jav
  a\lib\xmldb-xupdate.jar;.\java\lib\xmlrpc-1.1.jar
  
  Starting Ant...
  Buildfile: build.xml
  
  init:
  
  src-build:
  
  test-build:
  
  examples-build:
  
  build:
  
  jar-release:
  
  war-release:
  
  examples-release:
  
  release:
  
  BUILD SUCCESSFUL
  Total time: 7 seconds
  
  D:\xindice\current\xml-xindice&gt;            				
              		</source>
  			<note>Your compile will probably show a few more lines reporting that some files were compiled.  I omitted those for brevity.</note>
  		</section>
  		<section>
  			<title>Verify the compilation</title>
  			<p>If the compile was succeeded, you will find the output files in the dist\ subdirectory.</p>
  			<source>
  D:\xindice\current\xml-xindice&gt;dir dist
   Volume in drive D is Data
   Volume Serial Number is A3EB-9689
  
   Directory of D:\xindice\current\xml-xindice\dist
  
  11/18/2002  01:55p      &lt;DIR&gt;          .
  11/18/2002  01:55p      &lt;DIR&gt;          ..
  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,090,211,328 bytes free
  
  D:\xindice\current\xml-xindice&gt;            				
              		</source>
  		</section>	
  		<section>
  			<title>Feedback</title>
  			<p>If you run into problems, don't worry.  Be sure to send <link href="../../../mail.html">feedback</link> so that we can improve these documents for the next person.</p>
  		</section>
  	</steps>
  </howto>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/installation/book.xml
  
  Index: book.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "http://localhost/forrest/dtd/book-cocoon-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:51 $
    - Author: Vladimir R. Bossicard (vladimir@apache.org)
    -->
  <book software="Xindice" title="Xindice installation HOWTOs" copyright="2002 The Apache Foundation" xmlns:xlink="http://www.w3.org/1999/xlink">
  	<menu label="How-Tos">
  		<menu-item label="Index" href="../index.html"/>
  	</menu>
  	<menu label="Installation How-Tos">
  	<!--
  		<menu-item label="Introduction" href="index.html"/>
  		-->
  		<menu-item label="Tomcat" href="tomcat.html"/>
  	</menu>
  </book>
  
  
  
  1.1                  xml-xindice/src/documentation/content/xdocs/community/howto/installation/tomcat.xml
  
  Index: tomcat.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "http://localhost/forrest/dtd/howto-v10.dtd">
  <!--
    - Version: $Revision: 1.1 $ $Date: 2002/11/21 22:39:51 $
      -->
  <howto>
  	<header>
  		<title>Xindice Tomcat How-To</title>
  		<version>1.0</version>
  		<authors>
  			<person name="Dave Viner" email="dviner@apache.org"/>
  		</authors>
  		<last-modified-content-date date="2002-11-21"/>
  	</header>
  	<audience title="Intended audience">
  		<p>This How-to is aimed at developers or administrators who want to install Xindice with Tomcat.</p>
  	</audience>
  	<prerequisites title="Prerequisites">
  		<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 <link href="../compilation/index.html">Xindice</link>.</li>
  			<li>You must have an existing installation of Tomcat.  You should use version 4.1.12 or higher. You can install <fork href="http://jakarta.apache.org/tomcat/">Tomcat</fork> 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>
  		</ul>
  	</prerequisites>
  	<steps title="Steps">
  		<section>
  			<title>Copy the war file</title>
  			<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>
  			<source>
  D:\xindice\current\xml-xindice&gt;dir dist
   Volume in drive D is Data
   Volume Serial Number is A3EB-9689
  
   Directory of D:\xindice\current\xml-xindice\dist
  
  11/18/2002  01:55p      &lt;DIR&gt;          .
  11/18/2002  01:55p      &lt;DIR&gt;          ..
  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
  
  D:\xindice\current\xml-xindice&gt;copy dist\xindice-1.1b.war %CATALINA_HOME%\webapp
  s\
          1 file(s) copied.
  
  D:\xindice\current\xml-xindice&gt;
  			</source>
  			<note>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.</note>
  			<fixme author="dviner">Need some unix examples here.</fixme>
  		</section>
  		<section>
  			<title>Restart Tomcat</title>
  			<p>Restart your Tomcat server to be certain that it picks up the Xindice servlet.</p>
  			<p>Here's what that looks like in Windows</p>
  			<source>
  D:\xindice\current\xml-xindice&gt;cd %CATALINA_HOME%\bin
  
  D:\jakarta-tomcat-4.1.12\bin&gt;startup
  Using CATALINA_BASE:   D:\jakarta-tomcat-4.1.12
  Using CATALINA_HOME:   D:\jakarta-tomcat-4.1.12
  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&gt;
  			</source>
  			<note>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.</note>
  			<fixme author="dviner">Need some unix examples here.</fixme>
  		</section>
  		<section>
  			<title>Verify the installation</title>
  			<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>
  			<source>
  Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry loadRegistry
  INFO: Loading registry information
  Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry getRegistry
  INFO: Creating new Registry instance
  Nov 21, 2002 1:42:08 PM org.apache.commons.modeler.Registry getServer
  INFO: Creating MBeanServer
  Nov 21, 2002 1:42:09 PM org.apache.coyote.http11.Http11Protocol init
  INFO: Initializing Coyote HTTP/1.1 on port 8080
  Starting service Tomcat-Standalone 
  Apache Tomcat/4.1.12
  Nov 21, 2002 1:42:21 PM org.apache.xindice.core.Database setConfig
  INFO: Database points to D:\jakarta-tomcat-4.1.12\bin\.\db
  Nov 21, 2002 1:42:23 PM org.apache.xindice.server.XindiceServlet init
  INFO: Database successfully started
  Nov 21, 2002 1:42:24 PM org.apache.coyote.http11.Http11Protocol start
  INFO: Starting Coyote HTTP/1.1 on port 8080
  Nov 21, 2002 1:42:24 PM org.apache.jk.common.ChannelSocket init
  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
  			</source>
  			<fixme author="dviner">Need some unix examples here.</fixme>
  			<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>
  		</section>		
  		<p>If you run into problems, don't worry.  Be sure to send <link href="../../../mail.html">feedback</link> so that we can improve these documents for the next person.</p>
  	</steps>
  </howto>