Migrate

The Agent Migration feature allows you to seamlessly migrate your devices from BigFix on-premises to BigFix SaaS. This process utilizes a universal Fixlet for deployment and allows users to track the migration status through the migration dashboard.

Supported Platforms

The migration supports a wide range of operating systems, including:

  • Windows
  • RHEL
  • Ubuntu
  • Mac OS
  • Debian
  • Amazon Linux 2
  • Amazon Linux 2023
  • CentOS

Migration Metrics Dashboard

The Migration Metrics Dashboard tracks the transition of your endpoints from on-premises BigFix environments to the BigFix SaaS platform. The dashboard provides two views that you switch between with the Migrate / Devices toggle at the top right:

  • Migrate view: Lists every migration action and its overall progress.

  • Devices view: Lists every device across all migrations and the migration task to which each device belongs.

Note:
The system enforces a maximum limit of 15 simultaneous migration uploads per user to ensure system stability.
Core Metrics

A row of summary KPI cards displays batch-level progress and status totals for all initiated migration tasks.

  • Total migrations — total number of migration actions.
  • Success — migrations in which the targeted devices completed migration and are reporting.
  • In progress — migrations that are currently running.
  • Not started — migrations that have been created but have not begun reporting activity yet.

The Devices view and the migration detail view show device-level cards:

  • Total devices — total number of endpoints targeted for migration.
  • Success — devices that completed migration and are actively reporting.
  • In progress — devices that are currently running the migration Fixlet.
  • Past due — devices that did not complete migration before the migration's end date passed. You set this end date when you create the migration in the on-premises console; after that date, any device that has not reported a successful migration is marked past due. A device is typically past due because it was powered off, went offline, or hit a technical error mid-process and did not check back in with the SaaS console. Use this count to find machines to investigate, extend deadlines for, or re-trigger.
  • Not started — devices that are targeted but have not yet begun the migration Fixlet.

Migration list (Migrate view)

The Migrate view lists each migration in a sortable table with these columns:

Column Description
Migration ID Unique identifier for the migration. Select it to open the migration detail view.
Name Name of the migration action.
Status Overall status of the migration (for example, Success or Past due).
Progress Completion bar and percentage for the migration.
Devices Number of devices targeted by the migration.
Started Date and time the migration started.

Devices list (Devices view)

The Devices view lists every device across all migrations, with these columns:

Column Description
Status Migration status of the device.
Device name Name of the endpoint.
Operating System Operating system and build of the endpoint.
Migration ID Migration the device belongs to. This column is new in the Devices view. Select it to open the migration detail view.
Migration Name of the migration the device belongs to.
Last report Date and time the device last reported to the server.

Migration detail view

From either the Migrate or Devices view, select a Migration ID to open the Migration Details page. This page displays summary metrics and a device data table (Status, Device name, Operating System, Last report) filtered specifically for that migration.

The breadcrumb link at the top returns you to the list you came from: it reads Migrate when you open the detail view from the Migrate view, and Devices when you open it from the Devices view. Both lead to the same migration data.

The detail view supports Key Performance Indicator (KPI) cards, the View all link, column sorting, and the Remove migration monitor action. Filters are not available on the detail view.

Note:
  • If no data has been imported, the dashboard shows a No Data Available state and all counters remain at 0.
  • Pagination controls appear when the number of records exceeds 100.
  • After the migration file is uploaded, the Last report time field is blank. The field is populated only after the device has been successfully migrated and reports to the server.
Migration Dashboard Controls
  • Start migration – Opens the migration work flow to create a new migration.
  • Add Migration Monitor – Adds a new migration monitor to the dashboard.
  • Filter – Filters the dashboard view based on the selected criteria.
  • Migrate / Devices toggle – switches between the migration list and the device list.
  • View All / View Less – Expands or collapses the dashboard metrics to show all or a summarized view.

Frequently Asked Questions

  • Q: What is the maximum number of devices I can migrate in one action?
    • A: Each migration action is limited to a maximum of 10,000 devices.
  • Q: Will the root server or relays be migrated?
    • A: No, the migration Fixlet's relevance criteria are specifically designed to exclude relays and servers from being applicable for migration.
  • Q: How long does the migration take for my devices to report status?
    • A: Online devices are expected to report their status approximately 10 minutes after deployment. The total process for online devices is expected to take at least 10 minutes.

    • Device Limit: Each migration action is limited to a maximum of 10,000 devices.

  • Q: Can I delete a migration after it has been created?
    • A: Yes. Open the migration detail view (select a Migration ID from the Migrate or Devices view) and select Remove migration monitor. This removes the migration and all of its devices from the dashboard, and updates the KPI cards: the total migrations count decreases by one, and the total devices count decreases by that migration's device count. You remove one migration at a time; there is no multi-select. The action takes effect immediately, with no confirmation prompt, and returns you to the dashboard. For details, see Remove Migration Monitor.