Upgrade validation results (form)

Article
04/18/2014

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.

Tasks that use this form

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.

Tip

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

Navigating the form

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

Validation results grid columns

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.

Log grid columns

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

Buttons

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.

Fields

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