How to upgrade UVdesk!


  • mod admin

    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

    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 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:

    • 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.

    Thank You!! ♥


  • UVdesk Staff mod

    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

    bd9afc9c-0ff3-4394-aece-1b69548241a9-image.png

    Finally run the following commands:

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


Log in to reply