Troubleshooting

Procedure

Use this procedure if one or more upgrade programs fail during a Data Upgrade Run.

  1. Start the Data Upgrade Engine Runs (ttspt2500m000) session.
  2. Select the run and, on the appropriate menu, select Data Upgrade Tasks. The Data Upgrade Tasks (ttspt2520m000) session starts.
  3. Select View > Sort By > Upgrade Tasks by Real Status.
  4. Navigate to the upgrade tasks with Real Run Status Failed.
  5. Double-click a task. The Data Upgrade Tasks (ttspt2520m100) details session starts.
  6. In the Files by Data Upgrade Task tab, double-click a log file.
  7. View the contents of the log file.
  8. Solve the problem that caused the failure. For example:
    • Create a correction program.
    • Contact Infor Support.
    • Contact a consultant.
  9. If the problem is solved, ensure the task is restarted.
    • If the Data Upgrade Run is still running, set the Real Run Status of the task to Ready for Retry. You must perform this action in the Data Upgrade Tasks (ttspt2520m100) details session.
    • If the Data Upgrade Run does not run anymore, restart the run and ensure the failed task is started:
      1. Select the run in the Data Upgrade Engine Runs (ttspt2500m000) session.
      2. On the appropriate menu, select Data Upgrade Engine. The Data Upgrade Engine (ttspt2201m000) session starts.
      3. Select the Include failed upgrade tasks check box.
      4. Fill out the remaining fields and click Continue.
Trace level

If you set the DUE_TRACE environment variable to 1, an additional Trace Level field is displayed in the Data Upgrade Engine (ttspt2201m000) session.

The trace level indicates the amount of information that will be written to the $BSE/log/log.due file. This information provides insight in the scheduling and the communication between the multiple bshells.

You can select these trace levels:

  • 0 - No Extra Logging
  • 1 - Some Details
  • 2 - More Details
  • 3 - Full Details

For details on how to set environment variables, see Infor10 ERP Enterprise Server (LN) Technical Manual (U8172 US).

Performance and finetuning

You can optimize the performance of the Data Upgrade Engine. See Performance and finetuning.