Documentation Center

Installing the web application in Web 8 (.NET)

Run the web-install.ps1 PowerShell script using the available parameters to create the Web application for SDL Digital Experience Accelerator Web sites.

About this task

Setting Parameters
You can set the script parameters before running the script or on the command line:
  • Set the parameters on the command line when you run web-install.ps1 from the PowerShell command line, prefixing the parameters with a hyphen, for example -distDestination
This task describes how to run the script and set parameters on the command line.
Installing on Live and Staging Web sites
You need to run the web-install.ps1 PowerShell script on each machine where you want to publish content to, as defined by your Publication Targets. For example, on a Live machine where your external Web site is running, and/or on your Staging machine where you publish to an internal Web site where Experience Manager is set up for inline editing.

Procedure

  1. Access your SDL Digital Experience Accelerator installation media.
  2. Open a PowerShell command prompt in Run as administrator mode.
  3. Navigate to the \web\web8 folder and run the web-install.ps1 script specifying each parameter-value pair in the following format -parameter "value" (enclosing values in quotes if needed).

    For example (on one line):

    & '.web-install.ps1' -distDestination "C:\inetpub\wwwroot\DXA_Staging" 
    -webName "DXA Staging" -sitePort 8888 -discoveryServiceUrl http://localhost:8082/discovery.svc
  4. Specify the following parameters:
    ParameterDescriptionDefault
    distDestination File system path of the DXA Website root folder.none
    webName(optional) The name of the DXA Website.DXA
    siteDomain(optional) The host header of the DXA Website used in configs. Specify empty string to use the current computer name.none
    sitePortThe port for the DXA Websitenone
    logFolder(optional) The path to the log directory.C:\temp\logs
    logLevelThe level of Content Delivery logging.
    Possible values:
    • DEBUG
    • ERROR
    • INFO
    • TRACE
    • ALL
    • OFF
    • WARN
    ERROR
    siteLogFileThe log file name.site.log
    webSiteActionThe action to perform when the DXA Web site already exists.
    Possible values (the script prompts you to specify):
    • Ask- asks user what action to perform.
    • Cancel - cancels setup.
    • Preserve - use the existing Web site for Web application deployment: the distDestination, sitePort, and siteDomain parameters will be overwritten with Web site data.
    • Recreate - delete the old Web site and create a new one with specified parameters.
    Ask
    discoveryServiceUrlThe URL of the Discovery Service.none
    oAuthClientId(optional) The OAuth client ID. cduser
    oAuthClientSecret(optional) The OAuth client secret.CDUserP@ssw0rd
    The script creates the Web application.
  5. Start the Web application.