1. 2. Configure SitecoreAI instance

Export the site data from the source environment

This process exports all items from the Sitecore site source environment and uploads them to Azure Blob Storage, where they can be accessed by the SitecoreAI Pathway app using the XMCComponentExtraction-x.x.x.zip package.

Note

You can download this package from the 2 Configure SitecoreAI instance page by clicking info.png Read instructions in the Generate storage for source Sitecore XP page data section.

With other websites, this procedure is not needed as the site data is extracted using a crawler.

Note

If you are migrating Sitecore websites, you must have Admin access for XM/XP to change the security settings in the config and upload the extraction handler. You must also have .NET 9.0 installed.

To export the site data from the source environment:

  1. In the extracted XMCComponentExtraction folder, navigate to the AppConfig/Sitecore/ServicesClient/Sitecore.Services.Client.config file and download the file.

  2. Open the Sitecore.Services.Client.config file and change the Sitecore.Services.SecurityPolicy value to Sitecore.Services.Infrastructure.Web.Http.Security.ServicesOnPolicy.

    This change allows the extraction handler to access the required APIs. Revert this setting to its original value after the extraction is complete.

  3. Save and upload the .config file to the file system overwriting the existing file. This is typically done as a config patch.

  4. Navigate to the Sitecore/Admin folder and upload the ExtractorHandler.ashx file that was part of the extracted package. This is typically done through a standard deployment. To verify the handler is accessible, send a request to the .ashx file. A valid response indicates the handler is working correctly.

  5. On the Configure SitecoreAI instance page of the migration wizard, in the Generate storage for source Sitecore XP page data section, click in the Upload URL field and copy the Azure Blob Storage URL.

    Configure SitecoreAI instance Azure Blob Storage URL

  6. Open a terminal and run the extraction app (Extractor.App.Con.exe) with the following parameters:

    • CM Host - the hostname of the source XM/XP Content Management host.
    • Username - the username of an admin account on the source XM/XP environment.
    • Password - the password for the admin account.
    • Upload URL - the Azure Blob Storage URL.

    For example:

    .\\Extractor.App.Con.exe --cmHostName={YOUR_CM_HOST} --userName={YOUR_ADMIN_USER_NAME} --password={YOUR_PASSWORD} --uploadUrl="{UPLOAD_URL}"
If you have suggestions for improving this article, let us know!