Миграция с ERP USERSIDE

Возможна миграция с ERP Userside версии 3.12 и более новой.

Убедитесь, что все необходимые системные компоненты установлены. В зависимости от версии Userside, которую вы используете, у вас уже могут быть установлены те или иные компоненты. Убедитесь, что всё необходимое есть в наличии. Если чего-то не хватает — установите и выполните его настройку.

Сделайте резервную копию своего Userside — файлов и базы данных. Это обязательный шаг, потому как успешная миграция на Cubalink не может быть гарантирована в полной мере.

После того, как резервная копия выполнена, остановите работу cron (закомментируйте запуск userside cron и модулей), supervisor, nginx, php-fpm.

sudo systemctl stop supervisor
sudo systemctl stop nginx
sudo systemctl stop php-fpm

Служба из последней команды может называться иначе, например, php7.1-fpm, в зависимости от версии PHP, которая у вас используется.

Перенастройка для Cubalink

Вам необходимо перенастроить установленные ранее для Userside компоненты.

Первым делом переименуйте основной каталог:

sudo mv /var/www/userside /var/www/erp

PHP

Установите PHP 8.3 и все необходимые модули и выполните их настройку, как показано в разделах Установка PHP и Настройка PHP.

Nginx

Создайте каталог /var/www/erp/public и сделайте его владельцем пользователя www-data:

sudo mkdir -p /var/www/erp/public
sudo chown www-data:www-data /var/www/erp/public

Теперь нужно отредактировать файл настройки сервера NGINX. У вас он может называться по-разному или даже настройка для Userside может быть внутри какого-то другого файла конфигурации сервера. В самом простом случае вы можете удалить текущий файл и создать новый, как указано в разделе про настройку Nginx после установки.

Если вы решили отредактировать ваш существующий файл, то нужно внести следующие изменения:

1. Web Root. Строку:

   root   /var/www/userside/userside3;
   

   заменить на строку:

   root   /var/www/erp/public;
   

2. Корневой location /. Строку:

   try_files $uri $uri/ =404;
   

   заменить на строку:

   try_files $uri $uri/ /index.php$is_args$args;
   

3. fastcgi_pass для php-fpm. Строку (у вас может быть другая версия):

   fastcgi_pass  unix:/run/php/php8.1-fpm.sock;
   

   заменить на строку:

   fastcgi_pass  unix:/run/php/php8.3-fpm.sock;
   

Websocket пользователь

Если вы установили RebbitMQ только что перед процедурой миграции и создали всех пользователей по инструкции, то следующие команды не выполняйте и переходите к следующему разделу.

Если у вас Userside 3.17 и новее, то вероятней всего пользователь для websocket у вас уже есть.

Если вы сомневаетесь, есть ли у вас уже пользователь для websocket, выполните команду:

sudo rabbitmqctl list_users

Если среди пользователей вы видите пользователя с именем похожим на websock или на stomp, вероятно такой пользтватель уже есть. Посмотрите, какие права он имеет (вместо имя_пользователя укажите имя найденного пользователя):

sudo rabbitmqctl list_user_permissions имя_пользователя

Если в результате вы видите права доступа вроде таких:

user	configure	write	read
websocket	^userside-stomp:id-.*		^userside-stomp:id-.*

то это точно означает, что пользователь для websocket у вас уже есть.

В этом случае вам нужно изменить права доступа, выполнив следующие команды:

sudo rabbitmqctl clear_permissions имя_пользователя
sudo rabbitmqctl set_permissions имя_пользователя "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"

Здесь также не забудьте указать имя настоящего пользователя вместо имя_пользователя.

Postgres

Рекомендуется использовать последние стабильные версии PostgreSQL, так как помимо расширения функциональности они в некоторых случаях работают заметно быстрее.

Вы можете обновить кластер (так называется набор баз данных даже на одном сервере, даже если база данных одна) на последнюю версию. Для этого существуют готовые скрипты под debian и ubuntu из пакета postgresql-common.

Документация по обновлению кластера от Postgres: https://www.postgresql.org/docs/current/upgrading.html

Предупреждение

Не забудьте об обязательном резервном копировании баз данных перед подобными операциями.

Перезапуск служб

После редактирования конфигурации нужно перезапустить все затронутые службы:

sudo systemctl restart php8.3-fpm
sudo systemctl restart nginx

Запуск процедуры миграции

Процедура миграции ничем не отличается от процедуры новой инсталляции. Поэтому вы можете обратиться к главе Установка ERP и выполнять все действия последовально из нее (кроме создания каталога /var/www/erp, так как он у вас уже существует).