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

 

Настройка файла конфигурации приложения appsettings.json

Сервер обязан работать в режиме безопасного контекста(https)!

Необходимо открыть файл appsettings.json, расположенный в корневом каталоге сервера, с помощью любого текстового редактора.

{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:5001"
      },
      "Https": {
        "Url": "https://localhost:5000",
        "Certificate": {
          "Path": "YOUR_CERT_PATH",
          "Password": "CERT_PASSWORD"
        }
      }
    }
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  }
}

Необходимо заполнить следующие поля:

НаименованиеОписаниеПример
Url

Адрес, по которому будет доступен сервер.

Настраивается как для http, так и для https.

https://127.0.0.1:5000

http://127.0.0.1:5001

Path

Путь до сертификата.

Сертификат должен иметь расширение *.pfx


Certs/cert.pfx
PasswordПароль сертификата123456
{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://127.0.0.1:5001"
      },
      "Https": {
        "Url": "https://127.0.0.1:5000",
        "Certificate": {
          "Path": "Certs/cert.pfx",
          "Password": "123456"
        }
      }
    }
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  }
}

Далее запустите файл Pulsar.M2M.Server


В случае использования приложения на локальной машине в демонстрационных целях, блок HTTPS можно не настраивать.

Пример конфигурации приложения без блока HTTPS:

{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://127.0.0.1:5001"
      }
    }
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  }
}

Навигация

Навигация между этапами настройки осуществляется при помощи кнопок "Далее" и "Назад". Если кнопка является активной, переход будет осуществлен. 

Кроме этого навигацию можно осуществлять при помощи блока управления под формой. 

Цветовая схема панели навигации обозначает следующее:

asdfasfadsf  - Доступно для навигации

- Выбранный этап навигации

- Запрещено для навигации 

Настройка базы данных

Первым этапом настройки является настройка базы данных. Настройка базы данных выполняется в форме, содержащей две кнопки: "Тест" и "Далее".  Кнопка "Далее" по умолчанию является не активной.  В представленной форме необходимо корректно заполнить все существующие поля, которые должны совпадать с существующей базой данных. Для проверки корректного заполнения данных и тестирования подключения в правом нижнем углу формы находится кнопка "Тест". При нажатии на эту кнопку проверяется соединение с базой данных. Если произошла ошибка соединения, в правом верхнем углу страницы будет отображено сообщение об ошибке. В данном случае необходимо проверить введенные данные, при необходимости изменить их, и повторить попытку. При успешном соединении в правом верхнем углу страницы будет выведено уведомление об успешном соединении, а кнопка "Далее" станет активной.  При нажатии на кнопку "Далее", будет осуществлен переход к следующему этапу настройки. 

Обратите внимание, что при успешном тестировании подключения к базе данных, последующие изменения формы потребуют повторного тестирования, а навигация к следующим этапам настройки будет заблокирована.  

Настройка  администратора

Вторым этапом настройки является настройка администратора. Настройка администратора выполняется в форме, содержащей две кнопки "Назад" и "Создать". При нажатии на кнопку "Назад", будет осуществлен переход к предыдущей форме настроек. В представленной форме все поля должны быть заполнены.

Для создания администратора, после заполнения формы необходимо нажать кнопку "Создать".

Если форма не проходит валидацию (несовпадение паролей, длина пароля менее 8 символов), в правом верхнем углу страницы будет выведено уведомление.

Если форма проходит валидацию, будет выведено модальное окно для подтверждения сохранения настроек. 

Данное модальное окно необходимо для сохранения настроек базы данных и администратора и содержит две кнопки "ОК" и "Отмена". При нажатии кнопки "Отмена", модальное окно закрывается и появляется возможность редактирования данных предыдущих этапов настройки. При нажатии кнопки "ОК" происходит сохранение введенных данных. 

Обратите внимание, что после нажатия кнопки "ОК", отменить это действие и внести изменения в веденные данные будет невозможно. 

После подтверждения сохранения настроек появится модальное окно с отображением прогресса сохранения.

По умолчанию возможность закрытия данного модального окна отсутствует, однако при возникновении ошибки кнопка "Закрыть" и крестик в верхнем правом углу модального окна становятся доступными. Уведомление об ошибке появится в верхнем правом углу страницы. Если настройки сохранены успешно, модальное окно закроется и автоматически будет осуществлен переход на страницу, уведомляющую об успешном сохранении настроек. 

Заключительный этап

При успешном сохранении настроек об этом выводится уведомление, а сервер автоматически останавливается. 

Обратите внимание, что после сохранения настроек, отсутствует возможность вернуться к предыдущим этапам.