Restart a stuck scheduler task - HxGN SDx2 - January 2026 - Troubleshooting - Hexagon

HxGN SDx2 Troubleshooting

ft:locale
en-US
Product
HxGN SDx2
Search by Category
Troubleshooting

When data is submitted to the Integration Engine, the scheduler task can become stuck. You can troubleshoot this issue.

You must have Business Administrator or System Administrator role to view the Scheduled Tasks.

First, confirm the scheduler task is stuck

The SDxiHubAutoIntegrationSchedulerTask or the SDxiHubPublishDocLoadSchedulerTask can become stuck.

To check if the SDxiHubAutoIntegrationSchedulerTask is stuck:

  1. Set your Integration Data Filters to Consolidated.

  2. In the Design Tool Integration feature set, select Scheduled Tasks.

  3. Select the SDxiHubAutoIntegrationSchedulerTask, and select Actions list > Details.

  4. In the Scheduled task details section, find the Last processing ping time. If this value is older than two hours, the scheduled task may be stuck.

  5. In the Admin Integration Engine 3D Objects Progress dashboard, find the Shared Group Object Details widget.

  6. Expand expand the Shared Group Object Details widget.

  7. Sort the Last Updated Date column so that the most recent time is first. If the most recent time is older than one hour, the scheduled task may be stuck.

    The scheduled task is stuck if both values are older than the expected values.

To check if the SDxiHubPublishDocLoadSchedulerTask is stuck:

  1. Set your Integration Data Filters to the appropriate design component for your document.

  2. In the Documents feature set, select Active Smart Documents.

  3. Find the Last Updated Date column for documents with a Load Status of Processing. If your document has a Last Updated Date older than three hours, the scheduled task may be stuck.

Second, restart the scheduled task using an XML load file

To troubleshoot a stuck SDxiHubAutoIntegrationSchedulerTask, you must import a load file to reset the scheduled task and restart it:

  1. Set your Integration Data Filters to Consolidated.

  2. In the Design Tool Integration feature set, select Scheduled Tasks.

  3. Select SDxiHubAutoIntegrationSchedulerTask, and select Actions list > Export Data.

  4. Select export to save the XML to a file.

  5. Using a text editor, such as Notepad, on your local machine, open the XML file that you downloaded.

  6. Make the following edits in the XML file:

    • Change the SPFSchTskStartDate value to a time earlier than the current time (UTC).

    • Change the SPFSchTskLocked value to False.

    • Change the SPFSchTskStatus value to e1SchdReady.

  7. Save the XML file.

  8. Import the load file. For more information about loading an XML file, see Import a load file.

  9. In HxGN SDx2, in the Design Tool Integration feature set, select Integration Scheduler.

  10. Select Integration Scheduler, and select Actions list > Scheduler > Restart.

To troubleshoot a stuck SDxiHubPublishDocLoadSchedulerTask, you must import load files to reset the scheduled task and the document status and restart the scheduled task.

  1. Set your Integration Data Filters to Consolidated.

  2. In the Design Tool Integration feature set, select Scheduled Tasks.

  3. Select SDxiHubPublishDocLoadSchedulerTask, and select Actions list > Export Data.

  4. Select export to save the XML to a file.

  5. Using a text editor on your local machine, such as Notepad, open the XML file that you downloaded.

  6. Make the following edits in the XML file:

    • Change the SPFSchTskStartDate value to a time earlier than the current time (UTC).

    • Change the SPFSchTskLocked value to False.

    • Change the SPFSchTskStatus value to e1SchdReady.

  7. Save the XML file.

  8. In HxGN SDx2, import the load file. For more information about loading an XML file, see Import a load file.

  9. Set your Integration Data Filters to the appropriate design component for your document.

  10. In the Documents feature set, select Active Smart Documents.

  11. Select the stuck document, and select Actions list > Export Data.

  12. Select export to save the XML to a file.

  13. Using a text editor on your local machine, such as Notepad, open the XML file that you downloaded.

  14. Change the value of SDxIHubDocumentLoadStatus to e1SDxiHubReady.

  15. Save the XML file.

  16. In HxGN SDx2, import the load file. For more information about loading an XML file, see Import a load file.

  17. In the Design Tool Integration feature set, select Integration Scheduler.

  18. Select Integration Scheduler, and select Actions list > Scheduler > Restart.