Инструкция по установке СУБД Jatoba 4.13.2

Данная инструкция предназначена для версии Jatoba 4.13.2.

Установку СУБД «Jatoba» возможно провести несколькими способами:

В базовой установке zVirt MAX используется СУБД Jatoba, поставляемая с лицензией на 4 ядра (4 виртуальных ЦП). Минимальная (базовая) установка менеджера управления реализована только в виде виртуальной машины.

установка из локального репозитория (CDROM) – производится из файлов, записанных на компакт-диск или скопированных с него;
установка из удаленного репозитория производится с удаленного сервера производителя http://repo.gaz-is.ru ;

Установка СУБД «Jatoba» на ОС GNU/Linux происходит в несколько этапов:

настройка репозитория СУБД;
настройка репозитория СУБД;
установка основных пакетов;
инициализация директории данных СУБД;
получение и установка лицензии;
запуск сервиса СУБД.

Концептуальная схема последовательности действий представлена на рисунке. Более подробное описание установки приведено ниже.

Рисунок 1. Последовательность действий при установке СУБД на ОС GNU/Linux

1. Установка СУБД «Jatoba» из локального репозитория

Для установки СУБД «Jatoba» необходимо выполнить следующую последовательность действий:

создать каталог /localrepo, выполнив команду:
```
mkdir /localrepo
```
в каталог /localrepo скопировать необходимые файлы для установки СУБД «Jatoba». Требуется скопировать полную структуру файлов и каталогов из дистрибутива. Также допускается установка с CD/DVD носителя напрямую. В этому случае, пользователю не требуется копировать файлы, а вместо /localrepo во всех шагах далее указывать соответствующий путь до носителя и директорию репозитория СУБД на носителе для соответствующей ОС.
проверить результат копирования всех файлов, перейдя в каталог /localrepo и выполнив команду ls –l.

Рисунок 2. Содержимое каталога localrepo
установить открытый ключ репозитория при помощи команды:
```
rpm --import /localrepo/RPM-GPG-KEY-Jatoba
```
создать файл с описанием локального репозитория в системе. Для РЕД ОС 7.2 и 7.3 Муром необходимо добавить следующее описание репозитория в файл /etc/yum.repos.d/jatoba-4.repo.
```
[jatoba-4]
name=Jatoba 4 Official Repository
baseurl=file:///localrepo
gpgcheck=0
gpgkey=file:///localerepo/RPM-GPG-KEY-Jatoba
```
обновить описания пакетов при помощи команды:
```
yum makecache
```

установить основные пакеты СУБД «Jatoba» при помощи команды:

dnf install /localrepo/packages/jatoba4-libs-4.13.2-53316.x86_64.rpm
dnf install /localrepo/packages/jatoba4-client-4.13.2-53316.x86_64.rpm
dnf install /localrepo/packages/jatoba4-server-4.13.2-53316.x86_64.rpm
dnf install /localrepo/packages/jatoba4-contrib-4.13.2-53316.x86_64.rpm

перейти в директорию расположения исполняемых файлов СУБД «Jatoba», выполнив команду:
```
cd /usr/jatoba-4/bin/
```
инициализировать каталог данных СУБД «Jatoba» при помощи команды:
```
./jatoba-setup initdb jatoba-4
```
пройти процедуру активации.

Имеется два варианта активации лицензии:
Онлайн-активация означает, что запрос на активацию, формирование и сохранение лицензии будет выполнено непосредственно с этого компьютера.
Офлайн-активация означает, что на данном компьютере будет выполнен только запрос активации (сгенерирован специальный файл запроса). Саму активацию необходимо будет выполнить на компьютере, имеющем доступ в сеть Internet.

Для выполнения онлайн-активации лицензии СУБД «Jatoba» необходимо выполнить последовательность действий, приведенную ниже.
- перейти в каталог /usr/jatoba-4/bin/ и запустить активатор командой:
  ./jactivator
- ввести лицензионный ключ;
- ввести адрес электронной почты администратора СУБД – на этот адрес будут приходить письма от системы лицензирования;
- на запрос способа активации указать «1»
  
  Рисунок 3. Окно активации лицензии
- при первоначальной установке СУБД «Jatoba» следует выбрать режим активации «Обычная активация», введя значение «1». При окончании срока действия лицензии следует выбрать режим активации «Реактивация», введя значение «2». Дальнейший порядок установки при реактивации лицензии идентичен нижеописанному.
- указать директорию сохранения файла лицензии. Файл лицензии необходимо сохранить в следующей директории:
  /usr/jatoba-4/bin/
  Офлайн-активация лицензии СУБД «Jatoba» аналогична онлайн-активации до шага «Выбор способа активации»:
- на запрос способа активации указать значение «2»
- ввести путь, куда будет сохранен промежуточный файл запроса лицензии
- в указанной директории будет сформирован файл request.dat, в котором записан запрос на активацию. Содержимое этого файла необходимо будет внести в специальную форму на сайте сервиса лицензирования.
- далее на ЭВМ с доступом в Интернет осуществить переход на адрес сервера активации по форме https://license.gaz-is.ru/offlineActivate/;
- в окне браузера отобразится страница центра офлайн-активации продуктов ООО «Газинформсервис»;
- скопировать содержимое файла request.dat в поле ввода офлайн-активации или загрузить его с помощью кнопки «Обзор».
- нажать кнопку «Активировать»
  
  Рисунок 4. Страница центра офлайн-активации продуктов ООО «Газинформсервис»
- откроется окно ввода ключа активации;
  
  Рисунок 5. Форма ввода ключа для активации продуктов ООО «Газинформсервис»
  
  На указанный в запросе адрес электронной почты, придет письмо с ключом активации.
  
  Рисунок 6. Пример содержимого письма с ключом активации
- ввести полученный ключ из письма в форму активации и нажать кнопку «Активировать»;
  
  Рисунок 7. Форма выпуска лицензии
- содержимое лицензии из формы необходимо скопировать в файл jatoba.cer в текстовом редакторе и разместить файл лицензии в директории установки /usr/jatoba4/bin/. Файл лицензии готов к установке на ЭВМ с офлайн-активацией. Установка лицензии в каталог данных выполняется при помощи команды:
  chown postgres:postgres /usr/jatoba-4/bin/jatoba.cer
  Для пользовательского контроля необходимо проверить права на файл лицензии, который должен быть доступен на чтение системному пользователю postgres, выполнив команду:
  ls -l jatoba.cer
  Рисунок 8. Результат выполнения команды ls

Перед запуском СУБД требуется проверить наличие лицензионных параметров в разделе «LICENSER OPTION AND PARAMETRS», в конце конфигурационного файла postgresql.conf располагающегося по пути:

/var/lib/jatoba/4/data/postgresql.conf

Рисунок 9. Содержимое файла postgresql.conf

В случае отсутствия параметров в конфигурационном файле /var/lib/jatoba/4/data/postgresql.conf необходимо их внести, как указано в таблице.

Таблица 1. Таблица значений конфигурационного файла
Наименование параметра	Наименование параметра (англ.)	Значение
Продукт	lic_product_name	Jatoba
Файл сертификата	lic_file_path	/usr/jatoba-4/bin/jatoba.cer
Сервер лицензирования	lic_server_addr	https://license.gaz-is.ru

Для загрузки СУБД «Jatoba» вместе с ОС необходимо запустить сервис; добавить его в список автозапуска при старте операционной системы, выполнив команды:

systemctl start jatoba-4
systemctl enable jatoba-4

2. Установка СУБД «JATOBA» из удаленного репозитория

Для установки СУБД «Jatoba» из удаленного репозитория требуется подключение к сети Internet. Установка из удаленного репозитория аналогична установке из локального репозитория за исключением шагов копирования файлов дистрибутива, установки открытого ключа и содержимого файла репозитория.

Для установки СУБД «Jatoba» необходимо выполнить следующую последовательность действий:

установить открытый ключ удаленного репозитория при помощи команды rpm. Ниже находятся ссылки на файл ключа для соответствующих ОС:
- для РЕД ОС 7.2: http://repo.gaz-is.ru/redos/7.2/x86_64/jatoba/4/stable
- для РЕД ОС 7.3 : http://repo.gaz-is.ru/redos/7.3/x86_64/jatoba/4/stable
  
  Например, для РЕД ОС 7.3 Муром команды добавления открытого ключа могут быть выполнены следующим образом:
  rpm --import http://repo.gaz-is.ru/redos/7.3/x86_64/jatoba/4/stable/RPM-GPG-KEY-Jatoba
создать файл с описанием удаленного репозитория в системе для РЕД ОС 7.3 Муром необходимо добавить следующее описание репозитория в файл /etc/yum.repos.d/jatoba-4.repo;
```
[jatoba-4]
name=Jatoba 4 Official Repository
baseurl=http://repo.gaz-is.ru/redos/7.2/x86_64/jatoba/4/stable
enabled=1
gpgcheck=0
gpgkey=http://repo.gaz-is.ru/redos/7.3/x86_64/jatoba/4/stable/RPM-GPG-KEY-Jatoba
```

Дальнейшая установка СУБД «Jatoba» аналогична, описанному в разделе Установка СУБД Jatoba из локального репозитория, с шага обновить описания пакетов при помощи команды.