Run and Schedule User Synchronization

User synchronization in MyQ X does not run continuously. It runs on demand or on a schedule that you configure. This page describes how to trigger a synchronization run manually and how to set up automatic scheduled runs.

Run Synchronization Manually

Go to Settings > User Synchronization.
Select one or more synchronization sources from the list.
Click Synchronize now on the toolbar.

If another synchronization is already running, the Synchronize now button is unavailable and an error message is displayed. Wait for the running sync to complete before starting another.

The Synchronization Results panel opens automatically and displays the operation log in real time. The log tail follows automatically when the panel is scrolled to the bottom. A spinner at the bottom of the log indicates synchronization is in progress.

These options are available:

Cancel: Stops the synchronization. The process may take a moment to halt after clicking.
Save: Downloads the synchronization log as a file.

Schedule Synchronization

To run synchronization automatically on a recurring schedule, configure a task in the Task Scheduler.

Go to Settings > Task Scheduler.
Locate or create the User Synchronization task.
Set the schedule – frequency, time, and which sync sources to include.

For most environments, a daily scheduled sync is sufficient. If Entra ID is your single authoritative user source and you have Deactivate missing users and Add new users enabled, ensure the schedule runs frequently enough that joiners and leavers are reflected in MyQ within your acceptable time window.

If you have enabled delta synchronization on an Entra ID (Microsoft Graph) sync source, a second scheduled task - User Delta Synchronization - runs those sources incrementally on a frequent interval (every 10 minutes by default). This task processes only changes that occurred since the last delta run and keeps MyQ current with Entra ID between full synchronization runs.

If you use CSV as a supplementary sync source alongside an LDAP or Entra ID source, schedule the CSV sync to run after the primary sync completes – typically 30 minutes later – so that it operates on the most current user data.

Reading the Synchronization Log

The synchronization log records the outcome for every user and group processed during the run. Key log entries to look for:

Entry	Meaning
`created`	A new user or group was added to MyQ.
`updated`	An existing user or group was updated.
`deactivated`	A user was deactivated because they were no longer present in the source (requires Deactivate missing users enabled).
`Match via LOGIN`	An existing user was matched and updated by username.
`Match via PERSONAL NUMBER`	An existing user was matched and updated by personal number (requires Pair by personal number enabled).
`Job discarded. User "x" not found.`	A print job arrived for a username that does not exist in MyQ. The quoted value is what the sync must place in the username or alias field for jobs to authenticate.

If a sync completes without error but the user count is lower than expected, check whether query limits apply – this is particularly common with OpenLDAP sources. By default, OpenLDAP limits both the number of entries returned and the maximum time per query (500 entries, one hour). For larger installations, increase these limits in your OpenLDAP server configuration – otherwise the synchronization returns incomplete results.