Scout/Tutorial/4.0/cloud/add cloud support

The Scout documentation has been moved to https://eclipsescout.github.io/.

Scout Tutorial
This page belongs to the Cloud Tutorial.

• Back: New Eclipse Scout Project
• Next: Deploy your Scout App to the Cloud

Add Cloud Support to your Application

In the steps described below, we describe how to add the necessary plugins and services to enable cloud support for your application.

Installation of Synchronization Service Connectors

There are a number of plugins available on the Eclipse marketplace to support running scout applications in the cloud.

Adding Synchronization Service Connectors to your Application

After the installation of the cloud support plugins it is necessary to add the desired plugins to the product files that define your application.

This Change affects the following two product files: - /org.eclipse.scout.helloworld.server/products/development/helloworld-server-dev.product - /org.eclipse.scout.helloworld.server/products/production/helloworld-server.product

Open both product files, then open the Tab Dependencies and click “Add ...”.

For each Service two plugins are required:

• Memcachd (cache service)
  • com.bsiag.net.spy.memcached
  • org.eclipse.scout.rt.server.memcached
• Redis (cache service)
  • com.bsiag.redis.clients.jedis
  • org.eclipse.scout.rt.server.redis
• RabbitMQ (message queue service)
  • com.bsiag.com.rabbitmq.clients
  • org.eclipse.scout.rt.server.rabbitmq
• ActiveMQ (message queue service)
  • com.bsiag.org.apache.activemq.all
  • org.eclipse.scout.rt.server.activemq

Register the ClusterSynchronizationService

Open the /org.eclipse.scout.helloworld.server/plugin.xml and open the Tab Extensions. Select the Extension Point “org.eclipse.scout.service.services” and open the context menu. Select New -> Service.

Insert the Class-Field “org.eclipse.scout.rt.server.services.common.clustersync.ClusterSynchronizationService” and save the file.  

Configuration of Synchronization Service Connectors

For each installed service the service configuration has to be done in the config.ini-File of the server application.

Memcached

org.eclipse.scout.rt.server.memcached.MemcachedCacheService#url=
org.eclipse.scout.rt.server.memcached.MemcachedCacheService#port=
org.eclipse.scout.rt.server.memcached.MemcachedCacheService#auth=
org.eclipse.scout.rt.server.memcached.MemcachedCacheService#username=
org.eclipse.scout.rt.server.memcached.MemcachedCacheService#password=

Redis

org.eclipse.scout.rt.server.redis.RedisCacheService#host=
org.eclipse.scout.rt.server.redis.RedisCacheService#port=
org.eclipse.scout.rt.server.redis.RedisCacheService#auth=
org.eclipse.scout.rt.server.redis.RedisCacheService#password=

RabbitMQ

org.eclipse.scout.rt.server.rabbitmq.RabbitMQMessageService#host=
org.eclipse.scout.rt.server.rabbitmq.RabbitMQMessageService#auth=
org.eclipse.scout.rt.server.rabbitmq.RabbitMQMessageService#user=
org.eclipse.scout.rt.server.rabbitmq.RabbitMQMessageService#password=

ActiveMQ

org.eclipse.scout.rt.server.activemq.ActiveMQMessageService#host=
org.eclipse.scout.rt.server.activemq.ActiveMQMessageService#port=
org.eclipse.scout.rt.server.activemq.ActiveMQMessageService#password=
org.eclipse.scout.rt.server.activemq.ActiveMQMessageService#username=
org.eclipse.scout.rt.server.activemq.ActiveMQMessageService#auth=

The auth-Parameter accepts true or false of enabling and disabling the authentication. If your Services run at the default Port, you mustn't declare them in config.ini.