What to do When Your Import is Stuck
Introduction
In any data-driven platform, the ability to import records quickly and efficiently is crucial. eDirectory streamlines this process by allowing site managers to import listings via CSV files, which are processed by an automated "Import" Cron Job. This Cron Job is scheduled to run every 5 minutes, ensuring that new data is integrated smoothly into your directory. However, if your import remains in a "Pending" status for more than a few hours, it may indicate an issue with the Cron Job or other underlying system processes. This guide explains what "Pending" status means, why it might occur, and how you can resolve the issue to ensure your import completes successfully.
Note: Keep in mind that depending on the size of the file you're trying to import, it is normal the import status displays 'on queue' for a few hours. You can consider the import is stuck if it has been more than 24 hours and the import is not complete.
Understanding the Import Process
When you initiate an import of a CSV file, eDirectory relies on its "Import" Cron Job to process the data. This job runs on a schedule—every 5 minutes—so it is normal for your import to temporarily display a "Pending" status. Typically, this status is brief, and your data should be processed shortly after. If the file remains pending beyond the expected timeframe, this could be due to a stalled or malfunctioning Cron Job.
What to Do When an Import is Stuck
If your import remains in "Pending" status for over 5 minutes, follow these steps to address the issue:
Contact Support:
Send an email to our support team with the subject line "Import Stuck in Pending Status". This helps our team quickly identify the nature of the problem.
Provide Detailed Information:
In your email, include relevant details about your import, such as:
- The project name or the URL of your directory.
- The time and date when you initiated the import.
- Any error messages or unusual behaviors you observed.
- Details about the file you attempted to import (e.g., file size, number of records).
- Attach the file you're trying to import.
This information is critical for our support team to diagnose whether the issue is related to the Cron Job or another system component.
Await Response:
Once your email is submitted, our support team will review your request. If the problem is linked to stalled Cron Jobs, they will refresh the jobs, allowing the import process to resume immediately.
Conclusion
A "Pending" status during the import process is usually temporary and part of the normal operation of eDirectory's automated systems. However, if the status persists, it may indicate a technical issue that requires intervention. By following the steps outlined above—contacting support and providing detailed information—you can help ensure that any issues with the Cron Job are resolved quickly, allowing your import to complete successfully. Keeping your data current is essential for maintaining an efficient and up-to-date directory, so don’t hesitate to reach out to our support team if you encounter persistent problems.
Feel free to contact us at support@edirectory.com if you have any further questions or need additional assistance.