Перенос между серверами

Перенос биллинга и лицензии между серверами может потребоваться при смене оборудования.

Для переноса биллинга нужно:

На время переноса включить режим maintenance mode на старом сервере.
Импортировать данные пользователей со старого сервера на новый.
Перенести кастомные XML-файлы, дополнения и плагины на новый сервер.
Перенести кастомную витрину.
Запустить установку всех отсутствующих пакетов ПО (обработчиков услуг, платёжных систем, почтовых шлюзов).
Привязать лицензию на панель управления к новому серверу.
Отключить режим maintenance mode.

Обратите внимание!

После переноса BILLmanager рекомендуем удалить панель управления со старого сервера. Одинаковые настройки обработчиков услуг в двух биллинговых платформах приводят к некорректному открытию услуг.

Шаг 1. Включите режим maintenance mode

Maintenance mode — это режим технического обслуживания в BILLmanager. Пока включён этот режим, модули обработки и почтовые шлюзы в BILLmanager не будут выполнять операции.

Включите на старом сервере режим maintenance mode. Для этого создайте файл /usr/local/mgr5/etc/billmgr.DoNothing.

Шаг 2. Импортируйте данные пользователей

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

Обратите внимание!

Триальная лицензия имеет ограничение по количеству клиентов. После переноса BILLmanager активируйте на новом сервере коммерческую лицензию.

Перенос можно осуществлять между серверами с разными операционными системами. Например, вы можете перенести BILLmanager с Debian 8 на Centos 7.

Обратите внимание!

Редакции продукта на серверах должны совпадать. Например, если на старом сервере редакция продукта BILLmanager Corporate, то и на новом сервере должен быть BILLmanager Corporate.
При этом версия продукта на новом сервере должна быть не ниже, чем на старом сервере.

Чтобы перенести BILLmanager:

Перейдите в BILLmanager на старом сервере и настройте резервное копирование: Инструменты → Резервное копирование.
Нажмите Запустить, чтобы создать резервную копию.
Выберите созданную копию и нажмите Скачать, чтобы сохранить архив на ваш компьютер.
Перейдите в BILLmanager на сервере с CentOS 7 и настройте резервное копирование в Инструменты → Резервное копирование.
Нажмите кнопку Закачать и выберите архив, сохранённый на шаге 3.
Выберите загруженную резервную копию и нажмите Восстановить.
Дождитесь окончания операции восстановления.
Чтобы панель управления BILLmanager была доступна на новом сервере, укажите IP-адрес сервера в конфигурационном файле ihttpd /usr/local/mgr5/etc/ihttpd.conf.
Перезапустите панель управления. Для этого в терминале сервера выполните:
```
/usr/local/mgr5/sbin/mgrctl -m billmgr exit
```

Обратите внимание!

Созданные вами тарифы, шаблоны сообщений и документов хранятся в БД BILLmanager и будут перенесены вместе с ней.

Шаг 3. Перенесите кастомные XML-файлы, дополнения и плагины

Если вы создавали собственные XML-файлы, дополнения и плагины, для переноса их на новый сервер:

Создайте на новом сервере директорию /usr/local/mgr5/backup/ , если такой директории ещё нет.
Перенесите в эту директорию со старого сервера содержимое директорий:
- /usr/local/mgr5/etc/xml/ — директория с собственными XML-файлами;
- /usr/local/mgr5/addon/ — директория с собственными дополнениями;
- /usr/local/mgr5/src/ — директория с собственными плагинами.

Скопируйте содержимое директорий с пропуском существующих файлов:

cp -n /usr/local/mgr5/backup/xml/* /usr/local/mgr5/etc/xml/

cp -n /usr/local/mgr5/backup/addon/* /usr/local/mgr5/addon/

cp -n /usr/local/mgr5/backup/src/* /usr/local/mgr5/src/

Выполните повторную сборку и установку необходимых плагинов. Подробнее об этом см. Взаимодействие на низком уровне, плагины с++.

Шаг 4. Перенесите созданную вами витрину

Чтобы перенести собственную витрину со старого сервера на новый, перенесите на новый сервер директорию /usr/local/mgr5/skins/showroom.

Шаг 5. Запустите установку отсутствующих пакетов

После переноса БД запустите на новом сервере установку всех отсутствующих пакетов обработчиков услуг, платёжных систем и почтовых шлюзов.

Для установки недостающих пакетов запустите команду:

/usr/local/mgr5/sbin/mgrctl -m billmgr fix.modules

Шаг 6. Привязка лицензии к новому серверу

После переноса панели на новый сервер перейдите в личный кабинет, где у вас заказана лицензия.
Удалите триальную лицензию из личного кабинета.
В настройках платной лицензии введите IP-адрес нового сервера.
При изменении версии продукта смените тарифный план лицензии в личном кабинете. Условия и стоимость перехода на новый тариф уточняйте у компании-продавца.
Обновите файл лицензии. Для этого перейдите в панель управления, откройте раздел Помощь → О программе и нажмите кнопку Обновить лицензию. Либо загрузите лицензию вручную командой:
```
/usr/local/mgr5/sbin/licctl fetch billmgr
```

Шаг 7. Отключите режим maintenance mode

Для отключения режима maintenance mode удалите файл /usr/local/mgr5/etc/billmgr.DoNothing.