======Миграция базы данных======
===Создание рабочей среды===

Перед началом миграции необходимо получить  нужные файлы:
move.sh - отвечает за создание дампа.
convert_sql.awk - делает конвертацию полученного дампа в формат, пригодный для загрузки в базу postgresql.
116.sql - является шаблоном, на который и будет производится заливка подготовленной БД.
tables.csv - файл, с данными счетчиков, полученный экспортом с сервера через phpmyadmin.
И бинарники с конфигурационными файлами и скриптами для init.d.

Перед всеми действиями необходимо создать текущий дамп для возможного восстановления, **в комманду необходимо ввести пароль**
<file bash>
mysqldump -uroot -p(пароль) dozor --routines --default-character-set=utf8 | gzip -c > restore_mysql`date +%y%m%d`.sql.gz
</file>


Разархивируем полученные архивы
<file bash>
gunzip migr.tar
gunzip bins.tar
</file>

Делаем файл move.sh исполняемым
<file bash>
chmod +x move.sh
</file>

Далее запускаем файл коммандой

<file bash>
./move.sh
</file>

После завершения работы скрипта убеждаемся, что дамп создался

<file bash>
ls -la
</file>

После ввода комманды должен появится новый архив.
Далее необходимо зайти в phpmyadmin и выполнить комманду:

<file bash>
SELECT table_name,Auto_increment FROM information_schema.tables WHERE table_schema='dozor';
</file>

После получения результата, экспортируем данные в формате CSV. Обратите внимание на название таблицы, оно должно быть tables.csv.
Далее закидываем полученный файл в директорию с дампом.

Теперь необходимо подготовить дамп, полученный из текущей БД, для миграции. Для этого запускаем конвертер, указав имя.

 <file bash>
awk -f convert_sql.awk *Имя дампа.sql
</file>

Конвертер автоматически создаст папку postgres и сохранит полученный результат(файл dump.sql) в эту папку



===Создание пользователя===


 Все сервисы ПАК Астра запускаются и работают от имени выделенного пользователя «dozor», перед установкой сервисов ПАК Астра необходимо создать пользователя и группу и указать домашнюю папку и отключить вход:

<file bash>
useradd -d /var/lib/dozor -m -s /sbin/nologin
</file>

 Необходимо создать пользователя СУБД, от имени которого будут работать с базой данных все сервисы. Имя пользователя, используемое в шаблонах конфигурации и данном руководстве «dozor»: 
Для создания пользователя необходимо выполнить следующие запросы:

-Вход в PostgeSQL:

<file bash>
psql -U postgres
</file>
 Если запуск постгресса производится впервые- будет выдан запрос пароля пользователя.

-Создание пользователя dozor:

<file bash>
CREATE USER dozor WITH PASSWORD 'YourPassword';
</file>
где YourPassword - пароль пользователя dozor.

 Выход:

<file bash>
\q
</file>

 После создание пользователя, необходимо создать базу данных, которая будет использоваться сервисами ПАК Астра. Имя базы данных, используемое в шаблонах конфигурации и примерах в данном руководстве «dozor». 
Для создания БД необходимо выполнить следующий запрос:

<file bash>
CREATE DATABASE dozor OWNER = dozor;
</file>



===Миграция===
Перед миграцией необходимо залить шаблонный дамп и pgagent_jobs.
Что бы pgagent не мешал во время миграции необходимо остановить службу и убрать ее из автозагрузки

<file bash>
rc-service pgagent stop
</file>
<file bash>
rc-update delete pgagent default
</file>

Импорт дампа для работы pgagent, необходимо ввести пароль бд:
<file bash>
psql -U postgres < (путь до фала)/pgagent_jobs.sql
</file>

После импорта pgagent_jobs, необходимо залить шаблонный дамп:

<file bash>
psql -U postgres -d dozor < 116.sql
</file>

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

 
После того как все подготовительные работы завершены, приступаем к самой миграции.
Выключаем все сервисы 
<file bash>
rc-update delete d3srv default

rc-update delete e3srv default

rc-update delete d-sh default

rc-service d3srv stop

rc-service d-sh stop

rc-service e3srv stop
</file>

Далее заливаем уже конвертированный дамп с данными

<file bash>
psql -U postgres -d dozor < postgres/dump.sql
</file>

Далее меняем бинарники и конфигурационные файлы в папке dozor

<file bash>
cp d3srv d3srv.cfg e3srv e3srv.cfg d-sh d-sh.cfg /var/lib/dozor/
</file>

Так же необходимо проверить наличие папки updates и наличие прав, если папка отсутствует, переметить ее из старой директории с бинарниками mysql. 

Меняем владельца папки и ее содержимого с рута на пользователя дозор:

<file bash>
chown dozor:dozor /var/lib/dozor
</file>

Так же копируем файлы для init.d

<file bash>
cp d3srv e3srv d-sh /etc/init.d/
</file>

Останавливаем mysql сервер

<file bash>
rc-update delete mysql default

rc-service mysql stop
</file>


И восстанавливаем автозагрузку и запускаем сервисы

<file bash>
rc-update add d3srv default

rc-update add e3srv default

rc-update add d-sh default

rc-update add pgagent default

rc-service pgagent start

rc-service d3srv start

rc-service d-sh start

rc-service e3srv start
</file>

На старых серверах возможна проблема при запуске d3srv:
<file bash>
./d3srv: error while loading shared libraries: libnettle.so.8: cannot open shared object file: No such file or                                                                                                                        directory
</file>

В этом случае необходимо прописать 

<file bash>
emerge dev-libs/nettle
</file>