- updated server tutorial for version 4.0

html/tutorial/tutorial1/server.html

@@ -47,15 +47,55 @@ div.logic {
 Here is an illustration of the <A href="index.html">Alignment API
     tutorial</a> using the alignment server.</p>
 <small>This tutorial has been designed for the Alignment API version
-  3.0. Actual screendumps may vary since the interface has evolved
-  but the functionalities remain.</small>
+  3.0 and updated for the Alignment API 4.0. Actual screendumps may
+  vary since the interface has evolved but the functionalities remain.</small>
 	
 <h2>Launching the alignment server for the first time</h2>
 
 <p>This tutorial can be used by locally launching an Alignment server
   or by using a publicly available Alignment server. We explain here
   how to install the alignment server.</p>
-	
+<p>
+Installing the Alignment server requires a jdbc-compliant relational
+database. Here we use MySQL. Drivers for Postgres are also available
+from the release.
+</p>
+<p>
+Setting up the server requires to create a database. This is achieved
+through the following instructions:
+<div class="fragment">
+$ sudo /usr/local/mysql/bin/mysqld_safe --user=mysql &
+$ /usr/local/mysql/bin/mysqladmin -u root password <mysqlpassword>
+$ /usr/local/mysql/bin/mysqladmin -u root -h localhost password <mysqlpassword>
+$ /usr/local/mysql/bin/mysql -u root -p<mysqlpassword>
+sql> CREATE DATABASE AServDB;
+sql> GRANT ALL PRIVILEGES ON AServDB.* TO adminAServ@localhost IDENTIFIED BY 'aaa345';
+sql> quit
+</div>
+Of course, it is advised to use different user, password and database name. This can be achieved either:
+<ul>
+<li>by changing values of <tt>DBMSBASE</tt>, <tt>DBMSUSER</tt> and <tt>DBMSPASS</tt> in AlignmentServer and recompiling;</li>
+<li>by passing parameters dbmsbase, dbmsuser and dbmspass to AlignmentServer.</li>
+</ul>
+</p>
+
+<p>
+Once this done, the server can be launched through command line by:
+<div class="fragment">
+$ java -jar lib/alignsvc.jar -H
+</div>
+for a minimal HTML server, or
+<div class="fragment">
+$ java -jar lib/alignsvc.jar -Ddbmsbase=MyDB -Dwndict=../WordNet-3.0/dict -H -W -d 4
+</div>
+for a more complete server with specific database, access to wordnet set, webservices and
+debug.
+The alignment server is then available by HTTP through:
+<center>
+<a href="http://localhost:8089/html/">http://localhost:8089/html/</a>
+</center>
+</p>
+
 <h2>Connecting through the server with an HTTP client</h2>
 	
 <p>Once the server has been installed, it can be accessed using
@@ -82,7 +122,7 @@ You can browse in these menus to see what is available.</p>
 	
 <p>Your first matching task can be achieved by selecting the "Match
   ontology" button in the user menu:
-<center><img src="server/matching1.png" /></center>
+<center><img src="server/match1.png" /></center>
 As most of the tasks through the Alignment server, it provides a
 result under that form:
 <center><img src="server/result1.png" /></center>
@@ -144,9 +184,23 @@ Trimming, as most operations in the server, generate a new alignment:
 <div class="logic"><p><b>More work:</b> There is another switch (<tt>-T</tt>) in Procalign that specifies the way a threshold is applied (hard|perc|prop|best|span) the default being "hard". The curious reader can apply these and see the difference in results. How they work is explained in the Alignment <abbr>API</abbr> documentation.</p></div>
 
 <p><b>Other manipulations:</b> It is possible to invert an alignment
-  by using the </p>
+  by using the invert button of the main menu or the one provided
+  directly after results. This provides the following interface:</p>
 <center><img src="server/invert1.png" /></center>
 	
+<h2>Searching alignments</h2>
+	
+<p>The list of alignments available from the server can by obtained
+  from the main menu and gives:
+<center><img src="server/list1.png" /></center>
+It is also possible to look for alignments between specific ontologies
+through the Find button of the main menu. This present the following
+interface:
+<center><img src="server/find1.png" /></center>
+which returns the following result:
+<center><img src="server/list2.png" /></center>
+</p>
+
 <h2>Output</h2>
 	
 <p>From the server, it is possible to generate all the formats
@@ -166,18 +220,26 @@ Or in XSLT:
 <center><img src="server/format3.png" width="100%" /></center>
 </p>
 	
-<h2>Evaluating</h2>
+<h2>Loading and storing</h2>
 	
-<p><b>This part is not yet available through the server</b></p>
+<p>
+It is possible to load an alignment available somewhere on the web
+or on a disk through:
+<center><img src="server/load1.png" /></center>
+which returns:
+<center><img src="server/result2.png" width="100%" /></center>
+</p>
+<p>
+An alignment can be stored definitely on the server, i.e., its
+database through the Store button of the main menu which triggers the
+following interface:
+<center><img src="server/store1.png" width="100%" /></center>
+</p>
 
-<h2>Embedding</h2>
+<h2>Evaluating</h2>
 	
-<p>If you want to embed matching solutions in an applications, then
-  you should look at the <a href="index.html">genuine
-  tutorial</a>.</p>
+<p><b>This part is not yet available through the server</b></p>
 
-<p><b>TODO: Explain embedding of a matching system in the alignment server.</b></p>
-	
 <h2>Further exercises</h2>
 	
 <p>More info: <a href="http://alignapi.gforge.inria.fr">http://alignapi.gforge.inria.fr</a></p>
@@ -189,15 +251,11 @@ Planning:
 - Expressive alignment language (with SEKT/Fran篩s Sharffe)
 -->
 	
-<h2>Acknowledgements</h2>
-	
-<p>The format of this tutorial has been shamelessly borrowed from Sean Bechhofer's <a href="http://owl.man.ac.uk/2005/07/sssw/"><acronym>OWL</acronym> tutorial</a>.</p>	
-
 <hr />
 <small>
 <p style="text-align: center;">http://alignapi.gforge.inria.fr/tutorial//tutorial1/server.html</p>
-</small>
 <hr />
-<p>$Id$</p>
+<div>$Id$</div>
+</small>
 </body>
 </html>