/unicchat.free

Документация по UnicChat free

Инструкция по установке корпоративного мессенджера для общения и командной работы UnicChat

версия 6.4.3, версия документа 1.6

Оглавление

Архитектура установки

Установка на 1-м сервере

Шаг 1. Подготовка окружения

Требования к конфигурации до 50 пользователей. Приложение и БД устанавливаются на 1-й виртуальной машине

Конфигурация виртуальной машины
CPU 4 cores 1.7ghz, с набором инструкций FMA3, SSE4.2, AVX 2.0;
RAM 16 Gb;
250 Gb HDD\SSD;

Шаг 2. Клонирование репозитория

  1. Выполните на сервере git clone https://github.com/unicommorg/unicchat.free.git

Шаг 3. Внешние зависимости

На виртуальную машину установите docker и docker-compose, для этого воспользуйтесь инструкциями для вашей ОС, размещенными в сети Интернет.

Шаг 4. Проверка версии mongodb

  1. На виртуальной машине выполните команду grep avx /proc/cpuinfo или аналогичную для вашей ОС. 2. Если в ответе вы не видите AVX, то вам нужно в файле ./single_server_install/unicchat_all_in_one.yml в строке image: docker.io/bitnami/mongodb:${MONGODB_VERSION:-5.0} отредактировать версию mongodb, указав ее ниже 5.0, например, 4.4, image: docker.io/bitnami/mongodb:${MONGODB_VERSION:-4.4} 3. Если AVX на вашем сервере поддерживается (в ответе есть строки с поддержкой AVX), то ничего дополнительно делать не нужно.

Шаг 5. Запуск Unicchat

  1. Перейдите в каталог ./single_server_install
  2. Запустить сервер, для этого выполните команду docker compose -f unicchat_all_in_one.yml up -d
  3. Дождитесь пока будут загружены образы компонент, это может занять какое-то время. После загрузки, компоненты запустятся автоматически.
  4. Успешный запуск компонент будет отображаться в терминале:
  5. После запуска компонент, Unicchat будет доступен по адресу http://localhost:8080

Шаг 6. Создание пользователя-администратора

  1. При первом запуске откроется форма создания администратора
  • Organization ID - Идентификатор вашей организации, используется для подключения к push серверу. Может быть указан позже. Для получения ID необходимо написать запрос с указанием значения в Organization Name на почту support@unicomm.pro;
  • Full name - Имя пользователя, которое будет отображаться в чате;
  • Username - Логин пользователя, который вы будете указывать для авторизации;
  • Email - Действующая почта, используется для восстановления доступа;
  • Password - пароль вашего пользователя;
  • Confirm your password - подтверждение пароля;
  1. После создания пользователя, авторизоваться в веб-интерфейсе с использованием ранее указанных параметров.
  2. Для включения пушей, перейти в раздел Администрирование - Push. Включить использование шлюза и указать адрес шлюза https://push1.unic.chat
  3. Перейти в раздел Администрирование - Organization, убедиться что поля заполнены в соответствии с п.1
  4. Настройка завершена.

Шаг 7. Карта сетевых взаимодействий сервера

Входящие соединения на стороне сервера UnicChat:

Открыть порты:

  • 8080/TCP - по-умолчанию, сервер запускается на 8080 порту и доступен http://localhost:8080, где localhost - это IP адрес сервера UnicChat;
  • 443/TCP - порт будет нужен, если вы настроили nginx с сертификатом HTTPS;

Исходящие соединения на стороне сервера UnicChat:

  • Открыть доступ для Push-шлюза:

    • 443/TCP, на хост push1.unic.chat;

  • Открыть доступ для ВКС сервера:

    • 443/TCP, на хост live.unic.chat;
    • 7881/TCP, 7882/UDP
    • (50000 - 60000)/UDP (диапазон этих портов может быть измененён при развертывании лицензионной версии непосредственно владельцем лицензии)

  • Открыть доступ до внутренних ресурсов: LDAP, SMTP, DNS при необходимости использования этого функционала

Частые проблемы при установке

Раздел в разработке.

Клиентские приложения