web site update new pages for awss beanstalk deployment
[jabaws.git] / website / man_serverwar.html
index dc994bc..ddd7204 100644 (file)
 <div id="page">\r
 <div id="banner">\r
 <table> \r
-<tr><td style="width:130px;"><a href="http://www.dundee.ac.uk"><img src="images/uod_lt.gif"  alt="University of Dundee" class="logo"  title="University of Dundee" longdesc="http://www.dundee.ac.uk"/></a></td>\r
-<td class="bg"><img src="images/jabaws.png" title="JABAWS:MSA" alt="JABAWS:MSA"/></td>\r
-<td class="bg"><img src="images/align.png"/></td>\r
+<tr><td style="width:158px;"><a href="http://www.dundee.ac.uk"><img src="images/uod_lt_long.gif"  alt="University of Dundee" width="158" height="90" class="logo"  title="University of Dundee" longdesc="http://www.dundee.ac.uk"/></a></td>\r
+<td class="bg"><img src="images/jabaws2.png" alt="JABAWS-2.0:Disorder" width="353" height="67" title="JABAWS-2.0:Disorder"/></td>\r
+<td class="bg"><img src="images/banner_right.png" alt="Disorder" width="200" height="80"/></td>\r
 </tr>\r
-</table></div><!-- banner end-->\r
+</table>\r
+</div><!-- banner end-->\r
 \r
 <div id="wrapper">\r
 <div id="panel"><a href="index.html">Home</a> \r
        <div id="submenu">\r
                <a href="man_about.html">About</a>\r
                <a href="man_servervm.html" title="JABAWS Server as Virtual Appliance">Server VA</a>\r
+               <a href="man_awscloud.html" title="JABAWS Server in the Amazon EC2 Cloud">Server in the Cloud</a>\r
                <a class="selected" href="man_serverwar.html" title="JABAWS Server as Web Application aRchive">Server WAR</a>\r
                <a href="man_configuration.html" >Server<br/>\r
                Configuration</a>\r
                <a href="man_client.html" title="JABAWS Command Line Client">CMD Client</a>\r
+               <a href="man_stats.html" title="JABAWS Usage Statistics">Usage Statistics</a>\r
                <a href="man_dev.html" title="Accessing JABAWS from your program">Accessing<br/>\r
                JABAWS</a>      \r
+               <a href="man_server_dev.html" >JABAWS Development</a>\r
        </div>\r
 <a href="download.html">Download</a> \r
+<a href="PublicAnnualStat" title="JABAWS server usage statistics">Usage Statistics</a>\r
+<a href="ServiceStatus" title="JABAWS webservices status">Services Status</a>\r
 <a href="contacts.html">Contact Us</a>\r
-<a href="http://www.compbio.dundee.ac.uk">Barton Group</a> \r
-</div>\r
+<a href="http://www.compbio.dundee.ac.uk" title="University of Dundee, The Barton Group" >Barton Group</a></div>\r
 \r
 <!-- panel end-->\r
 <div id="content">\r
@@ -54,8 +59,7 @@
     programs for your system</a></li>\r
   <li><a href="#haveexec">Reuse the binaries that are\r
     already in your system</a></li>\r
-  <li><a href="#obtainexec">Obtaining alignment\r
-    programs for your operating system</a></li>\r
+  <li><a href="#obtainexec">Obtaining command line binaries </a><a href="#obtainexec">for your operating system</a></li>\r
   <li><a href="#usingWsTester">Testing JABAWS Server</a></li>\r
   <li><a href="#diffcontexts">Running many JABAWS instances on the same server</a> </li>\r
   <li><a href="#nocluster">JABAWS on a single server</a></li>\r
 version 2.4 of the Java Servlet specification, and a Java 6 runtime\r
 environment. We recommend using an official Oracle Java 6 runtime\r
 environment, and <a\r
-href="http://tomcat.apache.org/download-60.cgi">Apache-Tomcat</a> web application server version 6, but other versions may work as well.<br/><span class="attention">Please Note:</span> The JABAWS WAR is not generally compatible with older Mac systems based on the PowerPC architecture, since Java 1.6 is not available to run JABAWS.</p>\r
+href="http://tomcat.apache.org/download-70.cgi">Apache-Tomcat</a> web application server version 7, but older Tomcat versions above 5.5 would work too.<br/>\r
+<span class="attention">Please Note:</span> The JABAWS WAR is not generally compatible with older Mac systems based on the PowerPC architecture, since Java 1.6 is not available to run JABAWS.</p>\r
 \r
-<p>JABAWS Web Application aRchive can run on any host operating system that supports Java 1.6. However JABAWS depends on a number of third party programs which are not available for all operating systems. In particular, only Clustal and Muscle are currently available for MS Windows platform.\r
+<p>JABAWS Web Application aRchive can run on any host operating system that supports Java 1.6. However JABAWS depends on a number of third party programs which are not available for all operating systems. In particular, not all web services are currently available for MS Windows platform.\r
   <!-- todo: link to help about obtaining and installing tomcat -->\r
 </p>\r
-<p>JABAWS comes with pre-compiled MS Windows and Linux IA32 binaries, as well as the source code and build scripts necessary to recompile them.</p>\r
+<p>JABAWS comes with pre-compiled MS Windows and Linux x86 binaries, as well as the source code and build scripts necessary to recompile them.</p>\r
 <p>To run JABAWS on the cluster you must have shared disk space accessible from all cluster nodes. </p>\r
 <h3><a name="instwar" id="instwar"></a>Installing the JABAWS WAR file</h3>\r
 <p>JABAWS is distributed as a web application archive (WAR). To\r
@@ -104,28 +109,13 @@ configuration files</a> so these are used instead.</p>
 \r
 <h3><a name="useprebin" id="useprebin"></a>Using the pre-compiled i386 binaries on Linux</h3>\r
 \r
-<p>Before the binaries that are bundled with JABAWS can be used,\r
-they must first be made executable using the provided <a name=\r
-"setexecflag" id="setexecflag">'setexecflag.sh'</a> script:</p>\r
-\r
-<ol>\r
-<li>cd to <span class=\r
-"hightlight">&lt;webapplicationpath&gt;/binaries/src</span></li>\r
-\r
-<li>run <span class="hightlight">sh setexecflag.sh</span></li>\r
-\r
-<li>Make sure binaries supplied work under your OS.<br />\r
- For this run each binary, without any command line options or\r
+<p>JABAWS comes with pre-compiled x86 Linux binaries, thus on such systems JABAWS should work straight out of the box. If you are in any doubts or experience problems you may want to make sure that the binaries supplied work under your OS. To do this just execute each binary, without any command line options or\r
 input files. If you see an error message complaining about missing\r
 libraries or other problems, then you probably need to <a href=\r
-"#recompbinaries">recompile the binaries</a>.</li>\r
-\r
-<li>Restart the Tomcat.</li>\r
-</ol>\r
+"#recompbinaries">recompile the binaries</a>.</p>\r
 \r
-That's it! JABAWS should work at this point. Try it out using the JABAWS<a\r
-href="#usingWsTester"> test client</a>. If not,\r
-read on... or have a look at <a href="http://tomcat.apache.org/tomcat-6.0-doc/deployer-howto.html">deploying on Tomcat</a> tips.<br />\r
+You can try the JABAWS functionality with the JABAWS<a\r
+href="#usingWsTester"> test client</a>  or have a look at <a href="http://tomcat.apache.org/tomcat-6.0-doc/deployer-howto.html">deploying on Tomcat</a> tips if you experience any problems.<br />\r
  <em>Note: You may want to enable logging, <a href="man_configuration.html#logfiles"> as described here</a></em>.<br />\r
  \r
 \r
@@ -182,8 +172,7 @@ Then the default configuration will work for you. More information
 about <span class="hightlight">the\r
 Executable.properties</span> file is given in the <a href="man_configuration.html#exec">JABAWS Configuration chapter.</a></p>\r
 \r
-<h3><a name="obtainexec" id="obtainexec">Obtaining alignment\r
-programs for your operating system</a></h3>\r
+<h3><a name="obtainexec" id="obtainexec">Obtaining command line binaries for your operating system</a></h3>\r
 \r
 <p>You could search for pre-packaged compiled executable in your\r
 system package repository or alternately, download pre-compiled\r
@@ -192,14 +181,17 @@ replace the executables supplied with the downloaded ones, or
 modify the paths in <span class=\r
 "hightlight">executable.properties</span> as described above. Below are some suggestions on where you may be able to get the binaries for your system. </p>\r
 <ul>\r
+  <li><a href="http://www.clustal.org/omega/#Download">Clustal Omega </a></li>\r
   <li><a href="ftp://ftp.ebi.ac.uk/pub/software/clustalw2/2.0.12/">ClustalW</a></li>\r
   <li><a href="http://mafft.cbrc.jp/alignment/software/">Mafft</a></li>\r
   <li><a href="http://www.drive5.com/muscle/download3.6.html">Muscle</a></li>\r
   <li><a href="http://www.tcoffee.org/Packages/Binaries/">Tcoffee</a></li>\r
-  <li>Probcons (Linux <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/linuxI386/probcons/">I386</a> | <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/linuxAMD64/probcons/">AMD64</a>)</li>\r
+  <li>Probcons (Linux <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/linux_x86/probcons">x86</a> | <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/linux_x64/probcons">x64</a> | <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/mac/probcons">Mac</a>)</li>\r
+  <li>IUPred (Linux <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/linux_x86/iupred">x86</a> | <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/linux_x64/iupred">x64</a> | <a href="http://www.compbio.dundee.ac.uk/jabaws/archive/binaries/mac/iupred">Mac</a>)</li>\r
 </ul>\r
 <h3><a name="usingWsTester" id="usingWsTester"></a>Testing JABAWS Server </h3>\r
-<p>First of all make sure that Tomcat server is started successfully. If this was the case, then you should see JABAWS home page when you navigate to your Tomcat JABAWS context path e.g. <span class="code">http://myhost.compbio.ac.uk:8080/jabaws</span>If you see it, then it is time to make sure that web services are working too. Assuming that you have unpacked/deployed JABAWS from the server war file, you should be able to navigate to the test program which can be found in &lt;webapplicationpath&gt;/WEB-INF/lib/jabaws-client.jar file. To run the tests type:<span class="code"> java -jar jabaws-client.jar -h=&lt;Your web application server host name, port and JABAWS context path&gt;</span></p>\r
+<p>First of all make sure that Tomcat server is started successfully. If this was the case, then you should see JABAWS home page when you navigate to your Tomcat JABAWS context path e.g. <span class="code">http://myhost.compbio.ac.uk:8080/jabaws</span>If you see it, then it is time to make sure that web services are working too. The easiest way to do so is to access ServiceStatus web page. </p>\r
+<p>Alternatively, you should be able to use the test program which can be found in &lt;webapplicationpath&gt;/WEB-INF/lib/jabaws-client.jar file. To run the tests type:<span class="code"> java -jar jabaws-client.jar -h=&lt;Your web application server host name, port and JABAWS context path&gt;</span></p>\r
 <p>For example to test all JABAWS web services on host myhost.compbio.ac.uk type: </p>\r
 <p class="code">java -jar jabaws-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws </p>\r
 <p>You can choose a particular web server using -s option like this <span class="code">java -jar jabaws-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=ClustalWS </span>This command line assumes that java executable is in your path and jabaws-client.jar is located in the current directory.</p>\r
@@ -240,7 +232,7 @@ modify the paths in <span class=
 </div>\r
 \r
 <!-- content end-->\r
-<div id="copyright">Last update: 1 April 2011<br />\r
+<div id="copyright">Last update: 16 September 2011<br />\r
  Peter Troshin, Jim Procter and Geoff Barton, The Barton Group, University of\r
 Dundee, UK</div>\r
 </div>\r