Deploy the Authoring and Delivery Web Applications Separately - BloomReach Experience - Open Source CMS

This article covers a Hippo CMS version 12. There's an updated version available that covers our most recent release.

10-08-2017

Deploy the Authoring and Delivery Web Applications Separately

Introduction

Goal

Deploy the authoring and delivery applications in separate containers.

Background

Typically, BloomReach Experience Manager's authoring (cms) and delivery (site) applications are deployed together on the same server. The delivery application has access to the repository which is hosted by the authoring application. However there are use cases where deploying the authoring and delivery applications separately on different application servers is preferable. For example you may want to deploy the delivery application on multiple servers to increase availability. In these cases the delivery application is deployed without the authoring application, therefore it cannot access the repository hosted by the latter.

The solution is to package the content repository as a separate web application and deploy it together with the delivery application. The repository webapp will provide for access from the delivery application to the underlying storage repository.

See Create Separate Distributions for the Authoring and Delivery Web Applications for instructions on how to set up a project for this deployment scenario.

Requirements

Deployment

The project should be delivered as two separate distributions for the authoring and delivery applications. These two tar.gz files contain the web applications for each server. Deploy the cms and site WARs to the first server, and the site and repository WARs to the second.

Take special care to:

  • Specify the location of your repository.xml on both servers. This is done with the system property repo.config as mentioned in Configure the Application Server (Apache Tomcat on Linux).
  • Disable bootstrapping on the delivery server (-Drepo.bootstrap=false).

    Always start up the container hosting the delivery application (site.war) with bootstrapping disabled, i.e. with -Drepo.bootstrap=false.
    If you would enable bootstrapping for the delivery application, the following undesirable scenario would unfold:
    The bootstrap process removes all YAML definitions from the repository that it can't find on the classpath; because you have a limited set of artifacts on the repository classpath, a lot of YAML definitions will be removed; next time you start up the authoring node, where these YAML definitions items are on the classpath, the bootstrap process will re-import those YAML definitions because it can't find them in the repository anymore. The result is that you end up with duplicate content and configuration all over the place.
  • Make sure the authoring clusters are started before starting the delivery clusters.

Disabling Scheduled Jobs on the Delivery Nodes

By default all repository instances perform scheduled tasks in a clustered repository setup. Scheduled tasks are amongst others: scheduled (de-)publications, repository maintenance jobs, checking for brokenlinks, etc. In case you want to be sure that these actions do not run on the delivery nodes, you can disable this behaviour by adding the following directive to the startup script of the application container.

-Dhippo.scheduler.disabled=true
Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?