Sign in

How to Use the Aras Migration Analyzer

June 30, 2026 04:16 AM
3 min read

Setup

Setting Up the Database

Perform the following steps for each Aras Innovator database you want to analyze.

  1. Unzip the Aras Migration Analyzer package. You can do this on the server or a client machine.
  2. Open the Nash utility page for your Innovator installation in a web browser: http://{server}/{webalias}/Client/scripts/Nash.aspx

    3. Nash.aspx

  3. Enter credentials for an administrative user like admin or root and click Login.
  4. In the Aras Migration Analyzer package, open InnovatorSideUtility/AMA_UtilityMethod.xml.
  5. Copy the contents of AMA_UtilityMethod.xml and paste into the XML field in the Nash form.
  6. Click Submit to add the method to the Aras Innovator database you want to analyze.
Note
Executing this AML more than once will result in a “Method already exists” error message. If this happens, move on to the next section.

Setting Up the Code Tree

Perform the following steps for each Aras Innovator installation you want to analyze.

  1. Open the InnovatorServerConfig.xml file in the installation directory of your Aras Innovator instance.
  2. Add the following line to the file if it does not exist. If the DebugServerMethod operating parameter does exist, make sure it is set to “true”.
    3. <operating_parameter key="DebugServerMethod” value="true” />
  3. Save the InnovatorServerConfig.xml file.
Note
After you finish running the analysis, be sure to come back to this file and set the DebugServerMethod operating parameter to “false”. Leaving the parameter enabled for long periods of time cause many log files to accumulate on the server.

Running the Method Code Analysis

  1. In the Aras Migration Analyzer package, find MigrationAnalyzer.WpfUI.exe and run it to start the Aras Migration Analyzer.
  2. Enter the url of your Aras Innovator instance and click Login.

    3. Aras Migration Analyzer login page

  3. When the Aras Innovator login page appears, choose the database you want to analyze and enter credentials for an administrative user like admin or root. Click Login.

    4. Aras Innovator login page

  4. Next, the tool will present the main page for running the method code analysis.

    5. Main page for choosing methods to analyze

    1. Home: Return to the initial login page.
    2. Refresh: Reload the method list from the Aras Innovator database.
    3. Select All: Select every method in the list.
    4. Deselect All: Deselect every method in the list.
    5. Expand All: Expand all categories and packages to see every method in the list.
    6. Collapse All: Collapse all categories to hide all packages and methods in the list.
    7. .Net Version: Choose the .Net version (.NET 6 or .NET Core 3.1) to check the server methods for compatibility analysis.
    8. Analyze: Run the .NET Core migration analysis on the selected methods.
    9. Method List: This pane contains a list of server methods in the Aras Innovator database, organized by package. Packages are grouped into three categories:
    10. Custom Methods: Contains all packages that are not core Aras Innovator packages. This includes Aras applications and custom packages.
    11. Aras Innovator Default Methods: Contains core Aras Innovator packages. This category is deselected by default because Aras migrated all core code to .NET Core when subscribers upgraded to Release 15.
    12. Not in Package: Contains methods that don’t belong to a package definition.
    13. Detail Pane: Presents detailed analysis information about the selected method.
    14. Status Bar: Displays the progress of the analysis. When the analysis is complete, the status bar indicates how many methods are compatible with .NET Core, incompatible, or have compilation errors.
    15. Export to PDF: Allows the user to save the analysis results to a PDF file for review and sharing.
  5. Select the methods you want to analyze from the method list and click the Analyze button.
  6. Wait until the status bar indicates that the analysis is complete. Now you’re ready to review the results.

Status bar after analyzing 8 methods

Understanding the Analysis Results

There are two ways to review the results of the method analysis – inside the migration analyzer tool itself, or in an exported PDF.

Note
The Aras Migration Analyzer tool analyzes the compatibility of code only within the chosen server methods of an Aras Innovator database. It does not analyze code in custom DLLs that these server methods refer to. To assess the compatibility of code in a custom DLL, please use the relevant analyzer tool offered by Microsoft:a) The API Port Utility evaluates code for compatibility with .NET Core 3.1b) The .NET Upgrade Assistant evaluates code for compatibility against .NET 6.

Reviewing Results in the Migration Analyzer

Completed method analysis in the Migration Analyzer UI Once the analysis is complete, the righthand column of the method list will indicate one of the following results for each of the selected methods.

  • Compatible: The code in this method is compatible with .NET Core and doesn’t require updates.
  • Incompatible: One or more .NET Framework APIs used in this method does not port to .NET Core. This code will need to be updated before it will work in Aras Innovator 15+. Click the method in the list and review the details pane to learn which specific APIs will need to be replaced.
  • Error: There was a compilation error during the analysis. Click the method in the list and review the details pane for more information about the error.

For more information about migrating .NET Framework code to .NET Core, visit Microsoft’s migration guide: https://docs.microsoft.com/en-us/dotnet/core/porting/

Reviewing Results in a PDF

Completed analysis saved to PDF Once the analysis is complete, you have the option to save the results to a PDF file. The file contains all the same information as the Migration Analyzer UI, but in an easily shared format. The PDF shows a result and details (where necessary) for each analyzed method.