DigiVC документация

DigiVC документация

Инсталация и първоначална настройка

Production сървърът е предназначен за Oracle Linux 9 или DigiOS. PostgreSQL трябва да е версия 16 или по-нова. Базата може да е локална или на отделен PostgreSQL сървър.

Поддържан сървърен хост

Production сървърът е предназначен за Oracle Linux 9 или DigiOS. PostgreSQL трябва да е версия 16 или по-нова. Базата може да е локална или на отделен PostgreSQL сървър.

Какво се качва на сървъра

За нова server инсталация качете целия DigiVC release bundle с разширение .tar.xz. Не качвайте само client пакет и не се опитвайте да инсталирате .tar.xz като RPM.

В bundle-а обичайно има:

  • Server RPM;
  • manifest и SHA-256 checksums;
  • install-digivc-server;
  • наличните Linux/Windows client пакети.

Имената зависят от включените клиенти, но публичната версия е semantic version, например 0.1.3.

Инсталиране

mkdir -p ~/digivc-install
cd ~/digivc-install
tar -xJf /path/to/DigiVC-Release-*.tar.xz
cd DigiVC-Release-*
sudo ./install-digivc-server

Инсталаторът трябва да:

  1. провери bundle manifest-а и checksums;
  2. осигури нужния PostgreSQL client (psql и pg_isready);
  3. инсталира Server RPM;
  4. подготви systemd услугите и защитената runtime конфигурация;
  5. покаже URL и еднократен setup token за WEB настройката.

Първоначална WEB настройка

Отворете URL адреса, показан от инсталатора, и въведете setup token-а.

1. PostgreSQL

Изберете:

  • Local — PostgreSQL е на същата машина;
  • Remote — PostgreSQL е на друг сървър.

При remote връзка задайте host, port, PostgreSQL admin role и парола.

PostgreSQL SSL mode

РежимКога се използва
disablePostgreSQL няма SSL и връзката е в защитена вътрешна мрежа
preferОпитва SSL, но може да премине без него
requireИзисква криптирана връзка, без проверка на CA/hostname
verify-caИзисква SSL и проверява издаващия CA
verify-fullИзисква SSL, CA и съвпадение на hostname; най-строгият режим

Пример: remote PostgreSQL 10.10.0.40, който не поддържа SSL:

Database mode: Remote
Host: 10.10.0.40
Port: 5432
SSL mode: disable

2. WEB transport

Изберете как DigiVC слуша вътрешно:

  • HTTP — подходящо зад Digi Wall или друг reverse proxy, който завършва HTTPS;
  • HTTPS — DigiVC сам обслужва TLS.

Вътрешният listener и публичният адрес са различни настройки. Например:

DigiVC listener: HTTP
Bind: 0.0.0.0:8000
Public URL: https://digivc.company.example

При HTTP DigiVC не трябва да изисква или създава TLS key/certificate. При HTTPS инсталаторът създава и валидира необходимите TLS материали.

3. Първи администратор

Задайте:

  • username;
  • email;
  • display name;
  • парола и потвърждение.

Минималната дължина е 8 символа. Няма самоволно задължително изискване за специални символи, цифри или 12/14 символа.

След инсталацията

  1. Отворете public URL.
  2. Влезте с първия administrator account.
  3. Проверете Система и Операции.
  4. Създайте първия project и repository.
  5. Инсталирайте подходящия Desktop Client на работните станции.

Обновяване

Използвайте новия release bundle и включения lifecycle/installer workflow. Не заменяйте ръчно файлове в /opt, не редактирайте криптираната конфигурация и не изтривайте Vault Storage или PostgreSQL данните.