Upgrade 3.10

en | ru

Update date: January 2017

Version required: 3.9

A few words from the author - version features

• We have a new module usm_cabletest

• Added functionality for accounting and working with CWDM

• The structure of the update archive and the update process itself have changed. We are starting a gradual migration to PostgreSQL. Please read the recommendations below to correctly perform the upgrade

• We have added initial functionality to perform billing operations from under UserSide. See: Universal_API#Possible_operations_in_billing_(from_under_UserSide)

• After the upgrade, notifications may appear on the system home page that the server IP address does not match or that the DocumentRoot is incorrect. In these cases - check if DocumentRoot is specified correctly and change the IP address of the server to the correct one in "personal cabinet"

Features of the upgrade

• You need to update PHP to the latest version 5.6 (PHP7 is not necessary yet) and all PHP extensions.
• It is necessary to install missing php-extensions, which are listed on the Technical requirements page.
• It is required to install and configure PostgreSQL 9.6 (you will need the database name, username and password during installation USERSIDE onwards)
• Following the recommendations from the Upgrade page, start the upgrade process and get to the point where you need to click on the ‘Upgrade’ link
• Extract and copy the files from the userside-update-3-10.zip archive to the working system.

In this case - previously the directory structure was as follows

userside
/..
/erp/
/userside3/

And now the new catalogues will be added

userside
/..
/common/
/console/
/erp/
/messages/
/userside3/
/vendor/

• Following the recommendations from the Upgrade page, perform the following basic upgrade steps.

• While in the directory with the application (for example: /var/www/userside) run ‘php setup’ and answer the questions of the installer. After checking that all the necessary PHP extensions are present, you will be prompted for the database connection information (PostgreSQL) that you created a few steps earlier. If the installer encounters any problems, such as missing PHP extensions, the installer will be interrupted. In such a case you should first install all necessary extensions and only then continue the upgrade.

• Add a call to the system cron to call an additional script of the internal UserSide scheduler ‘’(correct the path to the necessary one and the username to the one the web server is running as)‘’.

 * * * * *   www-data   php /var/www/userside/userside cron > /dev/null 2>&1

• Very important! For users of SMS operator TurboSMS. You need to log in to your TurboSMS personal cabinet and enable the SOAP sending function. By default it can be disabled.
• After the upgrade - on the ‘Setup - SMS Setup’ page - check if the settings for connection with SMS-operator are correct and perform a connection test
• If you used your own script for sending SMS - it is required to redo it according to recommendations.
• The usm_asterisk module has been updated from version 0.1x to version 1.0. The archive with the new module contains instructions with upgrade actions. Please follow them.
• You can enable a separate Google API Key

List of Changes: view

Performing the upgrade: instruction