Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: for the plan.

Jump to: navigation, search

Scout/Tutorial/5.0/cloud/deploy on cloud

< Scout‎ | Tutorial‎ | 5.0
Scout Tutorial
This page belongs to the Cloud Tutorial.

Deploy your Scout App to the Cloud

We analyzed several PaaS vendors and made a list of vendors which are able to run the eclipse scout server application. See section "Suitable PaaS Providers" in this blog post for a brief overview.

As Amazon is a big player in the cloud environment and one of the few vendors who offer running multiple server nodes for free, this tutorial is based on the Amazon AWS Elastic Beanstalk offering to describe the installation and deployment of a Scout application to a PaaS environment.

If your don't have an Amazon AWS Acount just sign up here.


Before you can upload your Scout application, you have to configure the necessary database, cache and message queue services.

For the configuration of those services login to your Amazon [Console].


  1. Under the category Database open the point "ElastiCache - In-Memory Cache".
  2. Select "Launch Cache Cluster"
  3. Fill the Cluster Details like in the Graphic below.
    Scout cloud aws add memcached specify details.png
  4. In the additional cluster configuration are no changes needed. Click next.
    Scout cloud aws add memcached additional configuration.png
  5. Finally you get an overview over your cluster configuration. If everything is fine click "Launch Cache Cluster"


Amazon provides with AWS SNS & AWS SQS a Pub/Sub Messaging-System but its not easy to build a dynamic environment with this solution. Its easier to use to offer of They are providing the RabbitMQ Message Queue as a Service, hosted in the Amazon Cloud. So create an Account at for later use.

MySQL (optionally)

If you later want to use a database follow this steps, if not continue with "Create Beanstalk Application"

  1. Under the category Database open the point "RDS - Managed Relational Database Service".
  2. Create a new Database Instance by clicking "Launch a DB Instance".
    Scout cloud aws add mysql.png
  3. Select MySQL as Engine.
    Scout cloud aws add mysql select engine.png
  4. Select the option "No, this instance is intended for use outside of production or under the RDS Free Usage Tier"
    Scout cloud aws add mysql production plan.png
  5. In the next step you can specify your DB details.
    Scout cloud aws add mysql specify details.png
  6. In the advanced settings set the Database Name to "scoutcloud"
    Scout cloud aws add mysql configure advanced settings.png
  7. Finally launch the DB Instance.
If you want to connect from your local system to the DB, you have to add your ISP IP-Adress to the Security Group of the Database

Configure your Application & Build War-File for your server application

That your applications runs correctly on your AWS Cloud you have to insert your service parameter into the config.ini of your server application. Then open the Scout Explorer, right-click on "org.eclipse.scout.helloworld". Then click "Export Scout Projekt ..." and follow the wizard.

Create Beanstalk Application

  1. Open the AWS Elastic Beanstalk Console
  2. Click the button "Create New Application"
    Scout cloud aws create application start.png
  3. Define a name for your Application
    Scout cloud aws create application define name.png
  4. In the next Step you have to choose the option web server as your environment tier and tomcat as your predefined configuration. As environment type please choose load balancing, autoscaling.
    Scout cloud aws create application choose envoriment.png
  5. Upload your -File, which your build here.
    Scout cloud aws create application upload application.png
  6. Specify the name and url of your environment
    Scout cloud aws create application specify environment.png
  7. Additional Resources are not needed, click next.
    Scout cloud aws create application additional resources.png
  8. Select your t1.micro as your instance type and AWS Windows as EC2 key pair.
    Scout cloud aws create application configuration details.png
  9. Setting Environment Tags is not necessary, click next.
    Scout cloud aws create application environment tags.png
  10. Review your configuration and click Launch.
    Scout cloud aws create application review.png
  11. Check your application by clicking on your URL in the AWS application overview
    Scout cloud aws launch application.png
  12. If the deploy was successful, you will see the Eclipse Scout Welcome Screen as in the graphic below
    Scout cloud aws launch application browser.png
  13. To check if the interaction with the configured services is working append /process to your URL and login with Admin/Admin
    Scout cloud aws launch application browser process.png

The Scout documentation has been moved to

Back to the top