Running the Reference Implementation installation script for Linux OS

This web application is installed on a Linux system by running a script. The Dynamic Delivery Reference Implementation you'll set up is initially unsecured.

Before you begin

Refer to the related topic for more information to understand each of the install parameters.

  • Use only Java version 8
  • Set the JAVA_HOME environment variable to point to the Java installation directory
  • You need to have a Tomcat service installed, either Tomcat8 or Tomcat9
  • If you use the default context, the script is expecting to use a folder ROOT to deploy the ROOT.war file, so you need delete any existing ROOT folder before running the script.
You need to provide the Tomcat location. You can set this location using a script parameter as described below, or rely on the environment variable CATALINA_HOME for setting the Tomcat location.

About this task

This task is intended for you to get started using the Reference Implementation, easily and quickly.

If you are an advanced implementer and wish to install or configure the API (RESTful) role yourself, then you should refer to the related Content Delivery topics on Installing the API (RESTful) role and the Content Delivery client configuration file (cd_client_conf.xml).

The script you are using has the general format:
>>bash Install-DD-Web-App.sh -<param1> <value1> ... -<paramN> <valueN>
where each parameter begins with a dash followed by its value separated by a space.

Procedure

  1. Extract the zip artifacts (from the DDWebApp folder in the installation media)
  2. Run the Bash script with your user credentials and discovery URL. Provide the actual clientId, clientSecret and discoveryUrl, with this line as an example:
    $ bash Install-DD-Web-App.sh -discoveryUrl http://localhost:8080/discovery.svc -clientId cduser -clientSecret password123
  3. Optionally, set values for context, logDirectory and/or logLevel, tomcatLocation and enableFeatures.
    $ bash Install-DD-Web-App.sh -tomcatLocation "/opt/apache tomcat 8.5.23/" -discoveryUrl http://localhost:8080/discovery.svc -clientId cduser -clientSecret passwd123 -context "/webapp" -enableFeatures commenting -logLevel error -logDirectory "/logs/webapp"