Documentation Center

Importing the DXA Publications into Content Manager

Run the cms-import.ps1 PowerShell import script to import the Publications and content items that comprise DXA into your Content Manager be it SDL Tridion 2013 SP1 or Web 8.

Before you begin

  • To perform this import, you must be logged in as a user with administrator-level access to your SDL Tridion Content Manager.
  • The Content Manager must not contain Publications called 000 Empty, 100 Master, 110 DXASite Type, 200 Example Content, and 400 Example Site.

Procedure

  1. Access your SDL Digital Experience Accelerator installation media.
  2. From the cms\ folder, copy the DXA Application Data Definition.xml file to %TRIDION_HOME%\config\ImportExport\ApplicationData\ .
  3. Open a PowerShell command prompt in Run as administrator mode.
  4. (For SDL Web 8) Run the ttm-prepare.ps1 script to preconfigure the Topology Manager for the DXA Site Type and Business Process Types.
  5. Navigate to the cms\ folder and run the cms-import.ps1 script specifying each parameter-value pair in the format -parameter "value" (enclosing values in quotes if needed). For example:
    .\cms-import.ps1 -importType all-publications -cmsUrl "https://cms.example.com:81/"
    ParameterDescription
    importType

    Possible values are:

    • all-publications—creates a BluePrint with the following publications: 000 Empty, 100 Master, 110 DXASite Type, 200 Example Content, and 400 Example Site.
    • master-only—imports the DXA configuration, Schemas, and Templates into an existing Master Publication.
    • example-publications—imports the DXA example content and pages into an existing Web site Publications
    cmsUrlSpecifies the Web address of Content Manager Explorer.
    masterPublication

    When running in master-only mode, specify the name of the Publication to import to.

    By default, masterPublication is set to "100 Master".

    rootPublicationTitle of the BluePrint Root Publication.
    rootStructureGroup

    When running in master-only or example publications mode, specify root Structure Group of your Web site Publication names, and the title of the root Structure Group.

    By default, rootStructureGroup is set to "Home".

    noTopologyManager (optional) Suppresses the creation of mappings in SDL Web 8 Topology Manager (which requires Topology Manager cmdlets).
    cmsUserName(optional) The username used for the authentication.
    cmsUserPassword(optional) The password for the provided username.
    cmsAuth(optional) The authentication type; possible values are: Windows (default), and Basic. You can use the Basic authentication type, in case your Content Manager Server requires credentials other than Windows credentials.
    WhatIf(optional) This parameter takes no value and causes the script to only describe what it would do, without making any changes.
    Confirm(optional) This parameter takes no value, describes what the script will do and prompts for confirmation before proceeding.
    The cms-import.ps1 script imports DXA items into your Content Manager instance.
  6. Run cms-import.ps1 again and specify the following parameters to set Rights and Permissions for the default User Groups on the imported content:
    ParameterDescription
    importType

    Specify rights-permissions.

    cmsUrlSpecify the Web address of Content Manager Explorer.
    .\cms-import.ps1 -importType rights-permissions -cmsUrl "https://cms.example.com:81/"

Results

Go to the Web address of your Content Manager Explorer and confirm that the import created new Publications and assigned security.

If you import fails for any reason, see the Know issues section for possible solution to your problem.