This document introduces using the Migration Upgrade feature via the “Toolbox” → “Migration 3.0” function of Haozi Panel >=2.5.11 to migrate and upgrade to AcePanel 3.0. The overall approach is to migrate websites and databases to another server with AcePanel 3.0 installed, which is simpler than in-place upgrade operations.
If you need an in-place upgrade, please refer to:
Glossary
- In-place Upgrade: Complete the upgrade without reinstalling the operating system.
- Migration Upgrade: Migrate data to a new server to complete the upgrade.
- Old Panel: Haozi Panel 2.x (the panel to be upgraded.
- New Panel: AcePanel 3.0 (the target panel).
Pre-Operation Notes (Must Read)
- Extremely High Risk: You must take a snapshot/full backup of the server before starting, and confirm that rollback is possible.
- Long Downtime: It is recommended to stop websites and the environment during the upgrade, please reserve an upgrade window in advance and notify relevant business parties.
- **Migration Restrictions: 1. SSL certificates for websites are not supported, you will need to reconfigure them after migration. 2. Custom configurations such as pseudo-static for websites are not supported, you will need to reconfigure them after migration. 3. The website type after migration is PHP/pure static; for reverse proxy websites, it is recommended to recreate them directly on the new panel instead of migrating.
Pre-Upgrade Preparation
1) Confirm That the Old Panel Environment Is Running Normally
Log in to the old panel, check applications such as OpenResty, Percona, PHP in sequence, ensure they are running properly, and record the current version/configuration (for verification after migration).
2) Perform Server Snapshot/Backup
Go to the server console, perform a snapshot/backup operation on the server to be upgraded, and **be sure to wait for the backup to succeed before proceeding with the subsequent steps.
New Panel Preparation
Install AcePanel 3.0 on the new server, record the login information and save it for later use.
Go to “Settings” → “Users” → “Access Tokens”, create an access token for migration and save it for later use.
Install the same environment as the old panel (such as OpenResty, Percona, PostgreSQL, PHP versions and related components).
Wait for the environment installation to complete before proceeding to the next step.
Migrate Data
On the old panel, go to “Toolbox” → “Migration”, fill in the new panel information, and click “Next”.
Confirm that the environment is correct (differences in PHP version numbers can be ignored), and click “Next”.
Check the items that need to be migrated, and click “Start Migration”.
Wait for the migration to complete, download the migration log and confirm that there are no error records.
Follow-Up Work
Note: The default website directory structure of the new panel is different, the default path is: `/opt/ace/sites/site name/public
Note: If the website has HTTPS enabled, you need to reconfigure the certificate on the new panel; PHP websites using pseudo-static will need to reconfigure their pseudo-static settings.
After all websites are migrated, access and verify each one (homepage, APIs, backend, static resources, uploads and downloads, etc.) to ensure normal business operations.