Ручная установка и настройка web-сервиса «sauk access»
и базы данных mysql под windows
и базы данных mysql под windows
Установка и настройка Web-сервиса «SAUK Access» и базы данных MySQL под Windows
Если на компьютере уже установлена какая-либо версия продукта, его нужно полностью удалить (включая папку установки) и провести повторную установку и настройку согласно настоящей инструкции.
1. Установка ASP.NET
Текущая версия ПО «SAUK Access» работают под управлением .NET 8.0. Необходимо обеспечить наличие данного пакета на компьютере, где будет инсталлироваться ПО. Для работы программного обеспечения требуется установка дистрибутива ASP.NET Core Runtime 8.0 Hosting Bundle. Это программное обеспечение скачивается с сайта Microsoft и устанавливается самостоятельно. На момент написания инструкции рекомендуемый дистрибутив Hosting Bundle именуется как dotnet-hosting-8.0.20-win.exe. После установки данного ПО необходимо обязательно перезагрузить компьютер.
2. Установка дистрибутива Web-сервиса «SAUK Access»
Рассмотрим рекомендованный стандартной путь к директории установки «SAUK Access», по умолчанию C:\inetpub\wwwroot\. Папку дистрибутива Sauk Access со всеми располагающимися в ней файлами и каталогами скопируйте именно в эту папку, смотри рисунок 7.
1. Проверьте файлы приложения. Убедитесь, что в папке Sauk Access есть все необходимые файлы, включая:
2. Протестируйте запуск вручную.
1. Проверьте файлы приложения. Убедитесь, что в папке Sauk Access есть все необходимые файлы, включая:
- SaukAccess.dll; web.config; appsettings.json
- Папка wwwroot со статическими файлами (стили, иконки и прочие файлы)
2. Протестируйте запуск вручную.
- Откройте Командную строку или PowerShell от имени администратора.
- Перейдите в папку с вашим приложением: SaukAccess
- Запустите приложение: dotnet SaukAccess.dll
- Если приложение запустилось без ошибок и вы видите сообщение вроде
.Now listening on: http://localhost:5000, значит, всё в порядке. - Нажмите Ctrl+C для остановки.
3. Установка MySQL Server
Текущая версия ПО «SAUK Access» работают c бесплатной базой данных MySQL. Дистрибутив MySQL скачивается самостоятельно с сайта разработчика MySQL, протестированный дистрибутив имеет наименование MySQL Installer community 8.0.43.0.msi. Состав дистрибутива должен иметь следующие версии компонентов
MySQL Server 8.0.43, MySQL Workbench 8.0.43. Ссылка для загрузки http://dev.mysql.com/downloads/installer/.
Более подробно инструкция по установке MySQL Server и MySQL Workbench представлена дальне по тексту настоящей инструкции, в разделе 8.5.
MySQL Server 8.0.43, MySQL Workbench 8.0.43. Ссылка для загрузки http://dev.mysql.com/downloads/installer/.
Более подробно инструкция по установке MySQL Server и MySQL Workbench представлена дальне по тексту настоящей инструкции, в разделе 8.5.
4. Установка WEB-сервера
Существует множество сервисов, которые можно выбрать в качестве WEB-сервера. Рассмотрим некоторые из них, а именно – входящий в поставку профессиональной версии ОС Windows 10 и 11 WEB-сервер IIS и более стабильный, более надежный и эффективный WEB-сервер nginx. Рекомендуем остановиться на nginx.
5. Инсталляция и настройка nginx
☑ Приложение запускается фоновый процесс на определенном порту (по умолчанию http://localhost:5000).
☑ Nginx работает как обратный прокси-сервер (reverse proxy). Он принимает все входящие HTTP-запросы, по умолчанию по 80-му из локальной сети или интернета и "перенаправляет" их приложению SAUK Access.
Шаг А. Еще раз убедитесь, что все основные файлы из пункта 8.2 на месте.
Шаг Б. Установка и настройка nginx
1. Скачайте nginx
2. Установите nginx
3. Настройте nginx как обратный прокси
☑ Nginx работает как обратный прокси-сервер (reverse proxy). Он принимает все входящие HTTP-запросы, по умолчанию по 80-му из локальной сети или интернета и "перенаправляет" их приложению SAUK Access.
Шаг А. Еще раз убедитесь, что все основные файлы из пункта 8.2 на месте.
Шаг Б. Установка и настройка nginx
1. Скачайте nginx
- Зайдите на официальный сайт nginx https://nginx.org/en/download.html.
- Скачайте последнюю стабильную версию для Windows, nginx/Windows-x.x.x.
2. Установите nginx
- Распакуйте скачанный архив в удобное место. Например, в C:\nginx\.
- Важно: Путь к папке не должен содержать русских букв или пробелов. Идеальный вариант — C:\nginx\
3. Настройте nginx как обратный прокси
- Откройте файл конфигурации C:\nginx\conf\nginx.conf в текстовом редакторе (например, Notepad++ или в обычном блокноте).
- Найдите блок server и измените его, чтобы он выглядел следующим образом.
# Основные настройки работы nginx
worker_processes 1;
events{
worker_connections1024;
}
http{
include mime.types;
default_type application/octet-stream;
sendfileon;
keepalive_timeout65;
# Настройкидлявашегоприложения ASP.NET Core
server{
# nginx будет слушать порт 80
listen 80;
# Укажите ваше доменное имя или localhost, лучше вводить 127.0.0.1
server_name 127.0.0.1;
# Настройка для обработки статических файлов
# nginx будет отдавать файлы из папки wwwroot напрямую, что эффективнее
location ~* \.(css|js|jpg|jpeg|png|gif|ico|woff|ttf|svg)$ {
rootC:/inetpub/wwwroot/SaukAccess/wwwroot;
expires30d;
add_header Cache-Control "public, immutable";
}
# Все остальные запросы перенаправляем на порт 5000
location / {
proxy_pass http://localhost:5000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass$http_upgrade;
}
}
}
worker_processes 1;
events{
worker_connections1024;
}
http{
include mime.types;
default_type application/octet-stream;
sendfileon;
keepalive_timeout65;
# Настройкидлявашегоприложения ASP.NET Core
server{
# nginx будет слушать порт 80
listen 80;
# Укажите ваше доменное имя или localhost, лучше вводить 127.0.0.1
server_name 127.0.0.1;
# Настройка для обработки статических файлов
# nginx будет отдавать файлы из папки wwwroot напрямую, что эффективнее
location ~* \.(css|js|jpg|jpeg|png|gif|ico|woff|ttf|svg)$ {
rootC:/inetpub/wwwroot/SaukAccess/wwwroot;
expires30d;
add_header Cache-Control "public, immutable";
}
# Все остальные запросы перенаправляем на порт 5000
location / {
proxy_pass http://localhost:5000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass$http_upgrade;
}
}
}
- Для только что установленного nginx допускается полное копирование содержимого нижеуказанного листинга.
- ВАЖНО: в пути для статических файлов (root C:/...) используйте прямые слеши / вместо обратных \.
4. Запустите nginx.
- Откройте Командную строку CMD от имени администратора.
- Перейдите в папку nginx: cd C:\nginx
- Запустите его: start nginx
- Проверить, что процесс запустился
можно командой tasklist /fi "imagename eq nginx.exe", если в ответ в консоли не появилось никаких сообщений, то процесс не запустился, нужно перепроверить предыдущие действия.
5. Скачайте утилиту winsw (Windows Service Wrapper).
- Перейдите на страницу релизов проекта: https://github.com/winsw/winsw/releases
- Скачайте файл WinSW-x64.exe (для 64-битной системы).
- Переименуйте скачанный файл в SaukAccessService.exe.
- Положите этот файл в папку приложением Sauk Access.
6. Создайте файл конфигурации службы.
- В той же папке создайте XML-файл SaukAccessService.xml.
- Откройте его и напишите конфигурацию в синтаксисе xml:
<service>
<id>SaukAccessApp</id>
<name>SaukAccess Application Service</name>
<description>Этаслужбазапускаетприложение SaukAccess ASP.NET 8.0</description>
<executable>dotnet</executable>
<arguments>SaukAccess.dll --urls=http://localhost:5000</arguments>
<workingdirectory>%BASE%</workingdirectory>
<log mode="roll"></log>
<startmode>Automatic</startmode>
</service>
<id>SaukAccessApp</id>
<name>SaukAccess Application Service</name>
<description>Этаслужбазапускаетприложение SaukAccess ASP.NET 8.0</description>
<executable>dotnet</executable>
<arguments>SaukAccess.dll --urls=http://localhost:5000</arguments>
<workingdirectory>%BASE%</workingdirectory>
<log mode="roll"></log>
<startmode>Automatic</startmode>
</service>
7. Установите службу SaukAccessService
8. Запустите службу SaukAccessService
9. Установка службы nginx
- Откройте Командную строку от имени администратора.
- Перейдите в папку SaukAccess.
- Выполните команду: SaukAccessService.exe install
- Если всё прошло успешно, вы увидите сообщение об успешной установке.
8. Запустите службу SaukAccessService
- Вы можете запустить её из командной строки: SaukAccessService.exe start
- Или через оснастку "Службы" (жмём Win+R, вводим services.msc), находите в списке "SaukAccess Application Service" и запускаете её.
9. Установка службы nginx
- аналогичные шаги с 5 по 8 пункты для приложения WEB-сервера nginx, ниже перечисляется основные нюансы:
- Скачайте winsw с официальной страницы (например, WinSW-x64.exe).
- Переименуйте скачанный файл nginx-service.exe. Положите этот файл в папку C:\nginx\ (рядом с nginx.exe).
- Создайте файл конфигурации в синтаксисе xml
<service>
<id>nginx</id>
<name>Nginx Web Server</name>
<description>High Performance Nginx Web Server</description>
<executable>C:\nginx\nginx.exe</executable>
<logpath>C:\nginx\logs</logpath>
<log mode="roll-by-size"></log>
<startmode>Automatic</startmode>
</service>
<id>nginx</id>
<name>Nginx Web Server</name>
<description>High Performance Nginx Web Server</description>
<executable>C:\nginx\nginx.exe</executable>
<logpath>C:\nginx\logs</logpath>
<log mode="roll-by-size"></log>
<startmode>Automatic</startmode>
</service>
Шаг Г. Проверка работы
- Убедитесь, что служба Sauk Access Application Service работает (Status = "Running").
- Убедитесь, что процесс nginx.exe работает.
- Откройте браузер и перейдите по адресу http://localhost. Если вы указали в server_name другое имя (например, saukaccess.local), нужно добавить запись в файл C:\Windows\System32\drivers\etc\hosts.
- Ваше приложение должно открыться. Nginx принял запрос на 80-м порту и перенаправил его вашему приложению на порту 5000.
6. Инсталляция и настройка Microsoft IIS
В Профессиональной версии ОС Microsoft Windows доступен WEB-сервер Microsoft IIS. В зависимости от текущих настоек ОС может потребоваться провести установку и настройку IIS. Описанный ниже набор может отличаться от текущих настроек ОС, если ранее они уже были сделаны на данной машине. Изменять компоненты без проверки работоспособности других сервисов системы не рекомендуется.
Включите компоненты IIS. Откройте Панель управления → Программы → Включение или отключение компонентов Windows. Убедитесь, что включены следующие компоненты из перечня:
☑ Internet Information Services (Службы IIS)
☑ Web Management Tools (Службы управления сайтом)
☑ IIS Management Console (Консоль управления IIS)
☑ World Wide Web Services (Службы Интернета)
☑ Application Development Features (Компоненты разработки приложений)
☑ ISAPI Extensions (Расширения ISAPI)
☑ ISAPI Filters (Фильтры ISAPI)
☑ Common HTTP Features (Общие функции HTTP)
☑ Default Document (Документ по умолчанию)
☑ Directory Browsing (опционально, Перенаправление HTTP)
☑ HTTP Errors (Ошибки HTTP)
☑ Static Content (Статическое содержимое)
После выбора необходимых компонентов IIS и ASP.Net необходимо принять изменения и дождаться завершения операции принятия изменения ОС.
Включите компоненты IIS. Откройте Панель управления → Программы → Включение или отключение компонентов Windows. Убедитесь, что включены следующие компоненты из перечня:
☑ Internet Information Services (Службы IIS)
☑ Web Management Tools (Службы управления сайтом)
☑ IIS Management Console (Консоль управления IIS)
☑ World Wide Web Services (Службы Интернета)
☑ Application Development Features (Компоненты разработки приложений)
☑ ISAPI Extensions (Расширения ISAPI)
☑ ISAPI Filters (Фильтры ISAPI)
☑ Common HTTP Features (Общие функции HTTP)
☑ Default Document (Документ по умолчанию)
☑ Directory Browsing (опционально, Перенаправление HTTP)
☑ HTTP Errors (Ошибки HTTP)
☑ Static Content (Статическое содержимое)
После выбора необходимых компонентов IIS и ASP.Net необходимо принять изменения и дождаться завершения операции принятия изменения ОС.
6.1 Настройка Microsoft IIS
Рисунок 9. Директория wwwroot с каталогом Web-сервиса SAUK Access.
Переходим в Панель управления -> Система и безопасность -> Администрирование -> Диспетчер служб IIS. Или второй способ - Win+R в появившейся командной строке ввести inetmgr.
- В появившемся окне Диспетчер служб IIS В Пуле приложений необходимо убедиться, что в схеме по умолчанию (DefaultAppPool) версия среды CLR .NET выбрана как «Без управляемого кода», а режим управляемого конвейера выбран как «Встроенный» (рисунок 10).
- В директории «Сайты» удаляем демонстрационный WEB-сайт «Default Web Site»
- Правой кнопкой мыши щелкаем по «Сайты», из ниспадающего меню выбираем пункт «Добавить WEB-сайт» (Рисунок 11). В появившемся окне вводим название сайта и путь к директории, в которой физически находятся файлы приложения SAUK Access, пул приложений выбрать DefaulAppPool. Нажимаем ОК.
Рисунок 10. Настройка пула приложений по умолчанию
Рисунок 11. Преобразование каталога Sauk Access в приложение
Теперь необходимо проверить правильность настройки IIS. В командной строке браузера вводим адрес http://localhost. Должен загрузиться сайт, развертываемый IIS по умолчанию, то есть – WEB приложение SAUK. Если сайт не загружается, проверьте ранее сделанные настройки еще раз. Для доступа к ресурсу с другого компьютера сети используем IP-адрес сервера.
7. Установка базы данных MySQL
Предварительно необходимо загрузить последнюю версию MySQL с официального сайта разработчика http://dev.mysql.com. На момент написания инструкции доступна версия offline инсталлятора MySQL Installercommunity 8.0.43.0.msi.
Дождавшись окончания загрузки дистрибутива, начните установку.
Устанавливаемые пароли достаточно просты, пароли используются временно на время развертывания приложения. В последующем все стандартные следует поменять.
______________________________________________________________________________
Дождавшись окончания загрузки дистрибутива, начните установку.
- Install MySQL Products
- Выбрать тип установки Custom и продолжить установку.
- Приступаем к конфигурированию MySQL. Выбираем компоненты MySQL Server 8.0.43, MySQL Workbench 8.0.43. Продолжаем NEXT. При установке будет предложено выбрать тип конфигурации – выбираем Developer Machine, номер порта – вводим 3306 (Рисунок 12).
- В окне (рисунок 13) вводим и запоминаем пароль для доступа пользователя root, например, 111111. Добавляем нового пользователя user с правами администратора (Рисунок 14), вводим пароль, например, 111111. Заканчиваем установку (Рисунок 15) – далее по окнам оставлять параметры по умолчанию и нажимать Next.
Устанавливаемые пароли достаточно просты, пароли используются временно на время развертывания приложения. В последующем все стандартные следует поменять.______________________________________________________________________________
Рисунок 12. Настраиваем параметры запуска доступа к серверу MySQL
Рисунок 13. Добавление пользователей
Рисунок 14. Завершение установки и запуск сервиса MySQL. Название сервиса по умолчанию (в данном случае MySQL57) зависит от версии установленного MySQL Server.
Рисунок 15. Завершение установки – применение параметров и запуск всех служб MySQL
8. Настройка Базы данных
После установки MySQLможно выполнить развертывание БД с таблицами, которые ранее уже были сформированы (если вы переносите систему с одного компьютера на другой). Если вы впервые работаете с этим программным обеспечением, то пункт нужно пропустить (база данных будет создана автоматически при первом запуске программного обеспечения).
Пуск -> Все программы -> MySQL -> MySQL Workbench (Рисунок 16). Произвести клик на вкладку Local instance MySQL__, ввести логин и пароль одного из пользователей, заведенных в систему на этапе установки.
Пуск -> Все программы -> MySQL -> MySQL Workbench (Рисунок 16). Произвести клик на вкладку Local instance MySQL__, ввести логин и пароль одного из пользователей, заведенных в систему на этапе установки.
Рисунок 16. Главное окно MySQL Workbench
Переходим во вкладку Management -> Data Import / Restore. Выбираем дамп, в котором хранится конфигурация БД, описатели таблиц и примеры записей. Файл дампа распространяется с дистрибутивом либо предоставляется клиенту по запросу в случае заполнения (или частичного заполнения) базы данных на нашем производстве по согласованию с клиентом.
9. Проверка работоспособности Web-Сервиса SAUK
В командной строке браузера введите путь https://localhost/
При успешном выполнении всех вышеописанных пунктов Программное обеспечение SAUK Access отобразится на странице Вашего WEB-браузера.
При успешном выполнении всех вышеописанных пунктов Программное обеспечение SAUK Access отобразится на странице Вашего WEB-браузера.
SAUK© 2020 – 2025. Все тексты и изображения, представленные на сайте, являются интеллектуальной собственностью SAUK. Могут быть использованы только по письменному согласию SAUK. SAUK® является зарегистрированным торговым знаком.