PanelAlpha Documentation
Back Home
Live Demo Get Started

Migrations

Documentation
    Introduction FAQ
Getting Started
    Requirements Installation Update Guide SSL Configuration Resetting Admin Password Translations Health Check
Admin Area
    Dashboard Instances Services Users Logs Migrations
Onboarding Methods
    Quick Onboarding Super Quick Onboarding Standard Onboarding
System Configuration
    General Configuration Branding Hosting Servers DNS Servers Email Servers Remote Backups Plans Notifications Automatic SSL Themes, Plugins and Packages
Hosting Server Connections
    Hosting Scenarios PanelAlpha Engine for Docker cPanel Plesk DirectAdmin WP Cloud
Email Server Connections
    Mailcow cPanel
DNS Server Connections
    Cloudflare cPanel DNS Only PowerDNS
Billing Systems Integrations
    WHMCS
Billing Scenarios
    Introduction Single WordPress Instance Predefined WordPress Template Multiple WordPress Instances Cross-Selling Paid Plugins and Themes Cross-Selling Domains Plan Upgrade Free Trial Period
Integrations
    Integrated Solutions Matomo Google Analytics Let's Encrypt Google PageSpeed Insights DB-IP Extendify
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 MySQL Databases Cron Jobs DNS Zone Editor Email Addresses Email Forwarders

# Migrations

  • Automatic migrations
  • Manual migration
  • Migrations in progress
  • Migration details
  • Failed migrations
  • Successful migrations

The Migrations section guides you through migrating WordPress instances to PanelAlpha. This Migration center serves as a hub where you can preview a list of migrations in progress, successful migrations, and failed migrations. See the description below for detailed information and instructions on navigating the migration process smoothly.

If you see a red pulsing icon next to the Migrations icon in the main menu, do not hesitate, to open this section as your actions might be required for failed or in-progress migrations.

# Automatic migrations

Automatic migrations are initiated by your clients from their client area. When a client chooses to add a new WordPress instance by importing an existing one, a new automatic migration will appear in the "In Progress" section of your admin area. Here, you can monitor its progress and status.

In contrast to manual migrations, automatic migrations can be halted by the admin at any time (see actions button: "Stop"). You can also view the details of an ongoing migration. The migration process is updated in real-time, allowing you to see the status of each step as it progresses.

Once the migration is completed, it will be moved to the Successful Migrations list unless there were issues that require your attention.

# Manual migration

In case your clients encounter problems with the automatic import of their existing WordPress instances, there is an option to trigger such migrations manually. Administrators are allowed to trigger, manage, and track every migration taking place in their PanelAlpha. If you notice or are informed about a failed migration, such as issues with file uploads on the client side, you can step in to assist.

The manual migration option allows you to upload the WordPress instance files to a selected directory. To do so, you must zip the files, create a backup, and upload them to the server.

To initiate a manual migration of a WordPress website, follow these steps:

  1. Press the Manual Migration button located at the top of the page, this will redirect you to a form for initiating a manual migration.
  2. Fill Out the Form:
    • Select User and Service: Choose the user and the service where you want to migrate WordPress.
    • Press Create Instance and Initiate Import: This action will set up the migration process.
  1. Upload Files and Database: Use the provided FTP account credentials to upload the necessary files and database. Then, press Verify to confirm that the upload is complete.
  1. Review Temporary Domain and FTP Details: A temporary domain will be created, and FTP account credentials will be generated. You can view these details in the Migration Details → Process Details form → Uploaded Files.
  2. Continue Migration: Once the files are uploaded and verified, press Continue Import to complete the migration.

# Migrations in progress

The main table with the migrations listed is divided into three sections: In Progress, Failed and Successful migrations. Let's start by describing the first one, which is In Progress.

  • ID Number - Click to be redirected to the service details.

  • User - Displays user data; hover to see a tooltip with user details, or click to be redirected to the user details page.

  • Service - The service to which the WordPress installation is assigned.

  • Domain - The domain of the migrated WordPress installation; hover to see a list of instances.

  • Status - The current status of the migration. If there is an alert next to the current migration step, click it to be taken to the migration details form, where required actions are described.

  • Available Actions:

    • Show details - Click to be redirected to the Migration Details form; see the description below.
    • Stop migration - Applicable only to in-progress, automatic (triggered from client area) migrations. After confirming, the migration will be marked as failed.
    • Delete - Remove a single WordPress instance migration. The migration process will be stopped and deleted. You can also perform bulk deletions by selecting the migrations you wish to delete and using the mass actions button.

# Migration details

The Migration Details form provides comprehensive information on both completed and pending migration steps, including process details, destination specifics, and a log list.

  • Process Details - Provides instructions for uploading required files, including file paths and necessary data gathered during the instance import process. This may include FTP account details and temporary directories on both source and destination servers. In case of interruption, this section will guide you on the next steps to complete the migration. You can copy the details using the icon next to the remembered data.
    • Remote Server Temporary Directory - Path to the temporary folder on the WordPress server.
    • FTP Username - The FTP account username.
    • FTP Host - The FTP server address.
    • FTP Port - The port number used for the connection.
    • FTP Password - The FTP account password.

Carefully follow the steps to upload the required files. After completing the upload, verify the files by pressing the Verify button:

  • If verification is successful, you will be allowed to proceed and Continue Import.

  • If verification fails, you will be notified in the Uploaded Files section, where instructions for resolving the issue will be provided.

  • Steps - Track the progress of each migration step. Completed steps are marked accordingly, while pending steps are labeled as "Not Started." The migration process includes the following steps:

    • Creating Hosting Account - Set up a new hosting account for WordPress.
    • Creating Domain - Set up a website address for WordPress.
    • Creating Temporary Directory - Create a temporary directory on the destination server to upload WordPress files.
    • Creating FTP Account - Create an FTP account on the destination server to upload WordPress files.
    • Extracting Files - Extract WordPress files to the domain directory on the destination server.
    • Creating Database - Create a new database for WordPress.
    • Importing Database - Set up the database on the destination server.
    • Configuring WordPress - Adjust WordPress settings for the new location.
    • Removing FTP Account - Remove the FTP account from the destination server.
    • Cleaning Temporary Files - Remove files no longer needed after the import.

  • Destination Details - Contains information about the target location for the imported WordPress

    • Server IP/Hostname - The address of the destination server.
    • Hosting Account Username - Username of the hosting account.
    • Hosting Account Main Domain - Primary domain associated with the hosting account.
    • Path - Directory path to the WordPress installation.
    • Domain - Website domain for the imported WordPress.
    • Database Host - Address of the database server.
    • Database Name - Name of the WordPress database.
    • Database User - Name of the WordPress database.
    • Database Password - Password for database access.

  • Logs - Provides detailed information about the import process, including actions performed and any encountered errors. Hover over the message for more details on the logged action.

  • Source Details - Available for migrations triggered by clients in their client area. Manually triggered migrations do not include this section. You will find here connection information for the source WordPress:

    • URL - The website address of the source WordPress.
    • Protocol - Connection type (FTP, SFTP, or FTPS).
    • Path - Directory path to the WordPress installation.
    • FTP Host - The FTP server address.
    • FTP Port - The port number used for the connection.
    • FTP Username - The FTP account username.
    • FTP Password - The FTP account password.

# Failed migrations

The Failed Migrations table includes similar information to the In Progress section but with a key difference: the Status column indicates the reason for the migration failure.

  • ID Number - Click to be redirected to the service details.

  • User - Displays assigned user data; hover to see a tooltip with user details. Click to go to the user details page.

  • Service - The service to which the WordPress installation is assigned.

  • Domain - The domain of the migrated WordPress installation; hover to view a list of instances.

  • Status - Provides the reason for migration failure. These can be: "Stopped by admin" (for manual migrations), "Cannot dump MySQL database on remote server" or any other server error.

  • Available Actions:

    • Show Details - Click to view the Migration Details form. For more information, see the Migration Details section above.
    • Retry - Re-initiate the WordPress instance migration. This action is only applicable to migrations marked as stopped.
    • Mark As Successful - You can mark any failed migration as successful. After confirming, the migration will be marked as successful. Remember to manually complete the instance import to ensure it is usable.
    • Delete - Click to delete the specific WordPress instance migration. This stops and removes the migration process. For bulk deletions, select the migrations you wish to delete and use the mass actions button.

# Successful migrations

The Successful Migrations section lists all successfully completed migrations of WordPress instances to PanelAlpha. The Status column will always display "Completed."

  • ID Number - Click to be redirected to the service details.

  • User - Displays assigned user data; hover to see a tooltip with user details. Click to go to the user details page.

  • Service - The service to which the WordPress installation is assigned.

  • Domain - The domain of the migrated WordPress installation; hover to view a list of instances.

  • Status - Indicates that the migration has been successfully completed.

  • Available Actions:

    • Show Details - Click to view the Migration Details form. For more information, see the Migration Details section above.