Using and debugging DXA with Web 8.5 on Amazon

Late last year I decided to work on an easier setup for Web 8.5 and, happy with my results, I decided to continue playing around with it.

This post is mostly a reminder to myself of what I needed to do to:

  1. Load DXA on my local machine/visual studio
  2. Connect to the content services running on my AWS server
  3. Debug/run DXA from my local machine

First, installing the DXA.

  1. Download the latest DXA (1.7 at time of writing)
  2. Make sure to unblock this zip file (right click, properties, unblock)
  3. Unzip it somewhere
  4. Browse to [DXARoot]\web\src
  5. Copy the contents of this to wherever it is you want to store your web application, like c:\dev\DXA
  6. Open the DxaWebApp.sln Solution file with Visual Studio

If you have the Package Manager Console enabled in VS, you will get a warning that some packages are missing. Run

PS> Update-Package

This will download the required nuget packages (Sdl.Dxa.Framework-Web8).

At this point your app will build and run… but we’re far from finished.

Now, because we want to be able to run this thing, we need to get a bit deeper in the configuration. First, we’re going to add the Core Module, as documented by SDL here.

  1. Open powershell, and change current folder to [DXA Root]\modules\core
  2. Run ‘web-install.ps1 -distDestination “c:\Dev\Dxa\Site”‘

Back in Visual studio, there’s a nicely somewhat hidden button in Solution Explorer (3rd from the right) to “Show all files”


Clicking this will reveal the core module in your solution now. Right click the “Areas” folder and select “Include in Project”.

Next, let’s configure the DXA settings to talk to the webservices. This may get hairy.

First, if you used my scripts (or the default ones) on an AWS instance, you’ll likely find out the hard way that all your microservices are bound to the instance’s “internal” IP – something in the 10.x range. This won’t work, as the dxa web app won’t be able to connect to those addresses. So, first thing to do is to go EDIT all your cd_storage_conf files (and yes, I mean ALL of them for ALL services) and change the IP address linked to the capabilities to the PUBLIC IP of your AWS instance.

Restart all services once this is done (restart the discovery service first).

Next… go work on firewalls. You need to open access to Discovery, Session, Context, etc – basically, all of them. Remember you need to change this to allow incoming calls on the AWS security group settings and in Windows Firewall.

Once this is done (try accessing http://yourserverip:discoveryport/token.svc – you should get a reply stating “SDL Web OAuth 2.0 Token Servlet.”). It’s time to configure the DXA web app.

Open the web.config in Visual Studio and find the app setting for “discovery-service-uri”

<add key="discovery-service-uri" value="" />

Change this to point to your discovery service.

Next, modify your OAuth settings:

<add key="oauth-enabled" value="true" />
<add key="oauth-client-id" value="cduser" />
<add key="oauth-client-secret" value="WhateverIsTheCdUserPassword" />

If you don’t know your cduser password, check the cd_ambient_conf.xml file on the discovery service.

At this point, you should be good to go. Unfortunately, you’re not. Running this app now will show a nice error message:


This is the minimum you need in your bin\config\cd_ambient_conf.xml:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Configuration xmlns:xsi=""Version="8.5"xsi:noNamespaceSchemaLocation="schemas/cd_ambient_conf.xsd">

  <ForwardedClaims CookieName="TAFContext">
    <Claim Uri="taf:session:preview:preview_session"/>
      <Claim Uri="taf:session:preview:preview_session"/>

Add this (you will also have to create the config folder, inside the bin folder) and re-run your app.

You have now reached your LAST challenge for today. Your browser should be proudly displaying this message:

No matching Localization found for URL 'http://localhost:65393/'

If you’ve played around with Web 8 before, you know how to solve this. If this is your first foray into 8.x, then the reason you’re seeing this is because Tridion is trying to be smart.

With 8.x, SDL introduced some magic components that do smart stuff for you. One of the smart things it does is allow for dynamic configuration of websites (do you remember having to fiddle with cd_storage_conf and cd_link_conf whenever you added a website to a tridion install?). To do this dynamic configuration, Tridion needs to know which publication you are using right now, and it does this by mapping your current URL to a publication ID.

And localhost:65393 (or whatever port visual studio used for you) is not a known URL. So, let’s fix this.

Go to your CM server and open a powershell console.

Run Get-TtmWebsite

This will get you the current list of registered websites, and if you followed my install script, should get you an output similar to this:

PS C:\Users\Administrator> Get-TtmWebsite
BaseUrls             : {http://win-pkt1mendbr7:82}
CdEnvironmentId      : CdEnvironment1
EnvironmentPurpose   : Staging
CdEnvironment        :
ScopedRepositoryKeys : {DxaSiteType, DxaExampleSite}
Id                   : Website1
ExtensionProperties  : {}

What we want to do is add localhost:65393 to the BaseUrls property, so that Tridion can find us. To do that, run this command:

Set-TtmWebsite -Id Website1 -BaseUrls “http://win-pkt1mendbr7:82”, “http://localhost:65393”

Don’t be an idiot, and make sure that the original base url is the correct one instead of my example above. Running Get-TtmWebsite again should now show you something like this:


Run your webapp again, and bask in the glory of your superiority. Or go for a beer to celebrate, whatever rocks your boat.


You will deserve real KUDOS once you manage to get that Experience Manager Icon to load in your web browser and actually work. I’ll tell you right here right now that it is 100% possible with 1 CM configuration change and republishing of one specific page.

5 thoughts on “Using and debugging DXA with Web 8.5 on Amazon

  1. Great guide with detailed instructions. Could you do a similar tutorial for a Java based CD?

  2. Note that there is an installation instruction in the DXA docs that explains you have to copy cd_ambient_conf.xml from the DXA Distribution:

    Also note that there is a way to add a base URL which doesn’t require you to retype the existing ones:

    $website = Get-TtmWebsite Website1
    $website.BaseUrls += “http://localhost:65393″
    Set-TtmWebsite -Data $website

    (PowerShell rocks :-)

  3. Pingback: Using and debugging DXA (Java) with Web 8.5 on Amazon | SDL Tridion Developer

  4. BTW, very useful post. It helped me to run a local DXA using Spring Boot against a SDL Web located in AWS.

    Thank you so much.

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>