Scheduled Task Troubleshooting
Path Issues
The most common issue with Windows scheduled tasks for Curator is an incorrect path to the artisan file. To troubleshoot this:-
Open Task Scheduler:
- Press
Windows Key + R, typetaskschd.msc, and press Enter - Or search for “Task Scheduler” in the Start Menu
- Press
-
Find the Curator task:
- Look for tasks named “Curator Cron”, “Curator Central Dispatch”, or similar
- Double-click the task to open its properties
-
Check the action path:
- Click the “Actions” tab
- Click “Edit” to view the action details
- Note the full command in the “Program/script” and “Add arguments” fields
- Common format:
C:\InterWorks\Curator\libs\PHP\php.exe C:\InterWorks\Curator\htdocs\artisan schedule:run - Note: Your installation path may differ (e.g.,
D:\Curator,E:\InterWorks\Curator, etc.)
-
Test the command manually:
- Open Command Prompt as Administrator
- Copy the full command from the scheduled task (combining program and arguments)
- Run the command exactly as it appears in the task
- Observe the output:
- Success: Command runs without errors
- “The system cannot find the path specified”: Path to php.exe or artisan is incorrect
- PHP errors: Path is correct but there are application issues
- No output: May indicate the command is running but not producing visible output
-
Common path corrections:
- Verify your Curator installation directory (common locations:
C:\InterWorks\Curator,D:\Curator, etc.) - Ensure php.exe exists at:
[YourInstallDir]\libs\PHP\php.exe - Confirm artisan file exists at:
[YourInstallDir]\htdocs\artisan - Update the scheduled task with corrected paths if needed
- Remember: Replace
[YourInstallDir]with your actual installation path
- Verify your Curator installation directory (common locations:
Determine Correct Scheduled Task User
The scheduled task should run as the same user that your web server (IIS/Apache) is running as. Here’s how to determine the correct user: Check Web Server User in Curator Backend:- In the backend of Curator using the left-hand navigation, navigate to the Settings > Curator > Status page.
- Look for the “User” field in the System Information section
- This shows which user account your web server is running as (e.g., IIS_IUSRS, SYSTEM, apache, etc.)
- Your scheduled task should be configured to run as this same user to avoid permission issues
- In Task Scheduler, find the Curator task
-
View the user account using one of these methods:
- Method 1: In the main panel, look at the “Security options” column
- Method 2: Double-click the task, go to “General” tab
- Look for “When running the task, use the following user account:”
- Common accounts: SYSTEM, NT AUTHORITY\SYSTEM, or a service account
-
Additional task details:
- “Actions” tab shows the exact command being run
- “History” tab shows recent execution logs and any errors
- “Triggers” tab shows when the task runs (typically every minute)
Test Scheduled Task
To verify the scheduled task is working properly:-
Test command directly in Command Prompt:
- Open Command Prompt as Administrator
- Navigate to your Curator directory (adjust path as needed):
cd C:\InterWorks\Curator - Run the exact command from your scheduled task
- Important: Replace the paths below with the actual paths from your Task Scheduler action:
(Your paths may differ - use
D:\,E:\, or different directory names as shown in Task Scheduler) - Check the output:
- Success: Shows “Running scheduled command:” or similar output
- Errors: Note any error messages for troubleshooting
-
Manual test via Task Scheduler:
- Right-click the Curator task in Task Scheduler
- Select “Run”
- Check the “Last Run Result” column (should show “0x0” for success)
-
Check via Curator API:
- Follow instructions in the Auto Generate API Links section
- Set dropdowns to Portal and cron respectively
- Click the preview link
- Should display a “success” message
-
Verify in logs:
- Check Curator logs at:
[InstallDir]\storage\logs\system-[date].log - Look for recent cron execution entries
- Check Curator logs at:
Common Issues and Solutions
-
Task runs but nothing happens:
- Check if the user account has permissions to the Curator directory
- Verify PHP can be executed by the task user
- Check Windows Event Viewer for errors
-
Task shows error code:
0x1: General error - check the command syntax0x2: File not found - verify all paths0x5: Access denied - check permissions
-
Task doesn’t run on schedule:
- Verify the trigger is set to run every minute
- Check if “Start the task only if the computer is on AC power” is unchecked
- Ensure “Run whether user is logged on or not” is selected