<a href="{{ source_url_prefix }}{{ pagename }}{{ suffix }}">{{ _('View page source') }}</a>
{% elif show_source and has_source and sourcename %}
<!-- <a href="{{ pathto('_sources/' + sourcename, true)|e }}" rel="nofollow"> {{ _('View page source') }}</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
{% endif %}
{% endif %}
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
{%- if show_copyright %}
{%- if hasdoc('copyright') %}
{% trans path=pathto('copyright'), copyright=copyright|e %}© <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
.. links
.. _war file content table: advanced.html#jabaws_war_file_content
-.. _dm_javadoc: ../dm_javadoc/index.html
-.. _full_javadoc: ../full_javadoc/index.html
+.. _dm_javadoc: dm_javadoc/index.html
+.. _full_javadoc: full_javadoc/index.html
.. _prog_docs: http://www.compbio.dundee.ac.uk/jabaws/prog_docs/
.. _test JABAWS: advanced.html#testing-the-jabaws-server
.. _deploying on Tomcat tips: war.html
.. links
.. _Git-tracker: https://source.jalview.org/crucible/changelog/jabaws
-.. _Data Model JavaDoc: ../dm_javadoc/index.html
-.. _Complete JavaDoc: ../full_javadoc/index.html
+.. _Data Model JavaDoc: dm_javadoc/index.html
+.. _Complete JavaDoc: full_javadoc/index.html
.. _JavaDoc: http://www.compbio.dundee.ac.uk/jabaws/full_javadoc/index.html
.. _Test Results: http://www.compbio.dundee.ac.uk/user/www-jws2/tests/index.html
.. _TestNG: http://testng.org/doc/index.html
.. _Apache Ant: http://ant.apache.org/
-.. _download page: download.jsp
-.. _JABAWS CLI client: download.jsp#client
+.. _download page: ../download.jsp
+.. _JABAWS CLI client: ../download.jsp#client
.. _first aligning sequences example: develop.html#aligning-sequences
.. _JAX-WS: http://jax-ws.java.net/
.. _WS-I: http://www.ws-i.org/
rm -rf _build
# generating the html pages
make html
-mkdir ../website/docs/v_2_2_0/
-cp -r _build/html/* ../../website/docs/v_2_2_0/
+mkdir ../website/docs/
+cp -r _build/html/* ../../website/docs/
# extra for testing
#mkdir ../../jabaws-2.2-dev/docs
#cp -r _build/html/* ../../jabaws-2.2-dev/docs/
# }
# add the note.
-# Note: Some of the hyper-links found in this pdf might not work properly.
-
# # \begin{sphinxadmonition}{note}{Note:}
-# # Some of the links might not work properly in the pdf version...
+# # Some of the hyper-links found in this pdf might not work properly.
# # \end{sphinxadmonition}
-# cp _build/latex/JABAWS.pdf ../../jabaws-2.2-dev/docs/jabaws_manual.pdf
-# cp _build/latex/JABAWS.pdf ../../website/docs/v_2_2_0/jabaws_manual.pdf
+# cp _build/latex/JABAWS.pdf ../../website/docs/jabaws_manual.pdf
# rm -rf _build
# for multiple versions of this manual we need to implement some solution
The JABAWS Virtual Appliance is a way to run a JABAWS server locally, without the need to connect to the internet or configure JABAWS. What the appliance provides is a 'virtual server machine' (or more simply - *virtual machine* or *VM*), running an installation of the JABAWS Web Application Archive (WAR) on `TurnKey Linux`_ 12.1 (Standlone Tomcat). Once this has started up, it displays a message indicating the IP address of the JABAWS server, allowing any JABAWS client (such as Jalview or the JABAWS command line client) to connect to it.
-You can run the appliance with freely available program such as `VMware Player`_, but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use `VMware OVF`_ tool to prepare JABAWS image for a different virtualization platform e.g. `VirtualBox`_.
+You can run the appliance with freely available program such as `VMware Player`_, but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use `VMware OVF`_ tool to prepare JABAWS image for a different virtualization platform e.g. `VirtualBox`_. `VirtualBox`_ can also use the ``jabaws*.vmdk`` directly as an *existing preconfigured virtual hard disk file*, when creating a new Linux 2.4 / 3.x / 4.x 64-bit VM.
.. note:: The appliance best suits users who would like to use the JABAWS web-services locally. This might be because they do not want to access systems over an internet, or just want to keep their data private. It is also the recommended option for users who want to install JABAWS on Windows, which does not support all the bioinformatics programs that JABAWS can run.
The free `VMware Player`_ can be used to run the JABAWS services from the Windows and Linux host operating systems. `VMware Fusion`_, a commercial VMware product, offers virtual machine support for Mac.
-To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click "Open Virtual Machine" and point the Player to the location of the JABAWS, then choose the ``JABAWS*.vmx`` file to open an appliance.
+To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click "Open Virtual Machine" and point the Player to the location of the JABAWS, then choose the ``jabaws*.vmx`` file to open an appliance.
When you play the machine for the first time the Player might ask you whether "This virtual machine may have been moved or copied.", say that you have copied it. That is all.
.. links
.. _war file content table: advanced.html#jabaws_war_file_content
-.. _dm_javadoc: ../dm_javadoc/index.html
-.. _full_javadoc: ../full_javadoc/index.html
+.. _dm_javadoc: dm_javadoc/index.html
+.. _full_javadoc: full_javadoc/index.html
.. _prog_docs: http://www.compbio.dundee.ac.uk/jabaws/prog_docs/
.. _test JABAWS: advanced.html#testing-the-jabaws-server
.. _deploying on Tomcat tips: war.html
.. links
.. _Git-tracker: https://source.jalview.org/crucible/changelog/jabaws
-.. _Data Model JavaDoc: ../dm_javadoc/index.html
-.. _Complete JavaDoc: ../full_javadoc/index.html
+.. _Data Model JavaDoc: dm_javadoc/index.html
+.. _Complete JavaDoc: full_javadoc/index.html
.. _JavaDoc: http://www.compbio.dundee.ac.uk/jabaws/full_javadoc/index.html
.. _Test Results: http://www.compbio.dundee.ac.uk/user/www-jws2/tests/index.html
.. _TestNG: http://testng.org/doc/index.html
.. _Apache Ant: http://ant.apache.org/
-.. _download page: download.jsp
-.. _JABAWS CLI client: download.jsp#client
+.. _download page: ../download.jsp
+.. _JABAWS CLI client: ../download.jsp#client
.. _first aligning sequences example: develop.html#aligning-sequences
.. _JAX-WS: http://jax-ws.java.net/
.. _WS-I: http://www.ws-i.org/
The JABAWS Virtual Appliance is a way to run a JABAWS server locally, without the need to connect to the internet or configure JABAWS. What the appliance provides is a 'virtual server machine' (or more simply - *virtual machine* or *VM*), running an installation of the JABAWS Web Application Archive (WAR) on `TurnKey Linux`_ 12.1 (Standlone Tomcat). Once this has started up, it displays a message indicating the IP address of the JABAWS server, allowing any JABAWS client (such as Jalview or the JABAWS command line client) to connect to it.
-You can run the appliance with freely available program such as `VMware Player`_, but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use `VMware OVF`_ tool to prepare JABAWS image for a different virtualization platform e.g. `VirtualBox`_.
+You can run the appliance with freely available program such as `VMware Player`_, but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use `VMware OVF`_ tool to prepare JABAWS image for a different virtualization platform e.g. `VirtualBox`_. `VirtualBox`_ can also use the ``jabaws*.vmdk`` directly as an *existing preconfigured virtual hard disk file*, when creating a new Linux 2.4 / 3.x / 4.x 64-bit VM.
.. note:: The appliance best suits users who would like to use the JABAWS web-services locally. This might be because they do not want to access systems over an internet, or just want to keep their data private. It is also the recommended option for users who want to install JABAWS on Windows, which does not support all the bioinformatics programs that JABAWS can run.
The free `VMware Player`_ can be used to run the JABAWS services from the Windows and Linux host operating systems. `VMware Fusion`_, a commercial VMware product, offers virtual machine support for Mac.
-To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click "Open Virtual Machine" and point the Player to the location of the JABAWS, then choose the ``JABAWS*.vmx`` file to open an appliance.
+To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click "Open Virtual Machine" and point the Player to the location of the JABAWS, then choose the ``jabaws*.vmx`` file to open an appliance.
When you play the machine for the first time the Player might ask you whether "This virtual machine may have been moved or copied.", say that you have copied it. That is all.
<!-- <a href="_sources/advanced.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<tr class="row-even"><td>/</td>
<td>help pages, index.html is the starting page</td>
</tr>
-<tr class="row-odd"><td><a class="reference external" href="../dm_javadoc/index.html">dm_javadoc</a></td>
+<tr class="row-odd"><td><a class="reference external" href="dm_javadoc/index.html">dm_javadoc</a></td>
<td>JavaDoc for the JABAWS Data Model</td>
</tr>
-<tr class="row-even"><td><a class="reference external" href="../full_javadoc/index.html">full_javadoc</a></td>
+<tr class="row-even"><td><a class="reference external" href="full_javadoc/index.html">full_javadoc</a></td>
<td>JavaDoc for the complete JABAWS</td>
</tr>
<tr class="row-odd"><td><a class="reference external" href="http://www.compbio.dundee.ac.uk/jabaws/prog_docs/">prog_docs</a></td>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/changelog.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/citations.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/client.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/develop.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
</div>
<div class="section" id="the-api">
<span id="jabaws-api"></span><h2>The API<a class="headerlink" href="#the-api" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference external" href="../dm_javadoc/index.html">Data Model JavaDoc</a> - read this if your are coding against JABA Web Services</p>
-<p><a class="reference external" href="../full_javadoc/index.html">Complete JavaDoc</a> - for developers who want to use JABAWS framework and use Engines and Executables directly</p>
+<p><a class="reference external" href="dm_javadoc/index.html">Data Model JavaDoc</a> - read this if your are coding against JABA Web Services</p>
+<p><a class="reference external" href="full_javadoc/index.html">Complete JavaDoc</a> - for developers who want to use JABAWS framework and use Engines and Executables directly</p>
<hr class="docutils" />
</div>
<div class="section" id="structure-of-the-project">
</tbody>
</table>
<p>Additional utility libraries that this client depend upon is the compbio-util-1.3.jar and compbio-annotation-1.0.jar.</p>
-<p>Please refer to a <a class="reference external" href="../dm_javadoc/index.html">Data Model JavaDoc</a> for a detailed description of each class and its methods.</p>
+<p>Please refer to a <a class="reference external" href="dm_javadoc/index.html">Data Model JavaDoc</a> for a detailed description of each class and its methods.</p>
<hr class="docutils" />
</div>
<div class="section" id="connecting-to-jabaws">
<span id="jabaws-conn-conn"></span><h3>Connecting to JABAWS<a class="headerlink" href="#connecting-to-jabaws" title="Permalink to this headline">¶</a></h3>
-<p>For a complete working example of JABAWS command line client please see compbio.ws.client.Jws2Client class. JABAWS command line client source code is available from the <a class="reference external" href="download.jsp">download page</a>. Please note that for now all the examples are in Java, other languages will follow if there is sufficient demand.</p>
+<p>For a complete working example of JABAWS command line client please see compbio.ws.client.Jws2Client class. JABAWS command line client source code is available from the <a class="reference external" href="../download.jsp">download page</a>. Please note that for now all the examples are in Java, other languages will follow if there is sufficient demand.</p>
<p>Download a binary JABAWS client. Add the client to the class path. The following code excerpt will connect your program to Clustal web service deployed in the University of Dundee.</p>
<div class="highlight-java"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">java.net.URL</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">javax.xml.namespace.QName</span><span class="o">;</span>
</div>
<div class="section" id="a-complete-client-example">
<span id="jabaws-conn-aln-example"></span><h3>A complete client example<a class="headerlink" href="#a-complete-client-example" title="Permalink to this headline">¶</a></h3>
-<p>Finally, a complete example of the program that connects to JABAWS Clustal service and aligns sequences using one of the Clustal web service presets. All you need for this to work is a <a class="reference external" href="download.jsp#client">JABAWS CLI client</a>. Please make sure that the client is in the Java class path before running this example.</p>
+<p>Finally, a complete example of the program that connects to JABAWS Clustal service and aligns sequences using one of the Clustal web service presets. All you need for this to work is a <a class="reference external" href="../download.jsp#client">JABAWS CLI client</a>. Please make sure that the client is in the Java class path before running this example.</p>
<div class="highlight-java"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">java.io.ByteArrayInputStream</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">java.io.FileNotFoundException</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">java.io.IOException</span><span class="o">;</span>
<span class="o">}</span>
</pre></div>
</div>
-<p>For a more detailed description of all available types and their functions please refer to the <a class="reference external" href="../dm_javadoc/index.html">Data Model JavaDoc</a>.</p>
+<p>For a more detailed description of all available types and their functions please refer to the <a class="reference external" href="dm_javadoc/index.html">Data Model JavaDoc</a>.</p>
<hr class="docutils" />
</div>
</div>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/getting_started.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/included_tools.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
--- /dev/null
+Search.setIndex({docnames:["advanced","changelog","citations","client","develop","getting_started","included_tools","index","stats","va","war"],envversion:51,filenames:["advanced.rst","changelog.rst","citations.rst","client.rst","develop.rst","getting_started.rst","included_tools.rst","index.rst","stats.rst","va.rst","war.rst"],objects:{},objnames:{},objtypes:{},terms:{"0_17":0,"168h":8,"16th":7,"1st":7,"2nd":7,"378m":9,"512m":9,"6000m":0,"8cbe486":[1,6],"abstract":4,"boolean":4,"byte":[0,8],"case":[0,4,8,9],"class":[0,4],"default":[0,1,3,4,5,8,9],"enum":4,"export":0,"f\u00e1bio":2,"final":[0,4,5],"function":[0,3,5,7,10],"import":[2,4],"long":[0,4],"new":[0,1,3,5,7,9,10],"public":[4,7,10],"return":[0,1,4],"static":[0,4],"throw":4,"true":[0,4,8,10],"try":[0,10],"void":4,"while":4,Adding:7,DNS:9,For:[0,3,5,7,8,9,10],NOT:0,PBS:10,That:9,The:[0,1,3,5,7,8,9,10],Then:0,There:[0,4,8],These:[0,1,10],Use:4,Using:[0,3],aacon:[1,6],aaconw:[0,3],aamatrix:0,abandon:8,abil:4,abl:[0,1,3,4,8,9,10],about:[0,4,5,9,10],abov:[0,3,4,8,9,10],absolut:0,accept:[4,5,7,8],access:[0,1,3,5,7,9,10],accesslogvalv:0,accomplish:4,accord:0,accordingli:[0,4],account:[0,1,4],achiev:0,acid:[0,1,7],action:3,activ:0,actual:4,add:[4,9,10],added:[0,10],addit:[0,1,4],address:[0,9],adjust:0,admin:[8,9],administr:8,advanc:[7,9],advantag:9,after:[0,4,8,9,10],again:0,against:[4,5],aim:4,alexand:2,alig:1,align:[0,1,2,3,5,7,9,10],all:[0,1,3,4,5,8,9,10],all_cluster_independent_test:4,all_cluster_independent_windows_only_test:4,allow:[0,1,2,3,5,8,9,10],allowlink:8,alon:5,alreadi:[0,10],also:[0,1,3,4,7,8,9],altern:[0,4,5,10],amazon:1,amd64:0,ami:1,amino:[0,1,7],amount:[0,8,9],analog:0,analysi:[0,1,2,5],analyt:[1,7],ani:[0,3,4,5,9,10],annot:4,anonym:0,anoth:[3,4,10],ant:[0,4],antiresourcelock:[8,10],anyon:[4,5],anyth:0,anywher:0,apach:[0,4,5,8,10],aparamet:3,apart:9,api:[1,3,7],app:5,appli:0,applianc:[7,8],applic:[0,1,3,7,9],appreci:0,appropri:[0,4],aptrvrskgplrvgfvsngfgahptglltvalfealqrrqpdlqmhlfatsgddgstlrtrlaqa:4,architectur:[0,5,10],archiv:[4,7,9],arg:4,argument:4,around:4,arraylist:4,artifact:7,ask:9,assum:[0,5,10],asynchron:[0,8],attempt:4,authent:[0,8],auto:9,autogener:0,autom:0,automat:[0,5,8,10],avail:[0,1,3,4,5,7,8,9,10],averag:0,avoid:[0,4,10],awstat:0,backward:1,balanc:7,bar:[3,4],barton:2,base:[0,5,8,9,10],basic:[0,3,4,10],batch:10,bear:9,becaus:[3,4,9],been:[1,3,4,5,8,9],befor:4,being:4,below:[0,1,3,4,5,8,9,10],benefit:7,besid:4,best:[0,9],better:[4,5,10],between:[0,4],bigger:0,bigmem:0,bin:[0,4],binari:[4,5,7,10],bind:0,bioinformat:[0,2,5,9],bit:9,black:0,block:4,boot:[5,9],both:[0,1,3,5,10],bottom:[4,8],boundari:4,box:[0,9],bridg:9,brief:[5,7],browser:[0,5],btr304:2,bug:1,build:[0,7,10],bump:1,bundl:0,busi:0,button:5,bytearrayinputstream:4,calcul:[0,1,7,8,9],call:[0,1,3,4,10],caller:4,can:[0,3,4,5,8,9,10],cancel:[4,8],canceljob:4,cannot:[3,4,9],capac:10,catalina:[0,8,10],caution:4,cengin:0,chang:[0,1,3,4,5,8,9],changelog:7,charact:0,chase:0,check:[0,1,3,5,7,9,10],checker:0,chmod:0,choos:[0,5,9],chosen:0,chunk:4,chunkhold:4,citat:7,cite:2,clariti:3,classnam:0,clean:1,cli:[4,7],click:9,client:[0,1,7,9],client_help:4,clone:4,cloud:1,clustal:[1,3,4,6,8],clustalalignmentutil:4,clustalow:[0,3],clustalw2:0,clustalw:[0,1,3,4,6],clustalwsport:4,clustengin:0,cluster:[4,5,7,8,10],clusterengin:0,code:[0,3,7,10],coffe:[0,1,6],collect:[0,4,5,8],collector:8,color:0,column:8,come:[0,3,4,5,8,10],command:[0,7,9],comment:0,commerci:9,common:0,commun:[1,9],compar:1,compat:[1,4,5,10],compbio:[0,3,4],compil:[4,5,7,10],compilebin:[0,4,5],complain:0,complet:[0,5,7,8,10],compli:4,compliant:[0,3,5,10],complic:5,complil:4,complile_with_debug:4,compon:8,comput:[5,9],concern:5,condor:10,conf:[0,4,8,10],config:0,configur:[1,4,5,7,10],confirm:4,confus:4,connect:[0,5,7,9],conserv:[0,1,2,7],consid:8,consist:[4,5],consol:[3,9],constant:3,constraint:4,construct:4,constructor:4,consult:[8,10],consum:[3,5],contain:[0,1,4,5,8],content:[3,7,10],context:[0,3,5,8,10],contini:4,continu:2,contribut:[4,7],control:[3,4,5],convent:4,copi:[8,9],core:[0,9,10],correctli:0,correspond:0,could:[0,1,3,4,10],couldn:0,coupl:0,cours:9,cpu:[0,9],crawler:8,creat:[0,4,8,9],credenti:9,css:0,current:[0,1,4,5,10],custom:[3,7],customalign:4,customsuit:4,customtest:4,dai:8,daniel:2,darlrafahaqgvdaqrlvfmpklphpqylaryrhadlfldthpynahttasdalwtgcpvlttp:4,data:[0,4,5,9],databas:[0,4,8],datamodel:4,date:[0,3,8,10],deal:[1,9],dealt:10,debian:9,debug:[0,4],dec:7,decid:[0,4],dedic:1,defin:[1,3,4,7,8],definit:0,delet:1,demand:4,depend:[0,4,5,8,10],deploi:[0,4,5,8,9,10],deploy:[0,10],depth:0,describ:[0,4,8,10],descript:[0,1,4,8],descriptor:[0,10],design:[1,4],desktop:5,detail:[0,3,4,7,10],dev2:0,develop:[3,5,7],dhcp:9,did:0,differ:[0,3,4,9,10],directli:[0,4,9],directori:[0,1,4,5,7,10],disabl:[0,4,8],discoveri:4,disembl:[1,6],disemblw:[0,3],disk:[9,10],disord:[0,1,2,5,7],displai:[4,8,9],distribut:[0,1,2,7,9,10],distro:4,divers:1,dm_javadoc:0,doc:4,document:[0,1,3,4,5,10],doe:[0,4,8,9],doesn:5,doi:2,doing:[0,4],done:[0,1,3,4,8],doubt:0,download:[0,1,3,4,5,7],dpaaltalharvdvlrresgvfemdgfaddfgallqalarrhgwlgi:4,drive:9,drmaa:[0,5,10],drop:[1,5,10],due:[1,8],dunde:[0,4,5],durat:4,dure:8,each:[0,1,4,8],eas:1,easi:[4,5],easier:9,easiest:[0,4,5],ec2:1,eclips:4,edit:[0,4,9],edu:3,eight:4,either:[0,3,5],elect:5,elimin:5,elsewher:0,empti:8,enabl:[0,1,5,8,9,10],encod:[0,8,10],encourag:[1,4],end:0,engin:[1,4,7,8,10],ensur:4,enter:[4,5],enumer:4,env:0,environ:[4,7,9,10],environment:4,equal:3,equip:0,error:[0,4,8],especi:0,etc:[0,3,4],evalu:0,even:0,everi:[4,8],everyth:0,exact:0,exactli:[0,3,4],examin:0,exampl:[0,5,7,8,10],excerpt:4,excess:[0,4],exclud:[4,8],exec_nam:0,exectu:4,execut:[1,3,4,5,7,10],executablenam:4,executablenameparamat:0,executionstatist:[0,4],exist:[0,1,9],expand:9,expend:4,experi:[0,10],explanatori:4,explicit:10,explicitli:0,exploit:0,extend:4,extract:1,fail:[0,1,4,10],failur:[4,8],fals:[0,8,10],fasta34:0,fasta:[0,1,3,4],fasta_4_mafft:0,fastalist:4,fastaparttre:3,fastasequ:4,faster:[0,9],fastest:0,fatal:0,favorit:3,favour:1,featur:4,feb:0,februari:8,femdgfaddfgallqalarrhgwlgi:4,few:[0,4,8],field:4,file:[3,5,7,8,9,10],fileinputstream:4,filenam:4,filenotfoundexcept:4,fileoutputstream:4,find:[0,4],fine:[4,9],finish:[4,8],first:[0,4,8,9],five:4,fix:1,flag:[4,10],flexibl:10,folder:[4,9,10],follow:[0,4,8,10],foo:4,foobar:3,foofriend:3,forget:0,format:[3,4],found:[0,4,8,10],four:[1,4],framework:4,free:9,freeli:9,friend:4,friendli:5,from:[0,1,3,5,6,7,8,9,10],full:[0,3,4,5],full_javadoc:0,fulli:[0,1],fund:[0,2],further:[0,2,4,8],furthermor:0,fusion:[5,9],futur:5,gap:4,gapopen:4,gapopenpenalti:4,gcc:0,gener:[0,1,4,8,10],geoffrei:2,get:[0,1,4,7],getargu:4,getbyt:4,getfaarvagslnhhlgldemnvaddaafvakavalasdpaaltalharvdvlrresi:4,getjobstatu:4,getlimit:4,getport:4,getpreset:4,getpresetbynam:4,getresult:4,getrunneropt:4,git:[4,7],gitweb:4,give:10,given:[0,4,5,10],globplot:6,globplotw:[0,3],globu:10,glprob:[1,6],glprobsw:0,gnu:[5,9],going:[0,4],good:[0,5],googl:[1,7],googleanalyt:1,got:0,graphic:5,greater:[0,1],greatli:0,grid:10,gridwai:10,gridwar:0,group:[0,4,5,10],guid:[5,7],h_cpu:0,h_vmem:0,hand:4,handi:[0,3,4],handl:[3,4,10],hard:[4,9],hardwar:5,has:[0,1,3,4,5,8,9,10],hash:0,have:[0,1,4,5,7,8,9,10],health:0,heavi:9,heavili:[0,9],help:[0,1,2,4,5,8,9],here:[0,3,4,7,8,10],hierarchi:4,higher:3,hold:4,holder:4,home:[0,4],host:[0,3,4,9,10],host_and_context:3,hotloop:1,hour:8,how:[0,3,4,5],howev:[0,4,9,10],hptglltvalfealqrrqpdlqmhlfatsgddgstlrtrlaqastlhdvtalghlatakhirhhg:4,html:0,http:[0,3,4,5,9,10],httpcoderesponseservicestatu:0,huge:0,i386:0,idea:0,identif:1,identifi:4,idl:[0,4],idllfdlrgwggggrpevfalrpapvqvnwlaypgtsgapwmdyvlgdafalppalepfysehvl:4,ignor:3,imag:[0,1,9],impati:5,implement:[4,6,10],improv:[1,2],includ:[0,1,3,4,5,7],incompat:1,incomplet:8,incorpor:5,increas:0,independ:[0,3,4,10],index:0,indic:[8,9],individu:[0,8],inf:[0,4,5],influenc:0,info:[0,9],inform:[0,1,3,4,5,8,9,10],infrastructur:5,initi:[0,4,8],input:[0,3,4,8],inputfil:3,inputs:8,insert:4,insid:0,instal:[0,1,4,5,7],instanc:[0,3,4,10],instead:[0,4,5],institut:5,instruct:[3,5],integr:1,interest:5,interfac:[4,5],intern:7,internet:[5,9],interoper:[3,5],interruptedexcept:4,intranet:5,introduc:1,involv:4,ioexcept:4,ipv4:9,ipv6:9,iscancel:8,iscollect:8,isfinish:8,isol:4,issu:[4,7],its:[0,3,4,5,10],itself:0,iupr:6,iupredw:[0,3],jaba:[0,3,4,5,8,10],jabaw:[1,2,3,10],jabaws_serv:0,jabawsadmin1:9,jabawsadmin2:9,jalview:[1,4,7,9],jame:2,jan:8,januari:8,jar:[0,3,4,5],java:[0,2,3,4,5,6,9,10],java_hom:0,java_opt:0,javadoc:[0,4],javascript:0,javax:4,jax:4,jaxb:4,jaxw:4,jdk1:0,jdk:0,jessi:9,job:[1,3,4,5,7,10],jobid:[4,8],jobsout:[0,4],jobstatu:4,jobsubmissionexcept:4,jobtempl:0,jpred:1,jpredalig:1,jpredw:1,jre:0,jronn:[1,6],jronnw:[0,3],jsp:0,jul:7,junit:4,just:[0,3,5,9,10],jvm:[0,4],jws2:0,jws2client:4,keep:[4,9,10],kei:[3,8],keyboard:9,know:[0,4,10],known:[0,5],lab:[0,5,10],languag:[0,3,4,5],laptop:5,larg:[0,5,9],larger:9,last:8,later:[1,4,8],latest:1,latter:0,launch:5,layer:4,ld_library_path:[0,4],least:[0,5],leav:[0,4],length:0,let:[0,3,4,8,9,10],letter:0,level:[0,4],lfldthpynahttasdalwtgcpvlttpgetfaarvagslnhhlgldemnvaddaafvakavala:4,lib:[0,5],librari:[0,1,3,4,5,10],life:4,lightweight:0,like:[0,3,4,5,9],limit:[1,3,4,7,9,10],limitexceededexcept:4,limitsmanag:4,line:[0,7,9],link:[0,4,8],linux:[0,4,5,9,10],list:[0,1,3,4,5,7],littl:[0,4],llnwrrrlcdwraldvlsaqvraavaqgvgavepfaflsedasaaeqlacartraqaiaasvrpl:4,load:[4,7],local:[4,5,7,8,9,10],localengineexecutionlimit:0,localhost:[0,5,8,10],localhost_access_log:0,locat:[0,4,8,9],log4j:0,log:[7,8],logdir:0,login:[8,9],long_test:4,longer:[1,4],look:[0,4,7],lowercas:4,lrgwggggrpevfalrpapvqvnwlaypgtsgapwmdyvlgdafalppalepfysehvlrlqgaf:4,lsf:10,lx24:0,mac:[1,5,9,10],machin:[0,1,3,4,5,9,10],made:[4,8],madeira:2,mafft:[1,3,4,6,7],mafft_binari:0,mafftlimit:0,mafftparamet:0,mafftpreset:0,mafftw:[0,3],mai:[0,4,7,8,9,10],main:[0,4,5,8],make:[0,4,5,8,9,10],man_serverwar:0,manag:10,mani:[0,10],manipul:3,manner:5,manoeuvr:4,manual:[9,10],map:4,marker:4,match:4,matric:0,matrix:4,matter:3,maximum:[0,5,8],maxruntim:8,mayb:8,mean:[0,1,3,4,5,8,9],memori:[0,9,10],mention:4,menu:[0,5,9],messag:[0,9],meta:4,metadata:4,method:[0,1,4,5],mgdttagemavqrglalhq:3,mgdttagemavqrglalhqqrhaeaavllqqasdaapehpgialwlhaledagqaeaaaaytrah:4,might:[0,4,5,9,10],mind:9,minimum:9,minor:1,minut:[4,8],miss:0,mode:4,model:[0,4],modifi:[0,4],monitor:[0,4],month:8,monthli:8,more:[0,1,3,4,5,8,9,10],most:[3,5,8,9],mostli:4,move:9,msa:4,msaprob:[1,6],msaprobsw:0,msaw:4,mtadgprellqlraav:3,mtadgprellqlraavrhrpqdfvawl:3,mtadgprellqlraavrhrpqdfvawlmladaelgmgdttagemavqrglalhpghpeavarlgr:4,mtadgprellqlraavrhrpqdvawlmladaelgmgdttagemavqrglalhpghpeavarlgrv:4,multi:8,multipl:[0,1,2,4,5,7],muscl:[0,6],musclew:[0,3],must:[0,1,10],myhost:[0,3],mylabserv:3,mysql:9,myuni:3,name:[0,3,4,8,9,10],namespac:4,nat:9,nativ:[0,3,4],natur:8,navig:[0,8],necessari:[4,10],necessarili:8,need:[0,3,4,5,8,9,10],net:4,network:9,never:[0,1,8],newer:1,next:[3,4],nine:4,node:[0,10],nofft:3,non:0,none:9,normal:0,noscor:3,note:[3,4,8],noth:[4,9],notic:4,now:[1,3,4],nput:3,nucleotid:0,number:[0,1,4,8,10],object:[1,4],obtain:[4,7],obvious:10,oct:7,octob:5,off:3,offer:[0,1,4,9],offici:10,often:0,older:10,omega:[1,6],onc:[0,4,5,9],one:[0,1,3,4,5,8,9,10],ones:0,onli:[0,3,4,8,9,10],open:[0,3,4,5,7,9],oper:[0,5,9,10],oppos:8,optim:0,option:[0,1,3,4,5,8,9],optionlist:4,oracl:[9,10],order:[0,8],org:[0,4],organ:5,orient:[0,4],other:[0,3,4,5,8,9,10],otherwis:[0,10],our:[0,1,4,7],out:[0,3,4,8,10],output:[0,3,4],outputfil:3,outsid:[0,8,9],outstream:4,over:[3,5,9],overhead:0,overload:10,overview:[0,7],ovf:9,own:[0,3,5],packag:[0,1,3,4,5],page:[0,1,3,4,5,8,9],pam300:4,panel:5,paper:2,parallel:[9,10],paramet:[0,1,3,7],parameterinputfil:3,parser:4,part:[0,3,4,5,8],parti:10,particular:[0,4,8,10],pass:[0,4],password:[8,9],path:[0,1,3,4,5,10],path_to_jar_fil:3,pattern:0,paus:4,pbspro:10,pdf:7,peer:1,per:8,perfectli:10,perform:[0,4,5],period:[1,4,8],pertain:4,peter:[2,8],pipedexecut:4,plai:9,plain:[4,8],platform:[4,9,10],player:[5,9],pleas:[0,3,4,8,9,10],plugin:4,point:[0,3,4,5,8,9,10],port:[0,4],portabl:4,posix:0,possibl:[8,9,10],post:0,power:[0,9],powerpc:10,pqsmarmlavlrevpdsvlwllsgpgeadarlrafahaqgvdaqrlvfmpklphpqylaryrhad:4,pre:[1,4,7,9,10],preconfigur:9,predict:[0,1,5,7],prefer:[0,5,9],prefix:0,prepar:[2,7,9],preprocess:8,present:8,preset:[0,3,7],presetalign:4,presetman:4,presetmanag:4,presetnam:[3,4],press:5,prevent:[0,4,10],previou:4,print:3,println:4,privaci:5,privat:[0,4,5,9,10],privileg:[7,10],prm:3,probabl:0,probcon:[0,6],probconsw:[0,3],problem:[0,4],procedur:[4,10],procerror:8,process:[0,1,3,4,8],procoutput:8,procter:2,produc:[0,8],product:[0,5,9],profil:[0,4],prog_doc:0,program:[0,1,3,5,7,9,10],programmat:3,prohibit:0,project:[1,2,7],prolong:4,proper:1,properti:[0,1,4,8],protein:[0,1,2,5,7],protocol:0,provid:[0,1,3,4,5,9],proxi:4,publicli:[4,5],publish:0,pullexecstatist:4,purpos:0,put:[0,4,10],pvlttpgetfaarvagslnhhlgldemnvaddaafvakavalasdpaaltalharvdvlrresgv:4,qllpeepyitaqllnavaqgvgavepfaflsedasaaesvrplaptrvrskgplrvgfvsngfga:4,qname:4,qpsdtsrvvaeppsrtqcglpeqgvvlccfnnsyklnpqsmarmlavlrevpdsvlwllsgpgea:4,qualifi:4,qualifiednam:4,qualifiedservicenam:4,queer:0,queri:0,quickstart:5,rais:0,ram:[0,9],rang:5,rather:9,read:[0,4,5,10],readfasta:4,readi:5,real:4,reason:0,rebuild:4,rebuilt:4,recent:0,recheck:4,recommend:[0,1,3,4,5,9,10],recompil:[4,7,10],reconfigur:9,record:[1,4,8],redirect:0,reduc:[0,10],refer:[0,4,9],reflect:1,refus:10,regist:4,reject:0,rel:0,relat:[0,4],releas:7,rem465:1,remot:0,remov:[0,10],repeat:0,replac:[0,1,4,8],report:[0,4,7],repositori:[0,4],repres:4,request:[4,7,8,10],requir:[0,1,4,5,9,10],rerun_failed_test:4,reserv:0,reset:4,resid:[0,10],resili:10,resolut:0,resolvehost:0,resourc:[0,4,9],respect:[0,8],respond:0,respons:0,rest:[1,10],restart:[0,8,10],restructuredtext:4,result:[0,4,8],resultnotavailableexcept:4,results:8,retre:3,retriev:[0,4,8],reus:[4,7],review:0,right:10,rlqgafqpsdtsrvvaeppsrtqcglpeqgvvlccfnnsyklnpqsmarmlavlrevpdsvlwl:4,rna:[0,2,7],rnaalifold:6,rnaalifoldw:[0,1],rnastructscoremanag:1,role:8,rolenam:8,ronn:6,root:[4,9,10],rout:9,row:8,rule:0,run:[0,1,3,4,5,8,9,10],run_cluster_dependent_test:4,runner:4,runnerconfig:[4,8],runtest:4,runtim:[8,10],rwtqqrhaeaavllqqasdaapehpgialwlghaledhqllpeepyitaqldvlsaqvraavaqg:4,sai:9,same:[0,3,4,5,8,9,10],satisfi:4,scientif:1,score:1,scoremanag:1,screen:[0,9],screenshot:8,script:[0,3,4,5,10],search:0,second:[4,8],secondari:[0,1,2,7],section:[0,4,8],secur:[1,5],see:[0,3,4,5,8,9],select:5,self:4,semicolon:0,send:[5,10],sensit:5,sent:0,separ:[0,3,10],sequenc:[0,1,2,3,5,7],sequenceannot:4,sequencelist:4,sequenceutil:4,sequenti:4,serial:4,serv:[0,4,10],server:[3,4,7,9,10],server_url:0,servic:[0,1,2,3,5,7,8,9,10],servicenam:[0,3],servicestatu:0,servlet:[1,10],set:[0,3,4,8,9,10],setenv:0,setexecflag:[0,4],setexecutableflag:4,setnativespecif:0,setup:5,setvalu:4,seven:4,sever:[0,1,4,5],sftp:9,sge:0,sge_root:0,sgpgeadarlrafahaqgvdaqrlvfmpklphpqylaryrhadlfldthpynahttasdalwtgc:4,share:10,shell:9,sherstnev:2,ship:5,shot:9,should:[0,1,4,5,8,9,10],show:[3,8],shown:[3,5],side:4,sign:[1,3],signific:0,silent:4,similar:[4,9],similarli:9,simpl:[0,4,5],simplest:8,simpli:[0,4,5,9,10],simplifi:[0,1],sinc:[0,4,5,10],singl:[5,9,10],site:[3,10],six:4,size:[5,7,8],skeletalexecut:4,sleep:4,slightli:5,small:[0,10],smaller:0,soap:[0,3,4,5],softwar:[3,4,5],some:[0,1,4],someth:4,sometim:[4,8,10],soon:8,sourc:[0,3,5,7,10],space:[4,10],special:4,specif:[0,3,4,10],specifi:[0,3,8],speed:[0,4],sphinx:1,split:4,src:[0,4,5],ssh:9,stabil:4,stage:4,stand:5,standalon:9,standard:[0,1,4,8],standlon:9,start:[0,7,8,9],startup:0,stat:8,statist:[0,1,4,7],statpag:[0,4],statu:[0,1,5,7],step:0,still:10,stlhdvtalghlatakhirhhgidllfdlrgwggggrpevfalrpapvqvnwlaypgtsgapwmd:4,stop:1,storag:0,store:[0,4],stori:8,straight:0,straightforward:5,stream:8,string:[1,4],structur:[0,1,2,7],stub:4,subfold:4,submiss:0,submit:[0,4,5,8],substitut:0,successfulli:0,suffici:[4,9,10],suffix:0,suggest:[0,4],suit:[0,4,5,9],suitabl:0,summari:8,sun:[0,4,10],suppli:[0,1,4,10],support:[0,1,3,4,5,9,10],sure:[0,4,8,10],swap:1,symbol:[0,1,8],system:[4,5,7,8,9,10],tabl:[0,8],take:[0,4,9],task:[0,4,5,9,10],tcoffeew:[0,3],tell:0,temp:4,templat:7,temporari:[0,4,8],ten:4,tend:4,termin:0,test:[3,5,7,9,10],testcas:4,testng:4,testoutput:0,testsrc:4,text:[4,8],than:[0,1,4,9,10],thei:[0,4,5,9],them:[0,3,4,5,9,10],thi:[0,1,3,4,5,7,8,9,10],thin:4,third:[4,10],though:4,thread:[0,1,4,10],three:[0,4],through:[4,5],thu:[0,4],thw:0,time:[0,4,8,9],timestamp:8,tip:0,titl:8,tmp:0,togeth:[3,4],tomcat:[0,1,5,7,9,10],tomcat_dir:0,tomcat_root:[0,8],tomcatroot:10,too:[0,5,10],tool:[0,4,5,7,9],top:4,tostr:4,total:8,trace:0,tracker:[4,7],treat:0,trim:3,troshin:2,troubleshoot:7,tune:9,turnkei:[5,9],tvalfealqrrqpdlqmhlfatsgddgstlrtrlaqastlhdvtalghlatakhirhhgidllfd:4,two:[0,1,4,10],txt:[0,4,8],type:[0,4,5],uncom:0,undeploi:10,undeploy:10,under:[0,4,5],underneath:4,uniqu:8,unit:7,univers:[0,4,5],unix:[5,8],unless:9,unlik:[5,9],unpack:[5,9,10],unsupportedruntimeexcept:4,until:[0,4],updat:[0,1,4],upon:[0,4],upper:4,url:[0,3,4,5,9,10],us_intl:9,usag:7,use:[0,1,2,3,4,5,8,9,10],used:[0,1,3,4,9,10],useful:[0,3,4],user:[0,1,5,8,9,10],usernam:8,uses:[0,4,5,9,10],using:[0,3,4,5,8,10],utf:[8,10],util:[0,4],valid:7,valu:[0,3,4],valv:0,variabl:[4,7],variou:0,veri:[0,1,4,5],version:[0,3,5,6,7,8,9,10],vgavepfaflsedasaaeqlacartraqaiaasvrplaptrvrskgplrvgfvsngfgahptgl:4,via:[3,5,9],viennarna:6,view:[4,7],violat:4,virtial:9,virtual:[0,7,8],virtualbox:[1,9],visial:0,visit:5,visual:[1,8],visualis:8,vm_ip:9,vmdk:9,vmware:[1,5,9],vmx:9,vrwtqqrhaeaavllqqasdaapehpgialwlghaledagqaeaaaaaytrahqllpeepyitaq:4,vwmare:9,wai:[0,3,4,5,8,9],wait:[0,4],want:[0,3,4,5,7,9],war:[1,4,7,8,9],warn:0,wast:0,watch:4,web:[0,1,2,3,7,9],webal:0,webapp:[0,5,10],webapplicationpath:0,webmean:9,webservic:[0,4,5],websit:[1,4],weight:4,welcom:3,well:[0,4,5,10],were:[1,4,8,10],what:[0,5,9],whatev:[0,4],when:[0,2,8,9],whenev:4,where:[0,3,4,5,8,9],wherea:0,whether:[4,8,9],which:[0,1,3,4,5,8,9,10],who:[0,4,5,9],whole:[0,8],whose:8,why:0,wide:5,window:[0,4,5,9,10],wish:0,within:[0,1,4,8],without:[0,4,9,10],work:[2,4,5,7,9,10],worldwid:5,would:[0,3,4,5,9],wrap:4,wrapper:4,write:[3,5,7],writeclustalalign:4,written:0,wrongparameterexcept:4,wsbuild:4,wsdl:[4,7],wsimport:[0,4],www:[0,4,10],x86:[0,10],xincgc:0,xml:[0,4,8,10],xms512m:0,xmx1024m:0,xxx:0,xxxlimit:0,xxxparamet:[0,4],xxxpreset:0,yesterdai:3,you:[0,2,3,4,5,7,8,9,10],your:[3,5,7,8,9,10],your_jaba_context_nam:0,your_jabaws_server_url:0,yourself:[0,5],yvlgdafalppalepfysehvlrlqgafqpsdtsrvvaeppsrtqcglpeqgvvlccfnnsykln:4,zip:10},titles:["Advanced Usage","Changelog","Citations","Command Line Client (CLI)","For Developers","Getting Started","Included Tools","Welcome to JABAWS’s documentation!","Usage Statistics","Virtual Appliance (VA)","Web Application Archive (WAR)"],titleterms:{"16th":1,"1st":1,"2nd":1,"function":4,"new":4,"public":5,Adding:4,For:4,The:4,accept:0,access:[4,8],acid:6,advanc:0,align:[4,6],amino:6,analyt:0,api:4,applianc:[5,9],applic:[5,8,10],archiv:[5,10],artifact:4,balanc:0,benefit:5,binari:0,brief:4,build:4,calcul:4,changelog:1,check:4,citat:2,cli:[3,5],client:[3,4,5],cluster:0,code:4,command:[3,4,5],compil:0,complet:4,configur:[0,8,9],connect:4,conserv:6,content:[0,8],custom:4,dec:1,defin:0,detail:8,develop:4,directori:8,disord:6,distribut:[4,5],document:7,engin:0,environ:0,exampl:[3,4],execut:[0,8],file:[0,4],from:4,get:5,googl:0,guid:4,includ:6,instal:[3,9,10],intern:0,jabaw:[0,4,5,7,8,9],jalview:5,job:[0,8],jul:1,limit:0,line:[3,4,5],list:8,load:0,local:0,log:0,mafft:0,mai:1,multipl:6,obtain:0,oct:1,overview:4,paramet:4,pre:0,predict:6,prepar:4,preset:4,privileg:8,program:4,project:4,protein:6,recompil:0,releas:1,request:0,reus:0,rna:6,secondari:6,sequenc:[4,6],server:[0,5,8],servic:4,size:0,sourc:4,start:5,statist:8,statu:4,structur:[4,6],system:0,templat:4,test:[0,4],tomcat:8,tool:6,troubleshoot:10,unit:4,usag:[0,3,8,9,10],valid:0,variabl:0,version:1,view:8,virtual:[5,9],war:[0,5,10],web:[4,5,8,10],welcom:7,work:0,write:4,wsdl:0,your:[0,4]}})
\ No newline at end of file
<!-- <a href="_sources/stats.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
+++ /dev/null
-Advanced Usage
-==============
-
-JABAWS web services are WS-I basic profile compliant, which means they can be accessed using any programming language or system that can utilize standard SOAP web services. The Web Service Definition Language (WSDL) for each service is published on the JABAWS home page, and you can use this to automatically generate service bindings for your program. If you use Java you may wish to use our client package to access JABAWS. This package is based on the autogenerated source code produced by wsimport, which is the Java tool for creating web service bindings. In addition, this offers some additional methods that simplify working with JABAWS. For more information please refer to the data model javadoc.
-
-
-------------
-
-.. _jabaws_wsdl:
-
-Valid WSDL
-----------
-
-**Multiple sequence alignment services**
-
-* ClustalOWS - http://www.compbio.dundee.ac.uk/jabaws/ClustalOWS?wsdl
-* ClustalWS - http://www.compbio.dundee.ac.uk/jabaws/ClustalWS?wsdl
-* MuscleWS - http://www.compbio.dundee.ac.uk/jabaws/MuscleWS?wsdl
-* MafftWS - http://www.compbio.dundee.ac.uk/jabaws/MafftWS?wsdl
-* TcoffeeWS - http://www.compbio.dundee.ac.uk/jabaws/TcoffeeWS?wsdl
-* ProbconsWS - http://www.compbio.dundee.ac.uk/jabaws/ProbconsWS?wsdl
-* MSAprobsWS - http://www.compbio.dundee.ac.uk/jabaws/MSAprobsWS?wsdl
-* GLprobsWS - http://www.compbio.dundee.ac.uk/jabaws/GLprobsWS?wsdl
-
-**Protein disorder prediction services**
-
-* IUPredWS - http://www.compbio.dundee.ac.uk/jabaws/IUPredWS?wsdl
-* GlobPlotWS - http://www.compbio.dundee.ac.uk/jabaws/GlobPlotWS?wsdl
-* DisemblWS - http://www.compbio.dundee.ac.uk/jabaws/DisemblWS?wsdl
-* JronnWS - http://www.compbio.dundee.ac.uk/jabaws/JronnWS?wsdl
-
-**Amino acid conservation service**
-
-* AAConWS - http://www.compbio.dundee.ac.uk/jabaws/AAConWS?wsdl
-
-**RNA Secondary Structure Prediction**
-
-* RNAalifoldWS - http://www.compbio.dundee.ac.uk/jabaws/RNAalifoldWS?wsdl
-
-
-Please replace http://www.compbio.dundee.ac.uk/ with your JABAWS instance host name, and jabaws with your JABAWS context name to access your local version of JABAWS web services. For example http://localhost:8080/jabaws would be a valid URL for the default Apache-Tomcat installation and jabaws.war file deployment.
-
-
-------------
-
-.. _jabaws_config:
-
-JABAWS Configuration
---------------------
-
-There are three parts of the system you can configure. The local and the cluster engines, and the paths to the individual executables for each engine. These settings are stored in configuration files within the web application directory (for an overview, then take a look at the war file content table) [link].
-
-Initially, JABAWS is configured with only the local engine enabled, with job output written to directory called "jobsout" within the web application itself. This means that JABAWS will work out of the box, but may not be suitable for serving a whole lab or a university.
-
-
-------------
-
-.. _jabaws_config_le:
-
-Local Engine Configuration
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The Local execution engine configuration is defined in the properties file ``conf/Engine.local.properties``. The supported configuration settings are:
-
-``engine.local.enable=true`` - enable or disable local engine, valid values true | false
-
-``local.tmp.directory=D:\\clusterengine\\testoutput`` - a directory to use for temporary files storage, optional, defaults to java temporary directory
-
-``engine.local.thread.number=4`` - Number of threads for tasks execution (valid values between 1 and 2x cpu. Where x is a number of cores available in the system). Optional defaults to the number of cores for core number <=4 and number of cores-1 for greater core numbers.
-
-If the local engine going to be heavily loaded (which is often the case if you do not have a cluster) it is a good idea to increase the amount of memory available for the web application server. If you are using Apache-Tomcat, then you can define its memory settings in the JAVA_OPTS environment variable. To specify which JVM to use for Apache-Tomcat, put the full path to the JRE installation in the JAVA_HOME environment variable. (We would recommend using Sun Java Virtual Machine (JVM) in preference to Open JDK). Below is an example of code which can be added to ``<tomcat_dir>/bin/setenv.sh`` script to define which JVM to use and a memory settings for Tomcat server. Tomcat server startup script (``catalina.sh``) will execute ``setenv.sh`` on each server start automatically.
-
-.. code:: bash
-
- export JAVA_HOME=/homes/ws-dev2/jdk1.6.0_17/
- export JAVA_OPTS="-server -Xincgc -Xms512m -Xmx1024m"
-
-
-------------
-
-.. _jabaws_config_ce:
-
-Cluster Engine Configuration
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Supported configuration settings:
-
-``engine.cluster.enable=true`` - enable or disable local engine true | false, defaults to false
-
-``cluster.tmp.directory=/homes/clustengine/testoutput`` - a directory to use for temporary files storage. The value must be an absolute path to the temporary directory. This is required. The value must be different from what is defined for local engine. This directory must be accessible from all cluster nodes.
-
-For the cluster engine to work, the SGE_ROOT and LD_LIBRARY_PATH environment variables have to be defined. They tell the cluster engine where to find DRMAA libraries. These variables should be defined when the web application server starts up, e.g.
-
-.. code:: bash
-
- SGE_ROOT=/gridware/sge
- LD_LIBRARY_PATH=/gridware/sge/lib/lx24-amd64
-
-Finally, do not forget to configure executables for the cluster execution, they may be the same as for the local execution but may be different. Please refer to the executable configuration section for further details.
-
-
-------------
-
-.. _jabaws_config_ec:
-
-Executable Configuration
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-All the executable programs are configured in conf/Executable.properties file. Each executable is configured with a number of options. They are:
-
-.. code:: bash
-
- local.X.bin.windows=<path to executable under windows system, optional>
- local.X.bin=<path to the executable under non-windows system, optional>
- cluster.X.bin=<path to the executable on the cluster, all cluster nodes must see it, optional>
- X.bin.env=<semicolon separated list of environment variables for executable, use hash symbol as name value separator, optional>
- X.--aamatrix.path=<path to the directory containing substitution matrices, optional>
- X.presets.file=<path to the preset configuration file, optional>
- X.parameters.file=<path to the parameters configuration file, optional>
- X.limits.file=<path to the limits configuration file, optional>
- X.cluster.settings=<list of the cluster specific options, optional>
-
-Where X any of the bioinformatics tools available (e.g. clustalw, muscle, mafft, probcons, t-coffee, etc.).
-
-Default JABAWS configuration includes path to local executables to be run by the local engine only, all cluster related settings are commented out, but they are there for you as examples. Cluster engine is disabled by default. To configure executable for cluster execution uncomment the X.cluster settings and change them appropriately.
-
-By default limits are set well in excess of what you may want to offer to the users outside your lab, to make sure that the tasks are never rejected. The default limit is 100000 sequences of 100000 letters on average for all of the JABA web services. You can adjust the limits according to your needs by editing ``conf/settings/<X>Limit.xml`` files.
-After you have completed the editing your configuration may look like this:
-
-.. code:: bash
-
- local.mafft.bin=binaries/mafft
- cluster.mafft.bin=/homes/cengine/mafft
- mafft.bin.env=MAFFT_BINARIES#/homes/cengine/mafft;FASTA_4_MAFFT#/bin/fasta34;
- mafft.--aamatrix.path=binaries/matrices
- mafft.presets.file=conf/settings/MafftPresets.xml
- mafft.parameters.file=conf/settings/MafftParameters.xml
- mafft.limits.file=conf/settings/MafftLimits.xml
- mafft.cluster.settings=-q bigmem.q -l h_cpu=24:00:00 -l h_vmem=6000M -l ram=6000M
-
-Please not that relative paths must only be specified for the files that reside inside web application directory, all other paths must be supplied as absolute!
-
-Furthermore, you should avoid using environment variables within the paths or options - since these will not be evaluated correctly. Instead, please explicitly specify the absolute path to anything normally evaluated from an environment variable at execution time.
-
-If you are using JABAWS to submit jobs to the cluster (with cluster engine enabled), executables must be available from all cluster nodes the task can be sent to, also paths to the executables on the cluster e.g. ``cluster.<exec_name>.bin`` must be absolute.
-
-Executables can be located anywhere in your system, they do not have to reside on the server as long as the web application server can access and execute them.
-
-Cluster settings are treated as a black box, the system will just pass whatever is specified in this line directly to the cluster submission library. This is how DRMAA itself treats this settings. More exactly DRMAA ``JobTemplate.setNativeSpecification()`` function will be called.
-
-For further details and examples of configuration please refer to the ``Executable.properties`` file supplied with JABAWS.
-
-
-------------
-
-.. _jabaws_config_env_exe:
-
-Defining Environment Variables for Executables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-Environment variables can be defined in property
-
-.. code:: bash
-
- x.bin.env
-
-Where x is one of thw executables supported by JABAWS. Several environment variables can be specified in the same line. For example.
-
-.. code:: bash
-
- mafft.bin.env=MAFFT_BINARIES#/homes/cengine/mafft;FASTA_4_MAFFT#/bin/fasta34;
-
-The example above defines two environment variables with names ``MAFFT-BINARIES`` and ``FASTA_4_MAFFT`` and values ``/homes/cengine/mafft and /bin/fasta34`` respectively. Semicolon is used as a separator between different environment variables whereas hash is used as a separator for name and value of the variable.
-
-
-------------
-
-.. _jabaws_config_env_mafft:
-
-Configure JABAWS to Work with Mafft
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-If you use default configuration you do not need to read any further. The default configuration will work for you without any changes, however, if you want to install Mafft yourself then there is a couple of more steps to do.
-
-Mafft executable needs to know the location of other files supplied with Mafft. In addition some Mafft functions depends on the fasta executable, which is not supplied with Mafft, but is a separate package. Mafft needs to know the location of fasta34 executable.
-
-To let Mafft know where the other files from its package are, change the value of MAFFT-BINARIES environment variables. To let Mafft know where is the fasta34 executable set the value of FASTA_4_MAFFT environment variable to point to a location of fasta34 program. The latter can be added to the PATH variable instead. If you are using executables supplied with JABAWS, the path to Mafft binaries would be like ``<relative path to web application directory>/binaries/src/mafft/binaries`` and the path to fasta34 binary would be ``<relative path to web application directory>/binaries/src/fasta34/fasta34``. You can specify the location of Mafft binaries as well as fasta34 program elsewhere by providing an absolute path to them. All these settings are defined in ``conf/Executable.properties`` file.
-
-
-------------
-
-.. _jabaws_config_env_limit:
-
-Limiting the size of the job accepted by JABAWS
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-JABAWS can be configured to reject excessively large tasks. This is useful if you operate JABAWS service for many users. By defining a maximum allowed task size you can provide an even service for all users and prevents waste of resources on the tasks too large to complete successfully. You can define the maximum number of sequences and the maximum average sequence length that JABAWS accepts for each JABA Web Service independently. Furthermore, you can define different limits for different presets of the same web service.
-
-By default limits are disabled. You can enable them by editing ``conf/Executable.properties`` file. You can adjust the limits according to your needs by editing ``conf/settings/<X>Limit.xml`` files.
-
-
-.. _war_precompiled_bin:
-
-Pre-compiled binaries
-~~~~~~~~~~~~~~~~~~~~~
-
-.. danger:: improve this bit
-
-
-Using a different version of the alignment program with JABAWS
-
-JABAWS is supplied with binaries and source code of the executables related to the version it supports. So normally you would not need to install your own executables. However, if you have a different version of an executable (e.g. an alignment program) which you prefer, you could use it as long as it supports all the functions JABAWS executable require. This could be the case with more recent executable. If the options supported by your chosen executable is different from the standard JABAWS executable, then you need to edit ExecutableNameParamaters.xml configuration file.
-
-
-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 input files. If you see an error message complaining about missing libraries or other problems, then you probably need to recompile the binaries [link].
-
-You can try the JABAWS functionality with the JABAWS test client or have a look at deploying on Tomcat [link] tips if you experience any problems.
-
-.. note:: You may want to enable logging, as described here [link].
-
-
-JABAWS's web services use command line programs to do the actual analysis, so it must have access to programs which can be executed on your platform. The native executables bundled with JABAWS for Windows (32-bit) and Linux (i386, 32-bit) should be OK for those systems. The source code for these programs is also provided so you can recompile for your own architecture [link] and exploit any optimizations that your system can provide. Alternately, if you have already got binaries on your system, then you can simply change the paths in JABAWS's configuration files [link] so these are used instead.
-
-------------
-
-.. _war_recompile_bin:
-
-Recompiling binaries for your system
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you have a fully equipped build environment on your (POSIX-like) system, then you should be able to recompile the programs from the source distributions which are included in the JABAWS war file. A script called 'compilebin.sh' is provided to automate this task.
-
-1. In a terminal window, change the working directory to ``binaries/src``
-2. Execute the compilebin.sh script:
-
- .. code:: bash
-
- chmod +x compilebin.sh; compilebin.sh > compilebin.out;
-3. Then run:
-
- .. code:: bash
-
- chmod +x setexecflag.sh; sh setexecflag.sh
-
- If any of the binaries was not recompiled, then a 'file not found' error will be raised.
-
-4. Finally, restart your Tomcat server (or JABAWS application only), and test JABAWS [link] to check that it can use the new binaries.
-
-
-If you couldn't compile everything, then it may be that your system does not have all the tools required for compiling the programs. At the very least check that you have gcc, g++ and make installed in your system. If not install these packages and repeat the compilation steps again. You should also review the compilebin.sh output - which was redirected to compilebin.out, and any errors output to the terminal. Finally, try obtaining the pre compiled binaries [link] for your OS.
-
-
-------------
-
-.. _war_reusing_bin:
-
-Obtaining or reusing binaries
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You could search for pre-packaged compiled executable in your system package repository or alternately, download pre-compiled binaries from each alignment program's home page. Then, either replace the executables supplied with the downloaded ones, or modify the paths defined in ``executable.properties`` as described below.
-.. Below are some suggestions on where you may be able to get the binaries for your system.
-
-If you would like to use the binaries you already have, then you just need to let JABAWS know where they are. To do this, edit: ``conf/Executable.properties``
-
-When specifying paths to executables that already exist on your system, make sure you provide an absolute path, or one relative to the JABAWS directory inside webapps. For example, the default path for clustalw is defined as ``local.clustalw.bin=binaries/src/clustalw/src/clustalw2`` Alternatively, instead of changing ``Executable.properties`` you could also replace the executables bundled with JABAWS with the ones that you have, or make symbolic links to them. Then the default configuration will work for you. More information about the Executable.properties file is given in the JABAWS Configuration page.
-
-
-------------
-
-.. _jabaws_config_lb:
-
-Load balancing
---------------
-
-If your cluster is busy and has significant waiting times, you can achieve a faster response by allowing the server machine to calculate small tasks and then reserve the cluster for bigger jobs. This works especially well if your server is a powerful machine with many CPUs. To do this you need to enable and configure both the cluster and the local engines. Once this is done decide on the maximum size of a task to be run on the server locally. Then, edit "# LocalEngineExecutionLimit #" preset in ``<ServiceName>Limits.xml`` file accordingly. JABAWS server then will balance the load according to the following rule: If the task size is smaller than the maximum task size for local engine, and the local engine has idle threads, then it calculates task locally otherwise it submit the task to the cluster.
-
-
-------------
-
-.. _war_testing:
-
-Testing the JABAWS Server
--------------------------
-
-.. danger:: improve this bit
-
-Access ``<your_JABAWS_server_URL>/ServiceStatus`` to test all web services. Each time you access this URL, all services are tested. For production configuration we recommend prohibiting requests to this URL for non authenticated users to prevent excessive load on the server.
-
-Alternatively, you can use a command line client (part of the client only package) to test your JABAWS installation as described here. If you downloaded a JABAWS server package, you can use ``<your_jaba_context_name>/WEB-INF/lib/jaba-client.jar`` to test JABAWS installation as described here. If you downloaded the source code, then you could run a number of test suites defined in the build.xml Apache Ant file.
-
-
-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 in your browser (e.g. at ``http://myhost.compbio.ac.uk:8080/jabaws`` => ``<jabaws_server>``)
-
-If you see it, then it is time to make sure that web services are working too. The easiest way to do this is to access Services Status page available from the main JABAWS web page menu.
-
-If you need to monitor web service health automatically when the best option is to use service checker that responds with the standard HTTP status code. To access this checker use the following URL:
-
-**Using JABAWS service status checker**
-
-If you see it, then it is time to make sure that web services are working too. The easiest way to do this is to access Services Status page available from the main JABAWS web page menu.
-
-If you need to monitor web service health automatically when the best option is to use service checker that responds with the standard HTTP status code. To access this checker use the following URL: ``<jabaws-server>/HttpCodeResponseServiceStatus`` or alternatively ``<jabaws-server>/man_serverwar.jsp``
-
-This page returns code 200, and no page context if all services are operational, 503 if one of the services have problems. You can also check each web service individually by providing the name of the web service to check at the end of the service checker URL like this: ``<jabaws_server>/HttpCodeResponseServiceStatus/ClustalWS``
-
-
-Upon request, the service status checker will examine the health of the ClustalWS web service only. If the service name is not valid, then the service checker will return code 400.
-
-**Using command line client**
-
-Alternatively, you should be able to use the test program which can be found in ``<webapplicationpath>/WEB-INF/lib/jabaws-client.jar`` file. To run the tests type:
-
-.. code:: bash
-
- java -jar jabaws-client.jar -h=<Your web application server host name, port and JABAWS context path>
-
-For example to test all JABAWS web services on host myhost.compbio.ac.uk type:
-
-.. code:: bash
-
- java -jar jabaws-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws
-
-
-You can choose a particular web server using -s option like this java -jar jabaws-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=ClustalWS This command line assumes that java executable is in your path and jabaws-client.jar is located in the current directory.
-
-An example of the report testing tool produces for operating web service looks like this:
-
-.. code:: bash
-
- Connecting to service MuscleWS on http://myhost.compbio.ac.uk:8080/jabaws ... OK
- Testing alignment with default parameters:
- Queering job status...OK
- Retrieving results...OK
- Testing alignment with presets:
- Aligning with preset 'Protein alignment(Fastest speed)'... OK
- Aligning with preset 'Nucleotide alignment(Fastest speed)'... OK
- Aligning with preset 'Huge alignments (speed-oriented)'... OK
- Queering presets...OK
- Queering Parameters...OK
- Queering Limits...OK
- Queering Local Engine Limits...OK
- Check is completed service MuscleWS IS WORKING
-
-An example of the response of a web service which is deployed but is not operating is below:
-
-.. code:: bash
-
- Connecting to service ProbconsWS on http://localhost:8080/ws ... OK
- Testing alignment with default parameters:FAILED
- Service ProbconsWS IS NOT FUNCTIONAL
-
-
-If the web server did not respond the message looks like following:
-
-.. code:: bash
-
- Connecting to service TcoffeeWS on http://localhost:8080/ws ... FAILED
-
-
-------------
-
-.. _war_logging:
-
-JABAWS internal logging
------------------------
-
-JABAWS can be configured to log what it is doing. This comes in handy if you would like to see who is using your web services or need to chase some problems. JABAWS uses log4j to do the logging, the example of log4j configuration is bundled with JABAWS war file. You will find it in the ``/WEB-INF/classes/log4j.properties`` file. All the lines in this file are commented out. The reason why the logging is disabled by default it simple, log4j has to know the exact location of where the log files are stored. This is not known up until the deployment time. To enable the logging you need to define logDir property in the log4j.properties and uncomment section of the file which corresponds to your need. More information is given in the log4j.properties file itself. Restart the Tomcat or the JABAWS web application to apply the settings.
-
-After you have done this, assuming that you did not change the log4j.properties file yourself, you should see the application log file called activity.log. The file called activity.log. The amount of information logged can be adjusted using different logging levels, it is reduced in the following order of log levels TRACE, DEBUG, INFO, WARN, ERROR, FATAL.
-
-If you would like to know who is using your services, you might want to enable Tomcat request logging.
-
-------------
-
-.. _war_logging_req:
-
-JABAWS requests logging
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Enable Tomcat log valve. To do this uncomment the following section of <tomcat_root>/conf/server.xml configuration file.
-
-.. code-block:: xml
-
- <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
- prefix="localhost_access_log." suffix=".txt" pattern="common" resolveHosts="false"/>
-
-
-The following information will be logged:
-
-+--------------+------------------------------+-------------------------------+---------------+------------------------+
-| Remote IP | Date | Method server_URL protocol | HTTP status | Response size in bytes |
-+==============+==============================+===============================+===============+========================+
-| 10.31.11.159 | [10/Feb/2010:16:51:32 +0000] | "POST /jws2/MafftWS HTTP/1.1" | 200 | 2067 |
-+--------------+------------------------------+-------------------------------+---------------+------------------------+
-
-Which can be processed in various programs for log analysis, such as WebAlizer, Analog, AWStats [links].
-
-
-------------
-
-.. _jabaws_config_ga:
-
-JABAWS and Google Analytics
----------------------------
-
-
-JABAWS reports web services usage to our group Google Analytics (GA) account. JABAWS usage statistics are collected for funding and reporting purposes, and no private information is collected. The data sent by JABAWS is as follows:
-
-1. The IP address of the JABAWS server machine (the server IP can anonymized see ``conf/GA.properties`` config file)
-2. The name of the web service that was called.
-3. A few details of the system such as JABAWS version, java version, user language, color depth, screen resolution and character encoding.
-
-Google Analytics can be disabled or adjusted by removing/editing ``conf/GA.properties`` Google Analytics (GA) settings file. We would appreciate it greatly if you could leave it on!
-
-All calls to GA are very lightweight, completed asynchronously, create very little overhead and do not influence the server response time or performance.
-
-
-------------
-
-.. _war_contents:
-
-JABAWS War File Content
------------------------
-
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Directory | Content description |
-+=====================+==========================================================================================================================================================+
-| conf/ contains | configuration files such as Executable.properties, Engine.local.properties, Engine.cluster.properties |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| conf/settings | Contains individual executable description files. In particular XXXParameters.xml, XXXPresets.xml, XXXLimits.xml where XXX is the name of the executable |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| ExecutionStatistics | The database for storing the execution statistics |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| statpages | Web pages for usage statistics visialization and webservices status queries |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| jobsout/ | Contains directories generated when running an individual executable. E.g. input and output files and some other task related data (optional) |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| binaries/ | Directory contains native executables - programs, windows binaries (optional) |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| binaries/src | Contains source of native executables and Linux i386 binaries |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| binaries/windows | Contains binaries for MS Windows operating system |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| binaries/matrices | Substitution matrices |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| WEB-INF | Web application descriptor |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| WEB-INF/lib | Web application libraries |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| WEB-INF/classes | log4j.properties - log configuration file (optional) |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| static | Static content such as CSS, JavaScript and Image files |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| **Help Pages** | |
-+=====================+==========================================================================================================================================================+
-| / | help pages, index.html is the starting page |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| `dm_javadoc`_ | JavaDoc for the JABAWS Data Model |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| `full_javadoc`_ | JavaDoc for the complete JABAWS |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| `prog_docs`_ | Documentation for programs that are included in JABAWS |
-+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
-
-.. _dm_javadoc: http://www.compbio.dundee.ac.uk/jabaws/dm_javadoc/index.html
-.. _full_javadoc: http://www.compbio.dundee.ac.uk/jabaws/full_javadoc/index.html
-.. _prog_docs: http://www.compbio.dundee.ac.uk/jabaws/prog_docs/
+++ /dev/null
-Changelog
-=========
-
-
-.. _v2.2:
-
-Version 2.2 (Released XX April 2017)
-------------------------------------
-
-The website and documentation were improved:
-
-* `Sphinx`_ is now used to generate our documentation pages.
-* Documentation was updated to reflect the latest changes introduced in the project.
-* Downloading the JABAWS distributions no longer require 'sign in' or 'sign up' to a user account.
-* The pre-configured JABAWS Amazon Machine Image (AMI), which allowed for JABAWS to be run in the Amazon EC2 cloud, is no longer provided due to very limited use by the scientific community peers.
-
-The versions of several application programs provided by JABAWS were bumped to the latest available.
-
-* Clustal Omega was updated to version 1.2.4
-* ClustalW was updated to version 2.1
-* Mafft was updated to version 7.3.10
-* T-Coffee was updated to version 11.00.8cbe486
-* Protein secondary structure prediction with Jpred (version 3.0.3) was dropped from the list of provided services, as the use of the dedicated Jpred REST API (Jpred 4) is encouraged and recommended. This is the version that is currently provided within Jalview 2.9 or later.
-
-.. note:: JABAWS version 2.2 is fully backward compatible with JABAWS v1.0 and v2.0. This means all JABAWS 1.0, 2.0, 2.0.1 and 2.1 clients should also be able to use JABAWS 2.2 services.
-
-
-.. _Sphinx: http://www.sphinx-doc.org/en/stable/
-
-------------
-
-.. _v2.1:
-
-Version 2.1 (Released 1st Oct 2013)
------------------------------------
-
-Several new web services are available in this version of JABAWS:
-
-* Two multiple sequence aligners (MSAprobs and GLprobs), both services return the standard Alignment object
-* RNAalifoldWS returns RNAStructScoreManager, which is the standard ScoreManager objects with several additional methods
-* JpredWS returns the JpredAligment object, which is the standard alignment with additional methods for extracting Jpred predictions. These predictions are supplied as additional sequences in the aligment
-
-Some bugs have been fixed and several improvements have been done:
-
-* WS status servlet returns version and some additional information on each web service
-* a bug with path to help in the client
-* Fix two bug with the Google Analytics library: no-stop due to running thread
-* GoogleAnalytics gets proper JABAWS version
-
-------------
-
-.. _v2.0.1:
-
-Version 2.0.1 (Released 2nd Jul 2013)
--------------------------------------
-
-JABAWS 2.0.1 includes several bug fixes and minor updates for JABAWS Version 2.0. These are listed below:
-
-* Disembl returned swapped strings for HOTLOOPS and REM465
-* Jronn failed to process jobs with more than 3 sequences
-* JABAWS could not deal with FASTA records with '>' symbols in the record identificator
-* Change of parameter description for AAcon: parameters have been replaced with options for calculation methods. This allows a user to get several AAcon's conservation scores in one call
-* JABAWS never cleaned up job directories. Now JABAWS deletes the job directory if it exist longer than a period defined in Engine.properties
-* Default web security has been incompatible with Tomcat 7.0.31 and newer
-* Documentation has been updated
-
-------------
-
-.. _v2.0:
-
-Version 2 (Released 16th Dec 2011)
-----------------------------------
-
-Compared to JABAWS 1, JABAWS 2 offers a greater number and diversity of web services, Amazon EC2 integration and improved ease of use.
-
-It now contains:
-
-* Updates for all multiple sequence alignment services
-* Four new protein disorder prediction services
-* Clustal Omega multiple sequence alignment web service
-* Amino acid conservation service
-* Web services execution statistics visualization
-* Web services status check from a web page
-* VirtualBox support was dropped in favour of VMware
-* New WAR package for Mac users
-* Amazon Machine Image (AMI) distributive to enable users to use JABAWS on the EC2 cloud
-* Improved web services client API
-* Simplified WAR package installation
-
-.. warning:: To access the analysis web services introduced in JABAWS 2.0, clients that were designed for JABAWS v1.0 must be updated.
+++ /dev/null
-
-Citations
-=========
-
-.. Note:: It is important that you cite JABAWS when you use it. Citing us helps us funding the work we do and allow us to continue to improve the project further.
-
-.. _citations:
-
-Peter V. Troshin, James B. Procter and Geoffrey J. Barton - **Java Bioinformatics Analysis Web Services for Multiple Sequence Alignment - JABAWS:MS** Bioinformatics 2011. 27 (14): 2001-2002. doi: `10.1093/bioinformatics/btr304`_
-
-.. _10.1093/bioinformatics/btr304: https://doi.org/10.1093/bioinformatics/btr304
+++ /dev/null
-Command Line Client (CLI)
-=========================
-
-A JABAWS client is a Java application that lets you run the programs for which a JABAWS server provides web services. The most basic JABAWS client is a command line application this is able to call any of the JABAWS web services on any instance of JABAWS Server available over the web. The basic client is useful if you would like to test or execute the programs provided by the JABAWS server in your own scripts, but you do not want to handle any web service specific details. The client is an open source software, so you can also use the source code to as an example how to manipulate with JABAWS web services in your own code. Jalview [link], a multiple sequence alignment and analysis application, is a good example of a graphical JABAWS client. This client uses the same functionality as the JABAWS command line (CLI) client [link], but instead allows JABAWS services to be accessed in a more user-friendly manner, through a graphical user interface.
-
-The command line client comes as a part of client package [link] which you are welcome to download. The command line client can be used to align sequences using any of JABAWS supported web services. The client is OS independent and supports most of the functions which can be accessed programmatically via JABAWS API [link]. Using this client you could align sequences using presets or custom parameters, please see examples of this below. Here is the list of options supported by the command line client.
-
-
-------------
-
-.. _client_installing:
-
-Installing
-----------
-
-.. danger:: update for java
-
-You need Java vX or higher installed in your machine to be able to run the JABAWS CLI client.
-Please see the Java web site [link] for up to date instructions and downloads.
-
-
-------------
-
-.. _cli_usage:
-
-Usage
------
-
-.. code:: bash
-
- java -jar jaba-client.jar
-
-::
-
- Usage:
- java -jar <path_to_jar_file> -h=host_and_context -s=serviceName ACTION [OPTIONS]
- -h=<host_and_context> - a full URL to the JABAWS web server including context path e.g. http://10.31.10.159:8080/ws
- -s=<ServiceName> - one of [MafftWS, MuscleWS, ClustalWS, ClustalOWS, TcoffeeWS, ProbconsWS, AAConWS, JronnWS, DisemblWS, GlobPlotWS, IUPredWS]
-
-
- ACTIONS:
- -i=<inputFile> - full path to fasta formatted sequence file, from which to align sequences
- -parameters - lists parameters supported by web service
- -presets - lists presets supported by web service
- -limits - lists web services limits
- Please note that if input file is specified other actions are ignored
-
-
- OPTIONS: (only for use with -i action):
- -r=<presetName> - name of the preset to use
- -o=<outputFile> - full path to the file where to write an alignment
- -f=<parameterInputFile> - the name of the file with the list of parameters to use.
-
- Please note that -r and -f options cannot be used together. Alignment is done with either preset or aparameters from the file, but not both!
-
-
-------------
-
-.. _cli_example:
-
-Example Usage
--------------
-
-
-Align sequences from input.fasta file using Mafft web service with default settings, print alignment in Clustal format to console.
-
-.. code:: bash
-
- java -jar jabaws-min-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=MafftWS -i=d:\input.fasta
-
-Content of input.fasta file is show below (please note sequences has been trimmed for clarity)
-
-::
-
- >Foobar
- MTADGPRELLQLRAAVRHRPQDFVAWL
- >Bar
- MGDTTAGEMAVQRGLALHQ
- >Foofriend
- MTADGPRELLQLRAAV
-
-Align as in above example, but write output alignment in a file out.clustal, using parameters defined in prm.in file
-
-.. code:: bash
-
- java -jar jabaws-min-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=MafftWS -i=d:\input.fasta -o=d:\out.clustal -f=prm.in
-
-The content of the prm.in file is shown below
-
-::
-
- --nofft
- --noscore
- --fastaparttree
- --retree=10
- --op=2.2
-
-The format of the file is the same for all JABAWS web services. Parameters are specified in exactly the same way as for native executables - alignment programs like Mafft etc. So parameters which you can use with command line version of an alignment program can be used with JABAWS. Most of the settings controlling alignment process are supported, but because any output has to be handled by JABAWS, settings controlling output are not allowed to be changed. For a list of parameters supported by a web service see the next example. In prm.in parameters are separated by the new line, and name of the parameter is separated from its value with an equals sign. This format is constant no matter which JABAWS web service is used.
-
-.. code:: bash
-
- java -jar jabaws-min-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=MafftWS -parameters
-
-The same client can be used to access JABAWS on different hosts. Just point the client to the host you want to use by changing the value of -h key.
-
-For example you used ``-h=http://myhost.compbio.ac.uk:8080/jabaws`` server, now you want to use another server to ``-h=http://mylabserver.myuni.edu``. This comes handy if your favorite server is off and you need to do the job yesterday.
+++ /dev/null
-For Developers
-==============
-
-.. _jabaws_source:
-
-Source Code
------------
-
-.. note:: This is an open source project. If you want to contribute or report an issue have a look at our `Git-tracker`_.
-
-Publicly available Git repository: http://source.jalview.org/gitweb/?p=jabaws.git
-
-.. code:: bash
-
- git clone http://source.jalview.org/git/jabaws.git
-
-
-------------
-
-.. _jabaws_api:
-
-The API
--------
-
-`Data Model JavaDoc`_ - read this if your are coding against JABA Web Services
-
-`Complete JavaDoc`_ - for developers who want to use JABAWS framework and use Engines and Executables directly
-
-
--------------
-
-.. _jabaws_structure:
-
-Structure of the project
-------------------------
-
-| |folder| *binaries* contains native executables e.g. clustalw
-| |folder| *src* contains sources of native executables
-| |folder| *windows* contains pre-compiled Windows binaries
-| |folder| *compilebin.sh* the script to complile binaries
-| |folder| *setexecflag.sh* the script to set executable flag for the binaries
-| |folder| *conf* contains JABAWS configuration files
-| |folder| *ExecutionStatistics* the database for storing collected execution statistics
-| |folder| *jobsout* a default folder for temporary job directories
-| |folder| *statpages* the web pages for execution statistics display
-| |folder| *WEB-INF* default
-| |folder| *website* contains the JABAWS web pages
-| |folder| *archive* contains JABAWS packages, the WAR and JAR files
-| |folder| *datamodel* contains the JABAWS datamodel
-| |folder| *engine* contains the JABAWS engine - the code that abstract the execution environment and executes native binaries
-| |folder| *runner* contains the JABAWS runners - thin wrappers for native binaries
-| |folder| *webservices* contains the JABAWS SOAP web services
-| |folder| *testsrc* contains the JABAWS unit tests
-
-
-------------
-
-.. _jabaws_code:
-
-The code structure
-------------------
-
-.. image:: ../../website/static/img/ws-structure.png
- :height: 414
- :width: 282
- :scale: 95 %
- :align: left
-
-
-Each source folder depends on the upper folders for compilation. For example, the datamodel is the top level folder so it has no other dependencies on other JABAWS code. The Engine level depends on the datamodel to compile etc. The web services folder is the bottom layer and depends on all the other source code.
-
-So the JABAWS project is split into 4 layers. From bottom-up the first layer consists from the value classes used by all other layers of the hierarchy, in particular web services. So, to be able to use JABAWS one needs to have these classes. At the same time classes on this layer does not have any dependencies on the layers above.
-
-The second layer contains code for execution of the wrappers, which are the abstraction describing native executables. JABAWS can execute tasks locally that is on the same machine as JVM and on the cluster. Thus currently code on this layer contain two engines. This layer depends on the layer underneath, the data model layer, but is completely independent from the code above.
-
-The third layer consists of the wrappers for the native executables and classes to handle their configuration. It depends on the engines and the data model, but know nothing about the web services.
-
-Finally, the upper layer contains the web services, that depend on all the layers below.
-
-The layer isolation is archived though specially designed compilation task which is executed sequentially in several stages so that the first layer compiles before any other layers, second layer compiles after that and process continies before all the code is compiled. Any violation of the layer boundaries results in the compilation failure. Use Ant "Compile" or "Complile_with_debug" tasks to perform the staged compilation.
-
-A client package contains only classes from data model layer and a simple web services client. Framework package is for anyone who want to use JABAWS framework for controlling native executables in local or cluster environments. Framework exclude the web services layer. Server package contains all the code.
-
-
-------------
-
-.. _jabaws_tests:
-
-Running tests
--------------
-
-JABAWS uses TestNG [test] framework for testing. The test results for the JABAWS package offered for download can be found at: Test Results [link]
-JABAWS uses TestNG for testing. There is a TestNG plugin available for Eclipse which has functionality similar to JUnit. However, no plugins are necessary to run the test cases, as testng jar is supplied with JABAWS together with an ant tasks to run the test cases.
-
-
-Several testing groups are supported:
-
-* All tests ('Test')
-* Cluster tests ('Run_cluster_dependent_test')
-* Cluster independent tests ('All_cluster_independent_tests')
-* Windows only tests ('All_cluster_independent_windows_only_tests')
-* Performance and stability tests ('Long_tests')
-* Re-run failed tests ('Rerun_failed_tests')
-* Run custom test ('CustomTest')
-
-To run the tests you need to download all sources from repository [link]. Once you have done that, enter into the command line mode, change directory to the project directory and type:
-
-.. code:: bash
-
- ant -f build.xml <test group name>
-
-
-Make sure you have Apache Ant [link] installed and path to ant executable is defined in your path environmental variable. Replace test group name with the one of the names given in the list above to run required group of tests e.g for running cluster only tests use the following command:
-
-.. code:: bash
-
- ant -f build.xml Run_cluster_dependent_test
-
-
-If you work under Linux you could use a simple script from the root folder of repository called ``runtests.sh``. This script simply contains a collection of the test commands described above and paths to java home directory and an ant executable, which you can define once for your system and then reuse.
-
-A handy feature of TestNG is its ability to re-run failed tests. Failed test ant file is stored in ``test-output/testng-failed.xml``. and is used in the ant task called ``Rerun_failed_tests``. So re-running failed tests requires no more work than running any other test group and could be accomplished with the command:
-
-.. code:: bash
-
- ant -f build.xml Rerun_failed_tests
-
-
-CustomTest runs the test defined in the project root directory file called ``temp-testng-customsuite.xml``. This file is generated by TestNG plugin every time you run the test from Eclipse. Thus an easy way to run a test in a different environment is to run it from Eclipse first and then from ant using a custom test procedure.
-
-For cluster execution make sure that the property ``LD_LIBRARY_PATH`` defined in build.xml points to cluster engine LD libraries directory in your local system.
-
-
-------------
-
-.. _jabaws_conn_services:
-
-Accessing JABAWS from your program
-----------------------------------
-
-.. _jabaws_conn_functions:
-
-Web services functions overview
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-All JABAWS multiple sequence alignment web services comply to the same interface, thus the function described below are available from all the services.
-
-Functions for initiating the alignment
-
-.. code:: bash
-
- String id = align(List<FastaSequence> list)
- String id = customAlign(List<FastaSequence> sequenceList, List<Option> optionList)
- String id = presetAlign(List<FastaSequence> sequenceList, Preset preset)
-
-Functions pertaining to job monitoring and control
-
-.. code:: bash
-
- JobStatus status = getJobStatus(String id)
- Alignment al = getResult(String id)
- boolean cancelled = cancelJob(String id)
- ChunkHolder chunk = pullExecStatistics(String id, long marker)
-
-Functions relating to service features discovery
-
-.. code:: bash
-
- RunnerConfig rc = getRunnerOptions()
- Limit limit = getLimit(String name)
- LimitsManager lm = getLimits()
- PresetManager pm = getPresets()
-
-Please refer to a Data Model JavaDoc for a detailed description of each methods.
-
-
-------------
-
-.. _jabaws_conn_functions2:
-
-Structure of the template command line client
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-+------------------------+------------------------------------------------------------------------+
-| Packages | Classes and Interfaces |
-+========================+========================================================================+
-| compbio.data.msa | MsaWS the interface for all multiple sequence alignment web services |
-+------------------------+------------------------------------------------------------------------+
-| compbio.data.sequence | JABAWS data types |
-+------------------------+------------------------------------------------------------------------+
-| compbio.metadata | JABAWS meta data types |
-+------------------------+------------------------------------------------------------------------+
-| compbio.ws.client | JABAWS command line client |
-+------------------------+------------------------------------------------------------------------+
-
-Additional utility libraries that this client depend upon is the compbio-util-1.3.jar and compbio-annotation-1.0.jar.
-
-Please refer to a Data Model JavaDoc [link] for a detailed description of each class and its methods.
-
-
-------------
-
-.. _jabaws_conn_conn:
-
-Connecting to JABAWS
-~~~~~~~~~~~~~~~~~~~~
-
-For a complete working example of JABAWS command line client please see compbio.ws.client.Jws2Client class. JABAWS command line client source code is available from the download page [link]. Please note that for now all the examples are in Java, other languages will follow if there is sufficient demand.
-
-Download a binary JABAWS client. Add the client to the class path. The following code excerpt will connect your program to Clustal web service deployed in the University of Dundee.
-
-.. code-block:: java
-
- import java.net.URL;
- import javax.xml.namespace.QName;
- import javax.xml.ws.Service;
- // (...)
- String qualifiedName = "http://msa.data.compbio/01/01/2010/";
- URL url = new URL("http://www.compbio.dundee.ac.uk/jabaws/ClustalWS?wsdl");
- QName qname = new QName(, "ClustalWS");
- Service serv = Service.create(url, qname);
- MsaWS msaws = serv.getPort(new QName(qualifiedName, "ClustalWSPort"),
- MsaWS.class);
-
-Line 1 makes a qualified name for JABA web services.
-
-Line 2 constructs the URL to the web services WSDL.
-
-Line 3 makes a qualified name instance for Clustal JABA web service.
-
-Line 4 creates a service instance.
-
-Line 5 makes a connection to the server.
-
-A more generic connection method would look like this
-
-.. code-block:: java
-
- import java.net.URL;
- import javax.xml.namespace.QName;
- import javax.xml.ws.Service;
- import compbio.ws.client.Services
- // (...)
- String qualifiedServiceName = "http://msa.data.compbio/01/01/2010/";
- String host = "http://www.compbio.dundee.ac.uk/jabaws";
- // In real life the service name can come from args
- Services clustal = Services.ClustalWS;
- URL url = new URL(host + "/" + clustal.toString() + "?wsdl");
- QName qname = new QName(qualifiedServiceName, clustal.toString());
- Service serv = Service.create(url, qname);
- MsaWS msaws = serv.getPort(new QName(qualifiedServiceName, clustal + "Port"), MsaWS.class);
-
-
-Where Services is enumeration of JABAWS web services. All JABAWS multiple sequence alignment methods confirm to MsaWS specification, thus from the caller point of view all JABAWS web services can be represented by MsaWS interface. The full documentation of MsaWS functions is available from the JavaDoc [link].
-
-
-------------
-
-.. _jabaws_conn_aln:
-
-Aligning Sequences
-~~~~~~~~~~~~~~~~~~
-
-Given that *msaws* is web service proxy, created as described in "Connecting to JABAWS" section, the actual alignment can be obtained as follows:
-
-.. code:: bash
-
- List<FastaSequence> fastalist = SequenceUtil.readFasta(new FileInputStream(file));
- String jobId = msaws.align(fastalist);
- Alignment alignment = msaws.getResult(jobId);
- Line one loads FASTA sequence from the file.
-
-Line two submits them to web service represented by msaws proxy.
-
-Line three retrieves the alignment from a web service. This line will block the execution until the result is available. Use this with caution. In general, you should make sure that the calculation has been completed before attempting retrieving results. This is to avoid keeping the connection to the server on hold for a prolonged periods of time. While this may be ok with your local server, our public server (www.compbio.dundee.ac.uk/jabaws) will not let you hold the connection for longer than 10 minutes. This is done to prevent excessive load on the server. The next section describes how to check the status of the calculation.
-Methods and classes mentioned in the excerpt are available from the JABAWS client library.
-
-
-------------
-
-.. _jabaws_conn_status:
-
-Checking the status of the calculation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You may have noticed that there was no pause between submitting the job and retrieving of the results. This is because getResult(jobId) method block the processing until the calculation is completed. However, taking into account that the connection holds server resources, our public server (www.compbio.dundee.ac.uk/jabaws) is configured to reset the connection after 10 minutes of waiting. To work around the connection reset you are encouraged to check whether the calculation has been completed before accessing the results. You can do it like this:
-
-.. code-block:: java
-
- while (msaws.getJobStatus(jobId) != JobStatus.FINISHED) {
- Thread.sleep(2000); // wait two seconds, then recheck the status
- }
-
-
-------------
-
-.. _jabaws_conn_aln_presets:
-
-Aligning with presets
-~~~~~~~~~~~~~~~~~~~~~
-
-.. code:: bash
-
- PresetManager presetman = msaws.getPresets();
- Preset preset = presetman.getPresetByName(presetName);
- List<FastaSequence> fastalist = SequenceUtil.readFasta(new FileInputStream(file));
- String jobId = msaws.presetAlign(fastalist, preset);
- Alignment alignment = msaws.getResult(jobId);
-
-Line one obtains the lists of presets supported by a web service.
-
-Line two return a particular Preset by its name.
-
-Lines three to five are doing the same job as in the first aligning sequences example [link].
-
-
-------------
-
-.. _jabaws_conn_aln_params:
-
-Aligning with custom parameters
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code:: bash
-
- RunnerConfig options = msaws.getRunnerOptions();
- Argument matrix = options.getArgument("MATRIX");
- matrix.setValue("PAM300");
- Argument gapopenpenalty = options.getArgument("GAPOPEN");
- gapopenpenalty.setValue("20");
- List<Argument> arguments = new ArrayList<Argument>();
- arguments.add(matrix); arguments.add(gapopenpenalty);
- List<FastaSequence> fastalist = SequenceUtil.readFasta(new FileInputStream(file));
- String jobId = msaws.customAlign(fastalist, arguments);
- Alignment alignment = msaws.getResult(jobId);
-
-Line one obtains the ``RunnerConfig`` object that holds information on supported parameters and their values
-
-Line two retrieve a particular parameter from the holder by its name.
-
-Lines three sets a value to this parameter which will be used in the calculation.
-
-Line four and five do the same but for another parameter.
-
-Line six makes a List to hold the parameters.
-
-Line seven puts the parameters into that list.
-
-Line eight and ten is the same as in previous examples.
-
-Line nine submit an alignment request with the sequences and the parameters.
-
-The names of all the parameters supported by a web service e.g. "PAM300" can be obtained using ``options.getArguments()`` method. Further details on the methods available from ``RunnerConfig`` object are available from the JavaDoc.
-
-
-------------
-
-.. _jabaws_conn_aln_file:
-
-Writing alignments to a file
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-There is a utility method in the client library that does exactly that.
-
-.. code-block:: java
-
- Alignment alignment = align(...)
- FileOutputStream outStream = new FileOutputStream(file);
- ClustalAlignmentUtil.writeClustalAlignment(outStream, align);
-
-
-------------
-
-.. _jabaws_conn_aln_example:
-
-A complete client example
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Finally, a complete example of the program that connects to JABAWS Clustal service and aligns sequences using one of the Clustal web service presets. All you need for this to work is a JABAWS binary client [link]. Please make sure that the client is in the Java class path before running this example.
-
-.. code-block:: java
-
- import java.io.ByteArrayInputStream;
- import java.io.FileNotFoundException;
- import java.io.IOException;
- import java.net.URL;
- import java.util.List;
-
- import javax.xml.namespace.QName;
- import javax.xml.ws.Service;
-
- import compbio.data.msa.MsaWS;
- import compbio.data.sequence.Alignment;
- import compbio.data.sequence.FastaSequence;
- import compbio.data.sequence.SequenceUtil;
- import compbio.metadata.JobSubmissionException;
- import compbio.metadata.LimitExceededException;
- import compbio.metadata.Preset;
- import compbio.metadata.PresetManager;
- import compbio.metadata.ResultNotAvailableException;
- import compbio.metadata.UnsupportedRuntimeException;
- import compbio.metadata.WrongParameterException;
-
- public class Example {
-
- /*
- * Input sequences for alignment
- */
- static final String input = ">Foo\r\n"
- + "MTADGPRELLQLRAAVRHRPQDFVAWLMLADAELGMGDTTAGEMAVQRGLALHPGHPEAVARLGR"
- + "VRWTQQRHAEAAVLLQQASDAAPEHPGIALWLGHALEDAGQAEAAAAAYTRAHQLLPEEPYITAQ"
- + "LLNWRRRLCDWRALDVLSAQVRAAVAQGVGAVEPFAFLSEDASAAEQLACARTRAQAIAASVRPL"
- + "APTRVRSKGPLRVGFVSNGFGAHPTGLLTVALFEALQRRQPDLQMHLFATSGDDGSTLRTRLAQA"
- + "STLHDVTALGHLATAKHIRHHGIDLLFDLRGWGGGGRPEVFALRPAPVQVNWLAYPGTSGAPWMD"
- + "YVLGDAFALPPALEPFYSEHVLRLQGAFQPSDTSRVVAEPPSRTQCGLPEQGVVLCCFNNSYKLN"
- + "PQSMARMLAVLREVPDSVLWLLSGPGEADARLRAFAHAQGVDAQRLVFMPKLPHPQYLARYRHAD"
- + "LFLDTHPYNAHTTASDALWTGCPVLTTPGETFAARVAGSLNHHLGLDEMNVADDAAFVAKAVALAS"
- + "DPAALTALHARVDVLRRESGVFEMDGFADDFGALLQALARRHGWLGI\r\n"
- + "\r\n"
- + ">Bar\r\n"
- + "MGDTTAGEMAVQRGLALHQQRHAEAAVLLQQASDAAPEHPGIALWLHALEDAGQAEAAAAYTRAH"
- + "QLLPEEPYITAQLLNAVAQGVGAVEPFAFLSEDASAAESVRPLAPTRVRSKGPLRVGFVSNGFGA"
- + "HPTGLLTVALFEALQRRQPDLQMHLFATSGDDGSTLRTRLAQASTLHDVTALGHLATAKHIRHHG"
- + "IDLLFDLRGWGGGGRPEVFALRPAPVQVNWLAYPGTSGAPWMDYVLGDAFALPPALEPFYSEHVL"
- + "RLQGAFQPSDTSRVVAEPPSRTQCGLPEQGVVLCCFNNSYKLNPQSMARMLAVLREVPDSVLWLL"
- + "SGPGEADARLRAFAHAQGVDAQRLVFMPKLPHPQYLARYRHADLFLDTHPYNAHTTASDALWTGC"
- + "PVLTTPGETFAARVAGSLNHHLGLDEMNVADDAAFVAKAVALASDPAALTALHARVDVLRRESGV"
- + "FEMDGFADDFGALLQALARRHGWLGI\r\n"
- + "\r\n"
- + ">Friends\r\n"
- + "MTADGPRELLQLRAAVRHRPQDVAWLMLADAELGMGDTTAGEMAVQRGLALHPGHPEAVARLGRV"
- + "RWTQQRHAEAAVLLQQASDAAPEHPGIALWLGHALEDHQLLPEEPYITAQLDVLSAQVRAAVAQG"
- + "VGAVEPFAFLSEDASAAEQLACARTRAQAIAASVRPLAPTRVRSKGPLRVGFVSNGFGAHPTGLL"
- + "TVALFEALQRRQPDLQMHLFATSGDDGSTLRTRLAQASTLHDVTALGHLATAKHIRHHGIDLLFD"
- + "LRGWGGGGRPEVFALRPAPVQVNWLAYPGTSGAPWMDYVLGDAFALPPALEPFYSEHVLRLQGAF"
- + "QPSDTSRVVAEPPSRTQCGLPEQGVVLCCFNNSYKLNPQSMARMLAVLREVPDSVLWLLSGPGEA"
- + "DARLRAFAHAQGVDAQRLVFMPKLPHPQYLARYRHADLFLDTHPYNAHTTASDALWTGCPVLTTP"
- + "GETFAARVAGSLNHHLGLDEMNVADDAAFVAKAVALASDPAALTALHARVDVLRRESI";
-
- public static void main(String[] args) throws UnsupportedRuntimeException,
- LimitExceededException, JobSubmissionException,
- WrongParameterException, FileNotFoundException, IOException,
- ResultNotAvailableException, InterruptedException {
-
- String qualifiedServiceName = "http://msa.data.compbio/01/01/2010/";
-
- /* Make a URL pointing to web service WSDL */
- URL url = new URL("http://www.compbio.dundee.ac.uk/jabaws/ClustalWS?wsdl");
-
- /*
- * If you are making a client that connects to different web services
- * you can use something like this:
- */
- // URL url = new URL(host + "/" + Services.ClustalWS.toString() +
- // "?wsdl");
-
- QName qname = new QName(qualifiedServiceName, "ClustalWS");
- Service serv = Service.create(url, qname);
- /*
- * Multiple sequence alignment interface for Clustal web service
- * instance
- */
- MsaWS msaws = serv.getPort(new QName(qualifiedServiceName, "ClustalWS"
- + "Port"), MsaWS.class);
-
- /* Get the list of available presets */
- PresetManager presetman = msaws.getPresets();
-
- /* Get the Preset object by preset name */
- Preset preset = presetman
- .getPresetByName("Disable gap weighting (Speed-oriented)");
-
- /*
- * Load sequences in FASTA format from the file You can use something
- * like new FileInputStream(<filename>) to load sequence from the file
- */
- List<FastaSequence> fastalist = SequenceUtil
- .readFasta(new ByteArrayInputStream(input.getBytes()));
-
- /*
- * Submit loaded sequences for an alignment using preset. The job
- * identifier is returned by this method, you can retrieve the results
- * with it sometime later.
- */
- String jobId = msaws.presetAlign(fastalist, preset);
-
- /* This method will block for the duration of the calculation */
- Alignment alignment = msaws.getResult(jobId);
-
- /*
- * This is a better way of obtaining results, it does not involve
- * holding the connection open for the duration of the calculation,
- * Besides, as the University of Dundee public server will reset the
- * connection after 10 minutes of idling, this is the only way to obtain
- * the results of long running task from our public server.
- */
- // while (msaws.getJobStatus(jobId) != JobStatus.FINISHED) {
- // Thread.sleep(1000); // wait a second, then recheck the status
- // }
-
- /* Output the alignment to standard out */
- System.out.println(alignment);
-
- // Alternatively, you can record retrieved alignment into the file in
- // ClustalW format
-
- // ClustalAlignmentUtil.writeClustalAlignment(new FileOutputStream(
- // "output.al"), alignment);
-
- }
- }
-
-For a more detailed description of all available types and their functions please refer to the Data Model JavaDoc [link].
-
-
-------------
-
-.. _jabaws_new_services:
-
-Adding new web-services
------------------------
-
-.. _jabaws_new_guide:
-
-Brief Guide
-~~~~~~~~~~~
-
-
-1. Add a new executable which you'd like to wrap as a JABAWS web service to the binaries folder. If it has the source code and can be recompiled for different platforms include it under ``binaries/src``. Edit ``setexecutableflag.sh`` and ``compilebin.sh`` scripts in ``binaries/src`` accordingly.
-
-2. Make sure that all the dependencies of the software being installed are satisfied. If there are other binaries they should be included as well. Keep the dependent binaries in a subfolder for the main executable. Update ``compilebin.sh`` and ``setexecflag.sh`` scripts accordingly.
-
-3. Make sure that the new executable does not have any hard links to its dependencies, e.g. is able to run from any installation folder and does not contain any hard coded paths.
-
-4. Describe executable in ``conf/Exectuable.properties`` file. The lowercase name of the wrapper should be included in the name of the property for example Clustal properties all include clustal as a part of the name e.g. ``local.clustalw.bin``. The same property for MAFFT will be called ``local.mafft.bin``. For more help please refer to the Executable.properties file.
-
-5. Describe the executable supported parameters in the ``<ExecutableName>Parameters.xml``, presets in the ``<ExecutableName>Presets.xml`` and the execution limits in the ``<ExecutableName>Limit.xml``. By convention these files are stored in ``conf/settings``. All of these are optional. If the executable does not support parameters you do not have to mention the ``XXXParameter.xml`` file in the ``Executable.properties`` file at all. The same is true for Presets and Limits.
-
-6. Create a Java wrapper class for your executable. Create it within runner source directory. Examples of other wrappers can be found in ``compbio.runner.msa`` or in other ``compbio.runner.*`` packages. Wrapper should extend ``SkeletalExecutable<T>`` and implement ``PipedExecutable<T>`` if you need to pass the input or collect the results from the standard in/out. Please see Mafft code as example. Wrapper should expend ``SkeletalExecutable<T>`` if input/output can be set as a parameter for an executable. Please see the ClustalW code as example.
-
-7. Create a testcase suit for your wrapper in ``testsrc`` and run the test cases.
-
-8. Create parser for the output files of your executable. Suggested location ``compbio.data.sequence.SequenceUtil``.
-
-9. Test the parser.
-
-10. Decide which web services interfaces your executable is going to match. For example if the executable output can be represented as SequenceAnnotation then SequenceAnnotation interface might be appropriate. For multiple sequence alignment an Msa interface should be used.
-
-11. If you find a web interface that matches your returning data type, then implement a web service which confirms to it within a webservices source folder.
-
-12. Register web service in ``WEB-INF/web.xml`` and ``WEB-INF/sun-jaxws.xml``.
-
-13. Add generated wsdl to wsbuild.xml ant script to generate the stubs.
-
-14. Run build-server task in wsbuild file. Watch for errors. If the task fails that means that JAXB cannot serialize some of your new data structures. Add appropriate annotations to your data types. Also check that:
-
- * you do not have interfaces to serialize, since JAXB cannot serialize them
- * you have a default no args constructor (can be private if you do not need it)
- * JAXB cannot serialize Java Map class, use a custom data structure instead
- * Enum cannot be serialized as its abstract class (do not confuse with enum which is fine)
- * Fields serialization leaves a little more space for manoeuvre. If you do this then you may accept and return interfaces, e.g. List, Map; abstract classes etc, from your methods
-
- If you have the data on the server side, but nothing is coming through to the client, this is a JAXB serialization problem. They tend to be very silent and thus hard to debug. Check your data structure can be serialized!
-
-15. Modify the client to work with your new web service. Update Services enumeration to include new service and ensure that all the methods of this enumeration take into account the new service. Update the client help text (``client_help.txt``) and insert it into the Constraints class.
-
-16. Test the web service with the client.
-
-17. Test on the cluster.
-
-
-------------
-
-.. _jabaws_artifacts:
-
-Building web services artifacts
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-JABAWS are the standard JAX-WS [link] SOAP web services, which are WS-I [link] basic profile compatible. This means that you could use whatever tool your language has to work with web services. Below is how you can generate portable artifacts to work with JABAWS from Java. However if programming in Java, we recommend using our client library as it provides a handful of useful methods in addition to plain data types.
-
-.. code:: bash
-
- wsimport -keep http://www.compbio.dundee.ac.uk/jabaws/ClustalWS?wsdl
-
-
-Server side artifacts should be rebuild whenever the data model, meta model or MSA interface were changed. To do that run build-server task from wsbuild.xml ant build file. WSDL files will be generated in ``webservices/compbio/ws/server/resource`` directory. It is not necessary to edit them if any of the JABAWS clients are used. JABAWS are the standard JAX-WS web services, which are WS-I basic profile compatible.
-
-
-------------
-
-.. _jabaws_distributives:
-
-Preparing Distributives
-~~~~~~~~~~~~~~~~~~~~~~~
-
-There are a number of ant tasks aimed for preparing distributives for download. Currently a few types of JABAWS packages are offered:
-
-1. Client only (contains classes required to access JABA Web Services)
-2. Platform specific JABAWS (windows and other)
-3. JABAWS without binaries
-4. JABAWS framework
-
-Corresponding build task names are:
-
-1. min-jaba-client
-2. jaba-windows, jaba-complete
-3. jaba-no-binaries
-4. full-jaba-client
-
-The easiest way to build all distributives is to call ``build-all`` ant task. There are more tasks defined in build.xml than described here. They are mostly self explanatory.
-
-If you made any changes to the data model and would like to generate a complete JABAWS distro make sure you have rebuilt jaxws artifact as described below.
-
-
-
-.. _Git-tracker: https://source.jalview.org/crucible/changelog/jabaws
-.. _Data Model JavaDoc: http://www.compbio.dundee.ac.uk/jabaws/dm_javadoc/index.html
-.. _Complete JavaDoc: http://www.compbio.dundee.ac.uk/jabaws/full_javadoc/index.html
-
-
-
-.. |folder| image:: ../../website/static/img/folder-small.png
- :align: middle
- :width: 15
+++ /dev/null
-Getting Started
-===============
-
-JABAWS stands for JAva Bioinformatics Analysis Web Services. As the name suggests, JABAWS is a collection of web services for bioinformatics, and currently provides services that make it easy to access well-known multiple sequence alignment and protein disorder prediction programs (see the list of currently supported programs [link]). Future versions of JABAWS will incorporate other tools.
-
-JABAWS consists of a server and a client, but unlike most bioinformatics web-service systems, you can download and run both parts on your own computer! If you want a server just for yourself, then download and install the JABAWS Virtual Appliance (VA) [link]. It requires no configuration and is simple to install. If you want to install JABAWS for your lab or institution then download the JABAWS Web Application aRchive (WAR) [link]. It is slightly more complicated to configure but is very straightforward too. Finally, if you want to script against any version of JABAWS or are interested in writing your own client, the JABAWS command line (CLI) client [link] is what you need.
-
-
-------------
-
-.. _benefits:
-
-JABAWS Benefits
----------------
-
-* Can be deployed on most operating systems, as a VMware or compatible Virtual Appliance, as well as a Tomcat Java Web Application.
-* Comes complete with sources and binaries for all the bioinformatics programs that it runs.
-* Can operate as a stand alone server or one that submits jobs to a cluster via DRMAA [link].
-* Easy to access from Jalview [link] using its graphical client, or using the JABAWS command line client.
-* Clients can submit jobs to any JABAWS servers that they might want to access, such as the one running on your local computer, your lab's server, or the publicly available services at the University of Dundee [link].
-* Local or intranet installation eliminates any security concerns you might have about sending sensitive data over the internet.
-* Wide range of configuration options to control size of jobs accepted by a server, and the command line options available for the program run by a service.
-
-
-------------
-
-.. _distributions:
-
-JABAWS Distributions
---------------------
-
-.. danger:: Merge the downloads here
-
-.. tip:: To help you choose the JABAWS distribution that better suits your needs and read on the quickstart guides below.
-
-**I want to use JABAWS for...**
-
-* :ref:`jabaws-jalview-public` - Running JABAWS services through Jalview on the JABAWS *public* server
-* :ref:`jabaws-cli` - Accessing a *public* or *private* JABAWS server using the JABAWS client
-* :ref:`jabaws-war` - Running JABAWS for my group, lab, or organization on the *local* infrastructure
-* :ref:`jabaws-va` - Running JABAWS services through Jalview or the CLI client on a *private* virtual machine server
-
-
-------------
-
-.. _jabaws-jalview-public:
-
-Jalview and the JABAWS Public Server
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is the easiest way to run JABAWS web-services. Simply launch Jalview [link] and run any of the methods provided under the 'Web Service' menu. Jalview uses the public JABAWS server by default. If you are concerned about privacy or want to run sensitive analysis on your own hardware, you can either setup a local JABAWS Virtual Appliance (VA) [link] or configure the JABAWS Web Application aRchive (WAR) [link] in your infrastructure.
-
-
-------------
-
-.. _jabaws-cli:
-
-Command Line Client (CLI)
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is a single Java archive which contains the JABAWS command line interface (CLI) client. It allows anyone who wants to connect to the JABAWS web-services running at the University of Dundee's Public Server, or to run a local private JABAWS server from their own software. You can read more about how to use JABAWS command line (CLI) client given in the documentation pages [link][fix], but a brief instructions are given below:
-
-1. Download the Client Jar file [link]
-2. Download and install Java (version 1.6) [link]
-3. Provided that you have the Java ready to run, you can get command line help by changing to the directory where you downloaded the client jar, and typing:
-
- .. code:: bash
-
- java -jar jaba-client.jar
-
-
-The JABA Web Services are WS-I compliant. This means that you can access them from any language that has libraries or functions for consuming interoperable SOAP web services.
-
-
-------------
-
-.. _jabaws-va:
-
-Virtual Appliance (VA)
-~~~~~~~~~~~~~~~~~~~~~~
-
-The Virtual Appliance (VA) package allows you to run a JABAWS server installed on TurnKey Linux as a virtual machine on your laptop or desktop computer. A complete guide to the JABAWS VA is given in the documentation pages [link][fix], but for the impatient, brief instructions are given below:
-
-If you work on Windows, Linux or Unix:
-
-1. Download JABAWS Virtual Appliance [link]
-2. Download and install VMWare Player [link]
-3. Unpack the JABAWS virtual appliance and open it with VMware Player
-
-If you work on Mac do the same using VMware Fusion [link].
-
-**Testing**
-
-To check that your JABAWS virtual appliance is working visit the Services Status page available from the main JABAWS menu. For this enter the JABAWS URL for your new server into a web browser. This is shown once the appliance is booted up.
-
-Alternatively you can use Jalview to complete the testing.
-
-1. Launch the desktop version of Jalview [link]
-2. Open the Jalview desktop's preferences panel (from the Tools->Preferences menu option), select the ``Webservices`` panel and press the ``New Service URL`` button.
-3. Enter the JABAWS URL for your new server. This is shown once the appliance is booted up.
-
-
-------------
-
-.. _jabaws-war:
-
-Web Application aRchive (WAR)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The JABAWS Web Application aRchive (WAR) is for anyone who wants to run JABAWS for their group, lab or organization, or wants to enable their local JABAWS server to use the cluster or perform very large tasks. Complete documentation is provided in the documentation pages [link][fix], but brief instructions are given below:
-
-1. Download the JABAWS WAR file [link]
-2. Download and install Apache-Tomcat [link]
- You will need at least Tomcat version 5.5 of (we would recommend version 7.0) and at least Java 1.6 (i.e. JAVA 6).
-3. Drop the JABAWS WAR file into ``tomcat/webapps`` directory.
-4. (Re)start the Tomcat.
-5. Once the tomcat has started, it should automatically unpack the WAR into the webapps directory (if it doesn't, simply unpack the WAR archive).
-6. If you are on Mac or other unix-like architecture with GNU compilers available or you'd like to get a maximum performance
- ``cd`` to ``webapps/jabaws/binaries/src/`` and execute ``./compilebin.sh`` script to compile all binaries JABAWS depends on.
-
-**Testing**
-
-You can test that your JABAWS server is working in several ways.
-
-1. Visit Services Status page available from the JABAWS main page using your web browser.
-2. If you are working on the command line, then use the command line client shipped with the JABAWS war to test it by running:
-
- .. code:: bash
-
- java -jar <Path to tomcat WebApp directory>/jabaws/WEB-INF/lib/jaba-client.jar -h=http://localhost:8080/jabaws
-
- In this example we assumed that your JABAWS server URL is ``http://localhost:8080`` and JABAWS context path is *jabaws*
-3. Alternately, you can point Jalview at your new server:
-
- 1. Launch the desktop version of Jalview [link]
- 2. Open the Jalview desktop's preferences panel (from the Tools->Preferences menu option), elect the Webservices panel and press the New Service URL button.
- 3. Enter the URL for the tomcat server, including the context path for the JABAWS web app (e.g. http://localhost:8080/jabaws).
+++ /dev/null
-Included Tools
-==============
-
-.. _msa:
-
-Multiple Sequence Alignment
----------------------------
-
-* `Clustal Omega`_ (version 1.2.4)
-* `ClustalW`_ (version 2.1)
-* `Mafft`_ (version 7.310)
-* `Muscle`_ (version 3.8.31)
-* `T-coffee`_ (version 11.00.8cbe486)
-* `Probcons`_ (version 1.12)
-* `MSAProbs`_ (version 0.9.7)
-* `GLProbs`_ (version 0.9.7)
-
-
-.. _pdis:
-
-Protein Disorder Prediction
----------------------------
-
-* `DisEMBL`_ (version 1.5)
-* `IUPred`_ (version 1.0)
-* Jronn - Java implementation of `Ronn`_ (version 3.1)
-* `GlobPlot`_ (version 2.3)
-
-.. _aac:
-
-Amino Acid Conservation
------------------------
-
-* `AACon`_ (version 1.0)
-
-
-.. _rnass:
-
-RNA Secondary Structure
------------------------
-
-* RNAalifold from `ViennaRNA`_ (version 2.0)
-
-
-.. _Clustal Omega: http://www.clustal.org/omega
-.. _ClustalW: http://www.clustal.org/clustal2
-.. _Mafft: http://align.bmr.kyushu-u.ac.jp/mafft/software/
-.. _Muscle: http://www.drive5.com/muscle
-.. _T-coffee: http://www.tcoffee.org/Projects_home_page/t_coffee_home_page.html
-.. _Probcons: http://probcons.stanford.edu/
-.. _MSAProbs: http://msaprobs.sourceforge.net/
-.. _GLProbs: http://sourceforge.net/projects/glprobs/
-.. _DisEMBL: http://dis.embl.de/
-.. _IUPred: http://iupred.enzim.hu
-.. _Ronn: http://www.strubi.ox.ac.uk/RONN
-.. _GlobPlot: http://globplot.embl.de/
-.. _AACon: http://www.compbio.dundee.ac.uk/aacon
-.. _ViennaRNA: http://www.tbi.univie.ac.at/RNA
+++ /dev/null
-Virtual Appliance (VA)
-======================
-
-The JABAWS Virtual Appliance is a way to run a JABAWS server locally, without the need to connect to the internet or configure JABAWS. What the appliance provides is a 'virtual server machine' (or more simply - virtual machine or VM), running an installation of the JABAWS Web Application Archive (WAR) on TurnKey Linux 12.1 (Tomcat edition) [link]. Once this has started up, it displays a message indicating the IP address of the JABAWS server, allowing any JABAWS client (such as Jalview or the JABAWS command line client) to connect to it.
-You can run the appliance with freely available program such as VMware Player [link], but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use VMware OVF tool [link] to prepare JABAWS image for a different virtualization platform e.g. VirtualBox [link].
-
-
-.. note:: The appliance best suits users who would like to use the JABAWS web-services locally. This might be because they do not want to access systems over an internet, or just want to keep their data private. It is also the recommended option for users who want to install JABAWS on Windows, which does not support all the bioinformatics programs that JABAWS can run.
-
-For servers that will be used heavily, we recommend that a JABAWS Server WAR distribution is deployed, rather than the Virtual Appliance version of JABAWS. This is because the JABAWS appliance is pre-configured to use only 1 CPU and 512M of memory (where the minimum amount of memory required for a JABAWS server is about 378M), which is unlikely to be sufficient for heavy computation. It is possible to reconfigure the virtual appliance so it uses more computation resources, but for most production environments, the JABAWS WAR distribution will be easier to deploy and fine tune to take advantage of the available resources.
-
-
-------------
-
-.. _va_installing:
-
-Installing
-----------
-
-.. danger:: update for Virtualbox
-
-The free VMware Player [link] can be used to run the JABAWS services from the Windows and Linux host operating systems. VMware Fusion, a commercial VMware product, offers virtual machine support for Mac.
-
-To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click "Open Virtual Machine" and point the Player to the location of the JABAWS, then choose the JABAWS.vmx file to open an appliance.
-
-When you play the machine for the first time the Player might ask you whether "This virtual machine may have been moved or copied.", say that you have copied it. That is all.
-
-
-------------
-
-.. _va_usage:
-
-Usage
------
-
-By default, the JABAWS virtual appliance is configured with 512M of memory and 1 CPU, but you are free to change these settings. If you have more than one CPU or CPU core on your computer you can make them available for the JABAWS virtual machine by editing virtual machine settings. Please bear in mind that more CPU power will not make a single calculation go faster, but it will enable the VM to do calculations in parallel. Similarly, you can add more memory to the virtual machine. More memory lets your VM deal with larger tasks, e.g. work with large alignments.
-
-
-.. image:: ../../website/static/img/VMware_cpu.png
- :height: 267
- :width: 708
- :scale: 95 %
- :align: left
-
-The VMware Player screen shot above displays JABAWS VM CPU settings.
-
-
-------------
-
-.. _va_config:
-
-
-Configuration
--------------
-
-.. _va_vm_config:
-
-VM configuration
-~~~~~~~~~~~~~~~~
-
-**VMware info**
-
-* CPUs : 1
-* RAM : 512 MB
-* Networking : Host only (the VM has no access to the outside network, nothing from the outside network can access the VM)
-* Hard disk : 20 GB (expanding)
-* VMware tools : Installed
-
-**OS information**
-
-* OS : TurnKey Linux (v. 12.1, Standalone Tomcat) based on Debian 6.0.7 (Squeeze)
-* Installation : Oracle Java 6, Tomcat 7, JABAWS v. 2.1
-* IPv4 address : dhcp
-* IPv6 address : auto
-* DNS name : none
-* Name server : dhcp
-* Route : dhcp
-* Keyboard : US_intl
-
-**Login credentials**
-
-* Root password: jabaws
-* Tomcat admin password: adminjabaws
-
-**Services available at the virtial machine IP (e.g. VM_IP = 172.16.232.149)**
-
-* Tomcat Web Server: http://VM_IP (e.g. http://172.16.232.149)
-* Jabaws URL: http://VM_IP/jabaws (e.g. http://172.16.232.149/jabaws)
-* Web Shell: https://VM_IP:12320/ (e.g. https://172.16.232.149:12320)
-* Webmean: https://VM_IP:12321/ (e.g. https://172.16.232.149:12321)
-* SSH/SFTP: root@VM_IP (e.g. ssh root@172.16.232.149)
-
-
-------------
-
-.. _va_jabaws_config:
-
-JABAWS configuration
-~~~~~~~~~~~~~~~~~~~~
-
-After booting the JABAWS VM, you should see similar screen, however, the IP address of your VM may be different. To enable Jalview to work with your JABAWS appliance you need to go to Jalview->Tools->Preferences->Web Services -> New Service URL, and add JABAWS URL into the box provided. For more information please refer to Jalview help pages [link].
-
-.. image:: ../../website/static/img/vm_welcome_screen.png
- :height: 461
- :width: 734
- :scale: 95 %
- :align: left
-
-If you click on Advanced Menu, you will see the configuration console, similar to the one below.
-
-.. image:: ../../website/static/img/VMware_booted.png
- :height: 461
- :width: 735
- :scale: 95 %
- :align: left
-
-By default the JABAWS VM is configured to use host-only networking. This means that the host can communicate with the VM via a network, but no other machines can. Similarly, the VM cannot communicate with any other computers apart from the host. If you want to connect to the Internet from the VM, configure your VM to use NAT network. However, you will not be able to connect to the VM from the host in such case. If you want to be able to connect to your VM and let VM connect to the internet at the same time you would have to use a Bridged network. In such a case you would have to configure the VM IP address manually (unless of course your network has a DHCP server to do that).
+++ /dev/null
-Web Application Archive (WAR)
-=============================
-
-JABAWS requires a Java web application server compliant with version 2.4 of the Java Servlet specification, and a Java 6 runtime environment. We recommend using an official Oracle Java 6 runtime environment, and Apache-Tomcat [link] web application server version 7, but older Tomcat versions above 5.5 will work too.
-Please Note: 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.
-
-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. To install Tomcat follow the intructions provided in the following documentation [link].
-
-JABAWS comes with pre-compiled MS Windows and Linux x86 binaries, as well as the source code and build scripts necessary to recompile them.
-
-To run JABAWS on the cluster you must have shared disk space accessible from all cluster nodes.
-
-
-------------
-
-.. _war_installing:
-
-Installing
-----------
-
-.. danger:: update for java and tomcat
-
-You need Java vX or higher installed in your machine to be able to run the JABAWS CLI client.
-Please see the Java web site [link] for up to date instructions and downloads.
-
-JABAWS is distributed as a web application archive (WAR). To deploy JABAWS in Apache-Tomcat - simply drop the war file into the webapps directory of a running Tomcat, and it will do the rest. If you used this deployment procedure, do not remove the Jabaws WAR file, otherwise Tomcat will undeploy your application! The context path for your deployed application will be the same as the name of the war file. For example, assuming the Tomcat server is running on the ``localhost:8080`` and *jaba.war* file is put into the ``<tomcat server root>/webapps`` directory, the deployed application from the jabaws.war file then can be accessed by this URL ``http://localhost:8080/jabaws``.
-
-For any other web application server, please follow your server's specific deployment procedure for 'WAR' files. If you install JABAWS on a MS Windows machine, then at this point your JABAWS installation will already be up and running, and you can try its services out as described here [link]. If you install JABAWS on Linux you will need to set an executable flag for binaries. This is described here [link]. If your host operating system is different from Windows or Linux then read on.
-
-
-------------
-
-.. _war_usage:
-
-Usage
------
-
-**Running many JABAWS instances on the same server**
-
-
-JABAWS is supplied as a Web Application aRchive which can be dealt with as any other web applications. So it is perfectly possible to run two JABAWS instances from the same server. Just make two different contexts on your application server and unpack JABAWS in both of them. For example if your server name is http://www.align.ac.uk, and the context names are public and private. Than one group of users could be given a URL http://www.align.ac.uk/public and another http://www.align.ac.uk/private. These contexts will be served by two independent JABAWS instances, and could be configured differently. If you keep local engine enabled, make sure you reduce the number of threads local engine is allowed to use to avoid overloading the server. Alternatively two completely separate web application server instances (e.g. Apache-Tomcat) could be used. This will give you a better resilience and more flexibility in memory settings.
-
-**JABAWS on a single server**
-
-You can run JABAWS on a single server. Obviously the capacity will be limited, but it may be sufficient for a small lab. Installed on a single server, JABAWS executes tasks in parallel, so the more cores the server has the more requests it will be able to handle.
-
-
-**JABAWS supported cluster batch management systems**
-
-JABAWS uses DRMAA [link] v1.0 library to send and manage jobs on the cluster. DRMAA supports many different cluster job management systems. Namely Sun Grid Engine, Condor, PBS, GridWay, Globus 2/4, PBSPro, LSF. For up to date information please consult DRMAA web site. We found that DRMAA implementation differ from platform to platform and were trying to use only the basic functions. We have only tested JABAWS on Sun Grid Engine v 6.2. Please let use know if you have any experience of running JABAWS on other platforms.
-
-
-------------
-
-.. _war_troubleshooting:
-
-Troubleshooting
----------------
-
-**If Apache-Tomcat fails to deploy jabaws.war file:**
-
-* Make sure Tomcat has sufficient access rights to read your war file.
-* Restart the Tomcat, sometimes it will not restart after the new war file is added without restart
-* If Tomcat still refuses to unpack the war file, unpack it manually into web application folder (the war file is just a zip archive). Restart the Tomcat.
-
-**If Tomcat undeployes your application:**
-
-If the war file is automatically removed by Tomcat use an explicit application descriptor. Add a context descriptor file into ``<tomcatRoot>conf/Catalina/localhost`` directory. Name your context file the same as your application folder e.g. if your JABAWS resides in ``webapps/jabaws`` folder, then call the context file jabaws.xml. Below is an example of content this file might have.
-
-.. code-block:: xml
-
- <?xml version="1.0" encoding="UTF-8"?>
- <Context antiResourceLocking="false" privileged="true" />
-
-This should be sufficient to prevent Tomcat from removing your JABAWS from WEBAPPS. For more information about the Tomcat deployer read this documentation on the Apache-Tomcat web site.
+++ /dev/null
-Search.setIndex({docnames:["advanced","changelog","citations","client","develop","getting_started","included_tools","index","stats","va","war"],envversion:51,filenames:["advanced.rst","changelog.rst","citations.rst","client.rst","develop.rst","getting_started.rst","included_tools.rst","index.rst","stats.rst","va.rst","war.rst"],objects:{},objnames:{},objtypes:{},terms:{"0_17":0,"168h":8,"16th":7,"1st":7,"2nd":7,"378m":9,"512m":9,"6000m":0,"8cbe486":[1,6],"abstract":4,"boolean":4,"byte":[0,8],"case":[0,4,8,9],"class":[0,4],"default":[0,1,3,4,5,8,9],"enum":4,"export":0,"f\u00e1bio":2,"final":[0,4,5],"function":[0,3,5,7,10],"import":[2,4],"long":[0,4],"new":[0,1,3,5,7,9,10],"public":[4,7,10],"return":[0,1,4],"static":[0,4],"throw":4,"true":[0,4,8,10],"try":[0,10],"void":4,"while":4,Adding:7,DNS:9,For:[0,3,5,7,8,9,10],NOT:0,PBS:10,That:9,The:[0,1,3,5,7,8,9,10],Then:0,There:[0,4,8],These:[0,1,10],Use:4,Using:[0,3],aacon:[1,6],aaconw:[0,3],aamatrix:0,abandon:8,abil:4,abl:[0,1,3,4,8,9,10],about:[0,4,5,9,10],abov:[0,3,4,8,9,10],absolut:0,accept:[4,5,7,8],access:[0,1,3,5,7,9,10],accesslogvalv:0,accomplish:4,accord:0,accordingli:[0,4],account:[0,1,4],achiev:0,acid:[0,1,7],action:3,activ:0,actual:4,add:[4,9,10],added:[0,10],addit:[0,1,4],address:[0,9],adjust:0,admin:[8,9],administr:8,advanc:[7,9],advantag:9,after:[0,4,8,9,10],again:0,against:[4,5],aim:4,alexand:2,alig:1,align:[0,1,2,3,5,7,9,10],all:[0,1,3,4,5,8,9,10],all_cluster_independent_test:4,all_cluster_independent_windows_only_test:4,allow:[0,1,2,3,5,8,9,10],allowlink:8,alon:5,alreadi:[0,10],also:[0,1,3,4,7,8,9],altern:[0,4,5,10],amazon:1,amd64:0,ami:1,amino:[0,1,7],amount:[0,8,9],analog:0,analysi:[0,1,2,5],analyt:[1,7],ani:[0,3,4,5,9,10],annot:4,anonym:0,anoth:[3,4,10],ant:[0,4],antiresourcelock:[8,10],anyon:[4,5],anyth:0,anywher:0,apach:[0,4,5,8,10],aparamet:3,apart:9,api:[1,3,7],app:5,appli:0,applianc:[7,8],applic:[0,1,3,7,9],appreci:0,appropri:[0,4],aptrvrskgplrvgfvsngfgahptglltvalfealqrrqpdlqmhlfatsgddgstlrtrlaqa:4,architectur:[0,5,10],archiv:[4,7,9],arg:4,argument:4,around:4,arraylist:4,artifact:7,ask:9,assum:[0,5,10],asynchron:[0,8],attempt:4,authent:[0,8],auto:9,autogener:0,autom:0,automat:[0,5,8,10],avail:[0,1,3,4,5,7,8,9,10],averag:0,avoid:[0,4,10],awstat:0,backward:1,balanc:7,bar:[3,4],barton:2,base:[0,5,8,9,10],basic:[0,3,4,10],batch:10,bear:9,becaus:[3,4,9],been:[1,3,4,5,8,9],befor:4,being:4,below:[0,1,3,4,5,8,9,10],benefit:7,besid:4,best:[0,9],better:[4,5,10],between:[0,4],bigger:0,bigmem:0,bin:[0,4],binari:[4,5,7,10],bind:0,bioinformat:[0,2,5,9],black:0,block:4,boot:[5,9],both:[0,1,3,5,10],bottom:[4,8],boundari:4,box:[0,9],bridg:9,brief:[5,7],browser:[0,5],btr304:2,bug:1,build:[0,7,10],bump:1,bundl:0,busi:0,button:5,bytearrayinputstream:4,calcul:[0,1,7,8,9],call:[0,1,3,4,10],caller:4,can:[0,3,4,5,8,9,10],cancel:[4,8],canceljob:4,cannot:[3,4,9],capac:10,catalina:[0,8,10],caution:4,cengin:0,chang:[0,1,3,4,5,8,9],changelog:7,charact:0,chase:0,check:[0,1,3,5,7,9,10],checker:0,chmod:0,choos:[0,5,9],chosen:0,chunk:4,chunkhold:4,citat:7,cite:2,clariti:3,classnam:0,clean:1,cli:[4,7],click:9,client:[0,1,7,9],client_help:4,clone:4,cloud:1,clustal:[1,3,4,6,8],clustalalignmentutil:4,clustalow:[0,3],clustalw2:0,clustalw:[0,1,3,4,6],clustalwsport:4,clustengin:0,cluster:[4,5,7,8,10],clusterengin:0,code:[0,3,7,10],coffe:[0,1,6],collect:[0,4,5,8],collector:8,color:0,column:8,come:[0,3,4,5,8,10],command:[0,7,9],comment:0,commerci:9,common:0,commun:[1,9],compar:1,compat:[1,4,5,10],compbio:[0,3,4],compil:[4,5,7,10],compilebin:[0,4,5],complain:0,complet:[0,5,7,8,10],compli:4,compliant:[0,3,5,10],complic:5,complil:4,complile_with_debug:4,compon:8,comput:[5,9],concern:5,condor:10,conf:[0,4,8,10],config:0,configur:[1,4,5,7,10],confirm:4,confus:4,connect:[0,5,7,9],conserv:[0,1,2,7],consid:8,consist:[4,5],consol:[3,9],constant:3,constraint:4,construct:4,constructor:4,consult:[8,10],consum:[3,5],contain:[0,1,4,5,8],content:[3,7,10],context:[0,3,5,8,10],contini:4,continu:2,contribut:[4,7],control:[3,4,5],convent:4,copi:[8,9],core:[0,9,10],correctli:0,correspond:0,could:[0,1,3,4,10],couldn:0,coupl:0,cours:9,cpu:[0,9],crawler:8,creat:[0,4,8],credenti:9,css:0,current:[0,1,4,5,10],custom:[3,7],customalign:4,customsuit:4,customtest:4,dai:8,daniel:2,darlrafahaqgvdaqrlvfmpklphpqylaryrhadlfldthpynahttasdalwtgcpvlttp:4,data:[0,4,5,9],databas:[0,4,8],datamodel:4,date:[0,3,8,10],deal:[1,9],dealt:10,debian:9,debug:[0,4],dec:7,decid:[0,4],dedic:1,defin:[1,3,4,7,8],definit:0,delet:1,demand:4,depend:[0,4,5,8,10],deploi:[0,4,5,8,9,10],deploy:[0,10],depth:0,describ:[0,4,8,10],descript:[0,1,4,8],descriptor:[0,10],design:[1,4],desktop:5,detail:[0,3,4,7,10],dev2:0,develop:[3,5,7],dhcp:9,did:0,differ:[0,3,4,9,10],directli:[0,4],directori:[0,1,4,5,7,10],disabl:[0,4,8],discoveri:4,disembl:[1,6],disemblw:[0,3],disk:[9,10],disord:[0,1,2,5,7],displai:[4,8,9],distribut:[0,1,2,7,9,10],distro:4,divers:1,dm_javadoc:0,doc:4,document:[0,1,3,4,5,10],doe:[0,4,8,9],doesn:5,doi:2,doing:[0,4],done:[0,1,3,4,8],doubt:0,download:[0,1,3,4,5,7],dpaaltalharvdvlrresgvfemdgfaddfgallqalarrhgwlgi:4,drive:9,drmaa:[0,5,10],drop:[1,5,10],due:[1,8],dunde:[0,4,5],durat:4,dure:8,each:[0,1,4,8],eas:1,easi:[4,5],easier:9,easiest:[0,4,5],ec2:1,eclips:4,edit:[0,4,9],edu:3,eight:4,either:[0,3,5],elect:5,elimin:5,elsewher:0,empti:8,enabl:[0,1,5,8,9,10],encod:[0,8,10],encourag:[1,4],end:0,engin:[1,4,7,8,10],ensur:4,enter:[4,5],enumer:4,env:0,environ:[4,7,9,10],environment:4,equal:3,equip:0,error:[0,4,8],especi:0,etc:[0,3,4],evalu:0,even:0,everi:[4,8],everyth:0,exact:0,exactli:[0,3,4],examin:0,exampl:[0,5,7,8,10],excerpt:4,excess:[0,4],exclud:[4,8],exec_nam:0,exectu:4,execut:[1,3,4,5,7,10],executablenam:4,executablenameparamat:0,executionstatist:[0,4],exist:[0,1],expand:9,expend:4,experi:[0,10],explanatori:4,explicit:10,explicitli:0,exploit:0,extend:4,extract:1,fail:[0,1,4,10],failur:[4,8],fals:[0,8,10],fasta34:0,fasta:[0,1,3,4],fasta_4_mafft:0,fastalist:4,fastaparttre:3,fastasequ:4,faster:[0,9],fastest:0,fatal:0,favorit:3,favour:1,featur:4,feb:0,februari:8,femdgfaddfgallqalarrhgwlgi:4,few:[0,4,8],field:4,file:[3,5,7,8,9,10],fileinputstream:4,filenam:4,filenotfoundexcept:4,fileoutputstream:4,find:[0,4],fine:[4,9],finish:[4,8],first:[0,4,8,9],five:4,fix:1,flag:[4,10],flexibl:10,folder:[4,9,10],follow:[0,4,8,10],foo:4,foobar:3,foofriend:3,forget:0,format:[3,4],found:[0,4,8,10],four:[1,4],framework:4,free:9,freeli:9,friend:4,friendli:5,from:[0,1,3,5,6,7,8,9,10],full:[0,3,4,5],full_javadoc:0,fulli:[0,1],fund:[0,2],further:[0,2,4,8],furthermor:0,fusion:[5,9],futur:5,gap:4,gapopen:4,gapopenpenalti:4,gcc:0,gener:[0,1,4,8,10],geoffrei:2,get:[0,1,4,7],getargu:4,getbyt:4,getfaarvagslnhhlgldemnvaddaafvakavalasdpaaltalharvdvlrresi:4,getjobstatu:4,getlimit:4,getport:4,getpreset:4,getpresetbynam:4,getresult:4,getrunneropt:4,git:[4,7],gitweb:4,give:10,given:[0,4,5,10],globplot:6,globplotw:[0,3],globu:10,glprob:[1,6],glprobsw:0,gnu:[5,9],going:[0,4],good:[0,5],googl:[1,7],googleanalyt:1,got:0,graphic:5,greater:[0,1],greatli:0,grid:10,gridwai:10,gridwar:0,group:[0,4,5,10],guid:[5,7],h_cpu:0,h_vmem:0,hand:4,handi:[0,3,4],handl:[3,4,10],hard:[4,9],hardwar:5,has:[0,1,3,4,5,8,9,10],hash:0,have:[0,1,4,5,7,8,9,10],health:0,heavi:9,heavili:[0,9],help:[0,1,2,4,5,8,9],here:[0,3,4,7,8,10],hierarchi:4,higher:3,hold:4,holder:4,home:[0,4],host:[0,3,4,9,10],host_and_context:3,hotloop:1,hour:8,how:[0,3,4,5],howev:[0,4,9,10],hptglltvalfealqrrqpdlqmhlfatsgddgstlrtrlaqastlhdvtalghlatakhirhhg:4,html:0,http:[0,3,4,5,9,10],httpcoderesponseservicestatu:0,huge:0,i386:0,idea:0,identif:1,identifi:4,idl:[0,4],idllfdlrgwggggrpevfalrpapvqvnwlaypgtsgapwmdyvlgdafalppalepfysehvl:4,ignor:3,imag:[0,1,9],impati:5,implement:[4,6,10],improv:[1,2],includ:[0,1,3,4,5,7],incompat:1,incomplet:8,incorpor:5,increas:0,independ:[0,3,4,10],index:0,indic:[8,9],individu:[0,8],inf:[0,4,5],influenc:0,info:[0,9],inform:[0,1,3,4,5,8,9,10],infrastructur:5,initi:[0,4,8],input:[0,3,4,8],inputfil:3,inputs:8,insert:4,insid:0,instal:[0,1,4,5,7],instanc:[0,3,4,10],instead:[0,4,5],institut:5,instruct:[3,5],integr:1,interest:5,interfac:[4,5],intern:7,internet:[5,9],interoper:[3,5],interruptedexcept:4,intranet:5,introduc:1,involv:4,ioexcept:4,ipv4:9,ipv6:9,iscancel:8,iscollect:8,isfinish:8,isol:4,issu:[4,7],its:[0,3,4,5,10],itself:0,iupr:6,iupredw:[0,3],jaba:[0,3,4,5,8,10],jabaw:[1,2,3,10],jabaws_serv:0,jabawsadmin1:9,jabawsadmin2:9,jalview:[1,4,7,9],jame:2,jan:8,januari:8,jar:[0,3,4,5],java:[0,2,3,4,5,6,9,10],java_hom:0,java_opt:0,javadoc:[0,4],javascript:0,javax:4,jax:4,jaxb:4,jaxw:4,jdk1:0,jdk:0,jessi:9,job:[1,3,4,5,7,10],jobid:[4,8],jobsout:[0,4],jobstatu:4,jobsubmissionexcept:4,jobtempl:0,jpred:1,jpredalig:1,jpredw:1,jre:0,jronn:[1,6],jronnw:[0,3],jsp:0,jul:7,junit:4,just:[0,3,5,9,10],jvm:[0,4],jws2:0,jws2client:4,keep:[4,9,10],kei:[3,8],keyboard:9,know:[0,4,10],known:[0,5],lab:[0,5,10],languag:[0,3,4,5],laptop:5,larg:[0,5,9],larger:9,last:8,later:[1,4,8],latest:1,latter:0,launch:5,layer:4,ld_library_path:[0,4],least:[0,5],leav:[0,4],length:0,let:[0,3,4,8,9,10],letter:0,level:[0,4],lfldthpynahttasdalwtgcpvlttpgetfaarvagslnhhlgldemnvaddaafvakavala:4,lib:[0,5],librari:[0,1,3,4,5,10],life:4,lightweight:0,like:[0,3,4,5,9],limit:[1,3,4,7,9,10],limitexceededexcept:4,limitsmanag:4,line:[0,7,9],link:[0,4,8],linux:[0,4,5,9,10],list:[0,1,3,4,5,7],littl:[0,4],llnwrrrlcdwraldvlsaqvraavaqgvgavepfaflsedasaaeqlacartraqaiaasvrpl:4,load:[4,7],local:[4,5,7,8,9,10],localengineexecutionlimit:0,localhost:[0,5,8,10],localhost_access_log:0,locat:[0,4,8,9],log4j:0,log:[7,8],logdir:0,login:[8,9],long_test:4,longer:[1,4],look:[0,4,7],lowercas:4,lrgwggggrpevfalrpapvqvnwlaypgtsgapwmdyvlgdafalppalepfysehvlrlqgaf:4,lsf:10,lx24:0,mac:[1,5,9,10],machin:[0,1,3,4,5,9,10],made:[4,8],madeira:2,mafft:[1,3,4,6,7],mafft_binari:0,mafftlimit:0,mafftparamet:0,mafftpreset:0,mafftw:[0,3],mai:[0,4,7,8,9,10],main:[0,4,5,8],make:[0,4,5,8,9,10],man_serverwar:0,manag:10,mani:[0,10],manipul:3,manner:5,manoeuvr:4,manual:[9,10],map:4,marker:4,match:4,matric:0,matrix:4,matter:3,maximum:[0,5,8],maxruntim:8,mayb:8,mean:[0,1,3,4,5,8,9],memori:[0,9,10],mention:4,menu:[0,5,9],messag:[0,9],meta:4,metadata:4,method:[0,1,4,5],mgdttagemavqrglalhq:3,mgdttagemavqrglalhqqrhaeaavllqqasdaapehpgialwlhaledagqaeaaaaytrah:4,might:[0,4,5,9,10],mind:9,minimum:9,minor:1,minut:[4,8],miss:0,mode:4,model:[0,4],modifi:[0,4],monitor:[0,4],month:8,monthli:8,more:[0,1,3,4,5,8,9,10],most:[3,5,8,9],mostli:4,move:9,msa:4,msaprob:[1,6],msaprobsw:0,msaw:4,mtadgprellqlraav:3,mtadgprellqlraavrhrpqdfvawl:3,mtadgprellqlraavrhrpqdfvawlmladaelgmgdttagemavqrglalhpghpeavarlgr:4,mtadgprellqlraavrhrpqdvawlmladaelgmgdttagemavqrglalhpghpeavarlgrv:4,multi:8,multipl:[0,1,2,4,5,7],muscl:[0,6],musclew:[0,3],must:[0,1,10],myhost:[0,3],mylabserv:3,mysql:9,myuni:3,name:[0,3,4,8,9,10],namespac:4,nat:9,nativ:[0,3,4],natur:8,navig:[0,8],necessari:[4,10],necessarili:8,need:[0,3,4,5,8,9,10],net:4,network:9,never:[0,1,8],newer:1,next:[3,4],nine:4,node:[0,10],nofft:3,non:0,none:9,normal:0,noscor:3,note:[3,4,8],noth:[4,9],notic:4,now:[1,3,4],nput:3,nucleotid:0,number:[0,1,4,8,10],object:[1,4],obtain:[4,7],obvious:10,oct:7,octob:5,off:3,offer:[0,1,4,9],offici:10,often:0,older:10,omega:[1,6],onc:[0,4,5,9],one:[0,1,3,4,5,8,9,10],ones:0,onli:[0,3,4,8,9,10],open:[0,3,4,5,7,9],oper:[0,5,9,10],oppos:8,optim:0,option:[0,1,3,4,5,8,9],optionlist:4,oracl:[9,10],order:[0,8],org:[0,4],organ:5,orient:[0,4],other:[0,3,4,5,8,9,10],otherwis:[0,10],our:[0,1,4,7],out:[0,3,4,8,10],output:[0,3,4],outputfil:3,outsid:[0,8,9],outstream:4,over:[3,5,9],overhead:0,overload:10,overview:[0,7],ovf:9,own:[0,3,5],packag:[0,1,3,4,5],page:[0,1,3,4,5,8,9],pam300:4,panel:5,paper:2,parallel:[9,10],paramet:[0,1,3,7],parameterinputfil:3,parser:4,part:[0,3,4,5,8],parti:10,particular:[0,4,8,10],pass:[0,4],password:[8,9],path:[0,1,3,4,5,10],path_to_jar_fil:3,pattern:0,paus:4,pbspro:10,pdf:7,peer:1,per:8,perfectli:10,perform:[0,4,5],period:[1,4,8],pertain:4,peter:[2,8],pipedexecut:4,plai:9,plain:[4,8],platform:[4,9,10],player:[5,9],pleas:[0,3,4,8,9,10],plugin:4,point:[0,3,4,5,8,9,10],port:[0,4],portabl:4,posix:0,possibl:[8,9,10],post:0,power:[0,9],powerpc:10,pqsmarmlavlrevpdsvlwllsgpgeadarlrafahaqgvdaqrlvfmpklphpqylaryrhad:4,pre:[1,4,7,9,10],predict:[0,1,5,7],prefer:[0,5,9],prefix:0,prepar:[2,7,9],preprocess:8,present:8,preset:[0,3,7],presetalign:4,presetman:4,presetmanag:4,presetnam:[3,4],press:5,prevent:[0,4,10],previou:4,print:3,println:4,privaci:5,privat:[0,4,5,9,10],privileg:[7,10],prm:3,probabl:0,probcon:[0,6],probconsw:[0,3],problem:[0,4],procedur:[4,10],procerror:8,process:[0,1,3,4,8],procoutput:8,procter:2,produc:[0,8],product:[0,5,9],profil:[0,4],prog_doc:0,program:[0,1,3,5,7,9,10],programmat:3,prohibit:0,project:[1,2,7],prolong:4,proper:1,properti:[0,1,4,8],protein:[0,1,2,5,7],protocol:0,provid:[0,1,3,4,5,9],proxi:4,publicli:[4,5],publish:0,pullexecstatist:4,purpos:0,put:[0,4,10],pvlttpgetfaarvagslnhhlgldemnvaddaafvakavalasdpaaltalharvdvlrresgv:4,qllpeepyitaqllnavaqgvgavepfaflsedasaaesvrplaptrvrskgplrvgfvsngfga:4,qname:4,qpsdtsrvvaeppsrtqcglpeqgvvlccfnnsyklnpqsmarmlavlrevpdsvlwllsgpgea:4,qualifi:4,qualifiednam:4,qualifiedservicenam:4,queer:0,queri:0,quickstart:5,rais:0,ram:[0,9],rang:5,rather:9,read:[0,4,5,10],readfasta:4,readi:5,real:4,reason:0,rebuild:4,rebuilt:4,recent:0,recheck:4,recommend:[0,1,3,4,5,9,10],recompil:[4,7,10],reconfigur:9,record:[1,4,8],redirect:0,reduc:[0,10],refer:[0,4,9],reflect:1,refus:10,regist:4,reject:0,rel:0,relat:[0,4],releas:7,rem465:1,remot:0,remov:[0,10],repeat:0,replac:[0,1,4,8],report:[0,4,7],repositori:[0,4],repres:4,request:[4,7,8,10],requir:[0,1,4,5,9,10],rerun_failed_test:4,reserv:0,reset:4,resid:[0,10],resili:10,resolut:0,resolvehost:0,resourc:[0,4,9],respect:[0,8],respond:0,respons:0,rest:[1,10],restart:[0,8,10],restructuredtext:4,result:[0,4,8],resultnotavailableexcept:4,results:8,retre:3,retriev:[0,4,8],reus:[4,7],review:0,right:10,rlqgafqpsdtsrvvaeppsrtqcglpeqgvvlccfnnsyklnpqsmarmlavlrevpdsvlwl:4,rna:[0,2,7],rnaalifold:6,rnaalifoldw:[0,1],rnastructscoremanag:1,role:8,rolenam:8,ronn:6,root:[4,9,10],rout:9,row:8,rule:0,run:[0,1,3,4,5,8,9,10],run_cluster_dependent_test:4,runner:4,runnerconfig:[4,8],runtest:4,runtim:[8,10],rwtqqrhaeaavllqqasdaapehpgialwlghaledhqllpeepyitaqldvlsaqvraavaqg:4,sai:9,same:[0,3,4,5,8,9,10],satisfi:4,scientif:1,score:1,scoremanag:1,screen:[0,9],screenshot:8,script:[0,3,4,5,10],search:0,second:[4,8],secondari:[0,1,2,7],section:[0,4,8],secur:[1,5],see:[0,3,4,5,8,9],select:5,self:4,semicolon:0,send:[5,10],sensit:5,sent:0,separ:[0,3,10],sequenc:[0,1,2,3,5,7],sequenceannot:4,sequencelist:4,sequenceutil:4,sequenti:4,serial:4,serv:[0,4,10],server:[3,4,7,9,10],server_url:0,servic:[0,1,2,3,5,7,8,9,10],servicenam:[0,3],servicestatu:0,servlet:[1,10],set:[0,3,4,8,9,10],setenv:0,setexecflag:[0,4],setexecutableflag:4,setnativespecif:0,setup:5,setvalu:4,seven:4,sever:[0,1,4,5],sftp:9,sge:0,sge_root:0,sgpgeadarlrafahaqgvdaqrlvfmpklphpqylaryrhadlfldthpynahttasdalwtgc:4,share:10,shell:9,sherstnev:2,ship:5,shot:9,should:[0,1,4,5,8,9,10],show:[3,8],shown:[3,5],side:4,sign:[1,3],signific:0,silent:4,similar:[4,9],similarli:9,simpl:[0,4,5],simplest:8,simpli:[0,4,5,9,10],simplifi:[0,1],sinc:[0,4,5,10],singl:[5,9,10],site:[3,10],six:4,size:[5,7,8],skeletalexecut:4,sleep:4,slightli:5,small:[0,10],smaller:0,soap:[0,3,4,5],softwar:[3,4,5],some:[0,1,4],someth:4,sometim:[4,8,10],soon:8,sourc:[0,3,5,7,10],space:[4,10],special:4,specif:[0,3,4,10],specifi:[0,3,8],speed:[0,4],sphinx:1,split:4,src:[0,4,5],ssh:9,stabil:4,stage:4,stand:5,standalon:9,standard:[0,1,4,8],standlon:9,start:[0,7,8,9],startup:0,stat:8,statist:[0,1,4,7],statpag:[0,4],statu:[0,1,5,7],step:0,still:10,stlhdvtalghlatakhirhhgidllfdlrgwggggrpevfalrpapvqvnwlaypgtsgapwmd:4,stop:1,storag:0,store:[0,4],stori:8,straight:0,straightforward:5,stream:8,string:[1,4],structur:[0,1,2,7],stub:4,subfold:4,submiss:0,submit:[0,4,5,8],substitut:0,successfulli:0,suffici:[4,9,10],suffix:0,suggest:[0,4],suit:[0,4,5,9],suitabl:0,summari:8,sun:[0,4,10],suppli:[0,1,4,10],support:[0,1,3,4,5,9,10],sure:[0,4,8,10],swap:1,symbol:[0,1,8],system:[4,5,7,8,9,10],tabl:[0,8],take:[0,4,9],task:[0,4,5,9,10],tcoffeew:[0,3],tell:0,temp:4,templat:7,temporari:[0,4,8],ten:4,tend:4,termin:0,test:[3,5,7,9,10],testcas:4,testng:4,testoutput:0,testsrc:4,text:[4,8],than:[0,1,4,9,10],thei:[0,4,5,9],them:[0,3,4,5,9,10],thi:[0,1,3,4,5,7,8,9,10],thin:4,third:[4,10],though:4,thread:[0,1,4,10],three:[0,4],through:[4,5],thu:[0,4],thw:0,time:[0,4,8,9],timestamp:8,tip:0,titl:8,tmp:0,togeth:[3,4],tomcat:[0,1,5,7,9,10],tomcat_dir:0,tomcat_root:[0,8],tomcatroot:10,too:[0,5,10],tool:[0,4,5,7,9],top:4,tostr:4,total:8,trace:0,tracker:[4,7],treat:0,trim:3,troshin:2,troubleshoot:7,tune:9,turnkei:[5,9],tvalfealqrrqpdlqmhlfatsgddgstlrtrlaqastlhdvtalghlatakhirhhgidllfd:4,two:[0,1,4,10],txt:[0,4,8],type:[0,4,5],uncom:0,undeploi:10,undeploy:10,under:[0,4,5],underneath:4,uniqu:8,unit:7,univers:[0,4,5],unix:[5,8],unless:9,unlik:[5,9],unpack:[5,9,10],unsupportedruntimeexcept:4,until:[0,4],updat:[0,1,4],upon:[0,4],upper:4,url:[0,3,4,5,9,10],us_intl:9,usag:7,use:[0,1,2,3,4,5,8,9,10],used:[0,1,3,4,9,10],useful:[0,3,4],user:[0,1,5,8,9,10],usernam:8,uses:[0,4,5,9,10],using:[0,3,4,5,8,10],utf:[8,10],util:[0,4],valid:7,valu:[0,3,4],valv:0,variabl:[4,7],variou:0,veri:[0,1,4,5],version:[0,3,5,6,7,8,9,10],vgavepfaflsedasaaeqlacartraqaiaasvrplaptrvrskgplrvgfvsngfgahptgl:4,via:[3,5,9],viennarna:6,view:[4,7],violat:4,virtial:9,virtual:[0,7,8],virtualbox:[1,9],visial:0,visit:5,visual:[1,8],visualis:8,vm_ip:9,vmware:[1,5,9],vmx:9,vrwtqqrhaeaavllqqasdaapehpgialwlghaledagqaeaaaaaytrahqllpeepyitaq:4,vwmare:9,wai:[0,3,4,5,8,9],wait:[0,4],want:[0,3,4,5,7,9],war:[1,4,7,8,9],warn:0,wast:0,watch:4,web:[0,1,2,3,7,9],webal:0,webapp:[0,5,10],webapplicationpath:0,webmean:9,webservic:[0,4,5],websit:[1,4],weight:4,welcom:3,well:[0,4,5,10],were:[1,4,8,10],what:[0,5,9],whatev:[0,4],when:[0,2,8,9],whenev:4,where:[0,3,4,5,8,9],wherea:0,whether:[4,8,9],which:[0,1,3,4,5,8,9,10],who:[0,4,5,9],whole:[0,8],whose:8,why:0,wide:5,window:[0,4,5,9,10],wish:0,within:[0,1,4,8],without:[0,4,9,10],work:[2,4,5,7,9,10],worldwid:5,would:[0,3,4,5,9],wrap:4,wrapper:4,write:[3,5,7],writeclustalalign:4,written:0,wrongparameterexcept:4,wsbuild:4,wsdl:[4,7],wsimport:[0,4],www:[0,4,10],x86:[0,10],xincgc:0,xml:[0,4,8,10],xms512m:0,xmx1024m:0,xxx:0,xxxlimit:0,xxxparamet:[0,4],xxxpreset:0,yesterdai:3,you:[0,2,3,4,5,7,8,9,10],your:[3,5,7,8,9,10],your_jaba_context_nam:0,your_jabaws_server_url:0,yourself:[0,5],yvlgdafalppalepfysehvlrlqgafqpsdtsrvvaeppsrtqcglpeqgvvlccfnnsykln:4,zip:10},titles:["Advanced Usage","Changelog","Citations","Command Line Client (CLI)","For Developers","Getting Started","Included Tools","Welcome to JABAWS’s documentation!","Usage Statistics","Virtual Appliance (VA)","Web Application Archive (WAR)"],titleterms:{"16th":1,"1st":1,"2nd":1,"function":4,"new":4,"public":5,Adding:4,For:4,The:4,accept:0,access:[4,8],acid:6,advanc:0,align:[4,6],amino:6,analyt:0,api:4,applianc:[5,9],applic:[5,8,10],archiv:[5,10],artifact:4,balanc:0,benefit:5,binari:0,brief:4,build:4,calcul:4,changelog:1,check:4,citat:2,cli:[3,5],client:[3,4,5],cluster:0,code:4,command:[3,4,5],compil:0,complet:4,configur:[0,8,9],connect:4,conserv:6,content:[0,8],custom:4,dec:1,defin:0,detail:8,develop:4,directori:8,disord:6,distribut:[4,5],document:7,engin:0,environ:0,exampl:[3,4],execut:[0,8],file:[0,4],from:4,get:5,googl:0,guid:4,includ:6,instal:[3,9,10],intern:0,jabaw:[0,4,5,7,8,9],jalview:5,job:[0,8],jul:1,limit:0,line:[3,4,5],list:8,load:0,local:0,log:0,mafft:0,mai:1,multipl:6,obtain:0,oct:1,overview:4,paramet:4,pre:0,predict:6,prepar:4,preset:4,privileg:8,program:4,project:4,protein:6,recompil:0,releas:1,request:0,reus:0,rna:6,secondari:6,sequenc:[4,6],server:[0,5,8],servic:4,size:0,sourc:4,start:5,statist:8,statu:4,structur:[4,6],system:0,templat:4,test:[0,4],tomcat:8,tool:6,troubleshoot:10,unit:4,usag:[0,3,8,9,10],valid:0,variabl:0,version:1,view:8,virtual:[5,9],war:[0,5,10],web:[4,5,8,10],welcom:7,work:0,write:4,wsdl:0,your:[0,4]}})
\ No newline at end of file
<!-- <a href="_sources/va.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<div class="section" id="virtual-appliance-va">
<h1>Virtual Appliance (VA)<a class="headerlink" href="#virtual-appliance-va" title="Permalink to this headline">¶</a></h1>
<p>The JABAWS Virtual Appliance is a way to run a JABAWS server locally, without the need to connect to the internet or configure JABAWS. What the appliance provides is a ‘virtual server machine’ (or more simply - <em>virtual machine</em> or <em>VM</em>), running an installation of the JABAWS Web Application Archive (WAR) on <a class="reference external" href="https://www.turnkeylinux.org/tomcat">TurnKey Linux</a> 12.1 (Standlone Tomcat). Once this has started up, it displays a message indicating the IP address of the JABAWS server, allowing any JABAWS client (such as Jalview or the JABAWS command line client) to connect to it.</p>
-<p>You can run the appliance with freely available program such as <a class="reference external" href="http://www.vmware.com/products/player">VMware Player</a>, but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use <a class="reference external" href="https://code.vmware.com/web/dp/tool/ovf/4.1.0">VMware OVF</a> tool to prepare JABAWS image for a different virtualization platform e.g. <a class="reference external" href="https://www.virtualbox.org/">VirtualBox</a>.</p>
+<p>You can run the appliance with freely available program such as <a class="reference external" href="http://www.vmware.com/products/player">VMware Player</a>, but you will need to install it first. We have tested the JABAWS appliance with VMware Player v 3.1.2 on Windows and Linux, and VMware Fusion on Mac. However, you are not limited to these virtualization systems and can use the JABAWS Appliance with any other virtualization platform. You can use <a class="reference external" href="https://code.vmware.com/web/dp/tool/ovf/4.1.0">VMware OVF</a> tool to prepare JABAWS image for a different virtualization platform e.g. <a class="reference external" href="https://www.virtualbox.org/">VirtualBox</a>. <a class="reference external" href="https://www.virtualbox.org/">VirtualBox</a> can also use the <code class="docutils literal"><span class="pre">jabaws*.vmdk</span></code> directly as an <em>existing preconfigured virtual hard disk file</em>, when creating a new Linux 2.4 / 3.x / 4.x 64-bit VM.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The appliance best suits users who would like to use the JABAWS web-services locally. This might be because they do not want to access systems over an internet, or just want to keep their data private. It is also the recommended option for users who want to install JABAWS on Windows, which does not support all the bioinformatics programs that JABAWS can run.</p>
<p class="last">Check if you are running the recommended version of VWMare.</p>
</div>
<p>The free <a class="reference external" href="http://www.vmware.com/products/player">VMware Player</a> can be used to run the JABAWS services from the Windows and Linux host operating systems. <a class="reference external" href="http://www.vmware.com/products/fusion/overview.html">VMware Fusion</a>, a commercial VMware product, offers virtual machine support for Mac.</p>
-<p>To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click “Open Virtual Machine” and point the Player to the location of the JABAWS, then choose the <code class="docutils literal"><span class="pre">JABAWS*.vmx</span></code> file to open an appliance.</p>
+<p>To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click “Open Virtual Machine” and point the Player to the location of the JABAWS, then choose the <code class="docutils literal"><span class="pre">jabaws*.vmx</span></code> file to open an appliance.</p>
<p>When you play the machine for the first time the Player might ask you whether “This virtual machine may have been moved or copied.”, say that you have copied it. That is all.</p>
<hr class="docutils" />
</div>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>
<!-- <a href="_sources/war.rst.txt" rel="nofollow"> View page source</a> -->
- <a href="../../">Return to the JABAWS homepage</a>
+ <a href="../">Return to the JABAWS homepage</a>
</li>
<hr/>
<div role="contentinfo">
- <p><a href="../../">JABAWS 2.2</a>
+ <p><a href="../">JABAWS 2.2</a>
© Copyright 2017, Peter Troshin, Alexander Sherstnev, Jim Procter, Daniel Barton, Fábio Madeira, Alexey Drozdetskiy, Suzanne Duce and Geoff Barton.
</p>