Adding JMCR-Stable version
[Benchmarks_CSolver.git] / JMCR-Stable / mcr-test / WWW / Doc / User / installation.html
diff --git a/JMCR-Stable/mcr-test/WWW/Doc/User/installation.html b/JMCR-Stable/mcr-test/WWW/Doc/User/installation.html
new file mode 100644 (file)
index 0000000..43e4c51
--- /dev/null
@@ -0,0 +1,221 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"\r
+                      "http://www.w3.org/TR/REC-html40/loose.dtd">\r
+<html>\r
+<head>\r
+  <link rel="stylesheet" type="text/css" href="../style/doc.css">\r
+  <title>Jigsaw installation procedure</title>\r
+  <meta http-equiv="Content-Type" content="text/html">\r
+</head>\r
+\r
+<body>\r
+\r
+<div class="icons-w3c">\r
+<a href="../../../"><img src="/Icons/w3c_home" border="0" alt="W3C logo"\r
+height="48" width="72"></a></div>\r
+\r
+<div class="icons-jigsaw">\r
+<a href="../../"><img src="/Icons/jigsaw" border="0" alt="Jigsaw" height="49"\r
+width="212"></a></div>\r
+\r
+<div class="title">\r
+<h1 class="title">Jigsaw<br>\r
+<span class="subtitle">Installation Procedure</span></h1>\r
+<hr noshade="noshade" width="70%" align="left">\r
+<a href="../../Overview.html">Jigsaw Home</a> / <a\r
+href="../Overview.html">Documentation Overview</a></div>\r
+\r
+<div class="body">\r
+<h1>Prerequisite:</h1>\r
+\r
+<p>Before reading further make sure:</p>\r
+<ul>\r
+  <li>That you have downloaded the latest <b>Jigsaw</b> distribution (2.0.5,\r
+    or 2.1.1 for the experimental version)</li>\r
+  <li>That you have downloaded any implementation of <b>Java</b> for your\r
+    platform (JDK1.1.x or JDK1.2, for Jigsaw 2.1.0 and up, jdk1.2 is\r
+    mandatory. Jdk1.2 is also needed to use the <a href="JigAdmin/">fancy\r
+    administration</a> interface)</li>\r
+  <li>If you're using the zip distribution, make sure it's at least version\r
+    6.x</li>\r
+</ul>\r
+\r
+<p>This document describes how to install <b>Jigsaw</b>. As an example, we are\r
+assuming that you are running either on Windows (be it 95 or NT) or on UNIX,\r
+even though <b>Jigsaw</b> will (should ?) run on <i>any</i> platform that\r
+supports <b>Java</b>.</p>\r
+\r
+<p>The installation process involves the following steps:</p>\r
+<ul>\r
+  <li><a href="#unpack">Unpack the distribution file</a></li>\r
+  <li><a href="#env">Set up some environment variables</a></li>\r
+  <li><a href="#install">Build the right property files</a></li>\r
+  <li><a href="#run">Run <b>Jigsaw</b></a></li>\r
+</ul>\r
+\r
+<h1><a name="unpack"></a>Unpacking the distribution file</h1>\r
+\r
+<p>Pick a place to unpack the distribution: we'll call this directory the\r
+<i>installation directory</i> (abreviated as <i>INSTDIR</i>). This can be any\r
+directory, you just have to change your current working directory to it:</p>\r
+\r
+<div class="box">\r
+<pre>UNIX : cd <i>INSTDIR</i>\r
+<i></i>\r
+Windows : cd <i>INSTDIR</i></pre>\r
+</div>\r
+\r
+<p>Now unpack the file:</p>\r
+\r
+<div class="box">\r
+<pre>UNIX : cat jigsaw.tar.gz | gzip -d | tar xomvf -\r
+\r
+Windows : unzip jigsaw.zip</pre>\r
+</div>\r
+\r
+<p>This will create a number of directories under the <b>Jigsaw</b>\r
+directory:</p>\r
+<dl>\r
+  <dt><tt>Jigsaw/src</tt></dt>\r
+    <dd>Contains <b>Jigsaw</b> sources.</dd>\r
+  <dt><tt>Jigsaw/classes</tt></dt>\r
+    <dd>Contains the pre-compiled classes.</dd>\r
+  <dt><tt>Jigsaw/lib</tt></dt>\r
+    <dd>Contains some native code support for solaris.</dd>\r
+  <dt><tt>Jigsaw/Jigsaw</tt></dt>\r
+    <dd>Is a sample root directory to run the server in. This directory in\r
+      turns contain the following sub-directories:\r
+      <dl>\r
+        <dt><tt>Jigsaw/Jigsaw/config</tt></dt>\r
+          <dd>Is the configuration directory for the server</dd>\r
+        <dt><tt>Jigsaw/Jigsaw/configadm</tt></dt>\r
+          <dd>Is the configuration directory for the administration\r
+          server.</dd>\r
+        <dt><tt>Jigsaw/Jigsaw/logs</tt></dt>\r
+          <dd>Is the normal directory for log files</dd>\r
+        <dt><tt>Jigsaw/Jigsaw/bin</tt></dt>\r
+          <dd>Contains some shell scripts to help you start\r
+          <b>Jigsaw</b>.</dd>\r
+        <dt><tt>Jigsaw/Jigsaw/cache</tt></dt>\r
+          <dd>The directory to use for caching when using <b>Jigsaw</b> as a\r
+            caching proxy.</dd>\r
+        <dt><tt>Jigsaw/Jigsaw/WWW</tt></dt>\r
+          <dd>Is your exported file space</dd>\r
+      </dl>\r
+    </dd>\r
+</dl>\r
+\r
+<p>You are now ready for the next section, which explains how to setup your\r
+environment.</p>\r
+\r
+<h1><a name="env"></a>Setting up your environment</h1>\r
+\r
+<p>As <b>Jigsaw</b> is just a set of Java classes, you need to specify to the\r
+Java interpreter the place where <b>Jigsaw</b> classes are stored. This is\r
+usually done by setting some CLASSPATH environment variable. This is simply\r
+done by the following command for <strong>2.1.0 </strong>and up:</p>\r
+\r
+<div class="box">\r
+<pre> UNIX\r
+            # This depends on the shell you are using, we're assuming <tt>/bin/sh</tt>\r
+            CLASSPATH=<i>INSTDIR</i>/Jigsaw/classes/jigsaw.jar:<i>INSTDIR</i>/Jigsaw/classes/sax.jar:<i>INSTDIR</i>/Jigsaw/classes/xp.jar:.\r
+            export CLASSPATH\r
+\r
+\r
+ Windows\r
+            set CLASSPATH=<i>INSTDIR</i>\Jigsaw\classes\jigsaw.jar;<i>INSTDIR</i>\Jigsaw\classes\sax.jar;<i>INSTDIR</i>\Jigsaw\classes\xp.jar;.</pre>\r
+</div>\r
+\r
+<p>And this one for version up to <strong>2.0.x</strong>:</p>\r
+\r
+<div class="box">\r
+<pre> UNIX\r
+            # This depends on the shell you are using, we're assuming <tt>/bin/sh</tt>\r
+            CLASSPATH=<i>INSTDIR</i>/Jigsaw/classes/jigsaw.zip:INSTDIR/Jigsaw/classes/servlet.jar.\r
+            export CLASSPATH\r
+\r
+\r
+ Windows\r
+            set CLASSPATH=<i>INSTDIR</i>\Jigsaw\classes\jigsaw.zip;INSTDIR\Jigsaw\classes\servletjar.</pre>\r
+</div>\r
+\r
+<p>Don't forget to change <i>INSTDIR</i> with the absolute path of the place\r
+you have unpacked the distribution. You should now be ready to run\r
+<b>Jigsaw</b>.</p>\r
+\r
+<p><b>Warning</b>: on some Windows Java implementation, prefixing the\r
+CLASSPATH with the disk drive letter may cause some confusion. If java\r
+complains about not being able to find some class, you may want to remove the\r
+disk drive letter from the CLASSPATH. Note also that if you are adding this\r
+line in a batch file, you must escape the '\' the line will be: <tt>set\r
+CLASSPATH=<i>INSTDIR</i>\\Jigsaw\\classes\\jigsaw.zip</tt></p>\r
+\r
+<h1><a name="install"></a>Build the right property files</h1>\r
+\r
+<p>Be careful to have the right CLASSPATH (see above):</p>\r
+\r
+<div class="box">\r
+<pre> UNIX \r
+         cd <i>INSTDIR</i>/Jigsaw/Jigsaw\r
+         java Install\r
+\r
+\r
+ Windows  \r
+         cd <i>INSTDIR</i>\Jigsaw\Jigsaw\r
+         java Install</pre>\r
+</div>\r
+\r
+<h1><a name="run"></a>Running <b>Jigsaw</b></h1>\r
+\r
+<p>You are now all set to run <b>Jigsaw</b>. Just type in the following\r
+command:</p>\r
+\r
+<div class="box">\r
+<pre> UNIX  \r
+         cd <i>INSTDIR</i>/Jigsaw/Jigsaw\r
+         java org.w3c.jigsaw.Main -host<i> host</i> -root <i>INSTDIR</i>/Jigsaw/Jigsaw\r
+\r
+Windows  \r
+         cd <i>INSTDIR</i>\Jigsaw\Jigsaw\r
+         java org.w3c.jigsaw.Main -host <i>host</i> -root <i>INSTDIR\</i>Jigsaw\Jigsaw</pre>\r
+</div>\r
+\r
+<p>Don't forget to susbstitute to <i>INSTDIR</i> the absolute path of the\r
+location where you have unpacked the distribution file, and to <i>host</i> the\r
+full IP hostname of the machine running <b>Jigsaw</b>.</p>\r
+\r
+<p><b>Jigsaw</b> should be running, and will probably have emited a message\r
+like:</p>\r
+\r
+<div class="box">\r
+<pre>jigsaw Sample/Jigsaw> java org.w3c.jigsaw.Main\r
+loading properties from: /auto/tarantula/u/tarantula/0/w3c/ylafon/Sample/Jigsaw/config/server.props\r
+Jigsaw[2.0beta1]: serving at http://jigsaw.inria.fr:8007/\r
+*** Warning : no logger specified, not logging.\r
+JigAdmin[2.0beta1]: serving at http://jigsaw.inria.fr:8009/</pre>\r
+</div>\r
+</div>\r
+<!-- body -->\r
+\r
+<div class="footer">\r
+<p></p>\r
+<hr noshade="noshade">\r
+<a href="mailto:jigsaw@w3.org">Jigsaw Team</a><br>\r
+<span class="mini"> $Id: installation.html,v 1.31 2000/03/10 16:42:30 bmahe\r
+Exp $ </span>\r
+\r
+<p class="policyfooter"><font size="-1"><a\r
+href="/Consortium/Legal/ipr-notice.html#Copyright">Copyright</a> © 1999 <a\r
+href="http://www.w3.org">W3C</a> (<a href="http://www.lcs.mit.edu">MIT</a>, <a\r
+href="http://www.inria.fr/">INRIA</a>, <a\r
+href="http://www.keio.ac.jp/">Keio</a> ), All Rights Reserved. W3C <a\r
+href="/Consortium/Legal/ipr-notice.html#Legal Disclaimer"> liability, </a> <a\r
+href="/Consortium/Legal/ipr-notice.html#W3C Trademarks"> trademark </a>, <a\r
+href="/Consortium/Legal/copyright-documents.html"> document use </a> and <a\r
+href="/Consortium/Legal/copyright-software.html"> software licensing </a>\r
+rules apply. Your interactions with this site are in accordance with our <a\r
+href="/Consortium/Legal/privacy-statement.html#Public"> public </a> and <a\r
+href="/Consortium/Legal/privacy-statement.html#Members"> Member </a> privacy\r
+statements.</font></p>\r
+</div>\r
+</body>\r
+</html>\r