CPV LAB PRO V. 11.0 - ONE PAGE UPGRADE WIZARD

• To upgrade CPV Lab Pro (opens new window) to the latest version, you need to follow the instructions from the upgrade-wizard.php page.
• There are only 5 steps required to complete (around 15 min):
  • Step 1. Check Server Requirements
  • Step 2. Download Upgrade Package
  • Step 3. Import Database Update Files
  • Step 4. Verify the Database
  • Step 5. Upload the New Files

Pre-requirements

• 1. You need to have an older version of CPV Lab already installed
• 2. Before accesing the upgrade page you need to make sure you have the following available on your server:
  • Linux Server - VPS or Dedicated Hosting (recommended)
    • PHP 8.1 or 8.2 (PHP 8.2 recommended)
    • MySQL 5.6.3 or above/ MariaDB 10.0.12 or above
    • minimum 500 MB of disk space
    • ionCube Loader version 12.0 or newer
    • External requests enabled
    • 256MB of Memory allocated to PHP Process (memory_limit key from php.ini)
    • Required PHP Extensions
      • BCMath extension
      • iconv extension
      • mbstring extension
      • mysqli extension
      • session extension
      • SimpleXML extension
      • zip extension
      • xmlreader extension
      • json extension
• 3. We recommend making a backup of the database and the files from your CPV Lab Pro instance. It’s better to be safe in case something goes wrong.
  • The database can be backed up from PhpMyAdmin and the files can be copied with an FTP client application.
• 4. Download the Upgrade Wizard Package for your PHP version from the User Area (opens new window). Login into the User Area (opens new window) using the credentials received on email when CPV Lab Pro (opens new window) was purchased.
• 5. Copy and unzip this package on your computer
• 6. Upload only the check-server-settings.php file from the package on your server by using Filezilla FTP client (opens new window) or File Manager utility from cPanel or any other FTP utility.
  • This file will check for the necessary PHP version and ionCube Loader version
• 7. Access the check-server-settings.php page in a browser
  • The link to this page should be: http://<your_CPV_Lab_Pro_Location>/check-server-settings.php
• 8. If the page displays PHP version 8.1 or 8.2 and the "ionCube Loader is installed and working" message, then everyting is fine and you can continue.
  • If you get a completely blank page, then you need to have the ionCube Loader module upgraded on the server. You can contact your webhost and ask them to perform the ionCube Loader upgrade.

  

• 9. Then upload ALL files and folders from the package on your server by using Filezilla FTP client (opens new window) or File Manager utility from cPanel or any other FTP utility.
  • You should upload the files in the location where you have CPV Lab Pro (opens new window) installed
• 10. Access upgrade-wizard.php page in a browser
  • The link to this page should be: http://<your_CPV_Lab_Pro_Location>/upgrade-wizard.php

Step 1. Check Server Requirements

• A list with all the server requirements will appear in the Step 1 section
  • If your server is missing any of the items, it will be signaled with a RED message
  • If all your server requirements are met, they should all have a GREEN message
• Once you have all the server requirements met (they are all GREEN ), then you can move to Step 2. Download Upgrade Package

Step 2. Download Upgrade Package

• In order to download the Upgrade Package you need to provide the following information:

  • License Email - is the email used to purchase the license for CPV Lab Pro (opens new window)
  • PHP Version - will be pre-filled automatically when possible.
  • ionCube Loader version - will be pre-filled automatically when possible.

• Click "Download Upgrade Package" to download the appropriate upgrade package for your server settings.

• An archive will be downloaded

• Unzip this package on your computer

Step 3. Import Database Update Files

• Import the following MySQL script files from the upgrade package (from the "v11 MySql Scripts" directory) in the CPV Lab Pro database in the exact order as listed in the Wizard page. In this example we have:

  • cpvlabscript90-100.sql
  • cpvlabscript100-110.sql

• Follow these steps in order to import the scripts above (click on each link for instructions and sample image on the right side of the page) :

  • You need to open the PhpMyAdmin utility from cPanel or any other database tool.

  

  • Select your CPV Lab Pro database from the list of databases on the right.

    

  • Click on the "Import" tab from the menu at the top of the page.

    

  • In the Import window click on the "Browse" button and select the first file from the list above. Then click on the "Go" button.

    

  • You should see a confirmation message saying that the import was finished.

    

  • Repeat the import process ("Browse" button + "Go" button**) for each of the MySQL files from the list above.**

    

• Once you complete all the above steps, you can go to next step : Step 4. Verify the Database

Step 4. Verify the Database

• Here you will check that the files from Step 3 were imported correctly

  • Click on the "Verify the database" button to verify that the database was updated correctly to the latest version.

    • if you get the message below, then you need to repeat STEP 3 instructions:

    

    • if the message received is "Database was updated correctly to the latest version. You can continue to Step 5.", then you can continue to Step 5. Upload the New Files

Step 5. Upload the New Files

• Upload all files and folders from the "v11 Upgrade" directory in the package on the server (use Filezilla FTP client (opens new window) ) or File Manager utility from cPanel or any other FTP utility).
• Make sure that you overwrite the existing files.
• Click "Verify the Files" button to make sure all files are setup correctly.
• Ready! Go and check the updates! ☺️

About Error Messages

• All the error messages/warnings will be RED

• Most error messages include indications on how to be solved

  • Examples:

  

  

  

• You shouldn't go to a next step until you solve all the warnings from the current step

• Once a step is completed, you can move forward to the next step

IMPORTANT NOTE

• If the Upgrade Wizard page doesn't load and shows a blank screen or a message about corrupted files, then please check the ionCube Loader version from your server and make sure that you have ionCube Loader version 12.0 or newer.
• IonCube Loader 12.0 or newer is required for CPV Lab 11.0.

• If the Upgrade Wizard page appears without texts and images, then please check that the following 2 PHP extensions are enabled on the server:
  • mbstring
  • cURL