View source

[[Category: Cookbook]] {{Cloud}}

This tutorial is going to cover the basics of using Resin with Amazon Web Services for cloud deployment. If you are new to cloud computing and IaaS ([http:///en.wikipedia.org/wiki/Cloud_computing#Infrastructure Infrastructure as a Service]), follow along and you will soon be deploying Java web applications in the cloud. You wil create an EC2 instance. You will download and install Resin on Ubuntu on a local machine. You will install Resin on an Amazon Linux AMI instance (EC2 instance). You will use Roo to create a simple application and deploy it.

We use [http://www.springsource.org/spring-roo Roo because Spring] is fairly widely used, and Roo is a quick way to generate a sample app. Future tutorials will use other common Java tools as well as show you how to configure and manage a complete Resin cluster. Think of this as the first tutorial in a series of tutorials.

For this tutorial you will need Resin 4.0.24 or later.  Check back periodically because as we are going to expand the tutorial and improve Resin's support of cloud deployments. The Resin engineering team plans on improving cloud support continuously.

Many of the steps in this tutorial would be similar even if you were using [http://www.eucalyptus.com/ Eucalyptus],  [http://cloudstack.com/ CloudStack] with [http://cloudstack.org/download.html CloudBridge], [http://www.rightscale.com/products/plans-pricing/mycloud.php RightScale myCloud] or even [http://opennebula.org/documentation:rel3.0:ec2qcg OpenNebula] this guide should help you along as they all support the Amazon EC2 REST APIs. Also any cloud computing environment (private or public, on premises or hosted) will have similar characteristics. Thus even if you are using a private cloud using [http://www.openstack.org/ OpenStack] like [http://deliver.citrix.com/projectolympus Project Olympus], the principles will be the same. In fact even using remote servers deployed in a datacenter or virtualized servers with [http://www.citrix.com/English/ps2/products/subfeature.asp?contentID=2300456 Xen Server], [http://xen.org/products/cloudxen.html Xen Cloud] or [http://www.vmware.com/products/vsphere/overview.html VMWare vSphere] the steps will be very similar.


For this tutorial we expect you are familiar with starting, and stopping Amazon WS instances. If you are not, go through this [http://docs.amazonwebservices.com/AWSEC2/latest/GettingStartedGuide/ tutorial from Amazon WS]. You will need an Amazon WS account. Amazon WS allows you to have [http://aws.amazon.com/free/ free tier so you can learn Amazon WS (EC2, S3, Elastic Load Balancer, Block Storage, SimpleDB,  Simple Queue Service, Simple Notification Service)].


==Fire up an Amazon Instance==

Fire up an Amazon Instance using Amazon Linux (basically CentOS 5.4). Then [http://caucho.com/resin-4.0/changes/resin-4.0.24.xtp#RPM install Resin as follows using RPM]:

<code> <pre>

$ sudo rpm --import http://caucho.com/download/rpm/RPM-GPG-KEY-caucho
$ sudo yum install http://caucho.com/download/rpm/4.0.24/x86_64/resin-pro-4.0.24-1.x86_64.rpm

</pre></code>


==Install Resin on a Local Box==

Install 
[http://caucho.com/resin-4.0/admin/starting-resin-install.xtp#InstallingResinusingthedebpackageonUbuntuandDebian Resin] locally so you test locally and deploy. [http://caucho.com/resin-4.0/admin/starting-resin-install.xtp Feel free to install it on any supported OS].


Add Caucho's Debian repository to your system's repositories to use automated update tools like Synaptic and apt-get. To do this, add the following line to your /etc/apt/sources.list

<code> <pre>
deb http://caucho.com/download/debian unstable multiverse
</pre></code>


Then install Resin as follows:

<code> <pre>
apt-get update
apt-get install resin-pro
</pre></code>

It is a good idea to make sure the version you install on Amazon AMI matches the version you install locally.

You can see that Resin is installed as follows:

<code> <pre>
$ ls /etc/resin
app-default.xml  local.d  resin.properties  resin.xml

$ ls /var/www/
doc  licenses  log  resin-data  watchdog-data  webapps

$ ls /etc/init.d/resin
/etc/init.d/resin

$ ls -l /usr/local/share/resin
lrwxrwxrwx 1 root root 16 2011-11-18 09:03 /usr/local/share/resin -> resin-pro-4.0.24

</pre></code>


Also at this point, Resin should be running as well, and you can verify this with resinctl status:

<code> <pre>
$ resinctl status
Resin/4.0.24 status for watchdog at 127.0.0.1:6600

watchdog:
  watchdog-pid: 7383

server 'app-0' : ACTIVE
  password: missing
  watchdog-user: root
  user: www-data(www-data)
  root: /var/www
  conf: /etc/resin/resin.xml
  pid: 7590
  uptime: 0 days 00h19

</pre></code>

== Install Maven 3 (Optional, for Roo example) ==

If you already have a test .war file, you can skip to the deploy section and deploy your own war.

Install maven. Maven is not in the public Ubuntu repository.

<code><pre>
$ sudo add-apt-repository "deb http://build.discursive.com/apt/ lucid main"
$ sudo apt-get update
$ sudo apt-get install maven
</pre></code>

Create a symbolic link:
<code><pre>
$ sudo ln -s /usr/local/maven/bin/mvn /usr/local/bin/mvn
</pre></code>


== Install Spring Roo (Optional) ==

If you already have a test .war file, you can skip to the deploy section and deploy your own war.

[http://static.springsource.org/spring-roo/reference/html/intro.html#intro-installation Download and install Spring Roo using directions at the Spring Roo site].

This is how I install roo:

<code><pre>
$ unzip spring-roo-1.2.0.RC1.zip
$ sudo mv spring-roo-1.2.0.RC1 /usr/local/share/
$ sudo ln -s /usr/local/share/spring-roo-1.2.0.RC1/ /usr/local/share/spring-roo
$ sudo ln -s /usr/local/share/spring-roo/bin/roo.sh /usr/bin/roo
</pre></code>

At the roo prompt, type hint.

<code><pre>

$ roo
    ____  ____  ____  
   / __ \/ __ \/ __ \ 
  / /_/ / / / / / / / 
 / _, _/ /_/ / /_/ /  
/_/ |_|\____/\____/    1.2.0.RC1 [rev dcaa483]


Welcome to Spring Roo. For assistance press TAB or type "hint" then hit ENTER.
...
roo> hint

..

</pre></code>

Hint should always let you know what you might want to do next. Please feel free to read the Roo docs for details or just follow along and read the Roo docs later.

Create the project, this generates maven project files and Spring starter project.

<code><pre>

roo> project --topLevelPackage com.example.blog

Created ROOT/pom.xml
Created SRC_MAIN_RESOURCES
Created SRC_MAIN_RESOURCES/log4j.properties
Created SPRING_CONFIG_ROOT
Created SPRING_CONFIG_ROOT/applicationContext.xml

</pre></code>

Next setup the database and JPA, keep it simple to minimize the amount of things we need to configure later.

<code><pre>

roo> jpa setup --database H2_IN_MEMORY --provider HIBERNATE 

Created SPRING_CONFIG_ROOT/database.properties
Updated SPRING_CONFIG_ROOT/applicationContext.xml
Created SRC_MAIN_RESOURCES/META-INF/persistence.xml
Updated ROOT/pom.xml [added dependencies com.h2database:h2:1.3.161, org.hibernate:hibernate-core:3.6.8.Final, ...]

</pre></code>

Create a entity class called blog.

<code><pre>

roo> entity jpa --class ~.domain.Blog
Created SRC_MAIN_JAVA/com/example/blog/domain
Created SRC_MAIN_JAVA/com/example/blog/domain/Blog.java
Created SRC_MAIN_JAVA/com/example/blog/domain/Blog_Roo_Configurable.aj
Created SRC_MAIN_JAVA/com/example/blog/domain/Blog_Roo_Jpa_ActiveRecord.aj
Created SRC_MAIN_JAVA/com/example/blog/domain/Blog_Roo_ToString.aj
Created SRC_MAIN_JAVA/com/example/blog/domain/Blog_Roo_Jpa_Entity.aj

</pre></code>


Add two fields to the Blog class.

<code><pre>
~.domain.Blog roo> field string --fieldName title
Updated SRC_MAIN_JAVA/com/example/blog/domain/Blog.java
Created SRC_MAIN_JAVA/com/example/blog/domain/Blog_Roo_JavaBean.aj

~.domain.Blog roo> field string --fieldName message
Updated SRC_MAIN_JAVA/com/example/blog/domain/Blog.java
Updated SRC_MAIN_JAVA/com/example/blog/domain/Blog_Roo_JavaBean.aj
</pre></code>

Create the web tier
<code><pre>
~.domain.Blog roo> web mvc setup
Created ROOT/src/main/webapp/WEB-INF/spring
Created ROOT/src/main/webapp/WEB-INF/spring/webmvc-config.xml
Created ROOT/src/main/webapp/WEB-INF/web.xml
...
Updated ROOT/src/main/webapp/WEB-INF/web.xml
Updated ROOT/pom.xml [added dependencies org.springframework:spring-webmvc:${spring.version}, ...]
Updated SRC_MAIN_WEBAPP/WEB-INF/views/footer.jspx
</pre></code>


Generate the web tier. 

<code><pre>
~.domain.Blog roo> web mvc all --package ~.web

Created SRC_MAIN_JAVA/com/example/blog/web
Created SRC_MAIN_JAVA/com/example/blog/web/BlogController.java
...
Created SRC_MAIN_WEBAPP/WEB-INF/views/blogs
Created SRC_MAIN_WEBAPP/WEB-INF/views/blogs/views.xml
Updated SRC_MAIN_WEBAPP/WEB-INF/views/blogs/views.xml
...
Updated SRC_MAIN_WEBAPP/WEB-INF/views/blogs/views.xml
...
Created SRC_MAIN_WEBAPP/WEB-INF/views/blogs/update.jspx
</pre></code>

Package our web app

<code><pre>
roo> perform package
</pre></code>


Exit roo.
<code><pre>
roo> exit
</pre></code>

== Deploy locally and test ==

Deploy the example Roo app with Resin.

<code><pre>
$ resinctl deploy target/blog-0.1.0.BUILD-SNAPSHOT.war -name blog

Deployed production/webapp/default/blog from target/blog-0.1.0.BUILD-SNAPSHOT.war to hmux://127.0.0.1:6800

</pre></code>


You can see if the app was actually deployed:

<code><pre>
$ resinctl deploy-list

production/webapp/default/blog
</pre></code>

Now you should be able to load the Roo blog example.

http://localhost:8080/blog/


==Create an Elastic IP and assign it to your Amazon WS Linux instance==

Create an Elastic IP and assign it to the Amazon WS Linux instance using the [http://aws.amazon.com/console/ Amazon web console].

I got this IP address.
203.0.113.26


==Create password==


<code><pre>
$ resinctl generate-password -user admin -password roofoo

admin_user : admin
admin_password : {SSHA}BGBKQdCr0a5orH99eqIFwR/fffffffff

</pre></code>

==Create a properties file and put it into user-data of Amazon AMI==

[http://caucho.com/resin-4.0/changes/resin-4.0.24.xtp#resinproperties Resin properties].


<code><pre>
log_level     : info
dev_mode      : true
resin_doc     : true

app_tier      : 127.0.0.1
web_tier      :
cache_tier    :

setuid_user   : www-data
setuid_group  : www-data

http          : 8080
https         : 8443

admin_user : admin
admin_password : {SSHA}BGBKQdCr0a5orH99eqIFwR/ffffffff
admin_external : true
admin_remote_enable : true
session_store : true

</pre></code>


Create an amazon.xml 


<code><pre>
<resin xmlns="http://caucho.com/ns/resin"
      xmlns:resin="urn:java:com.caucho.resin">

  <resin:properties path="http://169.254.169.254/latest/user-data"
                    optional="true"/>

</resin>
</pre></code>


Log into Amazon AMI instance and add the above to /etc/resin/local.d/amazon.xml.


<code><pre>
$ ssh -i resin2.pem ec2-user@203.0.113.26 
$ sudo nano /etc/resin/local.d/amazon.xml
</pre></code>

From your local machine execute this command:


<code><pre>
$ resinctl deploy target/blog-0.1.0.BUILD-SNAPSHOT.war -name blog -address 203.0.113.26 -port 8080 -user admin -password roofoo
</pre></code>


Now it works in the cloud:

http://203.0.113.26:8080/blog/


Next step learn how to spin up instances with eucatools [[Resin Cloud deployment with Amazon WS EC2 and Euca Tools]].


Next step learn how to use MySQL setup with Resin and Amazon RDS [[Resin MySQL and RDS setup with Amazon RDS]].


[[Resin Cloud Deployment Reference]]