Upgrade (installer)
ATTENTION: These instructions are valid for ERP "UserSide" version 3.10 and higher. For versions below 3.10 - use separate instructions for upgrade.
Specifics of the version 3.11 upgrade: view Specifics of the version 3.12 upgrade: view Specifics of the version 3.13 upgrade: view Specifics of the version 3.14 upgrade: view Specifics of the version 3.15 upgrade: view Specifics of the version 3.16 upgrade: view Specifics of the version 3.17 upgrade: view
We recommend having two instances of the system. A separate production instance and a test instance. On the test instance, you can periodically update the database from the production system and perform upgrades to make sure everything is working, check new features, or identify things that are not working for you.
Instructions on how to create a copy of a working system for testing a new version or other research can be found in HOWTO: USERSIDE cloning.
Preparation work
1) Be sure to back up the database, the programme directory and all modules before upgrading the working copy! You are responsible for the safety of your data!
2) Disable all ERP "UserSide" modules in the system cron and stop all ongoing modules working with the Userside database during the upgrade
Upgrade
See also: Installer help
1) Navigate to the system directory (/var/www/userside)
2) Run the installer with the install command
sudo -u www-data php userside_install.phar install
In the work process, the installer checks for compliance with technical requirements and asks questions related to the upgrade.
During runtime, the installer will suggest you select the version to which you want to upgrade. It can be a version from a provided list (you can enter a serial number from the list) or any other version (you can enter a version number, e.g. 3.15.4).
A message will be displayed when the upgrade is completed.
If the installer is interrupted for any reason (data migration error or other), run the installer with the repair command
sudo -u www-data php userside_install.phar repair
If the problem cannot be solved by yourself, submit a ticket to Technical support.
4) if necessary, upgrade the UserSide family modules with new files on all machines where they are running
5) restore the previously disabled ERP "UserSide" modules in the system cron, and start the permanently running Userside services, if any