Установка и настройка

Ubuntu 22.04 или Debian 12

Установка компонентов

Данное руководство описывает настройку серверной среды, включая базу данных (PostgreSQL 16), кэширование (Redis), веб-сервер (Nginx), и специальное программное обеспечение «Katan». В каждом пункте выполняются действия для обеспечения правильной установки, настройки и запуска этих компонентов.

Технические требования к серверу и ПО указаны в разделе «Технические требования». Запускаем сервер на базе операционной системы Ubuntu 22.04 или Debian 12.

Переключаемся на учетную запись суперпользователя (root):

sudo su

Установка PostgreSQL

Добавляем в систему репозиторий PostgreSQL:

sh -c 'echo "deb https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

Добавляем в систему ключи для доступа к репозиторию PostgreSQL:

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add -

Обновляем список доступных пакетов системы и устанавливаем сервер и клиент PostgreSQL 16:

apt update && apt install -y postgresql-16 postgresql-client-16

Проверяем статус службы PostgreSQL:

systemctl status postgresql

Проверяем версию установленной PostgreSQL:

psql --version

Обновляем список доступных пакетов системы и устанавливаем расширение PostGIS для PostgreSQL 16:

apt update && apt install postgis postgresql-16-postgis-3 -y

Заходим в консоль PostgreSQL:

sudo -u postgres psql

Меняем пароль:

ALTER USER postgres PASSWORD '<НОВЫЙ ПАРОЛЬ>';

Выходим из консоли PostgreSQL:

\q

Установка Redis

Добавляем в систему репозиторий Redis:

add-apt-repository ppa:redislabs/redis

Обновляем список доступных пакетов системы и устанавливаем Redis:

apt update && apt install redis -y

Добавляем в автозапуск и запускаем службу Redis:

systemctl enable --now redis-server

Проверяем статус службы Redis:

systemctl status redis-server

Установка Nginx

Обновляем список доступных пакетов системы и устанавливаем Nginx:

apt update && apt install nginx -y

Проверяем статус службы Nginx:

systemctl status nginx

Удаляем из системы символическую ссылку на стандартную конфигурацию Nginx:

rm /etc/nginx/sites-enabled/default

Установка Katan

Даем права на выполнение скрипту установки Katan:

chmod 775 katan-installer

Запускаем скрипт установки Katan:

./katan-installer

Установщик запускается на http://localhost:8080.

Необходимо заполнить поля для подключения к Redis и Postgres, затем нажать кнопку «Проверить».

Если всё в порядке, становится доступной кнопка «Начать установку».

При нажатии начинается скачивание с сервера и установка.

Конфигурирование Nginx

Если используется собственный сертификат: Создаем в системе папку, где будут храниться сертификат и ключ:

mkdir /etc/nginx/ssl

Создаем в системе сертификат:

nano /etc/nginx/ssl/<ВАШ СЕРТИФИКАТ>

Создаем в системе ключ:

nano /etc/nginx/ssl/<ВАШ КЛЮЧ>

Открываем файл конфигурации Katan в Nginx:

nano /etc/nginx/sites-available/katan

Изменяем доменное имя:

map $host $katan_host {
default <ВАШЕ ДОМЕННОЕ ИМЯ>;
}

Изменяем пути к сертификату и ключу:

ssl_certificate <ПУТЬ К СЕРТИФИКАТУ>;
ssl_certificate_key <ПУТЬ К КЛЮЧУ>;

Создаем символическую ссылку для конфигурации Katan в Nginx:

ln -s /etc/nginx/sites-available/katan /etc/nginx/sites-enabled/

Проверяем правильность конфигурации Nginx:

nginx -t

Перезапускаем службу Nginx:

systemctl restart nginx

RED OS 8.0.2

Установка компонентов

Данное руководство описывает настройку серверной среды, включая базу данных (PostgreSQL 16), кэширование (Redis), веб-сервер (Nginx) и специальное программное обеспечение «Katan». В каждом пункте выполняются действия для обеспечения правильной установки, настройки и запуска этих компонентов.

Технические требования к серверу и ПО указаны в разделе «Технические требования». Запускаем сервер на базе операционной системы RED OS 8.0.2.

Переключаемся на учетную запись суперпользователя (root):

sudo su

Установка PostgreSQL

Устанавливаем сервер и клиент PostgreSQL 16:

dnf -y install postgresql16-server postgresql16 postgresql16-contrib

Создаём системные базы данных:

/usr/pgsql-16/bin/postgresql-16-setup initdb

Добавляем в автозапуск и запускаем службу PostgreSQL:

systemctl enable --now postgresql-16

Проверяем статус службы PostgreSQL:

systemctl status postgresql-16

Проверяем версию установленной PostgreSQL:

psql --version

Устанавливаем расширение PostGIS для PostgreSQL 16:

dnf -y install postgis-pgsql16

Входим в консоль PostgreSQL:

sudo -u postgres psql

Меняем пароль:

ALTER USER postgres PASSWORD '<НОВЫЙ ПАРОЛЬ>';

Выходим из консоли PostgreSQL:

\q

Установка Redis

Устанавливаем Redis:

dnf -y install redis

Добавляем в автозапуск и запускаем службу Redis:

systemctl enable --now redis

Проверяем статус службы Redis:

systemctl status redis

Установка Nginx

Устанавливаем Nginx:

dnf -y install nginx

Добавляем в автозапуск и запускаем службу Nginx:

systemctl enable --now nginx

Проверяем статус службы Nginx:

systemctl status nginx

Удаляем из системы символическую ссылку на стандартную конфигурацию Nginx:

rm -f /etc/nginx/conf.d/default.conf

Установка Katan

Даем права на выполнение скрипту установки Katan:

chmod 775 katan-installer

Запускаем скрипт установки Katan:

./katan-installer

Установщик запускается на http://localhost:8080.

Необходимо заполнить поля для подключения к Redis и Postgres, затем нажать кнопку «Проверить».

Если всё в порядке, становится доступной кнопка «Начать установку».

При нажатии начинается скачивание с сервера и установка.

Конфигурирование Nginx

Если используется собственный сертификат: Создаем в системе папку, где будут храниться сертификат и ключ:

mkdir /etc/nginx/ssl

Создаем в системе сертификат:

nano /etc/nginx/ssl/<ВАШ СЕРТИФИКАТ>

Создаем в системе ключ:

nano /etc/nginx/ssl/<ВАШ КЛЮЧ>

Создаем символическую ссылку для конфигурации Katan в Nginx:

ln -s /etc/nginx/sites-available/katan /etc/nginx/conf.d/katan.conf

Открываем файл конфигурации Katan в Nginx:

nano /etc/nginx/sites-available/katan

Изменяем доменное имя:

map $host $katan_host {
    default <ВАШЕ ДОМЕННОЕ ИМЯ>;
}

Изменяем пути к сертификату и ключу:

ssl_certificate <ПУТЬ К СЕРТИФИКАТУ>;
ssl_certificate_key <ПУТЬ К КЛЮЧУ>;

Проверяем правильность конфигурации Nginx:

nginx -t

Перезапускаем службу Nginx:

systemctl restart nginx

Разрешаем исходящие соединения для прокси-логики Nginx:

setsebool -P httpd_can_network_relay 1

Добавляем в автозапуск и запускаем службу Katan:

systemctl enable --now katan

ALT Server 11.1

Установка компонентов

Данное руководство описывает настройку серверной среды, включая базу данных (PostgreSQL 16), кэширование (Redis), веб-сервер (Nginx) и специальное программное обеспечение «Katan». В каждом пункте выполняются действия для обеспечения правильной установки, настройки и запуска этих компонентов.

Технические требования к серверу и ПО указаны в разделе «Технические требования». Запускаем сервер на базе операционной системы ALT Server 11.1.

Переключаемся на учетную запись суперпользователя (root):

su -

Установка PostgreSQL

Обновляем список доступных пакетов системы и устанавливаем сервер и клиент PostgreSQL 16:

apt-get update && apt-get install -y postgresql16-server postgresql16-contrib

Создаём системные базы данных:

/etc/init.d/postgresql initdb

Добавляем в автозапуск и запускаем службу PostgreSQL:

systemctl enable --now postgresql

Проверяем статус службы PostgreSQL:

systemctl status postgresql

Проверяем версию установленной PostgreSQL:

psql --version

Устанавливаем расширение PostGIS для PostgreSQL 16:

apt-get install postgresql16-postgis

Заходим в консоль PostgreSQL:

psql -U postgres

Меняем пароль:

ALTER USER postgres PASSWORD '<НОВЫЙ ПАРОЛЬ>';

Выходим из консоли PostgreSQL:

\q

Установка Redis

Устанавливаем Redis:

apt-get install redis

Добавляем в автозапуск и запускаем службу Redis:

systemctl enable --now redis

Проверяем статус службы Redis:

systemctl status redis

Установка Nginx

Устанавливаем Nginx:

apt-get install nginx

Добавляем в автозапуск и запускаем службу Nginx:

systemctl enable --now nginx.service

Проверяем статус службы Nginx:

systemctl status nginx

Удаляем из системы символическую ссылку на стандартную конфигурацию Nginx:

rm /etc/nginx/sites-enabled.d/default

Установка Katan

Даем права на выполнение скрипту установки Katan:

chmod 775 katan-installer

Запускаем скрипт установки Katan:

./katan-installer

Установщик запускается на http://localhost:8080.

Необходимо заполнить поля для подключения к Redis и Postgres, затем нажать кнопку «Проверить».

Если всё в порядке, становится доступной кнопка «Начать установку».

При нажатии начинается скачивание с сервера и установка.

Конфигурирование Nginx

Если используется собственный сертификат: Создаем в системе папку, где будут храниться сертификат и ключ:

mkdir /etc/nginx/ssl

Создаем в системе сертификат:

nano /etc/nginx/ssl/<ВАШ СЕРТИФИКАТ>

Создаем в системе ключ:

nano /etc/nginx/ssl/<ВАШ КЛЮЧ>

Создаем символическую ссылку для конфигурации Katan в Nginx:

ln -s /etc/nginx/sites-available/katan /etc/nginx/sites-enabled.d/katan.conf

Открываем файл конфигурации Katan в Nginx:

nano /etc/nginx/sites-available/katan

Изменяем доменное имя:

map $host $katan_host {
    default <ВАШЕ ДОМЕННОЕ ИМЯ>;
}

Изменяем пути к сертификату и ключу:

ssl_certificate <ПУТЬ К СЕРТИФИКАТУ>;
ssl_certificate_key <ПУТЬ К КЛЮЧУ>;

Проверяем правильность конфигурации Nginx:

nginx -t

Перезапускаем службу Nginx:

systemctl restart nginx

Добавляем в автозапуск и запускаем службу Katan:

systemctl enable --now katan