JBoss Community Archive (Read Only)

JBoss Cloud Access

Launching a standalone JBoss Enterprise Application Platform instance

In this example a sample web application is deployed to a standalone JBoss Enterprise Application Platform. For an example using clustering, refer to Launching clustered JBoss Enterprise Application Platform instances.


  • An Amazon EC2 subscriptionI;

  • A pre-configured Security Group which allows incoming requests on ports 22 and 8080.

Launch JBoss Enterprise Application Platform

  1. In the 'Navigation' pane, click on "Launch Instance";

  2. Find and select a Jboss Enterprise Web Server AMI according to Configure and launch AMI;

  3. Click in the "User Data:" field and enter the following lines:

    JBOSSAS_ADMIN_PASSWORD=<your password for opening admin console>
    JBOSS_IP= #listen on all IPs and interfaces
    cat> $USER_SCRIPT << "EOF"
    ## Deploy your application from an Internet URL
    # wget https://<your secure storage hostname>/<path>/<app name>.war -O /var/lib/jbossas/server/$JBOSSCONF/deploy/
    # deploy sample application from the local filesystem
    cp /usr/share/java/jboss-ec2-eap-samples/hello-1.0.war /var/lib/jbossas/server/$JBOSSCONF/deploy/hello.war
  4. continue with the instructions from Configure and launch AMI;

  5. Wait until the instance's status is shown as "running"

There are a number of parameters which can be used in the User Data field to customize the configuration and deployment of JBoss Enterprise Application Platform. Refer to Appendix 1 - User Script Parameters for details.

Test JBoss Enterprise Application Server

  1. In the instance details pane, note the instance's "Public DNS";

  2. In a browser, navigate to http://<public-DNS>:8080/hello;

  3. Confirm that the text "Hello World!" appears, otherwise refer to the Troubleshooting section below;

  4. In a browser, navigate to http://<public-DNS>:8080;

  5. Confirm that the JBoss Enterprise Application Platform home page appears, including a hyperlink to the Admin Console;

  6. Click on the "Admin Console" hyperlink and log in with the username "admin" and the password you entered in the 'User Data" field;

  7. Logout of the JBoss Enterprise Administration Platform Admin Console.

For an example that uses an RDBMS through Amazon' Relational Database Service (RDS) for JBoss Enterprise Application Platform and application, refer to Launching clustered JBoss Enterprise Application Platform instances.

If this is to be a production instance, add the following command under USER_SCRIPT in user data field, to ensure that security updates are applied on boot:

yum -y update
Make sure you run yum update regularly to apply latest security fixes and enhancements.

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-11 09:48:22 UTC, last content change 2012-05-22 14:54:39 UTC.