QRK Product Docs
Web portal

Managing Jobs

Creating and configuring migration jobs

A Job in Profile Magician encapsulates all the configuration needed for a migration. This centralizes configuration changes and provides a reference point for profile states before migrating.

Creating a New Job

  1. Navigate to Jobs > New Job.

  2. Name: Give it a descriptive name (e.g., "Entra ID migration - Marketing").

  3. Migration Mode:

    • Active Directory: Migrate users to a new AD domain.
    • Entra ID (Azure AD): Migrate users to Entra ID.
    • Workgroup: Migrate users to a local account and leave the domain.
  4. Configuration:

    • Target Domain: The domain to join (if applicable).
    • Entra ID Tenant: The tenant name (e.g. qrktech.com).
    • Reboot Delay: How long to wait before rebooting post migration (default 30s).
  5. User Mappings (Optional):

    • Upload a CSV to map specific old usernames to new ones.
    • If left blank, Profmage will migrate OldUser -> TargetDomain\OldUser if found on source and target.
  6. Security:

    • Enter a Configuration Password. This encrypts your job's domain credentials/Entra PPKG with client-side Perfect Forward Secrecy (E2EE).
    • Your configuration password is required to execute the migration. Store it somewhere safe!
    • Support will never ask for your configuration password.

Editing a Job

  1. Go to the Job Details page.
  2. Click Edit.
  3. You will be prompted to enter the current configuration password to decrypt the existing settings.
  4. Make your changes and save. You can keep the same password or set a new one.

Future runs of the client will immediately use the new configuration.

Viewing Logs

Inside a Job, you will see a list of machines that have submitted their telemetry.

  • Status: Pending, In Progress, Success, Error.
  • Logs: Click the "Logs" button on any machine row to view the most recent profmage.log from the client.
  • Download: You can also download the full set of logs (including permission logs) as a ZIP file.

On this page