How to upgrade UVdesk!

peopleinside

How to upgrade?

This guide is a generic guide written by an passionate UVdesk user so the procedure is at your own risk however if you take a full backup of your installation, as suggested in below steps, you should be safe and always free to resume your old installation.

Rare exception: Some UVdesk version may need special procedure for the upgrade, you usually can find what additional or different steps are needed by checking on the GitHub release page or in the Announcement section of the forum. This should be a rare case, usually general procedure is fine.

If you need some help you can always find support at https://forums.uvdesk.com/ or https://www.uvdesk.com

Method 1 using SSH

First of all be sure to have a full UVdesk root folder and database backup, without this you may loose your configuration or be unable to resume your install if something went wrong.

After you have a full backup you can run, in UVdesk root folder, the SSH command:

composer update

At the end of the update you should need to run php bin/console c:c inside the root UVdesk directory

Than you will also need run on SSH the following two commands:

php bin/console d:s:u --force
php bin/console assets:install

Now you need replace some files from your backup:
important configuration files that you will need to replace after the upgrade to not loose your configuration are:

swiftmailer.yaml
uvdesk_mailbox.yaml
uvdesk.yaml
translation.yaml (You will find these files under config->packages of your project).
services.yaml under config folder of your project should be backup too for have the default native language links in sent emails.

After you upgraded you will need to replace your new project public folder by old project public folder.

In the public folder there are some folders/files that maybe is better not replace so I suggest to
avoid to replace the following folders: css, scripts, boundles folders and the index.php file If you done some edits here I suggest to resume the edits manually.

In any case when you run php bin/console assets:install suggested below you will get all latest CSS and Js automatically updated in public folder.

At the moment you may need update also the translations folder manually, the folder is in the root of the UVdesk installation.

OR

Method 2 using SSH

First of all be sure to have a full UVdesk root folder and database backup, without this you may loose your configuration or be unable to resume your install if something went wrong.

Now with a full backup done, you need to update all dependent bundles of this project by running below SSH commands.

composer update uvdesk/core-framework
composer update uvdesk/support-center-bundle
composer update uvdesk/mailbox-component
composer update uvdesk/automation-bundle
composer update uvdesk/extension-framework

At the end of the update you should need to run php bin/console c:c inside the root UVdesk directory

Than you will also need run on SSH the following two commands:

php bin/console d:s:u --force
php bin/console assets:install

Now you need replace some files from your backup:
important configuration files that you will need to replace after the upgrade to not loose your configuration are:

swiftmailer.yaml
uvdesk_mailbox.yaml
uvdesk.yaml
translation.yaml (You will find these files under config->packages of your project).
services.yaml under config folder of your project should be backup too for have the default native language links in sent emails.

After you upgraded you will need to replace your new project public folder by old project public folder.

In the public folder there are some folders/files that maybe is better not replace so I suggest to
avoid to replace the following folders: css, scripts, boundles folders and the index.php file If you done some edits here I suggest to resume the edits manually.

In any case when you run php bin/console assets:install suggested below you will get all latest CSS and Js automatically updated in public folder.

At the moment you may need update also the translations folder manually, the folder is in the root of the UVdesk installation.

OR

Method 3 using SSH

First of all be sure to have a full UVdesk root folder and database backup, without this you may loose your configuration or be unable to resume your install if something went wrong.

When you have done the full backup you can simply create a new project by this command it will always install the latest version of the project:

composer create-project uvdesk/community-skeleton helpdesk-project

You can watch a video on how to generate the uvdesk folder file.

Now you need replace some files from your backup:
important configuration files that you will need to replace after the upgrade to not loose your configuration are:

swiftmailer.yaml
uvdesk_mailbox.yaml
uvdesk.yaml
translation.yaml (You will find these files under config->packages of your project).
services.yaml under config folder of your project should be backup too for have the default native language links in sent emails.

After you upgraded you will need to replace your new project public folder by old project public folder.

In the public folder there are some folders/files that maybe is better not replace so I suggest to
avoid to replace the following folders: css, scripts, boundles folders and the index.php file If you done some edits here I suggest to resume the edits manually.

In any case when you run php bin/console assets:install suggested below you will get all latest CSS and Js automatically updated in public folder.

At the moment you may need update also the translations folder manually, the folder is in the root of the UVdesk installation.

In the public folder there are some folders/files that maybe is better not replace so I suggest to
avoid to replace the following folders: css, scripts, boundles folders and the index.php file If you done some edits here I suggest to resume the edits manually.

In any case when you run php bin/console assets:install suggested below you will get all latest CSS and Js automatically updated in public folder.

At the moment you may need update also the translations folder manually, the folder is in the root of the UVdesk installation.

OR

Method 4 using FTP

For a better security be sure to use FTP over TLS explicit encryption mode as use FTP without TLS is a potential security risk.

First of all be sure to have a full UVdesk root folder and database backup, without this you may loose your configuration or be unable to resume your install if something went wrong.

When you have done the full backup you can download the ZIP file project from the following URL: https://cdn.uvdesk.com/uvdesk/downloads/opensource/uvdesk-community-current-stable.zip

Than simply replace files on your server.

Now you need replace some files from your backup:
important configuration files that you will need to replace after the upgrade to not loose your configuration are:

(config/packages)

swiftmailer.yaml
uvdesk_mailbox.yaml
uvdesk.yaml
translation.yaml (You will find these files under config->packages of your project).
services.yaml under config folder of your project should be backup too for have the default native language links in sent emails.

After you upgraded you will need to replace your new project public folder by old project public folder.

Now you need also replace the .env hidden file in the uvdesk root folder: default with your one that contains database infos.

Also update local language in the file: uvdesk/config/services.yaml

In the public folder there are some folders/files that maybe is better not replace so I suggest to
avoid to replace the following folders: css, scripts, boundles folders and the index.php file If you done some edits here I suggest to resume the edits manually.

Thank You!!

Sanjeev

One more approach to update your existing project :

Download project zip from here.

After downloading the project extract zip file.

Now, copy uvdesk folder from extracted folder->vendor->uvdesk from this location.

First, delete the uvdesk folder from your_project->vendor->uvdesk location.

Now, copy uvdesk foder from extracted folder and paste into your project under vendor folder.

Also replace your translation folder from extracted zip folder into your project.

Check below screenshot for reference the folder you need to replace in your project from extracted zip folder

Finally run the following commands:

php bin/console d:s:u --force
php bin/console c:c