Использование PostgreSQL на Linux🔗

Для версий Macroscop 4.0 и выше установка PostgreSQL на Linux выполняется в автоматическом режиме при развёртывании Macroscop Сервер.

Для версий Macroscop 3.4-3.6 установка PostgreSQL на Linux выполняется исключительно в ручном режиме.

Примечание

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

Debian, Ubuntu

Смена пароля для пользователя по умолчанию

В случаях, когда использование стандартного пароля пользователя СУБД не соответствует требованиям безопасности, допустимо изменить пароль для соединения между Macroscop и PostgreSQL на собственный.

Предупреждение

Указанные ниже действия должны выполняться непосредственно на сервере, для которого вносятся изменения.

Остановите работу Macroscop. Сделать это можно с помощью команды:
```
systemctl stop macroscop.service
```
С помощью утилиты psql задайте новый пароль для пользователя macroscop. Запустите утилиту, выполнив в Терминале команду:
```
psql -U macroscop -h 127.0.0.1 -d postgres
```
Введите текущий пароль для подтверждения входа (По умолчанию: masterkey).
Измените пароль командой:
```
ALTER USER CURRENT_USER PASSWORD 'newPassword';
```
где newPassword — это новый пароль для пользователя macroscop.
Перейдите в директорию /opt/MacroscopServer/MacroscopServerConfigs/, после чего откройте в любом текстовом редакторе конфигурационный файл ArchiveSystem.xml.
Найдите в этом файле секцию PostgreSqlConfig и внесите данные пользователя в строки User и Password.

Ниже приведён пример таких настроек:
```
<PostgreSqlConfig>
    <Ip>127.0.0.1</Ip>
    <Port>5432</Port>
    <User>macroscop</User>
    <Password>newPassword</Password>
</PostgreSqlConfig>
```
Для того чтобы система могла автоматически создавать резервные копии файлов БД, убедитесь, что данные выбранного пользователя внесены в файл паролей самой СУБД. Для этого перейдите в домашнюю директорию пользователя и откройте в любом текстовом редакторе файл .pgpass. Проверьте, что использованные имя пользователя и пароль имеют право на доступ к базам данных Macroscop.
Возобновите работу Macroscop. Сделать это можно путём выполнения в Терминале следующей команды:
```
systemctl start macroscop.service
```

Базы данных модулей аналитики

Если в системе используются модули Распознавание лиц или Распознавание автомобильных номеров, изменение пользователя СУБД окажет влияние в том числе и на их базы.

Если используется Локальная база данных, Macroscop будет использовать для доступа к базе имя и пароль, указанные в файле ArchiveSystem.xml.

Если используется Удаленная база данных, изменение учётных данных PostgreSQL на хранящем базу данных сервере потребует внесения новых имени и пароля в настройки всех камер, использующих эту базу.

Примечание

Пример:

Сервер 1 содержит базу лиц.

Сервер 2 имеет ряд камер, использующих базу лиц с Сервера 1.

Изменение пользователя СУБД на Сервере 2 не окажет влияния на доступ к базе лиц на Сервере 1.

Изменение пользователя СУБД на Сервере 1 потребует внесения новых данных в настройки всех камер на Сервере 2, использующих базу лиц.

Предупреждение

PostgreSQL не разрешает удалённый доступ к базам по умолчанию, в связи с чем его необходимо включить вручную при использовании удалённых баз данных.

Указанные ниже действия выполняются на сервере, хранящем базу данных модуля.

Откройте директорию с конфигурационными файлами PostgreSQL.

Путь по умолчанию:
```
/etc/postgresql/12/main/
```
В текстовом редакторе откройте файл postgresql.conf и добавьте в него строку вида:
```
listen_addresses = '*'
```
Указанный пример разрешает получать запросы через все доступные сетевые адаптеры сервера. При необходимости ограничить список адаптеров, разрешённых для приёма запросов к базам данных, замените символ * на точный адрес сетевого адаптера. Подробную информацию о настройке можно получить в документации к PostgreSQL 12.
В текстовом редакторе откройте файл pg_hba.conf и добавьте в него строку вида:
```
host all all 192.168.0.0/24 md5
```
Указанный пример разрешает удалённое подключение ко всем базам, хранящимся на сервере, для всех пользователей, обращающихся с адресов диапазона 192.168.0.XXX. В случае, если в сети системы применяется иная адресация, необходимо указать соответствующий диапазон адресов. Допускается внесение нескольких строк с разными диапазонами адресов. Подробную информацию о настройке можно получить в документации к PostgreSQL 12.
Перезапустите службу, выполнив в Терминале команду:
```
sudo systemctl restart postgresql-12.service
```

CentOS

Смена пароля для пользователя по умолчанию

Предупреждение

Указанные ниже действия должны выполняться непосредственно на сервере, для которого вносятся изменения.

Остановите работу Macroscop. Сделать это можно с помощью команды:
```
systemctl stop macroscop.service
```
С помощью утилиты psql задайте новый пароль для пользователя macroscop. Запустите утилиту, выполнив в Терминале команду:
```
psql -U macroscop -h 127.0.0.1 -d postgres
```
Введите текущий пароль для подтверждения входа (По умолчанию: masterkey).
Измените пароль командой:
```
ALTER USER CURRENT_USER PASSWORD 'newPassword';
```
где newPassword — это новый пароль для пользователя macroscop.
Перейдите в директорию /opt/MacroscopServer/MacroscopServerConfigs/, после чего откройте в любом текстовом редакторе конфигурационный файл ArchiveSystem.xml.
Найдите в этом файле секцию PostgreSqlConfig и внесите данные пользователя в строки User и Password.

Ниже приведён пример таких настроек:
```
<PostgreSqlConfig>
    <Ip>127.0.0.1</Ip>
    <Port>5432</Port>
    <User>macroscop</User>
    <Password>newPassword</Password>
</PostgreSqlConfig>
```
Для того чтобы система могла автоматически создавать резервные копии файлов БД, убедитесь, что данные выбранного пользователя внесены в файл паролей самой СУБД. Для этого перейдите в домашнюю директорию пользователя и откройте в любом текстовом редакторе файл .pgpass. Проверьте, что использованные имя пользователя и пароль имеют право на доступ к базам данных Macroscop.
Возобновите работу Macroscop. Сделать это можно путём выполнения в Терминале следующей команды:
```
systemctl start macroscop.service
```

Базы данных модулей аналитики

Примечание

Пример:

Сервер 1 содержит базу лиц.

Сервер 2 имеет ряд камер, использующих базу лиц с Сервера 1.

Изменение пользователя СУБД на Сервере 2 не окажет влияния на доступ к базе лиц на Сервере 1.

Предупреждение

Указанные ниже действия выполняются на сервере, хранящем базу данных модуля.

Откройте директорию с конфигурационными файлами PostgreSQL.

Путь по умолчанию:
```
/var/lib/pgsql/12/data/
```
В текстовом редакторе откройте файл postgresql.conf и добавьте в него строку вида:
```
listen_addresses = '*'
```
Указанный пример разрешает получать запросы через все доступные сетевые адаптеры сервера. При необходимости ограничить список адаптеров, разрешённых для приёма запросов к базам данных, замените символ * на точный адрес сетевого адаптера. Подробную информацию о настройке можно получить в документации к PostgreSQL 12.
В текстовом редакторе откройте файл pg_hba.conf и добавьте в него строку вида:
```
host all all 192.168.0.0/24 md5
```
Указанный пример разрешает удалённое подключение ко всем базам, хранящимся на сервере, для всех пользователей, обращающихся с адресов диапазона 192.168.0.XXX. В случае, если в сети системы применяется иная адресация, необходимо указать соответствующий диапазон адресов. Допускается внесение нескольких строк с разными диапазонами адресов. Подробную информацию о настройке можно получить в документации к PostgreSQL 12.
Перезапустите службу, выполнив в Терминале команду:
```
sudo systemctl restart postgresql-12.service
```