Upgrade validation results (form) [AX 2012]

Updated: January 17, 2012

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Click Preprocessing upgrade checklist > Upgrade readiness > Readiness results.

Use the Upgrade validation results form to view information about each upgrade readiness script that has been run. This form also provides tools that can help you resolve errors that cause scripts to fail.

Check upgrade readiness

The readiness scripts identify conditions that will affect the data upgrade, usually by causing a failure at some stage. The success or failure of each script is displayed in a grid. If a script fails, the form explains why the failure occurred and what action must be taken to resolve the problem. For some failures, you can use Fix buttons to fix the data by running logic that is embedded in the form itself. Make sure that you fix all errors before you begin the upgrade. We recommend that you run the upgrade readiness check during non-business or non-peak hours, and that you run it more than once. A good approach is to run it three times:

  • First run – Identify issues.

  • Second run – Confirm that issues from the first run have been resolved.

  • Third run – Before you run the live preprocessing scripts, make sure that no new data has been processed by Microsoft Dynamics AX since the readiness check. New data can cause the preprocessing scripts to fail.

We also recommend that you run the upgrade readiness check before you enter single-user mode.

TipTip

There is no limit to the number of times that you can run the check.

The following tables provide descriptions for the controls in this form.

The Validation results grid shows details about each upgrade readiness script that you select in the top grid. For scripts that have a status of Pass, no information is displayed. For scripts that have a status of Failed or Advisory, the information in the following table is displayed.

Column

Description

Result type

The type of validation result that is returned by the upgrade readiness script. The status can be one of the following:

  • Incomplete – The readiness script has not finished running.

  • Failed – The readiness check failed. Investigate and resolve the issue that led to the failure.

  • Advisory – Resolving the issue encountered is optional but highly recommended. Issues can include performance problems and unsupported scenarios.

  • Passed – The readiness check was successful. No user action is required.

Module

The name of the Microsoft Dynamics AX module that is associated with the upgrade readiness task.

Description

A short description of the upgrade readiness task.

Method name

The name of the method for the upgrade readiness script.

The Log grid shows details about each upgrade readiness script that you select in the Validation results grid. For scripts that have a status of Pass, no information is displayed. For scripts that have a status of Failed or Advisory, the information in the following table is displayed.

Column

Description

Result type

The type of validation result that is returned by the upgrade readiness script. Only scripts that have a status of Advisory or Failed are displayed in this grid.

Message

The error or advisory message that is returned by the upgrade readiness script. The message summarizes the issue that must be resolved.

Company

The name of the company for which data must be fixed.

Resolution

The recommended solution for the problem that the script recommends.

Resolved

Mark an Advisory issue as resolved, so that the script does not run again. You cannot update this column if the status of the script is Failed.

User comment

Enter comments about issues that are reported.

NoteNote

In the case of standard upgrade readiness scripts, information entered in the User comment field will be displayed in the results for all companies that use the same script.

Button

Description

Refresh

Update the grid to reflect script information that has changed.

Print report

Print a report that contains the results that are returned by the upgrade readiness scripts.

Open script

Open the upgrade readiness script in the code editor.

Details

Open the Upgrade validation details form, where you can view detailed information about a script that is listed in the Log grid. This information includes suggestions for resolving problems. In some cases, the Upgrade validation details form includes a Fix button. Click the button to open a form that can help you resolve the issue that the script encountered.

Field

Description

Total

The number of upgrade readiness scripts that are available for processing.

Incomplete

The number of upgrade readiness scripts that have not finished running.

Failed

The number of upgrade readiness scripts that have a validation status of Failed. Review and fix these scripts before you continue with the upgrade.

Advisory

The number of upgrade readiness scripts that have a validation status of Advisory. Review these scripts, and determine what resolution is most appropriate before you continue with the upgrade.

Passed

The number of upgrade readiness scripts that have a validation status of Passed. These scripts have passed validation, and no user action is required.

Run date

The date that the Upgrade readiness form was run. By default, this date is the date when the check for upgrade readiness was most recently run. However, you can select past dates in the menu.


Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).

Community Additions

Show: