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).

   

   Click Next.

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

   

   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.

   

   click Next button.

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

   

   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.

   

6. Click Install.

   

7. Click Finish.

   

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".