Upgrade Manager (Magic xpa 4.x)

The Upgrade Manager utility is provided to make the upgrade process easier. The utility shows you the changes done automatically to your applications and the steps that you need to do manually.

This utility is available after running the upgrade process on a uniPaaS V1.x project. No upgrade is required for 2.x or 3.0 projects.

For eDeveloper V9.4 or earlier projects, you first need to upgrade your project to a uniPaaS v1.x project. For additional information, see: Upgrading from eDeveloper V9.4 to Magic xpa 3.x.

For each item, the utility displays detailed information about the required change and you can go directly to this object in the Studio.

To see a video demonstration about the Magic xpa Upgrade Manger utility, click here.

The Upgrade Manager has three tabs:

• The To Do tab lists the issues that were found and that require manual adjustments.

• The To Check tab lists issues that may need adjustments.

• The To Know tab lists issues that you should be aware of, but there is nothing that you need to do to your project with this information.

The Upgrade Manager utility is opened in the following ways:

• After the upgrade process ends

• From the Tools menu

The source code of the application is available at Add_On\UpgradeManager so you can customize the application, such as changing the database to a multi-user database if several users need to use the Upgrade Manager utility on the same application.

If you use your own .ini file, you will not see the Upgrade Manager utility in the Tools menu. In this case, you need to add the Upgrade Manager entry to your Tools section in your .ini file as follows:

1. Open the Magic.ini file in the installation folder, search for the [TOOLS_MENU] string and copy the lines related to the Upgrade Manager.

2. Open your .ini file and paste the lines you copied to the end of your [TOOLS_MENU] section.

Note: The Upgrade Manager utility is started using the single user license. If you need to start this utility on more than one station at the same time, you need to define your license in the Upgrade Manager's ini file as follows:

1. Open your Magic.ini file and copy the LicenseFile and LicenseName lines.

2. Open the UpgradeManager.ini file in the Add_On\UpgradeManager folder.

3. Find the following lines and replace them with the lines from your Magic.ini file:

;LicenseFile = C:\Magicxpa\license.dat

;LicenseName = MGCSRT

Note: When the Upgrade Manager utility starts, it will connect to the internet in order to check for updates for the action items' descriptions. If you use a proxy server, this check will take about 30 seconds until a timeout is reached. To fix this issue, you need to define the HTTPProxyAddress setting in the UpgradeManager.ini file located in the Add_On\UpgradeManager folder.

Since version:

3.1