Adding JMCR-Stable version
[Benchmarks_CSolver.git] / JMCR-Stable / mcr-test / WWW / Doc / User / AdminTools.html
diff --git a/JMCR-Stable/mcr-test/WWW/Doc/User/AdminTools.html b/JMCR-Stable/mcr-test/WWW/Doc/User/AdminTools.html
new file mode 100644 (file)
index 0000000..172a778
--- /dev/null
@@ -0,0 +1,219 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+<HEAD>\r
+    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">\r
+    <link rel="stylesheet" type="text/css" href="../style/doc.css">\r
+    <TITLE>Jigsaw Administration Tools</TITLE>\r
+<!-- Created with AOLpress/2.0 -->\r
+</HEAD>\r
+<BODY BGCOLOR="#FFFFFF">\r
+    <div class="icons-w3c">\r
+      <a href="../../../">\r
+       <img src="/Icons/w3c_home" \r
+         border="0" \r
+         alt="W3C logo"\r
+         height="48" \r
+         width="72">\r
+      </a>\r
+    </div>\r
+    <div class="icons-jigsaw">\r
+      <a href="../../">\r
+       <img src="/Icons/jigsaw" \r
+         border="0"\r
+         alt="Jigsaw"\r
+         height="49"\r
+         width="212">\r
+      </a>\r
+    </div>\r
+\r
+    <div class="title">\r
+      <H1 class="title">Jigsaw Administration Tools</H1>\r
+      <hr NOSHADE width="70%" align="left">\r
+      <a href="../../Overview.html">Jigsaw Home</a> /\r
+      <a href="../Overview.html">Documentation Overview</a>\r
+    </div>\r
+    <div class="body">\r
+      <p>\r
+    <div class="box">\r
+      <IMG SRC="/Icons/32x32/caution.gif" ALT="WARN !" BORDER=0\r
+       HEIGHT=32 WIDTH=32> \r
+      There is a new <b>JigAdmin</b>, working only with JDK1.2\r
+      (swing), it is more beautiful and user friendly. If there is a\r
+      JDK1.2 available for your platform you should download it and\r
+      run the new JigAdmin. Here is the new \r
+      <a href="JigAdmin/Overview.html">JigAdmin documentation</a>. \r
+    </div>\r
+<p>\r
+There are, since <B>Jigsaw</B> 1.0beta, two different ways of administrating\r
+your server. The first one is the oldest one and is a per-server administration\r
+scheme, using HTML and <A HREF="../../User/Tutorials/configuration.html#global-configuration">form-based\r
+editors</A>.\r
+<BR>The new one is a graphical interface which communicate with an Administration\r
+server, called <B>JigAdmin Server</B>. This server can administer multiple\r
+Jigsaw servers running on the same machine, provided these servers has\r
+been launched at the same time (means by the same java VM), we will call\r
+this graphical interface <B>JigAdmin</B>.\r
+<BR>Since <B>Jigsaw</B> 2.0alpha, the only way of administrating <B>Jigsaw</B>\r
+is <B>JigAdmin</B>.\r
+<P>To use JigAdmin, follow one of these link:\r
+<UL>\r
+<LI>\r
+<A HREF="#running">How to run JigAdmin</A></LI>\r
+\r
+<LI>\r
+<A HREF="#using">How to use JigAdmin</A></LI>\r
+\r
+<LI>\r
+<A HREF="#navigate">How to navigate in the tree browser</A></LI>\r
+\r
+<LI>\r
+<A HREF="#stop-jigsaw">How to stop Jigsaw</A></LI>\r
+</UL>\r
+\r
+<H1>\r
+<A NAME="Running"></A>Running JigAdmin</H1>\r
+\r
+<H2>\r
+JigAdmin Server</H2>\r
+This is very easy in fact. The default configuration files provided both\r
+by the upgrade of an earlier <B>Jigsaw</B> or by the default installation\r
+are designed to start two server, an instance of <B>Jigsaw</B> and one\r
+<B>JigAdmin\r
+Server</B>. The default port of <B>JigAdmin Server</B> is 8009. When you\r
+start the server with:\r
+<P><TT>java org.w3c.jigsaw.Main</TT>\r
+<P>You must see, among the trace,&nbsp; this output:\r
+<P><TT>JigAdmin[2.0beta2]: serving at http://arachne.inria.fr:8009/</TT>\r
+<H2>\r
+JigAdmin Client</H2>\r
+Now that the administration server is running, you can access it with the\r
+following command:\r
+<P><TT>java org.w3c.jigadm.Main [-root root] [url]</TT>\r
+<P>The default root is your current directory, so if you are in the same\r
+directory where you started <B>Jigsaw</B>, you don't need the "-root" option.\r
+<BR>If you are running the administration server on the same machine, using\r
+the default port 8009, you don't need to provide an URL. The URL is the\r
+one of the administration server.\r
+<H1>\r
+<A NAME="Using"></A>Using JigAdmin</H1>\r
+\r
+<H2>\r
+Authentication</H2>\r
+To access the administration server, you need to be authenticated for\r
+obvious reasons.\r
+<BR><IMG SRC="jigadmauth.gif" VSPACE=10 HEIGHT=199 WIDTH=290 ALIGN=BOTTOM alt="authorization in jigadmin">\r
+<BR>The realm used to access the server is "admin", the default user is\r
+"<B>admin</B>" and the default password is also "<B>admin</B>". After the\r
+first authentification, modify the user ot the password or both to avoid\r
+unwanted changes to your server!\r
+<P>Now a new frame should popup and you must see this:\r
+<P><IMG SRC="jigadm1.gif" ALT="jigadm default screen" HEIGHT=119 WIDTH=130>\r
+<P>You are now ready to navigate through the server and configure your\r
+servers!\r
+<H2>\r
+The administration zone</H2>\r
+Expand the first node by clicking on the small icon. You must see something\r
+like this:\r
+<P><IMG SRC="jigadm2.gif" ALT="first node expansion" HEIGHT=133 WIDTH=130>\r
+<P>The "control" resource is used to control the server, the control resource\r
+of "Root" means that it controls the administration server itself.\r
+<P>The "http-server" resource is the first server administrated by <B>JigAdmin\r
+Server</B>. It corresponds to the server with the properties located in\r
+<TT>http-server.props</TT>.\r
+<P>The "realms" resource is used to allow access to the authentification\r
+realms used by the server. The "realms" resource of "Root" allows you to\r
+edit, modify or add new users to access <B>JigAdmin Server</B>.\r
+<H2>\r
+The server zone</H2>\r
+Expand one of the server node (in the default configuration, you will only\r
+have one server to edit: http-server). You must now see something like\r
+this:\r
+<P><IMG SRC="jigadm3.gif" ALT="after expansion of a server node" HEIGHT=171 WIDTH=141>\r
+<P>The "control" resource has the same meaning and same role as in the\r
+administration zone.\r
+<P>The "indexers" resource is used to add, delete or edit the indexers\r
+of the server. Read more about <A HREF="indexers.html">indexers</A> to\r
+understand how to edit them.\r
+<P>The "properties" resource corresponds to the general properties of <B>Jigsaw</B>.\r
+It correspond to the old <TT>/Admin/Properties</TT> directory of the form\r
+based editor.\r
+<P>The "realms" resource is also the same as in the administration zone.\r
+<P>The "space" resource correspond to the root resource of your server.\r
+Under "space" you will find the resources actually served by <B>Jigsaw</B>.\r
+It is the place to go if you want to add, delete or edit resources, add,\r
+delete or edit filters and so on.\r
+<H2>\r
+<A NAME="navigate"></A>Note on the tree browser</H2>\r
+\r
+<H4>\r
+Navigation helps</H4>\r
+To expand or collapse a node, you must click on the icon.\r
+<BR>To edit a resource, you must click on the label, the label will become\r
+magenta, like this:\r
+<P><IMG SRC="jigadm4.gif" ALT="selected node" HEIGHT=176 WIDTH=172>\r
+<P>The menu "Admin-Server" has the following capabilities:\r
+<UL>\r
+<LI>\r
+Open - Go to another <B>JigAdmin Server</B></LI>\r
+\r
+<LI>\r
+Open in new window - same as open, but in a new window</LI>\r
+\r
+<LI>\r
+Close window</LI>\r
+\r
+<LI>\r
+Exit - close all windows and exit</LI>\r
+</UL>\r
+\r
+<H2>\r
+<A NAME="stop-jigsaw"></A>How to stop Jigsaw</H2>\r
+First of all, <B><U>DO&nbsp;NOT&nbsp;USE&nbsp;Ctrl-c !</U></B>&nbsp; if\r
+you don't want to loose your changes<B>.</B><B></B>\r
+<P>You must stop the http server first, and then the administration server,\r
+for each server select the control node:\r
+<P><IMG SRC="control-http.gif" HSPACE=10 VSPACE=10 HEIGHT=117 WIDTH=163 alt="http controls"><IMG SRC="control-admin.gif" HSPACE=10 VSPACE=10 HEIGHT=115 WIDTH=165 alt="admin controls">\r
+<BR>Then you must see this:\r
+<BR><IMG SRC="control-button.gif" HSPACE=10 VSPACE=10 HEIGHT=326 WIDTH=298 alt="control button">\r
+<BR>For each server click on the <TT>Save</TT> button and then on the <TT>Stop</TT>\r
+button, your configuration in saved and your server stopped.\r
+   </div> <!-- body -->\r
+    <div class="footer">\r
+<P>\r
+<HR noshade>\r
+    <a href="mailto:jigsaw@w3.org">Jigsaw Team</a><br>\r
+    <span class="mini">\r
+      $Id: AdminTools.html,v 1.1 2010/06/15 12:23:03 smhuang Exp $\r
+    </span>\r
+    <p class="policyfooter">\r
+      <font size=-1>\r
+       <a href="/Consortium/Legal/ipr-notice.html#Copyright">Copyright</a>\r
+       &copy; 1999 <a href="http://www.w3.org">W3C</a> \r
+       (<a href="http://www.lcs.mit.edu">MIT</a>, \r
+       <a href="http://www.inria.fr/">INRIA</a>, \r
+       <a href="http://www.keio.ac.jp/">Keio</a> ), \r
+       All Rights Reserved. W3C \r
+       <a href="/Consortium/Legal/ipr-notice.html#Legal Disclaimer">\r
+         liability,\r
+       </a>\r
+       <a href="/Consortium/Legal/ipr-notice.html#W3C Trademarks">\r
+         trademark\r
+       </a>, \r
+       <a href="/Consortium/Legal/copyright-documents.html">\r
+         document use \r
+       </a>\r
+       and\r
+       <a href="/Consortium/Legal/copyright-software.html">\r
+         software licensing\r
+       </a> rules apply. Your interactions with this site are in\r
+       accordance with our \r
+       <a href="/Consortium/Legal/privacy-statement.html#Public">\r
+         public\r
+       </a> and \r
+       <a href="/Consortium/Legal/privacy-statement.html#Members">\r
+         Member\r
+       </a>\r
+       privacy statements.</font>\r
+    </div>\r
+</BODY>\r
+</HTML>\r