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

1. Скопируйте файл D:\Stack\Stack.Srv\Bin\ini\stack.ini в каталог D:\Stack\Stack.Srv\Bin\0

2. Откройте скопированный файл и отредактируйте следующие строчки:

Server=127.0.0.1 – имя SQL сервера или IP адрес

Base=base – имя базы данных

Schema=base.stack – имя схемы (имя_базы.stack)

Например:

Server=SQL-server

Base=Stack-IT

Schema= Stack-IT.stack

Сохраните и закройте stack.ini

3. Скопируйте и переименуйте каталог D:\Stack\Stack.Srv\Bin\0, например, в D:\Stack\Stack.Srv\Bin\0_0

4. Запустите из скопированного каталога файл stack.exe (D:\Stack\Stack.Srv\Bin\0_0\stack.exe)

5. Введите логин SA и пароль. После загрузки согласитесь на предложение конвертировать БД и пройдите по всем шагам конвертации. Обратите внимание, при конвертации таблиц не должно быть удаляемых полей. Если такие присутствуют, и вы не уверены в дальнейших действиях, следует обратится в компанию разработчика!

# Настройка веб приложений

Далее необходимо создать веб-сервисы в настройке службы диспетчера. Ниже описаны 2 варианта их добавления, автоматический (п.1) и ручной (п.2).

1. Для автоматического создания веб приложений, распакуйте архив NodeJS.7z, например, в папку программы D:\Stack\

1.1 Из получившейся папки (D:\Stack\NodeJS\) скопируйте файл deploy.bat в каталог программы (D:\Stack\)

1.2 Откройте скопированный файл на изменения (ПКМ - Изменить). Исправьте пути и параметры в соответствии с текущими условиями.

<путь_до_каталога_NodeJS>\node.exe <путь_до_каталога_NodeJS>\scripts deploy -task:<перечисленные_задачи_комплекса> -name:<произвольный_префикс> -user:sa -password:<пароль_SA>

Например:

D:\Stack\NodeJS\node.exe D:\Stack\NodeJS\scripts deploy -task:fl,ul,dlg_fl,dlg_ul,kassa -name:stack_app -user:sa -password:450194

1.3 Сохраните deploy.bat и запустите его. Скрипт создаст заданное количество web-приложений и файл env.json, который разместит в папке stack-front, при ее наличии, или в директории откуда запускался deploy.bat

image

Проверить правильность выполнения можно запустив настройку службы диспетчера (D:\Stack\Stack.Client\DispatcherSetup.cmd, пароль: stack). В разделе «Веб-сервер» должно быть несколько приложений:

  • SetupDispatcher – стандартное приложение для веб доступа к настройке диспетчера.
  • front – встроенный веб сервер, подходит для работы до 3-4 пользователей. Если пользователей больше, данное приложение стоит удалить (ПКМ – удалить) и установить внешний веб-сервер (рекомендуется nginx). Его установка будет описана ниже.
  • Несколько приложений вида: <префикс>_<имя_задачи_комплекса> - необходимы для работы соответствующей задачи.
  • <префикс>_share и <префикс>_upload – нужны для загрузки и выгрузки файлов.

image

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

2. Ручное создание веб приложений

2.1 Для ручного добавления веб приложений запустите Диспетчер приложений, для чего перейдите в папку с установленной программой по пути ..\Stack\Stack.Client и запустите файл сценария DispatcherSetup.cmd

image

в открывшемся окне введите пароль "stack" для доступа к настройке службы

image

В левой части окна настройки службы диспетчера программ СТЕК нажмите правой кнопкой мыши на "Веб-сервер" и выберите "Добавить веб-приложение"

image

и задайте имя веб приложения в соответствии с задачей

image

2.2 Сконфигурируйте веб-приложение выбрав его в левой части окна Диспетчера приложений:

2.2.1 Укажите префикс пути в url, для чего в правой части окна выберите нужный параметр, нажмите "Изменить",

image

укажите UrlPathPrefix вида /Stack/stack-front/passport и сохраните его

image

2.2.2 Укажите директорию запуска программ комплекса, прописав путь в формате C:\Stack\Stack.Srv\Bin\0 и сохраните его

image

2.2.3 Задайте параметры запуска программы комплекса указав

-u:sa -p:test -t:169 -LOADRES -nc

где -u: <логин>, -p:<пароль>, -t<задача с которой запускается программа комплекса>, -LOADRES<загрузка ресурсов>, -nc<запуск без конвертации>.

image

Значения параметра -t для запускаемой задачи можно посмотреть в файле ..\Stack\Stack.Srv\DB\Ini\!task_ini, ниже справочно приведены соответствия:

Расчеты с абонентами - физическими лицами (fl)=252

Работа с должниками - физическими лицами (dlg_fl)=278

АРМ кассира (kassa)=11065

Паспортный стол (passport)=169
      
Аварийно-диспетчерская служба (avar)=11061

Подомовой учет (pdu)=253

Расчеты с абонентами - юридическими лицами (ul)=11058

Работа с должниками - юридическими лицами (dlg_ul)=284

Коммуникации (commun)=281

АРМ поставщика (post)=5022

АРМ юриста поставщика (post_ur)=5024

Расчеты с поставщиками (rsp)=279

АРМ администратора комплекса (admin)=11075

2.2.4 В поле FunctionName напишите StackAPI_kvplata_v1

image

2.2.5 В поле ResultContentType укажите application/json;charset=utf-8

image

2.2.6 Для задач кроме share и upload измените параметр UseComStack на "Да"

image

2.2.7 Установите параметр FallbackEnabled в положение "Нет"

image

Остальные значения параметров оставить без изменений.

Повторить пункты 2.2.1-2.2.7 для каждой создаваемой задачи.

2.2.8 Для задач share и upload задать значение параметра StaticContentPath, указав путь вида C:\Stack\Stack.Srv\Bin\publicFiles

image

Изменить параметры: FunctionName указать WebFunction, в параметре ResultContentType вписать text/plain;charset=utf-8, UseComStack поставить в положение "Нет". Кроме того, для задачи share параметр ShareCtaticContent в положение "Да", UploadStaticContent в "Нет", а для задачи upload параметр ShareCtaticContent в положение "Нет", UploadStaticContent в "Да".

3. В папке с фронтом C:\Stack\stack-front скопируйте и переименуйте файл env.example.json в env.json где укажите адрес API_HOST для каждой из созданных задач в соответствии с указанными UrlPathPrefix каждой задачи, например:

{  
"API_HOST": "http://localhost:8080/Stack/stack-front/fl/v1",
"API\_HOST_FL": "http://localhost:8080/Stack/stack-front/fl/v1",
"API\_HOST_AVAR": "http://localhost:8080/Stack/stack-front/avar/v1",
"API\_HOST_ADMIN": "http://localhost:8080/Stack/stack-front/admin/v1",
"API\_HOST_SHARE": "http://localhost:8080/Stack/stack-front/share",
"API\_HOST_UPLOAD": "http://localhost:8080/Stack/stack-front/upload"
}

image

# Работа с Диспетчером программ СТЕК через web-интерфейс

Для конфигурации web-приложений программного комплекса СТЕК через веб-интерфейс необходимо:

1. В адресной строке браузера ввести адрес http://localhost:8080/SetupDispatcher/setup (при работе с удаленного компьютера вместо localhost укажите имя или IP адрес сервера) и выбрать "Веб-сервисы"

image

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

image

Добавление задач осуществляется через Мастер настройки

image

Здесь необходимо указать наименование создаваемой задачи, выбрать задачу, дополнительные службы, указать логин и пароль. Обратите внимание, что мастер заполнит поля "URL подключения" и "StackProgramDir" значениями "по-умолчанию", при необходимости замените их, после чего нажмите "создать" в нижнем правом углу окна мастера.

Так же можно создавать задачи нажав кнопку "+" над верхней частью списка приложений, в таком случае все параметры создаваемой задачи нужно будет указать "вручную".

Задачи share и upload создаются вручную.

image

Значение параметров web-приложений описаны в предыдущем разделе инструкции.