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 in SDL Web 8 or SDL Tridion 2013 SP1 (deprecated).

Before you begin

  • To perform this import, you must be logged in as a user with administrator-level access to SDL Web 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 file DXA Application Data Definition.xml 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 and specify the following mandatory parameters 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 value 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/"
  7. If you had previously published Publications on your Content Manager that contain Categories contained in this import, those Categories will now have become non-publishable. One consequence of this is that you are now unable to unpublish those Categories. To fix this, do the following:
    1. Access the URL of Content Manager Explorer
    2. In tree view, navigate to a Publication you want to be able to unpublish, and which contains these Categories.
    3. Open the Categories and Keywords node
    4. Right-click one of the Categories that were rendered non-publishable by the import.
      The Category properties open in a new browser tab.
    5. On the General tab, select the Publishable option.
    6. In the Home ribbon tab, select Save and Close to commit your changes and close the Category.
    7. Repeat steps d through f for all other applicable Categories.
    8. Repeat steps b through f for all other Publications that contain these Categories.
    9. Unpublish the Publications you want to unpublish.
    10. If you want, clear the Publishable option on the Categories you don't want to be publishable.

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 Known issues section for possible solution to your problem.