Перенос системы

[d.slepnev]

Перенос системы ТЕЗИС между серверами состоит из следующих этапов:

• Остановка службы
  • Остановка для Windows
  • Остановка для Linux
• Выполнение резервного копирования базы данных
  • Создание копии базы данных PostgreSQL
  • Создание копии базы данных MSSQL
• Выполнение резервного копирования файлов системы
• Установка системы на новом сервере
• Развертывание резервной копии базы данных на новом сервере
  • СУБД PostgreSQL
  • СУБД MSSQL
• Запуск службы
  • Запуск для Windows
  • Запуск для Linux
• Применение новой лицензии и проверка основных функций

Остановка службы

Перед началом работ по переносу СЭД ТЕЗИС необходимо остановить службу.

Остановка для Windows

1. Открыть консоль управления службами (Панель управления\Все элементы панели управления\Администрирование\Службы);
2. Найти в списке службу СЭД ТЕЗИС. Как правило, ее название содержит слова Apache Tomcat. Можно убедиться, что это требуемая служба, взглянув на ее исполняемый файл. Он должен
   располагаться в файлах системы ТЕЗИС;
3. Остановить службу любым доступным вариантом, например кнопкой «Остановить» в окне свойств службы.

Остановка для Linux

1. Перейти в папку «bin» СЭД ТЕЗИС, используя команду «cd» и введя путь до папки, например: cd /opt/haulmont/bin
2. В папке «bin» выполнить команду: sudo ./shutdown.sh
3. Чтобы убедиться в том, что все процессы службы tomcat завершены, можно использовать команду: ps ax | grep java
   Если система остановлена, вывод команды будет содержать только одну строку вида: 29642 pts/0 S+ 0:00 grep --color=auto java

Выполнение резервного копирования базы данных

Для определения версии и имени базы данных необходимо открыть файл tomcat/webapps/appcore/META-INF/context.xml. В нем указаны следующие, необходимые для снятия копии БД, данные:

• driverClassName – указывается тип используемой БД. Для PostgreSQL указан org.postgresql.Driver, для MsSQL указан net.sourceforge.jtds.jdbc.Driver;
• username и password – имя пользователя и пароль для подключения к БД;
• url – содержит адрес и название искомой базы данных.

Создание копии базы данных PostgreSQL

1. На сервере баз данных в командной строке (для Windows необходимо запустить командную строку от имени администратора) перейти в папку установки PostgreSQL, используя команду «cd»:

• для Windows: cd C:\Program Files\PostgreSQL\9.1\bin
• для Linux; cd /usr/pgsql-9.6/bin

2. Выполнить команду формирования копии:

• для Windows: pg_dump -p 5433 -U root -Fp thesis > 2019-03-16.sql
• для Linux: **sudo pg_dump -p 5433 -U root -Fp thesis > 2019-03-16.sql,**где 5433 – номер порта, если был установлен отличный от стандартного (стандартный порт - 5432), root – имя пользователя владельца базы (имя по умолчанию - root), thesis – имя базы данных ТЕЗИС (по умолчанию - thesis), 2019-03-16.sql – имя файла копии базы данных (как правило, в имени присутствует дата производимой копии).

3. Полученный файл БД необходимо перенести на новый сервер.

Создание копии базы данных MSSQL

1. Запустить SQL Server Management Studio и подключиться к серверу баз данных, указанному в параметре url.
2. Развернуть дерево сервера и нажать правой кнопкой мыши на базу данных, указанную в параметре url. В выпадающем меню необходимо выбрать пункт Задачи → Создать резервную копию.
3. В окне параметров резервного копирования необходимо указать Тип резервной копии: Полная, а Компонент резервного копирования: База данных.
4. В разделе Назначение необходимо выбрать Диск и, после нажатия на кнопку Добавить, указать путь и имя (с расширением .bak) для сохранения файла резервной копии. При нажатии на кнопку Ок начнется процесс копирования базы данных.
5. По завершении копирования будет выведено соответствующее сообщение. Полученный файл БД необходимо перенести на новый сервер.

Выполнение резервного копирования файлов системы

Резервное копирование файлов осуществляется путем архивирования папки tomcat.

Для Windows:

1. Перейти в папку, в которой расположена папка tomcat;
2. Нажать правой кнопкой мыши на папку tomcat и в контекстном меню выбрать пункт**«Отправить»-«Сжатая ZIP-папка»**, при необходимости можно переименовать получившийся архив.
3. Полученную резервную копию файлов необходимо перенести на новый сервер.

Для Linux:

1. Перейти в папку, в которой расположена папка tomcat, например, командой: cd /opt/haulmont
2. Выполнить архивирование файлов системы командой: tar -cvf name.tar ./tomcat,где name.tar – это желаемое имя архива, а ./tomcat – указание папки, которую следует заархивировать.
3. Полученную резервную копию файлов необходимо перенести на новый сервер.

Установка системы на новом сервере

Установка СЭД ТЕЗИС на новом сервере выполняется в соответствии с разделами Установка Windows+MS SQL, Установка Windows+PostgreSQL, Установка Linux, в зависимости от ОС нового сервера. В качестве дистрибутива СЭД ТЕЗИС необходимо использовать файлы системы, скопированные в пункте “Выполнение резервного копирования файлов системы” данной статьи.

Службу СЭД ТЕЗИС запускать на данном этапе нельзя! На созданную при установке, пустую базу данных необходимо развернуть резервную копию. Подробнее процесс развертывания базы данных описан в в следующем пункте. А также, если СУБД на новом сервере отличается от СУБД на старом сервере необходимо выполнить миграцию базы данных.

Развертывание резервной копии базы данных на новом сервере

Служба СЭД ТЕЗИС должна быть остановлена перед восстановлением копии БД.

СУБД PostgreSQL

Для Windows:

1. Запустить командную строку от имени Администратора;
2. Перейти в папку «bin» PostgreSQL, например: cd C:\PostgreSQL\pg10\bin
3. Выполнить команду: psql -U root db_name < backup_name.sql
   Где: root – имя роли, от которой выполняется команда,
   4.db_name* – имя базы данных, на которую выполняется восстановление,
   5.backup_name.sql* – путь и имя копии базы данных, например «C:\backup\backup.sql».

Для Linux:

1. В командной строке выполнить: sudo psql -U root db_name < backup_name.backup
   Где: root – имя роли, от которой выполняется команда,
   2.db_name* – имя базы данных, на которую выполняется восстановление,
   3.backup_name.sql* – путь и имя копии базы данных, например «C:\backup\backup.sql».

СУБД MSSQL

1. В контекстном меню базы данных выберите «Задачи» - «Восстановить» - «База данных»;
2. На вкладке «Общие» укажите «Устройство» (путь до резервной копии) и в разделе «Назначение» выберите имя базы данных, созданной при установке;
3. На вкладке «Файлы» в табличной части укажите расположение файлов базы данных. Они имеют расширения **.mdf и .ldf;
4. На вкладке «Параметры» проставьте отметку «Перезаписать существующую базу данных (WITH REPLACE)». Запустите восстановление базы данных.

Запуск службы

Запуск для Windows

1. Открыть консоль управления службами (Панель управления\Все элементы панели управления\Администрирование\Службы);
2. Найти в списке службу СЭД ТЕЗИС. Как правило, ее название содержит слова Apache Tomcat. Можно убедиться, что это требуемая служба, взглянув на ее исполняемый файл. Он должен
   располагаться в файлах системы ТЕЗИС;
3. Запустить службу любым доступным вариантом, например кнопкой «Запустить» в окне свойств службы.

Запуск для Linux

1. Перейти в папку «bin» СЭД ТЕЗИС, используя команду «cd» и введя путь до папки, например: cd /opt/haulmont/bin
2. В папке «bin» выполнить команду: sudo ./startup.sh

Применение новой лицензии и проверка основных функций

Внимание! Изменение конфигурации сервера, как и смена сервера приводит к тому, что лицензия становится неактивной. Потребуется выпуск новой лицензии.

Последним шагом при переносе системы на другой сервер является проверка ее корректной работоспособности.
Необходимо проверить:

• открытие системы по ссылке;
• при создании карточек проставляется верное время;
• вложения в карточку добавляются корректно;
• отчеты в PDF печатаются корректно;
• открытие Дизайнера БП;
• email-уведомления отправляются корректно;
• лицензия применилась (пункт меню “Помощь” - “О программе”).