1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE html PUBLIC "XHTML 1.0 Strict"
\r
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
\r
4 <html xmlns="http://www.w3.org/1999/xhtml">
\r
6 <meta name="Last-modified" content="Mon, 4 Apr 2011 12:00:00 GMT"/>
\r
7 <title>Java Bioinformatics Analyses Web Services (JABAWS) Server Virtual Appliance Manual</title>
\r
8 <link href="ws.css" rel="stylesheet" type="text/css" media=
\r
9 "screen, projection, handheld, tv" />
\r
10 <link rel="stylesheet" type="text/css" media="print" href=
\r
12 <script type="text/javascript" src="prototype-1.6.0.3.js"></script>
\r
13 <style type="text/css">
\r
15 .style1 {font-family: Verdana, Arial, Helvetica, sans-serif}
\r
23 <tr><td style="width:158px;"><a href="http://www.dundee.ac.uk"><img src="images/uod_lt_long.gif" alt="University of Dundee" width="158" height="90" class="logo" title="University of Dundee" longdesc="http://www.dundee.ac.uk"/></a></td>
\r
24 <td class="bg"><img src="images/jabaws2.png" alt="JABAWS-2.0:Disorder" width="353" height="67" title="JABAWS-2.0:Disorder"/></td>
\r
25 <td class="bg"><img src="images/banner_right.png" alt="Disorder" width="200" height="80"/></td>
\r
28 </div><!-- banner end-->
\r
31 <div id="panel"><a href="index.html">Home</a>
\r
32 <a href="quick_start.html">Getting Started</a>
\r
33 <a class="selected" href="man_about.html">Manual</a>
\r
35 <a href="man_about.html">About</a>
\r
36 <a href="man_servervm.html" title="JABAWS Server as Virtual Appliance">Server VA</a>
\r
37 <a class="selected" href="man_awscloud.html" title="JABAWS Server in the Amazon EC2 Cloud">Server in the Cloud</a>
\r
38 <a href="man_serverwar.html" title="JABAWS Server as Web Application aRchive">Server WAR</a>
\r
39 <a href="man_configuration.html" >Server<br/>
\r
41 <a href="man_client.html" title="JABAWS Command Line Client">CMD Client</a>
\r
42 <a href="man_stats.html" title="JABAWS Usage Statistics">Usage Statistics</a>
\r
43 <a href="man_dev.html" title="Accessing JABAWS from your program">Accessing<br/>
\r
45 <a href="man_server_dev.html" >JABAWS Development</a>
\r
47 <a href="download.html">Download</a>
\r
48 <a href="contacts.html">Contact Us</a>
\r
49 <a href="PublicAnnualStat" title="JABAWS usage statistics">Usage Statistics</a>
\r
50 <a href="http://www.compbio.dundee.ac.uk" title="University of Dundee, The Barton Group" >Barton Group</a>
\r
55 <h2 id="headtitle">JABAWS MANUAL</h2>
\r
57 <h2>JABAWS Server in the Amazon Cloud</h2>
\r
58 <ul><li><a href="#whatisvm">What is JABAWS in the Cloud?</a></li>
\r
59 <li><a href="#whenvm">How to use JABAWS on the Amazon EC2 cloud</a></li>
\r
61 <div id="jabaws_on_cloud">
\r
62 <h3><a name="whatisvm" id="whatisvm"></a>What is JABAWS in the Cloud?</h3>
\r
63 <p>We provide pre-configured JABAWS Amazon Machine Image (AMI) which you can use on <a href="http://aws.amazon.com/what-is-aws">Amazon EC2 cloud</a>. When to use JABAWS in the cloud? </p>
\r
65 <li>you need to perform large scale calculations but do not have a cluster</li>
\r
66 <li>your organization already uses the cloud, in that case it may be easier and more cost effective to use JABAWS on the cloud </li>
\r
67 <li>want to have you instance always ready </li>
\r
69 <p>If you know what to do than JABAWS AMI ID is <strong>ami-40fecd34</strong>, manifest <strong>846107356395/JABAWS2</strong> to get you started, if not read on. </p>
\r
70 <h3><a name="whenvm" id="whenvm"/></a>How to use JABAWS on the Amazon EC2 cloud </h3>
\r
72 <li><a href="https://www.amazon.com/ap/signin/175-8261537-7969810?_encoding=UTF8&openid.assoc_handle=aws&openid.return_to=https%3A//aws-portal.amazon.com/gp/aws/developer/registration/index.html/175-8261537-7969810&openid.mode=checkid_setup&openid.ns=http%3A//specs.openid.net/auth/2.0&openid.claimed_id=http%3A//specs.openid.net/auth/2.0/identifier_select&openid.pape.max_auth_age=600&siteState=awsMode%3A%3Aregistration%3A%3AheaderMessage%3A%3AAmazon Web Services Sign Up%3A%3A&pageId=aws.ssop&openid.pape.preferred_auth_policies=http%3A//schemas.openid.net/pape/policies/2007/06/multi-factor-physical&marketplaceId=ATVPDKIKX0DER&accountStatusPolicy=P1&openid.ns.pape=http%3A//specs.openid.net/extensions/pape/1.0&openid.identity=http%3A//specs.openid.net/auth/2.0/identifier_select&authCookies=1">Create Amazon Web Services account</a>. </li>
\r
73 <li><a href="https://console.aws.amazon.com/ec2/home?region=eu-west-1#selectInstance=&launchAmi=&s=Home">Log in into the Amazon Web Services (AWS) console.</a> Make sure you are in the EU West (Ireland) region. JABAWS image is not available in other regions as yet. See marker 1. </li>
\r
74 <li>Click on "Launch Instance" button marker 2. </li>
\r
76 <img src="images/aws_console_launch.gif" alt="AWS console" width="687" height="704">
\r
77 <li>Go to the "Community AMI" tab and search for JABAWS, then click select.</li>
\r
78 <img src="images/aws_launch.gif" alt="select AMI" width="864" height="262">
\r
79 <li>Choose the "hardware" for your JABAWS server instance. "Large" instance should be sufficient for a single user needs. If you are planning to use this instance as a server for the lab, you may want to select more powerful machine. Once you have chosen the hardware click continue. </li>
\r
81 <img src="images/aws_launch_instance.gif" alt="select hardware" width="872" height="590">
\r
83 <li>You should not need to customize anything on this page, continue to the next, you do not have to specify any key-value pairs on the next page either. </li>
\r
85 <img src="images/aws_launch_instance2.gif" alt="keys" width="872" height="592">
\r
87 <li> At the "Create a key pair" step, choose "Proceed without a key pair" unless you want to access JABAWS server via SSH. </li>
\r
89 <img src="images/aws_launch_instance3.gif" width="872" height="592">
\r
90 <li>Create a new security group with a single port HTTP (80) as shown below. You may want to add SSH (22) port if you are planning to manage your instance via SSH. </li>
\r
92 <img src="images/aws_launch_instance_sec_group.gif" alt="ese" width="856" height="588">
\r
93 <li>Review the configuration and launch the instance, then click "view your instances on the Instances page". </li>
\r
94 <img src="images/aws_launch_instance5.gif" width="870" height="430">
\r
95 <li>At this point you should have JABAWS instance up and running. Your AWS console should look something like this: </li>
\r
96 <img src="images/aws_launch_instance_done.gif" width="812" height="848">
\r
97 <li>Now you can consume JABAWS web services from the public DNS address of your JABAWS server instance. To register it with Jalview, for instance, just add the new JABAWS web server. Prefix your instance public DNS address with http:// e.g. type: http://<public DNS> for the instance on the screenshot it would be http://ec2-46-137-50-196.eu-west-1.compute.amazonaws.com. Done. Bear in mind though that your instance public DNS is likely to be different. </li>
\r
99 <p>If you need to run JABAWS for large organization you might want to configure load balancer and auto scaling to let JABAWS serve large number of users. Please get in contact with us if you are interested in exploring such configurations. </p>
\r
101 </div><!-- end of jabaws_on_cloud div -->
\r
104 <!-- content end-->
\r
105 <div id="copyright">Last update: 10 August 2011<br />
\r
106 Peter Troshin, Jim Procter and Geoff Barton, The Barton Group, University of
\r
110 <!-- wrapper end-->
\r
114 <!-- Google analitics -->
\r
115 <script type="text/javascript">
\r
116 var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
\r
117 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
\r
119 <script type="text/javascript">
\r
121 var pageTracker = _gat._getTracker("UA-5356328-1");
\r
122 pageTracker._trackPageview();
\r
git://source.jalview.org / jabaws.git / blob