Deploying Migration Framework

POA Migration Framework is distributed as an MSI script (pkg/MigrationFramework/Installer_MigFrm.msi) inside POA Migration product.

  1. Install the Framework on the Management Node of a source system, which is going to be migrated in POA.

    Note: If you are going to use domain account (not the local one) for migration the running service/website, you must run installation under the account with the Domain Administrator privileges (not the Local Administrator).

    POA Migration Framework Deployment

    Click Next.

  2. Browse the destination folder or use the default (recommended).

    POA Migration Framework deployment - Step 2

    Click Next to continue.

  3. Choose the type of the web service installation.

    Note: IIS installation type will not be available if IIS (minimum version is 6.0) with WWW service and ASP.NET components is not installed.

    POA Migration Framework Deployment - Step 4

    click Next button.

  4. Select an IP address and TCP port (it is recommended to use the default value).

    POA Migration Framework Deployment - Step 5

    Click the Next button.

  5. Specify credentials for Migration Framework service. It is recommended to use an account from the Local Administrators group or from the Domain Administrators group. Enter the User Name with Windows domain name (for a local user choose a computer name as a domain name) and enter the password.

    Click the Next button.

    POA Migration Framework Deployment - Step 6

  6. Click Install.

    POA Migration Framework Deployment - Step 7

  7. Click Finish.

    POA Migration Framework Deployment - Step 8

Known Issues

Error occurs during platform registration.

Precondition:

Agent uses Jet Text CSV database source.

Synopsis:

The following error occurs during the platform registration: Migration agent failed while executing command 'getPlatformXML' with error code #ErrorDuringPlatformInfoCollecting: No value given for one or more required parameters

Resolution:

The reason of this error may be a wrong delimiter that is used for Jet Text sources. Ensure that the registry value "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Jet\4.0\Engines\Text\Format" is "CSVDelimited".

Error occurs during attempt to communicate with Migration Framework

Symptom:

When trying to load the page (locally from server where Migration Framework is installed) "http://<server name>:9091/ccws.asmx" the following error is shown:

Configuration Error

Description: An error occurred during the processing of a configuration file required to service this request. Please review the specific error details below and modify your configuration file appropriately.

Parser Error Message: It is an error to use a section registered as allowDefinition='MachineOnly' beyond machine.config.

Source Error:

Line 54: running under AppPool identity account.

Line 55: -->

Line 56: <identity impersonate="false" userName="" password=""/>

Line 57:

Line 58: <authorization>

Cause:

ISP has changed the 'allowDefinition' attribute of the section to MachineOnly value in the machine.config file.

Resolution:

Edit the C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\CONFIG\machine.config file.

Find the 'section' tag with name="identity" and set its allowDefinition attribute to "MachineToApplication".