Замена служебной базы данных

Замена служебной базы данных#

При необходимости служебную БД можно заменить, выполнив следующие шаги (принимается, что продукт установлен в директории по умолчанию).

  1. Остановите службу веб-консоли.

    > net stop CPServerBackend
    
    # systemctl stop CPServerBackend
    
  2. Отредактируйте конфигурационный файл.

    C:\Program Files\Cyber Protego Server\backend\CPServerBackend.yml

    /opt/cyberprotect/cpserver/CPServerBackend.yml

    В файле укажите диалект базы данных: mssql или postgres. Второй вариант также необходимо выбирать для Jatoba/Tantor. Например:

    db:
      dialect: mssql
    

    Также укажите следующие параметры:

    • host — IP-адрес или имя хоста, на котором работает сервер БД.

    • port — порт сервера БД; игнорируется при указании именованного экземпляра (named instance) для диалекта mssql.

    • user — имя пользователя БД.

    • password — пароль пользователя БД.

    • database — имя служебной БД; если такой базы данных не существует, она будет создана.

    • sslMode (только для диалекта postgres) — режим SSL-соединения; возможные значения: disable, require, verify-ca, verify-full.

    Например:

    db:
      dialect: mssql
      mssql:
        host: 10.10.10.10
        port: 1433
        user: sa
        password: strong_password
        database: NewCyberProtegoSDB
    

    или

    db:
      dialect: postgres
      <...>
      postgres:
        host: 10.10.10.10
        port: 5432
        user: postgres
        password: strong_password
        database: NewCyberProtegoSDB
        sslMode: disable
    
  3. Если необходимо, примените к новой БД требуемую схему. Изначально она применяется к БД автоматически при установке веб-консоли. При смене базы данных, к новой БД также необходимо применить требуемую схему, если ранее этого не выполнялось.

    В случае, если к новой БД актуальная схема уже была применена (например, БД меняется на одну из использованных ранее), то применять схему еще раз не требуется, и этот шаг можно пропустить.

    Примечание

    Если на момент применения схемы БД еще не существует, она будет создана автоматически.

    Чтобы применить схему к БД, выполните следующую команду:

    Из директории C:\Program Files\Cyber Protego Server\backend

    > CPServerBackend.exe migrate-db --config="CPServerBackend.yml"
    

    Из директории /opt/cyberprotect/cpserver/backend

    # ./CPServerBackend migrate-db --config='../CPServerBackend.yml'
    

    Пример вывода в случае успешного выполнения команды:

    migration/mssql/20230210959000_init_report_tasks
    migration/mssql/20230210959000_init_roles
    migration/mssql/20230210959000_init_users
    migration/mssql/20230210959000_init_public
    
  4. Запустите остановленную ранее службу:

    > net start CPServerBackend
    
    # systemctl start CPServerBackend