updates to web site
[jabaws.git] / website / man_awscloud.html
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
5 <head>\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
11 "print.css" />\r
12 <script type="text/javascript" src="prototype-1.6.0.3.js"></script>\r
13 <style type="text/css">\r
14 <!--\r
15 .style1 {font-family: Verdana, Arial, Helvetica, sans-serif}\r
16 -->\r
17 </style>\r
18 </head>\r
19 <body>\r
20 <div id="page">\r
21 <div id="banner">\r
22 <table> \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
26 </tr>\r
27 </table>\r
28 </div><!-- banner end-->\r
29 \r
30 <div id="wrapper">\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
34         <div id="submenu">\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
40                 Configuration</a>\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
44                 JABAWS</a>      \r
45                 <a href="man_server_dev.html" >JABAWS Development</a>\r
46         </div>\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
51 </div>\r
52 \r
53 <!-- panel end-->\r
54 <div id="content">\r
55 <h2 id="headtitle">JABAWS MANUAL</h2>\r
56 \r
57 <h2>JABAWS Server in the Amazon Cloud</h2>\r
58 <ul>\r
59   <li><a href="#jabawsOnCloud">JABAWS on the Cloud</a></li>\r
60     <li><a href="#jabawsOnCloudHow">How to use JABAWS on the Amazon EC2 cloud</a></li>\r
61     </ul>\r
62 <div id="jabaws_on_cloud">\r
63   <h3><a name="jabawsOnCloud" id="jabawsOnCloud"></a>JABAWS on the Cloud</h3>\r
64   <p>We provide pre-configured JABAWS Amazon Machine Image (AMI) which you can use on the <a href="http://aws.amazon.com/what-is-aws">Amazon EC2 cloud</a>. Typical use cases are </p>\r
65   <ul>\r
66   <li>you need to perform large scale calculations but do not have the resources available locally </li>\r
67   <li>your organization already uses the Amazon cloud and you do not want to do any special arrangements for the JABAWS  </li>\r
68   <li>you want to benefit from the Amazon automatic scaling and monitoring to make sure JABAWS is always ready </li>\r
69 </ul>\r
70 <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
71 <h3><a name="jabawsOnCloudHow" id="jabawsOnCloudHow"/></a>How to use JABAWS on the Amazon EC2 cloud </h3>\r
72 <ol>\r
73   <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
74   <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
75   <li>Click on &quot;Launch Instance&quot; button  marker 2. </li>\r
76 \r
77 <img src="images/aws_console_launch.gif" alt="AWS console" width="687" height="704">\r
78 <li>Go to the &quot;Community AMI&quot; tab and search for JABAWS, then click select.</li>\r
79 <img src="images/aws_launch.gif" alt="select AMI" width="864" height="262">\r
80   <li>Choose the &quot;hardware&quot; for your JABAWS server instance. &quot;Large&quot; 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 a more powerful machine. Once you have chosen the hardware click continue. </li>\r
81 \r
82   <img src="images/aws_launch_instance.gif" alt="select hardware" width="872" height="590">\r
83 \r
84   <li>You should not need to customize anything on this page, continue to the next. </li>\r
85 \r
86   <img src="images/aws_launch_instance2.gif" alt="keys" width="872" height="592">\r
87 \r
88   <li> At the &quot;Create a key pair&quot; step, choose &quot;Proceed without a key pair&quot; unless you want to access JABAWS server via SSH. </li>\r
89 \r
90 <img src="images/aws_launch_instance3.gif" width="872" height="592">\r
91   <li>Create a new security group with a single HTTP (80) port as shown below. You may want to add SSH (22) port if you are planning to manage your instance via SSH. For starting/stopping your JABAWS instance SSH is not necessary, you can do this from the Amazon Webservices Console (AWS). </li>\r
92 \r
93   <img src="images/aws_launch_instance_sec_group.gif" alt="ese" width="856" height="588">\r
94   <li>Review the configuration and launch the instance, then click &quot;view your instances on the Instances page&quot;. </li>\r
95 <img src="images/aws_launch_instance5.gif" width="870" height="430">\r
96 <li>At this point you should have JABAWS instance up and running. Your AWS console should look something like this: </li>\r
97 <img src="images/aws_launch_instance_done.gif" width="812" height="848">\r
98 <li>Now you can consume JABAWS web services by accessing the public DNS address of your JABAWS server instance. For instance, to register it with Jalview, just add the new JABAWS web server. Prefix your instance public DNS address with http:// e.g. type: http://&lt;public DNS&gt;. The JABAWS instance on the screenshot can be accessed on http://ec2-46-137-50-196.eu-west-1.compute.amazonaws.com.   </li>\r
99 </ol>\r
100 <p>If you need to run JABAWS for large organization you might want to configure load balancer and auto scaling. Please get in contact with us if you are interested in exploring such configurations. </p>\r
101 <p>&nbsp;</p>\r
102 </div><!-- end of jabaws_on_cloud div -->\r
103 </div>\r
104 \r
105 <!-- content end-->\r
106 <div id="copyright">Last update: 10 August 2011<br />\r
107  Peter Troshin, Jim Procter and Geoff Barton, The Barton Group, University of\r
108 Dundee, UK</div>\r
109 </div>\r
110 \r
111 <!-- wrapper end-->\r
112 </div>\r
113 <!-- page end-->\r
114 \r
115 <!-- Google analitics -->\r
116 <script type="text/javascript">\r
117 var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");\r
118 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));\r
119 </script>\r
120 <script type="text/javascript">\r
121 try{\r
122 var pageTracker = _gat._getTracker("UA-5356328-1");\r
123 pageTracker._trackPageview();\r
124 } catch(err) {}\r
125 </script>\r
126 </body>\r
127 </html>\r
128 \r