¶ Описание поставляемых файлов
Дистрибутивы: https://disk.yandex.ru/d/Y7fxG0Ch5VSqEQ
В папке по ссылке лежат дополнительные материалы и актуальный дистрибутив, старые версии вы можете найти в папке Old. Каждый дистрибутив содержит следующие файлы (набор в старых версиях может отличаться):
- CC-Server_x64.tar.gz - сервер.
- CC-Server_x64.tar.gz.txt - хэш суммы CC-Server_x64.tar.gz
- Pilot Database Configuration.pilotcfx - конфигурация базы данных.
- README.txt - содержит ссылку на документацию и дополнительные сведения о релизе (может отсутствовать).
¶ Сервер
¶ Установка на Windows
- Установить IIS (Internet Information Services)
- Установить Hosting Bundle .NET 8 (смотрите раздел ASP.NET Core Runtime)
- Скачать и распаковать
CC-Server_x64.tar.gz. Распакуйте архив в папку Lmp.CC-Server (если данная папка отсутствует в архиве, в противном случае просто распакуйте), при необходимости данная папка может быть перемещена в любое удобное место.
Если после распаковки появился файл
.tar, то архив распакован не до конца. В этом случае необходимо повторить шаг 3 для полученного.tarфайла.
Перед дальнейшей настройкой выполните шаги из раздела "Настройка Lmp.CC-Server"
- Для ранее распакованной папки проверьте наличие полных прав на папку для пользователя
IIS_IUSRS. Для этого откройте свойства папки и перейдите на вкладку безопасность, в таблице должен быть данный пользователь, если пользователь отсутствует - добавьте его и установите полные права. - Открыть
Диспетчер служб IIS, добавить новый веб-сайт. Заполнить необходимые параметры с учетом требований к безопасности в вашей организации, для параметраФизический путьукажите ранее распакованную папку (Lmp.CC-Server). - Перейдите в раздел
Пулы приложений, в данном разделе найдите одноименный с сайтом пул. - Нажмите на нем 2 раза, для параметра
Версия среды CLR.NETустановите значениеБез управляемого кода - На том же пуле нажмите правую кнопку мыши, выберите
Дополнительные параметры, установите для параметраТайм-аут простоя (в минутах)значение 0. - Настройте https
Мобильное приложение работает исключительно по протоколу https, SSL сертификат должен быть от доверенного центра сертификации (самоподписанный не подойдет).
- Запустите или перезапустите сайт и пул.
- Проверьте доступность сервиса открыв в браузере ссылку следующего формата
[address]/api, при корректной настройке данный запрос вернет в качестве ответа json с информацией о сервисе.
¶ Установка на Linux
- Скачать и установить ASP.NET Core Runtime 8
- Скачать и распаковать
CC-Server_x64.tar.gzв/opt/lmp-project-group
sudo tar -xzvf CC-Server_x64.tar.gz -C /opt/lmp-project-group
Перед дальнейшей настройкой выполните шаги из раздела "Настройка Lmp.CC-Server"
- Создать нового пользователя
ConstructionControl
sudo useradd ConstructionControl -M -N -g daemon -s /bin/false
- Выдать созданному пользователю соответствующие права для папки
/opt/lmp-project-group/Lmp.CC-Server
sudo chown -R ConstructionControl:daemon /opt/lmp-project-group/Lmp.CC-Server
sudo chmod -R 744 /opt/lmp-project-group/Lmp.CC-Server
- Создать сервис
lmp-cc-server.service(замените$$DOTNET$$на соответствующую команду)
sudo cat << EOF > /etc/systemd/system/lmp-cc-server.service
[Unit]
Description=Pilot construction control service for the Pilot system. Copyright LMP Project Group.
[Service]
WorkingDirectory=/opt/lmp-project-group/Lmp.CC-Server
ExecStart=$$DOTNET$$ /opt/lmp-project-group/Lmp.CC-Server/PilotConstructionControlService.dll --urls "http://*:6666"
KillSignal=SIGINT
SyslogIdentifier=lmp-cc-server
User=ConstructionControl
[Install]
WantedBy=multi-user.target
EOF
- Включите и запустите созданный сервис
sudo systemctl daemon-reload
sudo systemctl enable lmp-cc-server.service
sudo systemctl start lmp-cc-server.service
- Сервис будет запущен на порте
6666, при необходимости это можно изменить в файле сервиса. Проверьте доступность сервиса открыв в браузере ссылку следующего формата[address]/api, при корректной настройке данный запрос вернет в качестве ответа json с информацией о сервисе. - Настройте Nginx (или аналогичный веб‑сервер) для работы по протоколу HTTPS.
Мобильное приложение работает исключительно по протоколу https, SSL сертификат должен быть от доверенного центра сертификации (самоподписанный не подойдет).
¶ Настройка Lmp.CC-Server
- Перейдите в папку, появившуюся после распаковки (или в папку куда ранее была произведена установка).
- Откройте любым доступным текстовым редактором файл
appsettings.json. - Заполните следующие параметры:
- Секция Serilog - отвечает за настройку провайдера логирования. Для Windows рекомендуется изменить значение параметра
pathрасположенного в объекте с параметром"Name": "File"в секцииWriteToна<путь к папке ProgramData>\LMP Project Group\Lmp.CC-Server\Logs\.log(необходимо экранировать символ\, для этого достаточно заменить данные символы на\\). При необходимости данная секция может быть переопределена администратором знающим движок логирования Serilog.
Обычно папка
ProgramDataрасполагается на системном диске и скрыта. Для быстрого перехода к данной папке нажмитеWin + R, в появившемся окне введите%programdata%и нажмитеEnter.
- Секция JWT - отвечает за управление токенами и сессиями:
- LifetimeAccessTokenMinutes - время жизни токена доступа (рекомендуемое значение: 10),
- LifetimeRefreshTokenMinutes - время жизни токена обновления токенов (рекомендуемое значение: 60),
- IdleTimeoutMinutes - тайм-аут сессии (рекомендуемое значение: 60),
- CheckIdleTimeoutMinutes - интервал проверки сессий на тайм-аут (рекомендуемое значение: 4).
- Секция Pilot - отвечает за подключение к Pilot-Server:
- Server - полная строка подключения к серверу Pilot (Например: http://10.10.10.100:5545),
- ProjectTypes - массив строк, где строка это название типа представляющего проект.
¶ Обновление на Windows
- Открыть Диспетчер служб IIS. Перейти в раздел Пулы приложений.
- Найдите нужный пул и остановите его.
- Скачать и распаковать
CC-Server_x64.tar.gz. Распакуйте архив в папку Lmp.CC-Server (если данная папка отсутствует в архиве, в противном случае просто распакуйте).
Если после распаковки появился файл
.tar, то архив распакован не до конца. В этом случае необходимо повторить шаг 3 для полученного.tarфайла.
- Перейти в данную папку и удалить файл
appsettings.json - Скопировать (с заменой) все файлы из папки в папку указанную для созданного при установке сайта.
- Перейти в раздел Пулы приложений. Запустите ранее остановленный пул.
¶ Обновление на Linux
- Скачать
CC-Server_x64.tar.gz - Остановить сервис
sudo systemctl stop lmp-cc-server.service
- Создать копию конфигурационного файла
sudo cp -f /opt/lmp-project-group/Lmp.CC-Server/appsettings.json /opt/lmp-project-group/Lmp.CC-Server/appsettings.json.backup
- Распаковать
CC-Server_x64.tar.gzв/opt/lmp-project-group
sudo tar -xzvf CC-Server_x64.tar.gz -C /opt/lmp-project-group
- Восстановить старый конфигурационный файл
sudo cp -f /opt/lmp-project-group/Lmp.CC-Server/appsettings.json.backup /opt/lmp-project-group/Lmp.CC-Server/appsettings.json
- Восстановить права для папки
/opt/lmp-project-group/Lmp.CC-Server
sudo chown -R ConstructionControl:daemon /opt/lmp-project-group/Lmp.CC-Server
sudo chmod -R 744 /opt/lmp-project-group/Lmp.CC-Server
- Запустить сервис
sudo systemctl start lmp-cc-server.service
¶ Мобильное приложение
Распространение мобильного приложения "СтройКонтроль" ("ConstructionControl") осуществляется через официальные магазины приложений в зависимости от операционной системы устройства:
Установка производится пользователем самостоятельно. Нужно скачать в соответствующем магазине и выполнить штатную процедуру установки, предусмотренную операционной системой.