Running the Reference Implementation installation script for Windows OS

This web application is installed by running a PowerShell 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.

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).

Procedure

  1. Extract the zip artifacts (from the DDWebApp folder in the installation media)
    In this example we use C:\Temp as the directory where we've extracted the artifacts.
  2. Create a new PowerShell script with following contents
    $discoveryUrl = "http://domain.com:8082/discovery.svc" 
    $clientId = "cduser"
    $clientSecret = "****" | ConvertTo-SecureString -AsPlainText -Force
    
    & C:\Temp\Install-DD-Web-App.ps1 -DiscoveryUrl $discoveryUrl -ClientId $clientId -ClientSecret $clientSecret
  3. Update the values for the following parameters: DiscoveryUrl, ClientId, and ClientSecret
  4. Optionally, set values for Context, LogDirectory and/or LogLevel and EnableFeatures.
    $discoveryUrl = "http://domain.com:8082/discovery.svc" 
    $clientId = "cduser"
    $clientSecret = "****" | ConvertTo-SecureString -AsPlainText -Force
    $logDirectory = "c:/logs" # Defaults to the installation directory of the web app
    $logLevel = "debug" # Defaults to WARN
    $tomcatServiceName = "Tomcat8"
    $context = "/web-app" # Defaults to "/" (ROOT)
    $enableFeatures = "commenting"
    
    & C:\Temp\Install-DD-Web-App.ps1 -DiscoveryUrl $discoveryUrl -ClientId $clientId -ClientSecret $clientSecret -Context $context -LogLevel $logLevel -LogDirectory $logDirectory -TomcatServiceName $tomcatServiceName -EnableFeatures $enableFeatures
  5. Execute the script as an Administrator.