Documentation Center

Upgrading your Background Task configuration

Only if you're upgrading Content Manager from a release older than Tridion Docs 15, you must transform your existing Background Task configuration XML from old format to Tridion Docs 15 format by running a Powershell script before starting your upgrade. During the upgrade, the configuration XML will then be automatically transformed to Tridion Docs 15.1 format.

About this task

If you're upgrading from Tridion Docs 15, you can skip this task, because your Background Task configuration will be upgraded for Tridion Docs 15.1automatically. But if you're upgrading from an earlier version than Tridion Docs 15, you must run a Powershell script before starting your upgrade.

Procedure

  1. On your installation media, go to the folder __Resources\InfoShareScripts\Upgrade140xTo1500\.
  2. Copy the script ConvertBackgroundTaskConfiguration.ps1 to your Content Manager server machine.
  3. The script looks for your Background Task configuration XML file in the folder C:\InfoShare\Web\Author\EnterViaUI\. If you would like the conversion to occur in another folder, edit the script to change the path.
  4. Run the Powershell script.
    The script reads Admin.XMLBackgroundTaskConfiguration.xml and creates a converted file Admin.XMLBackgroundTaskConfiguration.converted.xml in the same folder.
  5. Replace your existing XML Background Task configuration in the Content Manager database with the contents of the converted file. You can do this in one of the following ways:
    • In the Tridion Docs web client user interface, select Settings and then XML Background Task Settings. Clear the XML content you see, and paste the contents of Admin.XMLBackgroundTaskConfiguration.converted.xml into it. Then select Save to apply the change.
    • Write a script that replaces the XML in the database with the contents of Admin.XMLBackgroundTaskConfiguration.converted.xml, and run it.

What to do next

Your Background Task configuration is now in Tridion Docs 15 format. The upgrade process will automatically upgrade it to the Tridion Docs 15.1 format.