Upgrading from WISECP 3.x to 5.x
The 3.x to 5.x upgrade moves a WISECP 3.x installation to WISECP 5 in place, keeping your customers, services, invoices and settings.
Opening the Screen
The upgrade starts in the 3.x admin panel under Help → Updates. It needs 3.x release 3.1.9.8.3 or newer. On an older 3.x the Updates page offers that release first; the 5.0 line appears after you apply it.
The card WISECP 5.0 is ready for this installation carries the button Start the 5.0 upgrade wizard. It opens upgrade.php in your installation root with a signed link that expires with the day. Opening the file directly shows Not available; return to the Updates page and use the button.
How the Upgrade Runs
The wizard has two parts: a preparation screen that fetches the 5.x package, then five steps that carry out the upgrade. The steps share the installer's stage: the Start the Upgrade face names the installation, Start opens the agreement, a counter at the top right shows the step, and the Enter key moves on whenever the primary button is enabled. Nothing in your 3.x installation changes before the Upgrade step. Moving to a new server at the same time? Install 5.x there and use Import Tools instead. This wizard upgrades in place.
Preparation
Three rows run on their own. The licence service names the 5.0 build you may install. The package is downloaded to your server and unpacked into _wisecp_v5_stage next to your installation. A failed row shows its reason and a Try again button. When all three pass, the wizard opens.
The Five Steps
| Step | What happens | What you do |
|---|---|---|
| Start | Shows the installed version, folder, database, active theme and the staged package. | Accept the licence agreement, then click Continue. |
| Check | Checks the server, the database, the licence and free disk space. Rehearses the migration without changing anything; the migration preview and the list of what will not travel fold away under the verdict. | Read the results. Fix anything blocking, click Check again, then Continue. |
| Confirm | Names the folder that will keep your 3.x files. | Tick the database backup confirmation, then click Start the upgrade. |
| Upgrade | Runs eleven stages, one request each. The site is in maintenance mode until the health check passes. | Keep the page open. Nothing to click. |
| Finished | Confirms the site and the panel answer, then removes the wizard. | Click Go to the panel and sign in as before. |
What Is Carried Over
Customers, services, orders, invoices, tickets, uploads and visitor statistics stay where they are. Settings, encryption keys, module settings, notification preferences and the admin folder name are carried into 5.x. Passwords keep working: the Check step verifies that stored passwords open with the carried keys. If cPanel's MultiPHP Manager selected the folder's PHP version, the handler block it wrote into .htaccess is copied into the new .htaccess. The site keeps running on the same PHP version, and the Check step shows the version it found.
The logos you uploaded on 3.x (site, client area and email logos, and the favicon) are carried over; the default logos that came with 3.x are not, so 5.x shows its own. The colors your 3.x site showed move to Site Colors on the Logo/Branding tab. If they look pale, click Pick from logo there, then click Save Changes. Your contact address becomes the head office on the Contact page in place of the sample offices of the 5.x template. The full-access administrator group receives the permissions 5.x added; a restricted group receives only those that correspond to a permission it already had on 3.x.
What Is Not Carried Over
The Check step lists these for your installation. Nothing on the list is deleted; it stays in the backup folder.
Before You Start
Tasks
Run the Upgrade
- Take the database backup and confirm it restores.
- In the 3.x panel open Help → Updates, apply 3.1.9.8.3 if it is offered, then click Start the 5.0 upgrade wizard.
- Let the preparation finish, click Start on the opening face, accept the agreement and click Continue. Wait for Ready to Upgrade and click Continue again.
- Tick the backup confirmation and click Start the upgrade. The stages run through to Upgrade Complete, with links to the site and the panel.
After the Upgrade
- Sign in to the 5.x panel with the same email and password as before.
- Update the cron job: the 5.x command differs from the 3.x one, and Settings → Cron Jobs shows it.
- Pick and configure a website theme, check the modules that had no 5.x counterpart, and review the notification templates.
Continue After an Interruption
- If the connection drops, open the page again: the upgrade resumes where it stopped.
- If a stage fails, read the log under the stage list, fix the cause and click Retry. Finished stages are not repeated.
Go Back to 3.x
- Move the 5.x entries out of the root and put the contents of the backup folder back. The folder holds a notes file with the exact steps.
- Move uploads and visitor statistics back from the 5.x tree.
- Restore the full database backup you took before the upgrade. The site answers as 3.x again.
Things to Watch
The migration renames tables, converts every MyISAM table to InnoDB and writes values that 3.x cannot read. The files can be put back in a minute; the database only from your backup.
Keep the 3.x backup folder and the database backup for at least 72 hours. Data created in 5.x after the upgrade cannot be carried back to 3.x.
The Check step shows this when the same key is registered to another address. The upgrade still completes; ask support to reissue the licence for this address so verification settles.
Related Articles
Дякуємо за відгук!
Наша служба підтримки на зв’язку цілодобово з усього, чого ви не знайшли вище.