Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Предварительное развертывание

...

  1.  Cкачать пакет с решением и распаковать его в нужное место (по умолчанию - в корень системного диска C: ). На каталог назначить права для пользователя, от имени которого запускается пул приложений.

...

Структура каталога следующая:

  • express - каталог прикладного решения
    • admin - в каталоге лежит веб-интерфейс и все для его настройки
    • app - каталог для размещения сборок мобильного приложения
    • services - каталог с веб-сервисами
  • GrotemServer - каталог, в котором рекомендуется разворачивать сервер Grotem.Mobile
  • solutions - каталог, в котором рекомендуется разворачивать решения (задается в настройках сервера Grotem.Mobile)
  • metadata - каталог с файлами для создания мобильного решения (metadata.xml и т.д.) Image Modifiedскачать

    2. Скачать и распаковать архив сервера Grotem.Mobile по ссылке https://develop.superagent.ru

...

, содержимое архива распаковать и переместить в каталог GrotemServer.

...

Внимание: для работы приложения Grotem.Express необходимо скачивать сервер версии 3. Сервер версии 2 с приложением Grotem.Express не совместим.

В итоге, в каталоге GrotemServer должна получиться следующая структура:

  • bitmobile3 - каталог с сервером Grotem
  • fiscal - сервис фискализации для работы с Атол-Онлайн
  • fiscaldevices - сервис фискализации для работы с физической кассой на сервере (ссылка на инструкцию по установке и настройке)
  • gateway - шлюз для работы с сервером Grotem и другими сервисами
  • synchronization - сервис синхронизации

Image Added


3. На каталог с сервером и прикладным решением назначить права для пользователя, от имени которого запускается пул приложений (желательно создать отдельного пользователя с ролью локального администратора, в примере - пользователь grotem):

Image Added

Установка и настройка сервера Grotem.Mobile

Установка шлюза gateway

В оснастке "

Установка и настройка сервера Grotem.Mobile

Установка серверного приложения

В оснастке "Диспетчер служб IIS" нужно добавить новое приложение. Для этого:

...

  • DataBaseServer - параметры соединения с БД (указать параметры в строке соединения)

    • для смешанной авторизации на SQL строка подключения будет иметь вид server=localhost<адрес_сервера_SQL>;User Id=<username>;Pwd=<password>;Connection Timeout=3600

    • для Windows-авторизации: server=localhost<адрес_сервера_SQL>;Integrated Security=SSPI;Connection Timeout=3600

  • SolutionsFolder - указать каталог для создания решений

  • BitMobileServerId - ID сервера, в случае необходимости - изменить префикс сервераизменить 
  • RootPassword - установить пароль для доступа к серверупароль от сервера

Либо эти параметры можно изменить путем редактирования файла Web.config в каталоге сервера bitmobile3. 

...

Перезапустите пул "bitmobile". Серверное приложение готово к развертыванию мобильных решений.

Проверка работоспособности сервера и шлюза

...

В "Диспетчере служб IIS" правым кликом по папке "Сайты" вызвать контекстное меню, в котором выбрать - "Добавить веб-сайт". В открывшемся окне заполнить параметры:

Имя сайта - syncronization synchronization (пул оставить такой же)

Физический путь - путь до каталога с сервисом синхронизации, из вышеприведенной структуры - synchronization

...

Далее, перейти в Пулы приложений - syncronization synchronization - Основные настройки - Версия среды CLR .NET - Без управляемого кода.

...

Далее, в проводнике Windows открыть каталог syncronizationsynchronization, в нем найти файл appsettings.example.json и скопировать его под именем appsettings.json. В этом файле заполнить секции:заполнить секции:

 "Database": {
 "Prefix": "BitMobile_1_", // число в префиксе должно совпадать с ID сервера
 "Server": "{SQL address}",
 "Login": "{SQL user}",
 "Password": "{SQL user password}"
 },
 "Jwt "Database": {
 "PrefixIssuer": "BitMobile_1_Identity.API",
 "ServerAudience": "{SQL address}http://localhost",
 "LoginExpires": "{SQL user}360",
 "PasswordKey": "{SQL user password}"
 },
 "Jwt": {
 "Issuer": "Identity.API",
 "Audience": "http://localhost",
 "Expires": "360",
 "Key": "{some_big_key_value_here_secret}"
 },

Если есть сервис Elasticsearch, заполнить соответствующую секцию данными для доступа.

После окончания настроек перезапустить пул syncronization.

Настройка сервиса фискализации fiscal

Внимание! разворачивание и настройка сервиса fiscal производится только если требуется работа с сервисом фискализации Атол-онлайн.

Настройка сервиса фискализации также производится по аналогии с остальными.

В "Диспетчере служб IIS" правым кликом по папке "Сайты" вызвать контекстное меню, в котором выбрать - "Добавить веб-сайт". В открывшемся окне заполнить параметры:

Имя сайта - fiscal (пул оставить такой же)

Физический путь - путь до каталога с сервисом синхронизации, из вышеприведенной структуры - fiscal

Подключить как - указать ранее созданного пользователя (в примере - grotem)

Порт - 5002

Далее, перейти в Пулы приложений - syncronization - Основные настройки - Версия среды CLR .NET - Без управляемого кода.

 Далее, в проводнике Windows открыть каталог fiscal, в нем найти файл appsettings.example.json и скопировать его под имененм appsettings.json. В этом файле заполнить секции:

"ConnectionString": "Server={SQL address};Database=FiscalDB;User Id={SQL user};Password={SQL user password};",
 "Urls": {
 "Atol": "{Atol-online URL}"
 },
 "Jwt": {
 "Issuer": "Identity.API",
 "Audience": "http://localhost",
 "Expires": "360", // minute
 "Key": "{some_big_key_value_here_secret}"
 },

Если есть сервис Elasticsearch, заполнить соответствующую секцию данными для доступа.

После окончания настроек перезапустить пул fiscal.

some_big_key_value_here_secret}"
 },

Если есть сервис Elasticsearch, заполнить соответствующую секцию данными для доступа.

После окончания настроек перезапустить пул synchronization.

Настройка сервиса фискализации fiscal

Внимание! разворачивание и настройка сервиса fiscal производится только если требуется работа с сервисом фискализации Атол-онлайн.

Настройка сервиса фискализации также производится по аналогии с остальными.

В "Диспетчере служб IIS" правым кликом по папке "Сайты" вызвать контекстное меню, в котором выбрать - "Добавить веб-сайт". В открывшемся окне заполнить параметры:

Имя сайта - fiscal (пул оставить такой же)

Физический путь - путь до каталога с сервисом синхронизации, из вышеприведенной структуры - fiscal

Подключить как - указать ранее созданного пользователя (в примере - grotem)

Порт - 5002

Далее, перейти в Пулы приложений - fiscal- Основные настройки - Версия среды CLR .NET v.4.

Далее, в проводнике Windows открыть каталог fiscal, в нем найти файл appsettings.example.json и скопировать его под именем appsettings.json. В этом файле заполнить секции:

"ConnectionString": "Server={SQL address};Database=FiscalDB;User Id={SQL user};Password={SQL user password};",
 "Urls": {
 "Atol": "{Atol-online URL}"
 },
 "Jwt": {
 "Issuer": "Identity.API",
 "Audience": "http://localhost",
 "Expires": "360", // minute
 "Key": "{some_big_key_value_here_secret}"
 },

Если есть сервис Elasticsearch, заполнить соответствующую секцию данными для доступа.

После окончания настроек перезапустить пул fiscal.

После запуска сервиса fiscal проверить в БД создание базы FiscalDB. Если база не была создана, то выполнить в командной строке команду:

>dotnet C:\\Grotem\ge_package\GrotemServer\fiscal\Fiscal.API.dll

Image Added

Возможно возникновение ошибок, например, заняты порты 5000 и 5001. В этом случае необходимо выполнить команду с параметрами:

>dotnet C:\\Grotem\ge_package\GrotemServer\fiscal\Fiscal.API.dll --URLs http://localhost:<любой_свободный_порт> //попытка запуска службы на другом порту

или временно переназначить для сервисов "BitMobile" и "Synchronization" порты на другие свободные, выполнить команду и затем вернуть первоначальные настройки. После запуска сервиса fiscal в БД будет создана база FiscalDB.

Разворачивание мобильного решения

...

                        //пример "ANDROID_URL": "http://localhost/express/app/com.grotem.express.apk 
        }
</script>

```

Далее необходимо убедиться в наличии типа MIME. Для этого в оснастке IIS, в корневом разделе, откройте для редактирования типы MIME

Image Added

В открывшемся списке проверьте наличие и при необходимости добавьте расширение файла ".application" с типом "application/x-ms-application"

Image Added

Проверка работоспособности веб-интерфейса

...

В оснастке IIS перейдите на виртуальный каталог express и перейдите в модуль "URL Rewrite".

Image RemovedImage Added

В настройке URL Rewrite создайте одно пустое правило - оно будет выступать в качестве шаблона. Заполним обязательные поля: "Имя", "Шаблон" и "URL-адрес переопределения значением" значением "Template rule" и нажмем "Применить".

...