Установка#

Pangolin — система управления базами данных, основанная на PostgreSQL. В данном руководстве описываются аспекты Pangolin, связанные с установкой системы.

Документ предназначен для администраторов и специалистов по безопасности, отвечающих за установку и обновление продукта.

Примечание:

• Перед прочтением документа рекомендуется ознакомиться с используемыми терминами и определениями.

• Если FQDN (Fully Qualified Domain Name) каждого участника кластера в DNS не определены, добавьте их в /etc/hosts в формате ip fqdn (например: <IP-адрес> server.domain.ru) на каждом сервере. Это необходимо для создания arbiter-кластера.

• При использовании на серверах межсетевого экрана необходимо обеспечить сетевую связность по используемым портам.

• Нельзя менять в inventory имена узлов (master, replica, arbiter). В блоке arbiter_nodes указываются серверы, которые только участвуют в кластере etcd или Pangolin DCS, но не являются master или replica.

• Перед запуском скрипта инсталляции добавьте в файлы sudoerc основного узла, реплики и арбитра строку user_ansible ALL=(ALL:ALL) NOPASSWD: ALL.

Состав дистрибутива#

Единый дистрибутив PSQ-\<версия Pangolin\>-distrib.tar.gz содержит все перечисленные ниже компоненты дистрибутива для запуска установки/обновления:

Диаграмма процесса развертывания Pangolin#

Внимание!

В установке standalone-версии продукта участвуют две машины. Первая – откуда производится запуск ansible-установщика, вторая – целевая, куда разворачивается продукт.

Диаграмма процесса развертывания Pangolin:

Выбор способа установки#

В зависимости от способа развертывания сервиса воспользуйтесь одной из инструкций:

• целевая автоматизированная установка Pangolin;

• опциональная ручная установка Pangolin.

Перед началом установки сформируйте единый дистрибутив Pangolin из zip-пакета:

1. Получите архив zip-пакета и выполните команду распаковки:

   unzip -q <имя zip-пакета>.zip
   

2. Перейдите в каталог с распакованным zip-пакетом и выполните запуск скрипта по формированию единого дистрибутива:

   sh PSQ-<version>-unpacker-distrib.sh
   

Результатом выполнения будет единый дистрибутив в формате tar.gz (пример: PSQ-<version>-distrib.tar.gz), предназначенный для установки Pangolin.

Подготовка окружения#

Рекомендуется запускать установку продукта Pangolin в виртуальной среде Python. Для этого необходимо выполнить установку пакета pangolin-ansible-venv-controller на управляющем хосте, который поставляется в составе дистрибутива:

Внимание!

При установке на ОС Altlinux использовать пакетный менеджер - apt-get. При установке на ОС Astra использовать пакетный менеджер - apt. На других ОС использовать dnf или yum.

sudo пакетный_менеджер -y install pangolin-ansible-venv-controller

Настройка скриптов автоматизации#

Для корректной работы скриптов автоматизации необходимо, чтобы на целевых узлах (master/replica/arbiter) у скриптов автоматизации была возможность доступа к rpm/deb-пакетам каждого участвующего в обновлении или первичном развертывании компонента. Для организации данного доступа возможны несколько вариантов настройки скриптов автоматизации перед их использованием (способы друг друга взаимоисключают).

Первый вариант (не целевой, по умолчанию отключен)#

Скрипты могут получить доступ к пакетам через ключ/переменную pangolin_rpms_path, если пользователь самостоятельно скопирует все rpm/deb-пакеты из дистрибутива в заданную директорию на хост, с которого запускаются сами скрипты, и укажет путь до нее, используя pangolin_rpms_path в пользовательском конфигурационном файле. По умолчанию pangolin_rpms_path не используется, для его использования необходимо в пользовательском конфигурационном файле указать путь до директории со всеми rpm/deb-пакетами.

Второй вариант (используется по умолчанию)#

Скрипты автоматизации ищут все необходимые для своей работы rpm/deb-пакеты в linux-репозиторях ОС на узлах master/replica/arbiter. Предполагается, что пользователь или администратор ОС может сам настраивать необходимые ему репозитории, а также отслеживать их актуальность и работоспособность. Но в случае, если скрипты все же не находят необходимые пакеты в общих linux-репозиториях, происходит настройка на целевых узлах локального репозитория Pangolin, который входит в состав дистрибутива начиная с версии 6.4.1. Предусмотрены сценарии:

• Первичное развертывание:

  1. Локальный репозиторий автоматически извлекается из дистрибутива на узле, с которого запускаются скрипты, и копируется на узлы master/replica/arbiter.

  2. Происходит его регистрация в системе.

     После развертывания репозиторий остается на хостах. Одним из вариантов его дальнейшего использования может быть откат версий компонент к их первоначальным значениям в случае ошибки при работе сценария обновления СУБД и компонент на новую версию.

• Обновление версий СУБД и компонент. В этом случае алгоритм такой же как и при первичном развертывании.

  Примечание:

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

Особенности работы с ОС Linux#

• СУБД Pangolin предусматривает работу с процедурными языками tcl и perl, однако пакеты для данных языков не устанавливаются по умолчанию при установке. Для работы с этим процедурными языками необходимо установить языковые пакеты вручную и включить расширения pltcl, pltclu для tcl и plperl для perl соответственно.

• Для полноценной работы утилиты pgcompacttable в версии 6.4.0 необходимо установить вручную пакеты: perl-Time-HiRes, perl-DBI, perl-DBD-Pg.

• В СУБД Pangolin версии 6.4.0 (ФСТЭК) Sberlinux 9 не поддерживает локали, отличные от русской и английской (в связи с отсутствием пакета glibc-langpack-*).

• В СУБД Pangolin версии 6.4.0 (ФСТЭК) отсутствует возможность использования etcd при построении кластера, в связи с отсутствием пакета etcd в репозиториях.

Ручная установка Pangolin#

Внимание!

При ручной установке не будут настроены различные параметры, в том числе присущие только Pangolin:

• настройки конфигурационных файлов (postgresql.conf, pg_hba.conf);

• настройки кластерной конфигурации;

• будут отсутствовать компоненты Pangolin (etcd, Pangolin Manager, Pangolin Pooler, и другие);

• настройки ролевой модели;

• настройки расширений;

• настройки ротации журналов;

• и другие.

Примечание:

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

Установка на ОС «Platform V SberLinux OS Server 8.8»#

Примечание:

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

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp):

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_rhel87-D-<версия Pangolin>-distrib.zip):

   mv /путь к дистрибутиву/installer_sberlinux88-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin:

   cd /путь к директории/distrib/
   unzip installer_sberlinux88-D-<версия Pangolin>-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>-<version>-sberlinux8.8.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-sberlinux8.8.x86_64.rpm в архиве самостоятельно:

   installer_sberlinux88-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>-<версия Pangolin>-sberlinux8.8.x86_64.rpm
   installer_sberlinux88-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-sberlinux8.8.x86_64.rpm
   

4. Установите пакеты pangolin-dbms-<версия dbms>-<версия Pangolin>-sberlinux8.8.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-sberlinux8.8.x86_64.rpm:

   sudo dnf install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms>-<версия Pangolin>-sberlinux8.8.x86_64.rpm
   sudo dnf install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-sberlinux8.8.x86_64.rpm
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/06/
   sudo chown -R postgres:postgres /pgdata/06/
   sudo mkdir -p /pgerrorlogs/06/
   sudo chown postgres:postgres /pgerrorlogs/06/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь_до_файла/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres:

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор):

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vim ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST=127.0.0.1
   export PGPORT=5432
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/06/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :.

   3. Введите wq для сохранения файла и выхода из него.

   При возникновении проблем с редактором vi, можно использовать текстовый редактор nano:

   1. Откройте файл:

      nano ~/.bash_profile
      

   2. Вставьте команды:

      umask 022
      export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
      export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PGHOME=/usr/pangolin-<версия Pangolin>
      export PGDATABASE=postgres
      export PGUSER=postgres
      export PGHOST=127.0.0.1
      export PGPORT=5432
      export PGCLIENTENCODING=UTF8
      export CLNAME=clustername
      export PGDATA=/pgdata/06/data
      export MANPATH=$MANPATH:$PGHOME/share/man
      

   3. Сохраните изменения:

      1. Нажмите сочетание клавиш Ctrl + O.

      2. Нажмите клавишу Enter.

      3. Нажмите сочетание клавиш Ctrl + X.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД:

    • обычное окружение:

      initdb -k -D /pgdata/06/data/
      

    • окружение 1С:

      initdb --data-checksums --locale ru_RU.UTF-8 --username postgres --pgdata $PGDATA
      # для 1С крайне важно указывать локаль, в будущем она будет использоваться для инициализации БД, что создает 1С
      

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла).

    Откройте файл postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд добавьте следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = 5432
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • для окружения 1С рекомендуются следующие параметры:

      listen_addresses = '*'
      port = 5432
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     peer
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/06/data/ -l /pgerrorlogs/06/postgresql.log start
    

    Примечание:

    Возможные ошибки:

    1. Не читается файл лицензий:

       Check license file "/opt/pangolin_license/license.json" : file is not found
       

       Решение:

       Проверьте доступность под пользователем операционной системы postgres файла лицензии:

       1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

          [postgres@srv ~]$ echo $PG_LICENSE_PATH
          /opt/pangolin_license/
          

          При необходимости исправьте:

          export PG_LICENSE_PATH=/opt/pangolin_license/
          

       2. Доступность файла лицензии:

          [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
          total 12
          drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
          drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
          -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
          

    2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

       2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/06/data/pg_hba.conf"
       2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
       

       Решение:

       Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

14. Выполните команду psql:

    postgres@srv-64-44:~$ psql
    psql (15.5)
    Type "help" for help.
    
    postgres=#
    

Установка на ОС «РЕД ОС 7.3»#

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp).

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_redos73-D-<version>-distrib.zip).

   mv /путь к директории/installer_redos73-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin.

   cd /путь к директории/distrib/
   unzip docker_redos73-D-<версия Pangolin>-16-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>-<version>-redos7.3.2.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-redos7.3.2.x86_64.rpm в архиве самостоятельно:

   installer_redos73-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>-<версия Pangolin>-redos7.3.2.x86_64.rpm
   installer_redos73-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-redos7.3.2.x86_64.rpm
   

4. Установите пакет pangolin-dbms-<версия dbms>-<version>-redos7.3.2.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-redos7.3.2.x86_64.rpm:

   sudo dnf install pangolin-dbms-<версия dbms>-<версия Pangolin>-redos7.3.2.x86_64.rpm
   sudo dnf install pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-redos7.3.2.x86_64.rpm
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/06/
   sudo chown -R postgres:postgres /pgdata/06/
   sudo mkdir -p /pgerrorlogs/06/
   sudo chown postgres:postgres /pgerrorlogs/06/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь к файлу/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres (если такого нет, то создайте):

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор).

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vi ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST={IP-адрес}
   export PGPORT={Порт}
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/0{major_version}/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :

   3. Введите wq для сохранения файла и выхода из него.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД:

    • обычное окружение:

      initdb -k -D /pgdata/0{major_version}/data/
      

    • окружение 1С:

      initdb --data-checksums --locale ru_RU.UTF-8 --username postgres --pgdata $PGDATA
      # для 1С крайне важно указывать локаль, в будущем она будет использоваться для инициализации БД, что создает 1С
      

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла). Открытие файла postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд необходимо добавить следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = {Порт}
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • окружение 1С:

      listen_addresses = '*'
      port = {Порт}
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      default_statistics_target = 1000
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла, отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     trust
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/0{major_version}/data/ -l start
    

Примечание:

Возможные ошибки:

1. Не читается файл лицензий:

   Check license file "/opt/pangolin_license/license.json" : file is not found
   

   Решение:

   Проверьте доступность под пользователем операционной системы postgres файла лицензии:

   1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

      [postgres@srv ~]$ echo $PG_LICENSE_PATH
      /opt/pangolin_license/
      

      При необходимости исправьте:

      export PG_LICENSE_PATH=/opt/pangolin_license/
      

   2. Доступность файла лицензии:

      [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
      total 12
      drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
      drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
      -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
      

2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

   2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/0{major_version}/data/pg_hba.conf"
   2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
   

   Решение:

   Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

14. Выполните команду psql:

    postgres@srv-64-44:~$ psql
    psql ({postgres_version})
    Type "help" for help.
    
    postgres=#
    

Установка на ОС «Astra Linux 1.7»#

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp):

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_astrase17-D-<version>-distrib.zip).

   mv /путь к директории/installer_astrase17-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin:

   cd /путь к директории/distrib/
   unzip installer_astrase17-D-<версия Pangolin>-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>_<version>_amd64.deb, pangolin-dbms-<версия dbms client>-client_<version>_amd64.deb в архиве самостоятельно:

   installer_astrase17-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>_<версия Pangolin>_amd64.deb
   installer_astrase17-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client_<версия Pangolin>_amd64.deb
   

4. Установите пакеты pangolin-dbms-<версия dbms>_<version>_amd64.deb, pangolin-dbms-<версия dbms client>-client_<version>_amd64.deb:

   sudo apt install /укажите_полный_путь/до_пакета/distrib/pangolin-dbms-<версия dbms>-<версия Pangolin>_amd64.deb
   sudo apt install /укажите_полный_путь/до_пакета/distrib/pangolin-dbms-<версия dbms client>-client_<версия Pangolin>_amd64.deb
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/06/
   sudo chown -R postgres:postgres /pgdata/06/
   sudo mkdir -p /pgerrorlogs/06/
   sudo chown postgres:postgres /pgerrorlogs/06/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь к файлу/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres:

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор).

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vim ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST=127.0.0.1
   export PGPORT=5432
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/06/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :.

   3. Введите wq для сохранения файла и выхода из него.

   При возникновении проблем с редактором vi, можно использовать текстовый редактор nano:

   1. Откройте файл:

      nano ~/.bash_profile
      

   2. Вставьте команды:

      umask 022
      export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
      export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PGHOME=/usr/pangolin-<версия Pangolin>
      export PGDATABASE=postgres
      export PGUSER=postgres
      export PGHOST=127.0.0.1
      export PGPORT=5432
      export PGCLIENTENCODING=UTF8
      export CLNAME=clustername
      export PGDATA=/pgdata/06/data
      export MANPATH=$MANPATH:$PGHOME/share/man
      

   3. Сохраните изменения:

      1. Нажмите сочетание клавиш Ctrl + O.

      2. Нажмите клавишу Enter.

      3. Нажмите сочетание клавиш Ctrl + X.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД.

    • обычное окружение:

      initdb -k -D /pgdata/0{major_version}/data/
      

    • окружение 1С:

      initdb --data-checksums --locale ru_RU.UTF-8 --username postgres --pgdata $PGDATA
      

      Примечание:

      В случае возникновении ошибки:

      initdb: error while loading shared libraries: libjsoncpp.so.1: cannot open shared object file: No such file or directory
      

      Необходимо установить пакет:

      sudo apt install libjsoncpp1
      

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла).

    Откройте файл postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд добавьте следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = 5432
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • для окружения 1С рекомендуются следующие параметры:

      listen_addresses = '*'
      port = 5432
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      default_statistics_target = 1000
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     peer
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/0{major_version}/data/ -l /pgerrorlogs/0{major_version}/postgresql.log start
    

Примечание:

Возможные ошибки:

1. Не читается файл лицензий:

   Check license file "/opt/pangolin_license/license.json" : file is not found
   

   Решение:

   Проверьте доступность под пользователем операционной системы postgres файла лицензии:

   1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

      [postgres@srv ~]$ echo $PG_LICENSE_PATH
      /opt/pangolin_license/
      

      При необходимости исправьте:

      export PG_LICENSE_PATH=/opt/pangolin_license/
      

   2. Доступность файла лицензии:

      [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
      total 12
      drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
      drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
      -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
      

2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

   2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/06/data/pg_hba.conf"
   2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
   

   Решение:

   Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

14. Выполните команду psql:

    postgres@srv-64-44:~$ psql
    psql ({postgres_version})
    Type "help" for help.
    
    postgres=#
    

Установка на ОС «Альт СП 8.4»#

Примечание:

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

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp):

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_altlinux84-D-<версия Pangolin>-distrib.zip):

   mv /путь к дистрибутиву/installer_altlinux84-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin:

   cd /путь к директории/distrib/
   unzip installer_altlinux84-D-<версия Pangolin>-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>-<version>-altlinuxp8.4.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-altlinuxp8.4.x86_64.rpm в архиве самостоятельно:

   docker_6_2_0_alt10-D-<версия Pangolin>-69-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp8.4.x86_64.rpm
   docker_6_2_0_alt10-D-<версия Pangolin>-69-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp8.4.x86_64.rpm
   

   Примечание:

   Если на текущем шаге возникла ошибка -bash: unzip: command not found – необходимо установить утилиту unzip и вернуться к шагу с распаковкой. Установка unzip:

   sudo apt-get install unzip
   

4. Установите пакеты pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp8.4.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp8.4.x86_64.rpm:

   sudo apt-get install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp8.4.x86_64.rpm
   sudo apt-get install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp8.4.x86_64.rpm
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/0{major_version}/
   sudo chown -R postgres:postgres /pgdata/0{major_version}/
   sudo mkdir -p /pgerrorlogs/0{major_version}/
   sudo chown postgres:postgres /pgerrorlogs/0{major_version}/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь_до_файла/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres:

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор):

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vim ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST=127.0.0.1
   export PGPORT=5432
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/0{major_version}/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :.

   3. Введите wq для сохранения файла и выхода из него.

   При возникновении проблем с редактором vi, можно использовать текстовый редактор nano:

   1. Откройте файл:

      nano ~/.bash_profile
      

   2. Вставьте команды:

      umask 022
      export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
      export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PGHOME=/usr/pangolin-<версия Pangolin>
      export PGDATABASE=postgres
      export PGUSER=postgres
      export PGHOST=127.0.0.1
      export PGPORT=5432
      export PGCLIENTENCODING=UTF8
      export CLNAME=clustername
      export PGDATA=/pgdata/06/data
      export MANPATH=$MANPATH:$PGHOME/share/man
      

   3. Сохраните изменения:

      1. Нажмите сочетание клавиш Ctrl + O.

      2. Нажмите клавишу Enter.

      3. Нажмите сочетание клавиш Ctrl + X.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД:

    initdb -k -D /pgdata/06/data/
    

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла).

    Откройте файл postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд добавьте следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = 5432
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • для окружения 1С рекомендуются следующие параметры:

      listen_addresses = '*'
      port = 5432
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     peer
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/0{major_version}/data/ -l /pgerrorlogs/0{major_version}/postgresql.log start
    

    Примечание:

    Возможные ошибки:

    1. Не читается файл лицензий:

       Check license file "/opt/pangolin_license/license.json" : file is not found
       

       Решение:

       Проверьте доступность под пользователем операционной системы postgres файла лицензии:

       1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

          [postgres@srv ~]$ echo $PG_LICENSE_PATH
          /opt/pangolin_license/
          

          При необходимости исправьте:

          export PG_LICENSE_PATH=/opt/pangolin_license/
          

       2. Доступность файла лицензии:

          [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
          total 12
          drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
          drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
          -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
          

    2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

       2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/06/data/pg_hba.conf"
       2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
       

       Решение:

       Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

    [16:41:22  postgres@srv-0-211 ~]$ psql
    psql ({postgres_version})
    Type "help" for help.
    
    postgres=#
    

Установка на ОС «Альт СП 9.2»#

Примечание:

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

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp):

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_altlinux92-D-<версия Pangolin>-distrib.zip):

   mv /путь к дистрибутиву/installer_altlinux92-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin:

   cd /путь к директории/distrib/
   unzip installer_altlinux84-D-<версия Pangolin>-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>-<version>-altlinuxp8.4.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-altlinuxp8.4.x86_64.rpm в архиве самостоятельно:

   installer_altlinux92-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp9.x86_64.rpm
   installer_altlinux92-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp9.x86_64.rpm
   

   Примечание:

   Если на текущем шаге возникла ошибка -bash: unzip: command not found – необходимо установить утилиту unzip и вернуться к шагу с распаковкой. Установка unzip:

   sudo apt-get install unzip
   

4. Установите пакеты pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp9.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp9.x86_64.rpm:

   sudo apt-get install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp9.x86_64.rpm
   sudo apt-get install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp9.x86_64.rpm
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/06/
   sudo chown -R postgres:postgres /pgdata/06/
   sudo mkdir -p /pgerrorlogs/06/
   sudo chown postgres:postgres /pgerrorlogs/06/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь_до_файла/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres:

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор):

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vim ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST=127.0.0.1
   export PGPORT=5432
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/06/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :.

   3. Введите wq для сохранения файла и выхода из него.

   При возникновении проблем с редактором vi, можно использовать текстовый редактор nano:

   1. Откройте файл:

      nano ~/.bash_profile
      

   2. Вставьте команды:

      umask 022
      export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
      export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PGHOME=/usr/pangolin-<версия Pangolin>
      export PGDATABASE=postgres
      export PGUSER=postgres
      export PGHOST=127.0.0.1
      export PGPORT=5432
      export PGCLIENTENCODING=UTF8
      export CLNAME=clustername
      export PGDATA=/pgdata/06/data
      export MANPATH=$MANPATH:$PGHOME/share/man
      

   3. Сохраните изменения:

      1. Нажмите сочетание клавиш Ctrl + O.

      2. Нажмите клавишу Enter.

      3. Нажмите сочетание клавиш Ctrl + X.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД:

    • обычное окружение:

      initdb -k -D /pgdata/06/data/
      

    • окружение 1С:

      initdb --data-checksums --locale ru_RU.UTF-8 --username postgres --pgdata $PGDATA
      # для 1С крайне важно указывать локаль, в будущем она будет использоваться для инициализации БД, что создает 1С
      

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла).

    Откройте файл postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд добавьте следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = 5432
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • для окружения 1С рекомендуются следующие параметры:

      listen_addresses = '*'
      port = 5432
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     peer
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/06/data/ -l /pgerrorlogs/06/postgresql.log start
    

    Примечание:

    Возможные ошибки:

    1. Не читается файл лицензий:

       Check license file "/opt/pangolin_license/license.json" : file is not found
       

       Решение:

       Проверьте доступность под пользователем операционной системы postgres файла лицензии:

       1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

          [postgres@srv ~]$ echo $PG_LICENSE_PATH
          /opt/pangolin_license/
          

          При необходимости исправьте:

          export PG_LICENSE_PATH=/opt/pangolin_license/
          

       2. Доступность файла лицензии:

          [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
          total 12
          drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
          drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
          -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
          

    2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

       2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/06/data/pg_hba.conf"
       2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
       

       Решение:

       Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

14. Выполните команду psql:

    postgres@srv-64-44:~$ psql
    psql (15.5)
    Type "help" for help.
    
    postgres=#
    

Установка на ОС «Альт СП 10»#

Примечание:

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

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp):

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_altlinux92-D-<версия Pangolin>-distrib.zip):

   mv /путь к дистрибутиву/installer_altlinux10-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin:

   cd /путь к директории/distrib/
   unzip docker_6_3_0_alt10-D-<версия Pangolin>-69-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>-<version>-altlinuxp8.4.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-altlinuxp8.4.x86_64.rpm в архиве самостоятельно:

   docker_6_3_0_alt10-D-<версия Pangolin>-69-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp10.x86_64.rpm
   docker_6_3_0_alt10-D-<версия Pangolin>-69-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp10.x86_64.rpm
   

   Примечание:

   Если на текущем шаге возникла ошибка -bash: unzip: command not found – необходимо установить утилиту unzip и вернуться к шагу с распаковкой. Установка unzip:

   sudo apt-get install unzip
   

4. Установите пакеты pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp10.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp10.x86_64.rpm:

   sudo apt-get install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms>-<версия Pangolin>-altlinuxp10.x86_64.rpm
   sudo apt-get install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-altlinuxp10.x86_64.rpm
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/06/
   sudo chown -R postgres:postgres /pgdata/06/
   sudo mkdir -p /pgerrorlogs/06/
   sudo chown postgres:postgres /pgerrorlogs/06/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь_до_файла/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres:

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор):

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vim ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST=127.0.0.1
   export PGPORT=5432
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/06/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :.

   3. Введите wq для сохранения файла и выхода из него.

   При возникновении проблем с редактором vi, можно использовать текстовый редактор nano:

   1. Откройте файл:

      nano ~/.bash_profile
      

   2. Вставьте команды:

      umask 022
      export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
      export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PGHOME=/usr/pangolin-<версия Pangolin>
      export PGDATABASE=postgres
      export PGUSER=postgres
      export PGHOST=127.0.0.1
      export PGPORT=5432
      export PGCLIENTENCODING=UTF8
      export CLNAME=clustername
      export PGDATA=/pgdata/06/data
      export MANPATH=$MANPATH:$PGHOME/share/man
      

   3. Сохраните изменения:

      1. Нажмите сочетание клавиш Ctrl + O.

      2. Нажмите клавишу Enter.

      3. Нажмите сочетание клавиш Ctrl + X.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД:

    • обычное окружение:

      initdb -k -D /pgdata/06/data/
      

    • окружение 1С:

      initdb --data-checksums --locale ru_RU.UTF-8 --username postgres --pgdata $PGDATA
      # для 1С крайне важно указывать локаль, в будущем она будет использоваться для инициализации БД, что создает 1С
      

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла).

    Откройте файл postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд добавьте следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = 5432
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • для окружения 1С рекомендуются следующие параметры:

      listen_addresses = '*'
      port = 5432
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     peer
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/06/data/ -l /pgerrorlogs/06/postgresql.log start
    

    Примечание:

    Возможные ошибки:

    1. Не читается файл лицензий:

       Check license file "/opt/pangolin_license/license.json" : file is not found
       

       Решение:

       Проверьте доступность под пользователем операционной системы postgres файла лицензии:

       1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

          [postgres@srv ~]$ echo $PG_LICENSE_PATH
          /opt/pangolin_license/
          

          При необходимости исправьте:

          export PG_LICENSE_PATH=/opt/pangolin_license/
          

       2. Доступность файла лицензии:

          [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
          total 12
          drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
          drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
          -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
          

    2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

       2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/06/data/pg_hba.conf"
       2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
       

       Решение:

       Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

14. Выполните команду psql:

    postgres@srv-64-44:~$ psql
    psql (15.5)
    Type "help" for help.
    
    postgres=#
    

Установка на ОС «Red Hat Enterprise Linux 8.7»#

Примечание:

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

1. Создайте директорию с дистрибутивом Pangolin (в каталоге, который доступен для чтения для всех пользователей ОС, например в каталоге /tmp):

   mkdir distrib
   

2. Поместите дистрибутив Pangolin в директорию distrib (отредактируйте команду в соответствии с местонахождением директории distrib и дистрибутива installer_rhel87-D-<версия Pangolin>-distrib.zip):

   mv /путь к дистрибутиву/installer_rhel87-D-<версия Pangolin>-distrib.zip /путь к директории/distrib/
   

3. Перейдите в директорию distrib и распакуйте дистрибутив Pangolin:

   cd /путь к директории/distrib/
   unzip installer_rhel87-D-<версия Pangolin>-distrib.zip
   unzip owned-distrib.zip
   tar -xvf owned-distrib.tar.gz
   

   Либо найдите пакеты pangolin-dbms-<версия dbms>-<version>-rhel8.7.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<version>-rhel8.7.x86_64.rpm в архиве самостоятельно:

   installer_rhel87-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms>-<версия Pangolin>-rhel8.7.x86_64.rpm
   installer_rhel87-D-<версия Pangolin>-distrib.zip/owned-distrib.zip/owned-distrib.tar.gz/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-rhel8.7.x86_64.rpm
   

4. Установите пакеты pangolin-dbms-<версия dbms>-<версия Pangolin>-rhel8.7.x86_64.rpm, pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-rhel8.7.x86_64.rpm:

   sudo yum install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms>-<версия Pangolin>-rhel8.7.x86_64.rpm
   sudo yum install /полный_путь_до_пакета/distrib/pangolin-dbms-<версия dbms client>-client-<версия Pangolin>-rhel8.7.x86_64.rpm
   

5. Создайте директорию $PGDATA, /pgerrorlogs и /opt/pangolin_license:

   sudo mkdir -p /pgdata/06/
   sudo chown -R postgres:postgres /pgdata/06/
   sudo mkdir -p /pgerrorlogs/06/
   sudo chown postgres:postgres /pgerrorlogs/06/
   sudo mkdir -p /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/
   

6. Добавьте файл с лицензией license.json в папку /opt/pangolin_license/ с правами postgres:postgres:

   sudo mv /путь_до_файла/license.json /opt/pangolin_license/
   sudo chown postgres:postgres /opt/pangolin_license/license.json
   

7. Переключитесь на пользователя postgres:

   sudo su - postgres
   

8. Откройте файл .bash_profile при помощи текстового редактора и добавьте строку окружения (в примерах используются текстовые редакторы vi и nano, вы можете повторить все действия, описанные ниже, либо можете использовать удобный вам текстовый редактор):

   Открытие файла .bash_profile при помощи текстового редактора vi:

   vim ~/.bash_profile
   

   Для редактирования файла в текстовом редакторе vi опуститесь в конец файла и нажмите клавишу i для перехода в режим редактирования, затем вставьте (правой кнопкой мыши) команды:

   umask 022
   export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
   export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
   export PGHOME=/usr/pangolin-<версия Pangolin>
   export PGDATABASE=postgres
   export PGUSER=postgres
   export PGHOST=127.0.0.1
   export PGPORT=5432
   export PGCLIENTENCODING=UTF8
   export CLNAME=clustername
   export PGDATA=/pgdata/06/data
   export MANPATH=$MANPATH:$PGHOME/share/man
   

   После выполнения вышеперечисленных действий, сохраните изменения:

   1. Нажмите клавишу Esc для выхода из режима редактирования.

   2. Нажмите сочетание клавиш Ctrl + :.

   3. Введите wq для сохранения файла и выхода из него.

   При возникновении проблем с редактором vi, можно использовать текстовый редактор nano:

   1. Откройте файл:

      nano ~/.bash_profile
      

   2. Вставьте команды:

      umask 022
      export LD_LIBRARY_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PATH=$PATH:/usr/pangolin-<версия Pangolin>/bin
      export PG_PLUGINS_PATH=/usr/pangolin-<версия Pangolin>/lib
      export PGHOME=/usr/pangolin-<версия Pangolin>
      export PGDATABASE=postgres
      export PGUSER=postgres
      export PGHOST=127.0.0.1
      export PGPORT=5432
      export PGCLIENTENCODING=UTF8
      export CLNAME=clustername
      export PGDATA=/pgdata/06/data
      export MANPATH=$MANPATH:$PGHOME/share/man
      

   3. Сохраните изменения:

      1. Нажмите сочетание клавиш Ctrl + O.

      2. Нажмите клавишу Enter.

      3. Нажмите сочетание клавиш Ctrl + X.

9. Перечитайте переменные окружения для bash_profile:

   . ~/.bash_profile
   

10. Разверните СУБД:

    • обычное окружение:

      initdb -k -D /pgdata/06/data/
      

    • окружение 1С:

      initdb --data-checksums --locale ru_RU.UTF-8 --username postgres --pgdata $PGDATA
      # для 1С крайне важно указывать локаль, в будущем она будет использоваться для инициализации БД, что создает 1С
      

11. Отредактируйте конфигурационный файл $PGDATA/postgresql.conf с помощью текстового редактора (добавьте в конец файла).

    Откройте файл postgresql.conf при помощи текстового редактора vi:

    vi $PGDATA/postgresql.conf
    

    Работа в текстовом редакторе vi была описана в п.8, на данном шаге при помощи тех же команд добавьте следующие параметры в конец файла:

    • обычное окружение:

      listen_addresses = '*'
      port = 5432
      max_connections = 100
      superuser_reserved_connections = 3
      
      enabled_extra_auth_methods = 'peer, trust'
      

    • для окружения 1С рекомендуются следующие параметры:

      listen_addresses = '*'
      port = 5432
      max_connections = 200 # с учетом ожидаемого количества
      superuser_reserved_connections = 3
      
      optimize_for_1c = 'on'
      shared_preload_libraries = 'pg_stat_statements, plantuner'
      
      # Параметры памяти имеет смысл скорректировать с учетом ваших КТС
      # huge_pages = on
      # shared_buffers = 96GB # от 1/4 до 2/5 RAM, если не используются HugePages - не более 128GB
      # effective_cache_size = 288GB # 3/4 RAM
      temp_buffers = 256MB
      maintenance_work_mem = 256MB
      wal_buffers = 64MB
      work_mem = 128MB
      
      max_worker_processes = 8    # равно количеству ядер
      max_parallel_workers_per_gather = 4
      max_parallel_workers = 8    # равно количеству ядер
      max_parallel_maintenance_workers = 4
      
      fsync = 'on'
      checkpoint_completion_target = 0.9
      checkpoint_timeout = 30min
      wal_level = 'minimal'
      max_wal_senders = 0
      wal_compression = 'off'
      wal_sync_method = 'fdatasync'
      synchronous_commit = 'off'
      commit_delay = 1000
      commit_siblings = 5
      
      
      # min_wal_size = 100GB
      # max_wal_size = 100GB
      
      bgwriter_delay = 20ms
      bgwriter_lru_maxpages = 400
      bgwriter_lru_multiplier = 4.0
      autovacuum = 'on'
      track_counts = 'on'
      autovacuum_max_workers = 4   # 1/4 количества ядер
      autovacuum_naptime = 20s
      max_locks_per_transaction = 1000
      max_prepared_transactions = 1000
      max_files_per_process = 8000
      effective_io_concurrency = 200
      from_collapse_limit = 11
      join_collapse_limit = 11
      random_page_cost = 1.1
      geqo = 'on'
      geqo_threshold = 12
      password_encryption = 'md5'
      logging_collector   = 'on'
      log_min_messages    = 'log'
      log_statement       = 'none'
      pgaudit.log         = 'none'
      performance_insights.enable = 'off'
      password_policies_enable = 'off'
      pg_outline.enable = 'off'
      enable_monitor_object_modification_date = 'off'
      object_modification_date_keep_interval  = '1 week'
      enabled_sec_admin_extra_auth_methods = 'md5,trust,peer,cert'
      enabled_extra_auth_methods           = 'md5,trust,peer,cert'
      ssl = 'off'
      track_io_timing = 'off'
      row_security = 'off'
      standard_conforming_strings = 'off'
      escape_string_warning = 'off'
      plantuner.fix_empty_table = on
      

12. По аналогии с редактированием предыдущего файла отредактируйте конфигурационный файл pg_hba.conf:

    1. Откройте файл pg_hba.conf при помощи текстового редактора vi:

       vi $PGDATA/pg_hba.conf
       

    2. Вставьте строки:

       local   all             all                                     peer
       host    all             all             0.0.0.0/0               trust
       

13. Запустите экземпляр Pangolin:

    pg_ctl -D /pgdata/06/data/ -l /pgerrorlogs/06/postgresql.log start
    

    Примечание:

    Возможные ошибки:

    1. Не читается файл лицензий:

       Check license file "/opt/pangolin_license/license.json" : file is not found
       

       Решение:

       Проверьте доступность под пользователем операционной системы postgres файла лицензии:

       1. Указание в переменной PG_LICENSE_PATH=/opt/pangolin_license/

          [postgres@srv ~]$ echo $PG_LICENSE_PATH
          /opt/pangolin_license/
          

          При необходимости исправьте:

          export PG_LICENSE_PATH=/opt/pangolin_license/
          

       2. Доступность файла лицензии:

          [postgres@srv ~]$ ls -la $PG_LICENSE_PATH
          total 12
          drwxr-xr-x  2 postgres postgres 4096 Apr 12 12:17 .
          drwxr-xr-x. 5 root     root     4096 Apr 12 12:14 ..
          -rw-r--r--  1 postgres postgres  500 Apr 12 12:17 license_trial_202407.json
          

    2. Скопированы некорректные символы в конфигурационный файл. После запуска в логе появляется запись об ошибках чтения конфигурационного файла в $PGDATA/log/*. Например:

       2024-04-12 12:25:50.689 MSK [60403] КОНТЕКСТ:  строка 100 файла конфигурации "/pgdata/06/data/pg_hba.conf"
       2024-04-12 12:25:50.689 MSK [60403] СООБЩЕНИЕ:  неверный метод проверки подлинности " "
       

       Решение:

       Скорее всего привнесены лишние символы при копировании строк из инструкции. Необходимо либо скорректировать, либо удалить проблемные строки и ввести их с клавиатуры например через vi.

14. Выполните команду psql:

    postgres@srv-64-44:~$ psql
    psql (15.5)
    Type "help" for help.
    
    postgres=#
    

Автоматизированная установка Pangolin#

В составе дистрибутива поставляется инсталлятор, установка возможна как с отдельного хоста, так и с master/replica планируемого кластера. Поддерживается установка cluster и standalone конфигурации.

Примечание:

Конфигурационные файлы и сценарии, приведенные в данном руководстве, являются примерами. Значение приведенных параметров и переменных зависит от конкретного случая установки.

Для осуществления автоматизированной установки Pangolin, выполните последовательно шаги, описанные в подразделах ниже.

Подготовка виртуального окружения#

Выполните шаги:

1. Установите виртуальное окружение:

   python3 -m venv install_venv
   

   Примечание:

   install_venv здесь и далее - имя venv. Может быть любым.

2. Активируйте виртуальное окружение:

   source /opt/pangolin-ansible-venv-controller/bin/activate
   

3. Скачайте дистрибутив из Nexus, распакуйте его и перейдите в каталог distrib:

   wget --user <username> --ask-password <distribuitive_url> && \
   mkdir distrib && \
   tar -xvf <distriburive.tar.gz> -C ./distrib/ 
   

Подготовка rpm/deb-пакетов#

Скрипты автоматизации установки Pangolin поддерживают два варианта развертывания rpm/deb-пакетов:

• rpm/deb-пакеты находятся в репозитории (по умолчанию);

• rpm/deb-пакеты находятся непосредственно на серверах, на которые будет производиться установка.

rpm/deb-пакеты находятся в репозитории#

Пользователь может как создать локальный репозиторий, так и поместить rpm/deb-пакеты Pangolin в свой репозиторий.

Действия по настройке локального репозитория (это действие нужно сделать для всех хостов, на которых будет производиться установка):

1. Выполните команду:

   dnf install -y createrepo
   

   Примечание:

   При установке на ОС Altlinux используйте пакетный менеджер - apt-get. При установке на ОС Astra - пакетный менеджер apt. На других ОС используйте dnf или yum.

2. Создайте файл /etc/yum.repos.d/local_repo.repo с содержимым:

   [local_repo]
   name=local_repo
   baseurl=file:///components_repo/local_repo/RPMS.local/
   gpgcheck=0
   enabled=1
   

3. Создайте директорию, где будут храниться rpm-пакеты:

   mkdir -p /components_repo/local_repo/RPMS.local/
   

4. Перенесите все rpm-пакеты в данную директорию.

5. Произведите инициализацию локального репозитория:

   createrepo /components_repo/local_repo/RPMS.
   

rpm/deb-пакеты находятся непосредственно на серверах#

Для подготовки к установке Pangolin:

1. Перенесите на все целевые хосты все rpm/deb-пакеты в дистрибутиве. Например в директорию /path/to/dir/rpm.

   Внимание!

   Нужно перенести именно rpm/deb-пакеты, а не весь дистрибутив на целевые хосты.

2. Чтобы скрипты ориентировались на директорию с rpm/deb-пакетами, добавьте и настройте параметр в конфигурационном файле (custom_config_initial.yml):

   pangolin_rpms_path: /path/to/dir/rpm
   

3. Переместите rpm-пакет pangolin-ansible-venv-controlled*.rpm на целевой хост, данный пакет находится в дистрибутиве 3rdparty.

Подготовка конфигурационных файлов#

Заполнение inventory-файлов#

Заполните inventory-файл в зависимости от конфигурации установки.

Файл hosts.ini заполняется в соответствии с шаблоном:

• для standalone находится по пути: installer/inventories/standalone/hosts.ini;

• для cluster находится по пути: installer/inventories/cluster/hosts.ini.

Файл hosts.ini состоит из нескольких групп (имена определены в скобках), которые используются для классификации и определения того, какие хосты будут использоваться. Для установки необходимо заполнить переменные группы postgres_nodes и arbiter_nodes (для кластерной конфигурации):

• ansible_host — в случае установки по IP-адресу, укажите ip_address, в случае установки по имени DNS укажите hostname;

• ansible_user — имя пользователя для использования при подключении к хосту. Должен иметь права для эскалации до root, то есть должен иметь возможность выполнять все команды от имени root;

• переменная ansible_password должна содержать пароль пользователя в чистом виде или имя переменной, которая будет содержать зашифрованный с помощью ansible-vault пароль.

Внимание!

Пароль пользователя следует указывать в кавычках для того, чтобы избежать конфликтов при цитировании специальных символов. Пользователь, указанный в файле hosts.ini, должен обладать правами sudo + nologin.

Ниже представлены примеры файла hosts.ini для standalone и cluster архитектур.

hosts.ini для standalone-конфигурации:

[standalone:children]
postgres_group

[postgres_group:children]
postgres_nodes

[postgres_group:vars]
ansible_connection=ssh

[postgres_nodes]
master  ansible_host=<IP-адрес>  ansible_user=<Имя пользователя>   ansible_password="<Пароль>"

hosts.ini для кластерной конфигурации:

[cluster:children]
postgres_group
arbiter_group

[postgres_group:children]
postgres_nodes

[arbiter_group:children]
arbiter_nodes

[postgres_group:vars]
ansible_connection=ssh

[arbiter_group:vars]
ansible_connection=ssh

[postgres_nodes]
master   ansible_host=<IP-адрес>  ansible_user=<Имя пользователя>   ansible_password="<Пароль>"
replica  ansible_host=<IP-адрес>  ansible_user=<Имя пользователя>   ansible_password="<Пароль>"

[arbiter_nodes]
arbiter  ansible_host=<IP-адрес>  ansible_user=<Имя пользователя>   ansible_password="<Пароль>"

Внимание!

Если в файле hosts.ini переменная ansible_password содержит ansible-vault, то пароль необходимо зашифровать. Ниже приведен пример шифрования текста passwordtest с помощью ansible-vault:

ansible-vault encrypt_string passwordtest
New Vault password:
Confirm New Vault password:
!vault |
    $ANSIBLE_VAULT;1.1;AES256
    {зашифрованный пароль}
Encryption successful

В случае, когда пароли для хостов групп postgres_group и arbiter_group совпадают, достаточно вывод команды ansible-vault поместить в inventory-файл сluster.yml/standalone.yml, расположенный в каталоге inventories/(standalone/cluster)/group_vars. Аналогичным образом необходимо перешифровать пароли в файле custom_file_sample.yml пример файла тем же ключом, которым был зашифрован пароль для учетной записи в текущем шаге.

Примечание:

Узнать подробнее о Ansible inventory можно в документации Ansible.

Заполнение файла конфигурации custom_config_sample.yml#

Пример конфигурационного файла custom_config_sample.yml, который можно использовать для развертывания продукта со значениями по умолчанию или с минимальными корректировками, находится в каталоге installer/templates/custom_config_sample.yml.

Поскольку custom_config_sample.yml является примером и вариантом готового решения, некоторые секции и параметры были перенесены в custom_config_initial.yml - конфигурационный файл, содержащий все динамически настраиваемые параметры СУБД Pangolin. При необходимости их можно переопределить в файле custom_config_sample.yml.

Пример заполнения custom_config_sample.yml:

# для конфигурации с применением хранилища ETCD

patroni_yml:
  etcd:
    hosts: [ <IP-адрес-1>, <IP-адрес-2>, <IP-адрес-3>] # укажите IP-адреса хостов кластера. Обычно это master, replica, arbiter.
    port: 2379 # укажите порт.

# для всех конфигураций

pip_repository:
  index_url: http://<hostname>/altlinux_trusted_repo/mirror/pypi_2/simple/
  trusted_host: <hostname>

Внимание!

Для etcd по умолчанию рекомендовано использовать порт 2379.

Сгенерируйте сертификаты, в случае, если в настраиваемом конфигурационном файле выше было выставлено значение для параметра: mtls_support: true и/или pkcs12_plugin_enable: true.

На текущий момент кластер можно развернуть с включенной аутентификацией SSL и без нее. Целью включения аутентификации является обеспечение безопасного взаимодействия компонентов внутри кластера.

Если активирован параметр pkcs12_plugin_enable: true, то сертификаты должны быть сгенерированы в формате PKCS#12 или будут получены из Secret Management System (далее – SecMan), в зависимости от заполненных значений в пользовательском конфигурационном файле. Подробнее читайте в документе «Руководстве по системному администрированию», раздел «Использование сертификатов PKCS#12 в кластере Pangolin».

Для поиска или генерации сертификата в SecMan необходимо активировать параметр use_remote_pki: true и заполнить атрибуты в разделе p12_secman: для каждого сертификата.

При включенном параметре (mtls_support: true) скрипты развертывания и обновления продукта определяют расположение сертификатов по путям из параметров соответствующего компонента (параметры из секции «3.2. НАСТРОЙКИ БЕЗОПАСНОГО ПОДКЛЮЧЕНИЯ (SSL)» (custom_config_initial.yml) – pg_certs_pwd) и проверяют их наличие.

Если сертификат отсутствует по указанному пути, то будет выведена блокирующая ошибка. Примеры ошибок:

"{{ control_name }}.FAIL__Файл сертификата 'root.crt' не найден на хосте. Проверьте наличие файла и значение в пользовательском конфигурационном файле - 'custom_config_sample.yml'__{{ control_name }}.FAIL"

Ниже приведен пример скрипта для генерации сертификатов и распространения их на указанные виртуальные машины:

#!/bin/sh
# IP/DNS-записи хостов.
hosts_list=(127.0.0.1 127.0.0.2 127.0.0.3)
# Пароль пользователя с root правами.
ssh_password=(TestPassword!)
# Пользователь с root-правами.
ssh_user=(admin_dev)
mkdir ssl
cd ssl

openssl req -new -nodes -text -out ./root.csr -keyout ./root.key -subj "/CN=PGSEdevCA"
openssl x509 -req -in ./root.csr -text -days 3650  -extfile /etc/pki/tls/openssl.cnf -extensions v3_ca -signkey ./root.key -out ./root.crt
openssl req -new -nodes -text -out ./client.csr -keyout ./client.key -subj "/CN=postgres"
openssl x509 -req -in ./client.csr -text -days 3650 -CA ./root.crt -CAkey ./root.key -CAcreateserial -out ./client.crt
openssl req -new -nodes -text -out ./patroni.csr -keyout ./patroni.key -subj "/CN=patroni"
openssl x509 -req -in ./patroni.csr -text -days 3650 -CA ./root.crt -CAkey ./root.key -CAcreateserial -out ./patroni.crt
openssl req -new -nodes -text -out ./patronietcd.csr -keyout ./patronietcd.key -subj "/CN=patronietcd"
openssl x509 -req -in ./patronietcd.csr -text -days 3650 -CA ./root.crt -CAkey ./root.key -CAcreateserial -out ./patronietcd.crt
openssl req -new -nodes -text -out ./pgbouncer.csr -keyout ./pgbouncer.key -subj "/CN=pgbouncer"
openssl x509 -req -in ./pgbouncer.csr -text -days 3650 -CA ./root.crt -CAkey ./root.key -CAcreateserial -out ./pgbouncer.crt
rm *.csr

######Copy_certs_on_nodes_and_generate_server_cert
for host in ${hosts_list[@]}
do
sshpass -p ${ssh_password} ssh -o StrictHostKeyChecking=no -p 22 ${ssh_user}@${host} 'sudo rm -rf /pg_ssl && sudo mkdir /pg_ssl && sudo chown $(whoami):$(whoami) /pg_ssl'
sshpass -p ${ssh_password} scp ./* ${ssh_user}@${host}:/pg_ssl
sshpass -p ${ssh_password} ssh -o StrictHostKeyChecking=no -p 22 ${ssh_user}@${host} 'cat << EOT >> /pg_ssl/server.conf
[req]
req_extensions = v3_req
distinguished_name = req_distinguished_name
[req_distinguished_name]
[ v3_req ]
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName = @alt_names
[ ssl_client ]
extendedKeyUsage = clientAuth, serverAuth
basicConstraints = CA:FALSE
subjectKeyIdentifier=hash
authorityKeyIdentifier=keyid,issuer
subjectAltName = @alt_names
[ v3_ca ]
basicConstraints = CA:TRUE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName = @alt_names
authorityKeyIdentifier=keyid:always,issuer
[alt_names]
EOT'

sshpass -p ${ssh_password} ssh -o StrictHostKeyChecking=no -p 22 ${ssh_user}@${host} 'cd /pg_ssl && echo DNS.1 = $(hostname -f) >> server.conf && echo IP.1 = $(hostname -i) >> server.conf && openssl req -new -nodes -text -out ./server.csr -keyout ./server.key -subj "/CN=$(hostname -f)" -config $(echo ./server.conf)'
sshpass -p ${ssh_password} ssh -o StrictHostKeyChecking=no -p 22 ${ssh_user}@${host} 'cd /pg_ssl && openssl x509 -req -in ./server.csr -text -days 3650 -CA ./root.crt -CAkey ./root.key -CAcreateserial -out ./server.crt -extensions ssl_client -extfile $(echo ./server.conf)'
sshpass -p ${ssh_password} ssh -o StrictHostKeyChecking=no -p 22 ${ssh_user}@${host} 'sudo chmod 0600 /pg_ssl/*.key && sudo chmod 0644 /pg_ssl/*.crt'

###/etc/pki/ca-trust/source/anchors/ - 'RedHat' /etc/pki/tls/openssl.cnf\ - 'Altlinux' ###
sshpass -p ${ssh_password} ssh -o StrictHostKeyChecking=no -p 22 ${ssh_user}@${host} 'sudo cp /pg_ssl/root.crt /etc/pki/ca-trust/source/anchors/ && sudo update-ca-trust'
done

Данные сертификаты не будут подписаны, но будут являться минимальными требуемыми для установки. После установки продукта Pangolin необходимо подписать данные сертификаты в удостоверяющем центре (подробная информация о генерации сертификатов в документе «Руководство администратора», раздел «Генерация сертификатов»).

Примечание:

Скрипты развертывания не осуществляют проверку валидности сертификатов.

Установка с фиксированным UID/GID для пользователей#

Начиная с версии 6.3.0 была добавлена возможность установки с фиксированным UID/GID для пользователей. Для этого добавлены параметры:

• kmadmin_user_group.is_enabled: переменная типа boolean, служащая для включения функциональности. Значение True принимается как флаг активации - в этом случае пользователь будет создан с указанными значениями UID/GID. По умолчанию используется значение False;

• pangolin_users_group.is_enabled: переменная типа boolean, включение функциональности для группы pangolin_users_group;

• pangolin_users_group.group_gid: переменная типа int, определяющая GID для группы pangolin_users_group. Значение по умолчанию: 226;

• kmadmin_user_group.group_gid: целочисленная переменная, содержащая значение GID для пользователя гр. По умолчанию используется значение 126.

• kmadmin_user_group.user_uid: целочисленная переменная, содержащая значение UID для пользователя. По умолчанию используется значение 126.

При развертывании из RPM/DEB-пакетов функциональность активируется через объявление соответствующих переменных окружения.

Например, для пользователя kmadmin_pg перед установкой из пакета задаются $KMADMIN_PG_USER_GUID и $KMADMIN_PG_GROUP_GUID для UID/GID. Объявление (наличии в пространстве имен) этих переменных включает функциональность, при этом UID/GID берутся из заданных значений.

Если переменные не определены, значение для UID/GID выбираются из доступных.

Установка без наличия DNS сервера на устанавливаемых узлах#

Начиная с версии 6.4.2, был добавлен параметр used_fqdn_host, отвечающий за установку СУБД Pangolin в средах, где не предусмотрен DNS-сервер. По умолчанию данный параметр включен, и скрипты автоматизации будут использовать DNS-сервер для установки продукта.

В случае наличия A-записи, равной DNS-имени hostname проверить работоспособность DNS-сервера можно командой dig hostname с узла, на котором будет запускаться ansible.

Пример:

➜  ~ dig srv-0-190.db.dev.sbt

; <<>> DiG 9.10.6 <<>> srv-0-190.db.dev.sbt
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 27230
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 512
;; QUESTION SECTION:
;srv-0-190.db.dev.sbt.          IN      A

;; ANSWER SECTION:
srv-0-190.db.dev.sbt.   3600    IN      A       {IP-адрес}

В случае отсутствия А-записи или наличия записи, не соответствующей имени hostname, нужно выключить параметр used_fqdn_host (установить в значение false). Далее запустить установку СУБД Pangolin. Результатом данных действий будет установленный продукт в кластерной или standalone-конфигурации с использованием IP-адресов вместо DNS-записи.

При установке параметр следует отключить в конфигурационном файле, установив его значение в false:

used_fqdn_host: false

Примечание:

Для корректной работы скриптов автоматизации необходимо, чтобы у пользователя был предварительно корректно настроен DNS-сервер, так как скрипты используют доменное имя в своей работе.

Запуск сценария установки#

Выполните шаги:

1. Заполните параметры, заключенные в < >, запустите playbook_install.yaml из директории installer:

   ansible-playbook -vvv playbook_install.yaml \
   -i inventories/<cluster||standalone>/hosts.ini \
   -t <configuration>  \
   -e '{"as_TUZ":['tuz_1']}' \
   --flush-cache \
   --extra-vars 'local_distr_path=<path_to_distributive> \
   installation_type=<cluster||standalone> \
   PGPORT=5433 \
   PGDATA=/pgdata/<major_version>/data \
   PGLOGS=/pgerrorlogs/<major_version> \
   clustername=clustername \
   custom_config=templates/custom_config_sample.yml \
   pangolin_license_path=/home/sbt_user/license_trial.json \
   nolog=true'
   

   Пример заполненной команды для запуска playbook_install.yaml в случае cluster-установки Pangolin:

   ansible-playbook -vvv playbook_install.yaml \
   -i inventories/cluster/hosts.ini \
   -t cluster-patroni-etcd-pgbouncer  \
   -e '{"as_admins":['admin_1', 'admin_2']}' \
   -e '{"as_TUZ":['tuz_1']}' \
   --flush-cache \
   --extra-vars 'local_distr_path=/home/pprb_dev/distrib \ #каталог, в который распакован дистрибутив.
   installation_type=cluster \
   PGPORT=5433 \
   PGDATA=/pgdata/06/data \
   PGLOGS=/pgerrorlogs/06 \
   tablespace_name=tbl_name \
   tablespace_location=/pgdata/06/tablespaces \
   schema_name=shema \
   db_name=first_db \
   clustername=clustername \
   custom_config=templates/custom_config_sample.yml \
   nolog=true \
   pangolin_license_path=/home/sbt_user/license_trial.json' #путь к файлу лицензии
   

2. Дождитесь окончания установки и деактивируйте виртуальное окружение:

   deactivate