Skip to main content
NoteThis article is about Box Shuttle in the Admin Console. If you’re using legacy Box Shuttle, a standalone tool, see legacy migration guides.
Box Shuttle allows you to schedule jobs to run automatically based on two scheduling methods:
  • By time. Schedule jobs to run at specific times or on a recurring basis.
  • By job. Queue jobs to start automatically when another job completes.
data_migration1.jpg

​
Schedule by time

  1. In the Jobs Dashboard, locate the job you want to schedule.
  2. Select the More menu (three dots) for the job > Schedule.
  3. In the Schedule Job dialog, select Time.
  4. Configure when the job should run:
    • Start Date: Date when the job should run.
    • Start Time: Time when the job should run.
    • Repeat Job: Optional recurring schedule (daily, weekly, Monday to Friday, or Saturday and Sunday).
Note:Start Date and Start Time match the operating system’s time zone.
  1. For migration jobs, select Simulation or Transfer.
  2. Set completion conditions (see Completion conditions below).
  3. Select Schedule.

​
Schedule by job (Queue)

  1. In the Jobs Dashboard, locate the job you want to schedule.
  2. Select the More menu (three dots) for the job > Schedule.
  3. In the Schedule Job dialog, select Queue.
  4. Select the job that will trigger this schedule.
Tip:Select the same job to create a self-restarting schedule for continuous synchronization.
  1. For migration jobs, select Simulation or Transfer.
  2. Set completion conditions (see Completion conditions below).
  3. Select Schedule.

​
Completion conditions

You can define conditions that must be met before a scheduled job runs, based on the outcome of either the previous run of the same job (for time-based schedules) or the triggering job (for by-job schedules):
  • No conditions (default): The job runs regardless of the previous job’s outcome.
  • Successfully completed: The job runs only if the previous job completed without errors.
  • Completed, possibly with errors: The job runs if the previous job completed, even with errors. The job won’t run if the previous job failed or didn’t complete.
Important:If conditions aren’t met, the scheduler won’t run the job. For example, if you select Successfully completed but the previous job was stopped, the scheduled job won’t run. To check whether conditions are met, hover over the schedule pill when the job is not running.
migration2.jpg

​
Schedule status indicators

After scheduling, jobs display one of these status indicators:
  • Scheduled: the job was scheduled to run one time only.
  • Recurring: the job was scheduled to run periodically.
  • Paused: the job was paused and it won’t run until resumed.
  • Invalid: the schedule is no longer valid. This primarily occurs when a triggering job for a by-job schedule is deleted.
When a scheduled job runs, admins and co-admins receive an email notification, confirming that the schedule works as expected. For details, see Manage Account Settings.

​
Manage scheduled jobs

You can manage the already scheduled jobs using the Scheduler menu. The options allow you to:
  • Pause Schedule or Resume Schedule
  • Edit Schedule
  • Cancel Schedule
data_migration3.jpg

​
Scheduler limitations

There are certain limitations you need to have in mind when using the scheduler.

​
General

The scheduler may be unable to start a job for a number of reasons that are out of Shuttle’s control:
  • The job status may change to Invalid due to reconfiguration or changed source system credentials
  • Windows source system may disconnect.
Monitor your jobs periodically as they run to confirm that nothing prevents a job from starting.

​
Windows source system

Scheduler only runs one job for a Windows source system at a time. This ensures that each job has sufficient memory, CPU and other resources to transfer data to Box at optimal speeds. This does not affect cloud-sourced systems.
  • If you have a migration job already running for any reason, the scheduler will fail any additional jobs set to run while the first job is running.
  • If a job is already running when another job is scheduled to run, it will mark the second job as failed before it actually starts.
  • If you have two jobs scheduled for a Windows source system at the same time, it will run the first one and fail the second one.
When the job fails, it will receive the Failed status on the dashboard. Because the job fails before it even starts, it won’t have any job history, so you won’t see the job failure in the report section of Shuttle. The only place that the job failure will be listed is in the job card:
failed-job.jpg
If you go into Run History for the job, you will still see any previous runs of the job, but you will not see any details related to the scheduled job failure other than the Failed tag in the job header, because the job did not actually run.