PanelAlpha Documentation
Back Home
Live Demo Get Started

Managing Migrations

Documentation
    Introduction
Getting Started
    Installation Guide Update Guide SSL Configuration Translations
System Configuration
    General Configuration Plans Large WordPress Sites Hosting Servers DNS Servers Email Servers Remote Backups Notifications Automatic SSL Plugins & Themes Reseller Area Background Billing Diagnostic Mode Automatic Tester Snapshot Tool Server Migration
Migrations
    Overview Migration Types Import Process Managing Migrations Migration Details Troubleshooting Best Practices
WP Cloud Migration
    Overview
Admin Area
    Dashboard Instances Services Users Logs
Onboarding Methods
    Quick Onboarding Super Quick Onboarding Standard Onboarding
Hosting Servers
    Hosting Scenarios PanelAlpha Engine cPanel Plesk DirectAdmin WP Cloud
DNS Servers
    Cloudflare Bunny.net cPanel DNS Only PowerDNS
Email Servers
    Mailcow cPanel
Billing Systems Integrations
    PanelAlpha WordPress Hosting For WHMCS
Billing Scenarios
    Introduction Free Trial Period
Integrations
    Atarim AWStats Matomo Google Analytics Let's Encrypt Google PageSpeed Insights DB-IP Extendify WithoutDNS
Client Area - Instances
    List of Instances Creating New Instance Importing Existing Instance Instance Details Changing Domain Sharing Instances Monitoring Backups Plugins Advanced Settings
Client Area - Hosting
    Summary Domains FTP Accounts SFTP Accounts MySQL Databases Cron Jobs File Manager DNS Zone Editor Email Addresses Email Forwarders

# Managing Migrations

  • Migrations in Progress
    • Key columns
    • Primary actions
    • Status indicators
    • Taking action on in-progress migrations
  • Failed Migrations
    • Key columns
    • Common failure reasons
    • Primary actions
    • Troubleshooting workflow
  • Successful Migrations
    • Key columns
    • Available Actions
    • Information Available in Details
    • Use Cases
  • Related Documentation

The main migrations table is divided into three tabs: In Progress, Failed, and Successful. Each tab follows the same pattern: purpose → key columns → primary actions.

# Migrations in Progress

Purpose: Monitor migrations that are currently executing (automatic or manual) and intervene when needed.

# Key columns

  • ID Number: Unique migration identifier (also service ID); click to view service details page
  • User: User who owns the instance; hover to see tooltip with user details (email, status), click to view user profile
  • Service: Service/plan to which the WordPress installation is assigned; displays plan name
  • Domain: Domain of the migrated WordPress installation; hover to see instance details tooltip
  • Status: Current migration step and progress
    • Shows which step is currently executing (e.g., "Downloading Files...")
    • Displays alert icon (⚠️) if action is required
    • Shows progress percentage for applicable steps
    • Click the status or alert icon to open migration details

# Primary actions

  • Show Details (eye icon): Opens the Migration Details modal with full information about the migration
  • Stop Migration (stop icon): Halts the migration immediately (only for automatic migrations)
    • Confirms before stopping
    • Migration will be marked as failed with reason "Stopped by admin"
    • Cannot stop manual migrations that are past the upload stage
  • Delete (trash icon): Stops and removes the migration permanently
    • Confirms before deletion
    • Stops the migration process if running
    • Removes all migration records
    • Does NOT delete the partially created instance
  • Bulk Delete: Select multiple migrations using checkboxes and use the mass actions dropdown

# Status indicators

  • Green checkmark (✓): Step completed successfully
  • Yellow/orange spinner (⟳): Step currently in progress
  • Red alert (⚠️): Step failed or requires manual action
  • Gray circle (○): Step not yet started

# Taking action on in-progress migrations

When a migration shows an alert status, it typically means:

1. Manual upload required: For manual migrations waiting for admin to upload files

  • Action: Upload wordpress-files.zip and database.sql via FTP
  • Next: Click Verify to check uploads, then Continue Import

2. Verification needed: Files uploaded but not yet verified

  • Action: Click the Verify button in Process Details
  • Next: If successful, Continue Import button will be enabled

3. Error occurred: A step failed during execution

  • Action: Review Logs tab for specific error message
  • Next: Retry migration or Mark as Failed

4. Admin intervention needed: Configuration or permission issue requires manual resolution

  • Action: Follow instructions in Process Details tab
  • Next: Contact hosting server admin if needed, then Retry

Note: When you see an alert icon

  • Open Migration Details → Logs to read the exact failing step
  • Check Process Details for required admin action (upload/verify)
  • If credentials are wrong, edit and retry; if blocked by provider, switch to manual migration
  • If truly unrecoverable, delete or mark as failed to clear the queue

# Failed Migrations

Purpose: Review migrations that encountered errors and choose to retry, mark successful after manual fix, or delete.

# Key columns

  • ID Number: Migration/service identifier; click to view service details
  • User: User who owns the instance; hover for tooltip, click for user profile
  • Service: Service/plan assignment
  • Domain: Domain of the failed migration
  • Status: Reason for migration failure (detailed error message)

# Common failure reasons

  • "Stopped by admin": Admin manually stopped the migration
  • "Cannot connect to FTP server": FTP credentials invalid or server unreachable
  • "Cannot dump MySQL database on remote server": Database export failed on source
  • "Insufficient disk space": Not enough space on destination server
  • "WordPress not found at specified path": Invalid path provided for FTP method
  • "Database import failed: Table already exists": Database collision on destination
  • "File extraction failed": Corrupted ZIP file or permission issues
  • "Connection timeout": Network connectivity issues during file transfer
  • "Maximum execution time exceeded": PHP timeout during large data processing

# Primary actions

1. Show Details (eye icon):

  • Opens Migration Details modal
  • Review Logs tab for specific error messages
  • Check which step failed
  • See source and destination details

2. Retry (refresh icon):

  • Re-initiates the WordPress instance migration
  • Starts from the beginning
  • Useful if failure was due to temporary issue (network, server load)
  • Only available for automatic migrations and manual migrations that failed after upload

3. Mark As Successful (checkmark icon):

  • Manually marks the migration as successful
  • Use when you've manually fixed the issue outside PanelAlpha
  • Migration moves to Successful tab
  • Instance status is updated to active
  • Important: Ensure you've actually completed the migration manually before using this

4. Delete (trash icon):

  • Permanently removes the migration record
  • Stops any retry attempts
  • Removes partial data if migration didn't complete
  • Confirms before deletion
  • Can bulk delete multiple failed migrations

Note: Safe to delete?

  • OK to delete if: migration is failed/stopped, logs collected, no further retries planned.
  • Avoid deleting if: client is still uploading files or investigation is ongoing.
  • Deleting does not remove any partially created instance; verify instances separately.

# Troubleshooting workflow

  1. Review failure reason: Check Status column for initial indication
  2. Open details: Click Show Details to see full logs
  3. Identify root cause: Read error messages in Logs tab
  4. Attempt resolution:
    • For credential errors: Verify and retry with correct credentials
    • For space issues: Free up disk space on destination server
    • For timeout issues: Consider manual migration for large sites
    • For plugin errors: Try FTP method instead
  5. Retry or manual completion: Use Retry if issue resolved, or complete manually and Mark As Successful

# Successful Migrations

Purpose: Reference completed migrations for audit, verification, or comparisons.

# Key columns

  • ID Number: Migration/service identifier; click to view service details
  • User: User who owns the instance; hover for tooltip, click for user profile
  • Service: Service/plan the instance is assigned to
  • Domain: Domain of the successfully migrated WordPress
  • Status: Always shows "Completed" with green checkmark
  • Completed At: Timestamp when migration finished

# Available Actions

Show Details (eye icon):

  • View complete migration information
  • Review Steps tab to see all completed steps
  • Check Destination Details for instance information
  • Review Logs for complete migration history
  • Useful for audit trails and verification

# Information Available in Details

  • All steps with completion times
  • Total migration duration
  • Source details (for automatic migrations)
  • Destination server and database credentials
  • Full log history

# Use Cases

  • Audit trail: Review who migrated what and when
  • Documentation: Reference for setting up similar migrations
  • Troubleshooting: Compare successful migration logs with failed ones
  • Reporting: Export data for management reports
  • Verification: Confirm all post-migration actions completed

# Related Documentation

  • Migration Types - Understand different migration methods
  • Migration Details - Detailed information about each migration
  • Troubleshooting - Solve common migration issues