App Update Command

The app:update command enables you to painlessly update your help desk to the latest version available to your license.

Contents

Requirements
How It Works
Usage

If your deployment is running on Docker, you must update the system using these steps.

Requirements

The disable_functions php.ini directive must not be set. System update makes use of functions such as proc_open, exec and others.
The following CLI applications must be installed on the server: mysqldump, tar. They will be searched for via the PATH environment variable.

How It Works

Pre-flight Checks
Several checks are performed to ensure that the help desk is able to safely update to a new version. These checks include, but are not limited to:
- Sufficient disk space available.
- Files are owned by the same user/group as the user running the command.
- The file system is not read-only.
- The license is permitted to update to the new version.
Download Release
The release is downloaded and file verification checks are made to ensure it's not been tampered with.
Backup
A full backup of the help desk is taken as described at Backup and Restore.
Extract Release
Maintenance mode is enabled on the help desk and the release is extracted overwriting the existing files in the installation directory.
Database Upgrades
The app:upgrade command is used to perform database upgrades and complete the update. Maintenance mode is also disabled.

Usage


php app-manager/artisan app:update

Usage Options

Additional Options

Option	Description
`--agree-eula`	Explicitly agree to the SupportPal EULA.
`--no-backup`	The command generates a backup before making any changes to the help desk installation files. This can drastically slow down the speed of the command. If you've taken you're own backups, then this option will enable you to skip creating a backup.
`--mysqldump-binary-path`	The command will try to automatically find `mysqldump`. If it returns an error, you can manually specify the absolute path to mysqldump. For example: `php app-manager/artisan app:update --mysqldump-binary-path="C:\laragon\bin\mysql\mysql-5.7.24-winx64\bin\mysqldump"`
`--tar-binary-path`	The command will try to automatically find `tar`. If it returns an error, you can manually specify the absolute path to tar. For example: `php app-manager/artisan app:update --tar-binary-path="C:\Program Files\Git\bin\tar.exe"`
`--force`	Run the command non-interactively; use of the `--agree-eula` option is also necessary.

For further assistance, please refer to the help information which can be found by running:

php app-manager/artisan help app:update

Example Output


[2021-08-24 12:44:02] Checking if the application is able to upgrade...
You have version 3.6.0. Latest version available is 3.7.0.
[2021-08-24 12:44:02] Downloading version 3.7.0 to /tmp/supportpal-krpMCX/helpdesk-3.7.0.tar.gz...
[2021-08-24 12:44:03] Backing up database...
[2021-08-24 12:44:05] The backup was generated at /var/www/html/storage/app/backups/database-2021-08-24-12-44-03.sql.gz
[2021-08-24 12:44:05] Backing up filesystem...
[2021-08-24 12:44:05] Cloning filesystem to temporary path started
[2021-08-24 12:44:05] Creating filesystem skeleton clone
[2021-08-24 12:44:05] Cloning /var/www/html/app
[2021-08-24 12:44:06] Cloning /var/www/html/database
[2021-08-24 12:44:06] Cloning /var/www/html/config
[2021-08-24 12:44:06] Cloning /var/www/html/vendor
[2021-08-24 12:44:08] Cloning /var/www/html/resources
[2021-08-24 12:44:08] Cloning /var/www/html/bootstrap
[2021-08-24 12:44:13] Cloning filesystem completed
[2021-08-24 12:44:13] Backing up /var/www/html/storage/app/backups/filesystem-2021-08-24-12-44-05/...
[2021-08-24 12:44:39] OK (1 backup, 2 checks)
[2021-08-24 12:44:39] The backup was generated at /var/www/html/storage/app/backups/filesystem-2021-08-24-12-44-05.tar.gz
[2021-08-24 12:44:39] Combining backups...
[2021-08-24 12:44:39] The backup was generated at /var/www/html/storage/app/backups/app-2021-08-24-12-44-39.tar.
[2021-08-24 12:44:39] Extracting /tmp/supportpal-krpMCX/helpdesk-3.7.0.tar.gz...
[2021-08-24 12:44:49] Success
+--------------------------------------------+
|
| Upgrade Existing Installation
|
| 3.6.0 -> 3.7.0
|
+--------------------------------------------+

Our Upgrade Guide contains useful information regarding breaking changes and best practices for upgrading:
https://docs.supportpal.com/current/Upgrade+Guide
        
Please read our software license agreement below. By continuing, you are agreeing to the license.
https://www.supportpal.com/company/eula
        
Database setup complete.

+--------------------------------------------+
|
| Upgrade Complete
|
+--------------------------------------------+