Skip to main content

Update from Terminal

Prerequisites

Make sure the following condition are met before attempting to update:

  1. vtenext must be updated to version 25.02.2. Only from this version it's possible to proceed to the next update step
  2. A valid license must be active

 

Update with vteUpdater

Since this version of vtenext supports only php >= 8.3, there are 2 options:

  • move the entire installation on a new host with php 8.3 (recommended Ubuntu Server 24.04), with all the necessary packages (see the Installation Requirements page). In this case, make sure the connection parameters in config.inc.php are correct in the new host.
  • update the current host to a new version with php 8.3 (in this case it's strongly recommended to do a snapshot before starting)

After this, the update procedure can begin:

  1. Login via SSH to the server hosting vtenext and navigate to its directory.
  2. Execute ./vteUpdater.sh (make it executable if it's not already) and follow the instructions.
    The output should be similar to this:
    root@testhost:/var/www/html/vte3001upd# ./vteUpdater.sh

VTE Automatic Updater -- version 1.72
[INFO] Checking for upgrades of this script...
[INFO] Found VTE at revision 3001
[INFO] Checking for latest available version...

You can update to revision ????, . Do you want to proceed? (Y/N) : y

Please type your username : **********
Password: *****************
[INFO] Validating credentials...
[INFO] Downloading package...
[INFO] Packages downloaded succesfully
[INFO] Updating VTE to revision ????
mysql: [Warning] Using a password on the command line interface can be insecure.
mysql: [Warning] Using a password on the command line interface can be insecure.
[INFO] Database size is 140 MB, (biggest table is sdk_language, 15 MB)

The user and group for the web server have been detected as www-data:www-data. Is this correct? (Y/N) : y
[INFO] Starting file comparison...
File comparison: [########################################] 100%
[INFO] No differences found
[INFO] Waiting 2 minutes for cron processes to finish...
[INFO] Creating backup of VTE files...
Do you want to backup the database? (Y/N) : y
[INFO] Creating backup of database...
[INFO] Starting update...
[INFO] Files copied. Executing schema update...
[INFO] Removing obsolete files...
[WARNING] The file ./config.template.php might have some custom code, left untouched
[INFO] Removed 6289 files and 1126 directories
[INFO] Executing post-delete scripts...
[INFO] Update notes:
[INFO] The obsolete module Dashboard has been eliminated, as well as the method SDK::setDashboard
[INFO] If you were still using Dashboards, please migrate them to Charts or custom Iframe
[INFO] 
[INFO] Classes Vtiger_Net_Client and Vtiger_Feed_Parser have been eliminated.
[INFO] Please review the custom code if they were still used
[INFO] 
[... redacted ...]
[INFO] 
[INFO] Update successful!

  3. In case of custom modifications to the code, they need to be ported manually to the new version, and checked to be sure they work with php 8.3. Refer to the developers manual to see what has changed
Back to top