Pre-upgrade Tool - for managing muliple path Channels and CommCore Installation

Managing Channels and CommCore Server Files on Upgrade when installed in different paths

If Channels and CommCore are installed in different paths prior to upgrading to Channels CU10 or a Channels CU10 QFE from a version prior to CU10, there is a possibility of Web.config and other files no being migrated after the upgrade.  To prevent loss of files, system administrators should to run a pre-upgrade script provided in this article. This script identifies the Channels and CommCore installation folders, updates the filesystem and prepares the server for the upgrade. There is no reason to run this tool if the installation is a stand-alone Channels Server, a stand-alone CommCore Server or a server with Channels and CommCore files in the same install path.

ChannelsPlatformPreUpgradeScript9.4CU10QFE01.zip

The script detects and overwrites files/filetypes (if present) in the following directories while copying the files to the relevant destinations.

<installPath>\NetAgent Server\<IP Addresss>\templates\*.*

<installPath>\NetAgent Server\CommCore Services\moxie\PostOffice\templates\*.*

<installPath>\NetAgent Server\<IP Address>\http\Libraries\AW\source\lib\templates\*.*

<installPath>\NetAgent Server\<IP Address>\emailtemp\*.*

<installPath>\NetAgent Server\<IP Address>\http\LANGFILESW\*.*

<installPath>\NetAgent Server\<IP Address>\http\salesconversion.aspx

<installPath>\NetAgent Server\<IP Address>\http\conf\emailportal.xml

<installPath>\NetAgent Server\<IP Address>\attachments\*.*

<installPath>\NetAgent Server\<IP Address>\library\*.*

<installPath>\NetAgent Server\<IP Address>\http\*.config

<installPath>\NetAgent Server\<SurveyInstance>\Survey\http\*.config

<installPath>\NetAgent Server\<SurveyInstance>\Survey\*.*

Execute this script as described below: 

  1. Copy the file ChannelsPlatformPreUpgradeScript9.4CU10QFE01.zip and extract its contents to a local folder.
  2. Start a PowerShell Command Prompt.
    1. Type PowerShell in the  Windows > Search box
    2. Right-Click Windows PowerShell > Click “Run as Administrator” > Click “Yes” In the pop-up prompt.
  3. Navigate to the folder in step 1 above, and execute the script: ChannelsPlatformPreUpgradeScript9.4CU10QFE01.ps1
  4. Verify that  the procedure is complete by viewing the output in the PowerShell window, or reading the log file generated.

 %ProgramData%\Moxie\SetupLog\ChannelsPlatformPreUpgradeScript.log

 If executed on any of the following this script exits without taking any action:

  • A stand-alone Channels Server.
  • A stand-alone CommCore Server.
  • A server with Channels and CommCore files in the same install path.