24.4. Non-clustered Instances

Procedure 24.1. Launch a Non-clustered Instance of JBoss EAP 6 on a Red Hat AMI (Amazon Machine Image)

1. Configure the User Data field. The configurable parameters are available here: Section 24.10.1, “Permanent Configuration Parameters”, Section 24.10.2, “Custom Script Parameters”.

   Example 24.1. Example User Data Field

   The example shows the User Data field for a non-clustered JBoss EAP 6 instance. The password for the user admin has been set to adminpwd.

   JBOSSAS_ADMIN_PASSWORD=adminpwd
   JBOSS_IP=0.0.0.0 #listen on all IPs and interfaces
   
   # In production, access to these ports needs to be restricted for security reasons
   PORTS_ALLOWED="9990 9443"
   
   cat> $USER_SCRIPT << "EOF"
   
   # Get the application to be deployed from an Internet URL
   # mkdir -p /usr/share/java/jboss-ec2-eap-applications
   # wget https://<your secure storage hostname>/<path>/<app name>.war -O /usr/share/java/jboss-ec2-eap-applications/<app name>.war 
   
   # Create a file of CLI commands to be executed after starting the server
   cat> $USER_CLI_COMMANDS << "EOC" 
   # deploy /usr/share/java/jboss-ec2-eap-applications/<app name>.war
   EOC
   
   EOF
   

2. For Production Instances

   For a production instance, add the following line beneath the USER_SCRIPT line of the User Data field, to ensure security updates are applied on boot.

   yum -y update

   Note

   yum -y update should be run regularly, to apply security fixes and enhancements.
3. Launch the Red Hat AMI instance.

1. • Deploy the Sample Application

     Add the following lines to the User Data field:

     # Deploy the sample application from the local filesystem
     deploy --force /usr/share/java/jboss-ec2-eap-samples/hello.war
     

     Example 24.2. Example User Data Field with Sample Application

     This example uses the sample application provided on the Red Hat AMI. It also includes basic configuration for a non-clustered JBoss EAP 6 instance. The password for the user admin has been set to adminpwd.

     JBOSSAS_ADMIN_PASSWORD=adminpwd
     JBOSS_IP=0.0.0.0 #listen on all IPs and interfaces
     
     # In production, access to these ports needs to be restricted for security reasons
     PORTS_ALLOWED="9990 9443"
     
     cat> $USER_SCRIPT << "EOF"
     
     # Create a file of CLI commands to be executed after starting the server
     cat> $USER_CLI_COMMANDS << "EOC" 
     
     # Deploy the sample application from the local filesystem
     deploy --force /usr/share/java/jboss-ec2-eap-samples/hello.war
     EOC
     
     EOF
     

   • Deploy a Custom Application

     Add the following lines to the User Data field, configuring the application name and the URL:

     # Get the application to be deployed from an Internet URL
     mkdir -p /usr/share/java/jboss-ec2-eap-applications
     wget https://<your secure storage hostname>/<path>/<app name>.war -O /usr/share/java/jboss-ec2-eap-applications/<app name>.war
     

     Example 24.3. Example User Data Field with Custom Application

     This example uses an application called MyApp, and includes basic configuration for a non-clustered JBoss EAP 6 instance. The password for the user admin has been set to adminpwd.

     JBOSSAS_ADMIN_PASSWORD=adminpwd
     JBOSS_IP=0.0.0.0 #listen on all IPs and interfaces
     
     # In production, access to these ports needs to be restricted for security reasons
     PORTS_ALLOWED="9990 9443"
     
     cat> $USER_SCRIPT << "EOF"
     
     # Get the application to be deployed from an Internet URL
     mkdir -p /usr/share/java/jboss-ec2-eap-applications
     wget https://PATH_TO_MYAPP/MyApp.war -O /usr/share/java/jboss-ec2-eap-applications/MyApp.war 
     
     # Create a file of CLI commands to be executed after starting the server
     cat> $USER_CLI_COMMANDS << "EOC" 
     deploy /usr/share/java/jboss-ec2-eap-applications/MyApp.war
     EOC
     
     EOF
     

2. Launch the Red Hat AMI instance.

Procedure 24.2. Test the Non-clustered JBoss EAP 6 Instance is Running Correctly

1. Determine the instance's Public DNS, located in the instance's details pane.
2. Navigate to http://<public-DNS>:8080.
3. Confirm that the JBoss EAP home page appears, including a link to the Admin console. If the home page is not available, refer here: Section 24.11.1, “About Troubleshooting Amazon EC2”.
4. Click on the Admin Console hyperlink.
5. Log in:
   • Username: admin
   • Password: Specified in the User Data field here: Section 24.4.1, “Launch a Non-clustered JBoss EAP 6 Instance”.

6. Test the Sample Application

   Navigate to http://<public-DNS>:8080/hello to test that the sample application is running successfully. The text Hello World! should appear in the browser. If the text is not visible, refer here: Section 24.11.1, “About Troubleshooting Amazon EC2”.
7. Log out of the JBoss EAP 6 Admin Console.