Развёртывание КПО Server

КПО Server — это серверное приложение, обеспечивающее управление, маршрутизацию и синхронизацию данных между пользователями мобильного клиента КПО-А. Сервер необходим для организации защищённого обмена информацией, координации действий и централизованного управления группами пользователей.

Данное руководство описывает процесс установки и первоначальной настройки КПО Server.

1. Подготовка среды

Перед началом установки убедитесь, что сервер соответствует следующим минимальным требованиям:

• Операционная система: Linux (Ubuntu 20.04/22.04 LTS)
• Процессор: 4 ядра и выше
• Оперативная память (ОЗУ): от 8 ГБ
• Дисковое пространство: от 100 ГБ
• Доступ в интернет (для синхронизации и получения обновлений)

Необходимое программное обеспечение:

• Java 11 (OpenJDK или Oracle JDK)
• PostgreSQL 13+ (для хранения данных)
• Доступ по SSH для администрирования

2. Установка КПО Server

Шаг 1: Получение дистрибутива

1. Скачайте дистрибутив КПО Server с официального сайта:
   https://kpo.npo-dvina.ru (требуется авторизация)

Шаг 2: Распаковка

1. Распакуйте архив в выбранную директорию установки:

tar -xzf kpo-server-[version].tar.gz -C /opt/

Шаг 3: Настройка базы данных

1. Создайте пользователя и базу данных в PostgreSQL:

sql
CREATE USER kpo_user WITH PASSWORD 'your_password';
CREATE DATABASE kpo_db OWNER kpo_user;

2. Выполните миграцию схемы данных (используйте SQL-файл из дистрибутива)

Шаг 4: Установка зависимостей

1. Убедитесь, что Java 11 установлена и настроена:
   java -version
2. При необходимости установите дополнительные системные библиотеки

3. Конфигурация сервера

Настройка конфигурационного файла

1. Откройте файл конфигурации: server.config
2. Задайте основные параметры:

properties
server.address=your_server_ip_or_domain
server.api.port=8089
server.client.port=8087

# НастройкиБД

db.url=jdbc:postgresql://localhost:5432/kpo_db
db.username=kpo_user
db.password=your_password

Настройка SSL (рекомендуется)

• Для тестовой среды: используйте самоподписанные сертификаты
• Для боевой эксплуатации: настройте SSL-сертификаты (Let's Encrypt или корпоративные)

4. Запуск сервера

Для Linux-систем:

1. Перейдите в директорию установки
2. Выполните команду:

bash
./kpo-server.sh start

3. Проверьте статус службы:

bash
./kpo-server.sh status

5. Проверка работоспособности

1. Доступ к веб-интерфейсу:

• Откройте браузер и перейдите по адресу: http://<IP-сервера>:8089
• Авторизуйтесь с учетными данными администратора

Первоначальная настройка:

• Добавьте пользователей через административную панель
• Настройте группы и роли доступа
• Создайте необходимые политики безопасности

Подключение мобильных клиентов:

• В настройках приложения КПО-А укажите адрес вашего сервера
• Протестируйте подключение и обмен данными

6. Дополнительные настройки

Резервное копирование

• Настройте регулярное бэкапирование базы данных
• Сохраняйте копии конфигурационных файлов

Мониторинг

• Подключите системы мониторинга (Prometheus + Grafana)
• Настройте оповещения о критических событиях

Безопасность

• Настройте межсетевой экран (firewall)
• Ограничьте доступ к портам 8089 и 8087 только для доверенных IP-адресов
• Регулярно обновляйте компоненты системы

Полезные рекомендации

• ✅ Перед обновлением всегда создавайте резервные копии БД и конфигураций
• ✅ Для боевой эксплуатации обязательно используйте SSL-шифрование
• ✅ Регулярно проверяйте логи сервера на наличие ошибок
• ✅ Для крупных инсталляций рассмотрите использование кластеризации

7. Частые проблемы и решения

В: Сервер не запускается, в логах ошибка "Port already in use"

О: Один из портов (8089, 8087) занят другим процессом.

• Решение:

1. Найдите процесс:

   sudo netstat -tulpn | grep :8089

2. Остановите конфликтующий процесс или измените порт в server.config
3. Перезапустите сервер

В: "Connection refused" при подключении к базе данных

О: PostgreSQL не запущен или недоступен.

• Решение:

1. Проверьтестатус PostgreSQL: sudo systemctl status postgresql
2. Запуститеслужбу: sudo systemctl start postgresql
3. Проверьте правильность учётных данных в конфигурации

В: Ошибка "Java not found" при запуске

О: Java 11 не установлена или путь к Java не настроен.

• Решение:

1. Установите OpenJDK 11: sudo apt install openjdk-11-jdk
2. Проверьте установку: java -version
3. Настройте переменную JAVA_HOME в системе

В: Мобильные клиенты не могут подключиться к серверу

О: Проблемы с сетевыми настройками или firewall.

• Решение:

1. Проверьте доступность портов с клиентских машин: telnet <server_ip> 8087
2. Настройте firewall:

bash
sudo ufw allow 8089/tcp
sudo ufw allow 8087/tcp

В: Ошибка "SSL handshake failed" при подключении клиентов

О: Проблемы с SSL-сертификатами.

• Решение:

1. Проверьте срок действия сертификатов
2. Убедитесь, что сертификаты подписаны доверенным центром
3. Для тестовой среды отключите проверку SSL в клиенте (не рекомендуется для продакшена)

В: Сервер работает медленно, высокие задержки ответа

О: Недостаточно ресурсов или проблемы с базой данных.

• Решение:

1. Проверьте использование CPU и памяти
2. Проанализируйте производительность БД: EXPLAIN ANALYZE для медленных запросов
3. Увеличьте объём ОЗУ или оптимизируйте настройки PostgreSQL

В: После обновления сервер перестал работать

О: Конфликт версий или проблемы с миграцией данных.

• Решение:

1. Восстановите резервную копию БД, сделанную перед обновлением
2. Проверьте совместимость версий в документации
3. Выполните миграцию данных заново

В: Не удаётся авторизоваться в веб-интерфейсе администратора

О: Проблемы с учётными данными или сессиями.

• Решение:

1. Проверьте правильность логина/пароля
2. Очистите кеш браузера и cookies
3. Проверьте настройки сессий в конфигурации сервера

В: В логах появляются ошибки "Memory allocation failed"

О: Недостаточно оперативной памяти.

• Решение:

1. Увеличьте объём ОЗУ на сервере
2. Настройте параметры JVM в скрипте запуска:

bashbr>JAVA_OPTS="-Xmx4g -Xms2g"

В: Данные не синхронизируются между клиентами

О: Проблемы с сетью или настройками репликации.

• Решение:

1. Проверьте логи сервера на наличие ошибок синхронизации
2. Убедитесь, что все клиенты используют одинаковую версию протокола
3. Проверьте настройки групп и политик доступа

Рекомендации по диагностике

• Проверяйте логи: Все ошибки записываются в /var/log/kpo-server/
• Мониторинг ресурсов: Используйте htop, iotop для анализа нагрузки
• Тестирование сети: Проверяйте connectivity с клиентских машин
• Документируйте изменения: Фиксируйте все изменения в конфигурации

Экстренное восстановление

При критических сбоях:

1. Остановите сервер: ./kpo-server.sh stop
2. Восстановите БД из резервной копии
3. Проверьте целостность конфигурационных файлов
4. Запустите сервер и проверьте работу

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

• Полные логи ошибок
• Версию ОС и КПО Server
• Конфигурацию оборудования
• Описание предпринятых действий

Получение помощи

Если в процессе установки возникли трудности:

• Документация: Полное руководство администратора доступно в комплекте поставки

• Техническая поддержка:

  • Телефон: 8 (800) 101 50 70
  • Email: post@npo-dvina.ru