Data upgrade cockpit (form)
Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012
Click System administration > Setup > Checklists > Data upgrade checklist. Click Presynchronize, Launch data upgrade, or Upgrade additional features.
The Data upgrade cockpit (%1 -> %2) creates upgrade jobs and tasks and runs them in the correct order, to help ensure that data is upgraded correctly.
Note
Upgrade tasks are run in parallel, based on the number of batch threads set in the Server configuration form. The default number of threads is eight.
The Data upgrade cockpit (%1 -> %2) is opened from the Data upgrade checklist. It contains a grid that describes the upgrade jobs and provides tools that you can use to run, monitor, and manage the jobs.
Tasks that use this form
The following tasks in the Data upgrade checklist open the Data upgrade cockpit (%1 -> %2).
Navigating the form
The following tables provide descriptions for the controls in this form.
Tabs
Tab |
Description |
---|---|
Data upgrade |
Maintain all aspects of the running of upgrade tasks. |
Configuration |
Configure data upgrade parameters and control the batch server. |
General |
Export data upgrade job information to a Microsoft Excel spreadsheet and to analyze job dependencies. |
Grids
Grid |
Description |
---|---|
Upgrade job |
Displays the name, status, priority, and other information for each upgrade job. |
Grid columns
Column |
Description |
---|---|
Status icon |
A visual indicator of the status of the upgrade task. |
Status |
The status of the upgrade task: Waiting, Ready, Executing, Finished, Failed, or Disabled. |
Description |
A short description of the upgrade task. |
Company accounts ID |
The name of the company account being upgraded. An asterisk (*) indicates a task that will run for all company accounts. |
Method name |
The name of the upgrade script method. |
Module |
The name of the Microsoft Dynamics AX module associated with the upgrade task. |
Duration |
Elapsed time since the upgrade task began running. |
Priority |
The priority of the upgrade task in the batch queue. |
Start time |
The time when the upgrade task began running. |
Version |
The upgrade target version of Microsoft Dynamics AX. |
Task type |
The upgrade task type: Standard, Shared, Start, or Final. The task type determines how upgrade script execution is sequenced. |
Task ID |
The identifier of the upgrade task. |
Buttons
Button |
Description |
---|---|
Run |
Submit upgrade jobs to the batch queue. This button can also be used to resume paused jobs. |
Change failed tasks to waiting |
Reset the status of failed tasks so that they can be run again. |
Pause |
Pause all upgrade tasks that are running. |
Reload scripts |
Set upgrade scripts that have already been run to be run again. Important Rerunning the upgrade scripts might cause data corruption. Use this option only for upgrade script development and for testing. |
View batch job |
View the upgrade batch job that contains the upgrade tasks. |
Upgrade parameters |
Open the Configure data upgrade form to set the number of batch threads and the refresh rate for the Data upgrade cockpit (%1 -> %2). |
Batch thread |
Open the Batch tasks form to set the number of batch threads on the AOS that is running the upgrade. |
Export to Microsoft Excel List |
Export the contents of the grid to an Excel spreadsheet. Note Excelmust be installed on the target computer. |
Analyze dependency View |
Open the Analyze dependency form, which is useful in upgrade script development. |
View task progress |
View the progress of the selected bulk copy task. |
View error |
Display errors that occurred while the batch job was running. |
Rerun task |
Rerun the selected task. |
View predecessor |
View the predecessor task of the selected task. This function applies only to tasks that depend on the completion of another task. |
View batch task |
Open the Batch tasks form to view details of the selected task. |
View upgrade script |
Display the code for the selected upgrade script. |
Disable upgrade script |
Set the status of the selected upgrade script to Disabled to prevent the script from running. This button is available only when the script status is Waiting. Warning For debugging use only. Do not use on a production system. |
Enable upgrade script |
Restore the status of the selected script to Waiting. This button is available only when the script status is Disabled. |
Refresh |
Update the job status information on the form. |
Fields
Field |
Description |
---|---|
Show all tasks |
Select this option to display all upgrade tasks in the grid. If the option is not selected, only tasks that are not finished will be displayed. |
Overall upgrade progress |
The progress bar represents the portion of completed data upgrade tasks. Progress is calculated based on the total weight of the tasks completed. |
Start time |
The time when the Data upgrade cockpit (%1 -> %2) began running upgrade jobs. |
Last updated |
The time when the job status information on the form was last updated. |
Total tasks |
The total number of upgrade tasks. |
Succeeded |
The number of tasks that have a Finished status. |
Failed |
The number of jobs that have a Failed status. |
Executing |
The number of jobs with an Executing status. |
Ready |
The number of jobs that have a Ready status. |
Waiting |
The number of jobs that have a Waiting status. |
Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).