Documentation Center

Installing SDL Digital Experience Accelerator for the sample single-machine installation

Install SDL Digital Experience Accelerator, or DXA for short, to create Publications with sample content in Content Manager, as well as a dynamic, responsive and device-independent sample Web site with a customizable HTML design, together with a .NET Web application.

Procedure

  1. Click here to download the latest release of the .NET version of DXA.
  2. If SDL Web 8.5 is not the latest SDL Web release, check if the DXA release you just downloaded is compatible with it.
  3. If the DXA release you just downloaded is not compatible with SDL Web 8.5, discard your download and instead refer to the GitHub repository for the .NET version of DXA to find and download a DXA release that is compatible.
  4. In Windows Explorer, find the zip file you downloaded, right-click it, select Properties from the context menu, and in the dialog that opens, select Unblock. Then click OK to apply your change and close the dialog.
  5. Create a new folder, c:\SDLDXAinstall\.
  6. Unzip the zip file you downloaded into this folder.
  7. In PowerShell, navigate to c:\SDLDXAinstall\cms\.
  8. Run the following command:
    & '.\ttm-prepare.ps1'

    Ignore any warnings that appear while running this script.

  9. When prompted for a Discovery Service URL for the 'Staging' environment, enter http://localhost:8082/discovery.svc.
  10. When prompted for an OAuth Client ID, enter cmuser.
  11. When prompted for an OAuth Client secret, enter CMUserP@ssw0rd.
  12. When prompted for DXA 'Staging' Website Base URL(s), enter http://localhost:93.
  13. When prompted for a Discovery Service URL for the 'Live' environment, leave it empty.
    The script runs and sets up the Topology.
  14. Run the following command:
    .\cms-import.ps1 -importType all-publications -cmsUrl http://localhost:91
    The script runs and imports Publications into your Content Manager.
  15. Run the following command:
    .\cms-import.ps1 -importType rights-permissions -cmsUrl http://localhost:91
    The script runs and sets up permissions.
  16. Open an internet browser and go to http://localhost:91/.
  17. From the slide-out menu on the left, select Content Explorer.
    The Content Manager Explorer main screen appears, with a popup dialog showing the default language and locale.
  18. Select Apply and Refresh in the popup dialog to close it.
  19. In the Publications pane on the left, select 400 Example Site.
  20. In the content area, select the Home Structure Group.
  21. In the Ribbon tab above, select Publish.
    The Publish dialog opens.
  22. Select DXA Staging on the left and clear Republish Only (Do Not Publish New Content) on the right. Then select Publish.
    The Publish dialog closes.
  23. In the Ribbon tab above, select Publishing Queue.
    The Publishing Queue dialog opens.
  24. Select Show Tasks to see your publish action in the table below.
  25. Select the refresh button above the table to refresh the table, and continue doing so until the State column shows the value Success. This typically takes several minutes.
  26. Select Close.
  27. Back in the main screen, in the content area, double-click the Home Structure Group to see its contents.
  28. Select the Page called _Navigation.
  29. In the Home Ribbon tab above, select Publish again.
  30. In the Publish dialog, select DXA Staging and select Publish.
    The Publish dialog closes.
  31. Check your publish progress in the Publishing Queue dialog as before. This publish action typically takes less than a minute to complete.
  32. Select Close to close the Publishing Queue dialog.
  33. In your PowerShell console, navigate to c:\SDLDXAinstall\web\.
  34. Run the following command:
    .\web-install.ps1 -distDestination "C:\inetpub\wwwroot\DXA_Staging" -webName "DXA Staging" -sitePort 93 -discoveryServiceUrl http://localhost:8082/discovery.svc
  35. Remove the folder c:\SDLDXAinstall\
  36. Visit http://localhost:93 to see the sample Web site.