История страницы

Перед установкой

---

• Проверьте, соответствует ли ваш компьютер(мобильный телефон) требованиям к аппаратному и программному обеспечению

• На компьютере должны быть установлены следующие компоненты:

Интерактивный режим установки серверного приложения (рекомендуется)

Шаг 1. Загрузка

1. Зайдите на страницу загрузки дистрибутива сервера;
2. Найдите ссылку с подходящей вам версией;
3. Если на компьютере уже установлены компоненты SQL,SSMS,IIS,Net Framework, тогда скачать из папки "Only Installer"
4. Если на компьютере отсутствуют компоненты, скачать Full Install, страница помощи при установки компонентов(link)
5. Сохраните установочный файл на ваш компьютер

Шаг 2. Установка

1. Запустить exe

Image Removed

2. Нажать клавишу "Далее"

3. Появится окно со следующими данными, менять не желательно:

• Корневая директория "C:\inetpub\wwwroot\bitmobile\"
• Установить приложение на веб сайт "Default Web Site"
• Указать имя приложения - "bitmobile"
• Указать пул приложений: "DefaultAppPool"

Image Removed

5. Нажать "Далее"
6. Указать пароль для доступа к bitmobile server (не чувствителен)
7. В поле "Сервер" указать сервер для установки bitmobile Server. Если установка предполагается на локальный компьютер, то указываем "localhost"
8. Нажать "Далее"
9. Нажать "Установить"
10. В процессе установки запустится инсталлятор syncFramework 2.1. Следовать инструкциям инсталлятора SyncFramework 2.1
11. После установки, для проверки работоспособности(при условии установки сервера на локальный компьютер) вводим в cmd:

cd C:\inetpub\wwwroot\bitmobile\Utils
Enter
utils.exe -ver -host http://localhost/bitmobile -p yourpass

12. В ответ сервер возвратит версию

Шаг 3. Настройка Internet Information Services (IIS)

Правой кнопкой нажимаем на Default Web Site и выбираем пункт "Добавить приложение"
Image Removed

• Удостоверьтесь, что на компьютер установлены требуемые компоненты 

Шаг

Image Removed

Указываем в настройках значение "True", для параметра "Разрешены 32-разрядные приложения"
Image Removed

Шаг 4. Права доступа, Настройка IIS

Потребуется создать учетную запись, под которой будет работать пул приложений IIS. 

Image Removed

В полях написать следующие данные(для примера) :

• Пользователь - "bitmobileuser"
• Полное имя - "bitmobileuser"
• Описание - "bitmobileuser"
• Пароль - "12321"
• Подтверждение - "12321"
• Убрать галку "Требовать смены пароля"
• Поставить галку "Срок действия пароля неограничен"

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

Для этого потребуется зайти в Microsoft SQL Management Studio → законнектиться к БД 

В таблице Logins вызвать контекстное меню и выбрать "New Login..."

Image Removed

В поле "Login Name" ввести имя пользователя, для примера "bitmobileuser"

В графе "Server roles" выставить у значения dbcreator "True" (поставить галочку в чекбоксе) . Нажать "ок"

При использовании SSPI в строке подключения, пул приложений следует запускать от пользователя, который имеет права на MSSQL

Неинтерактивный режим установки серверного приложения

1. Загрузка

1. Зайдите на страницу загрузки дистрибутива сервера;
2. Найдите ссылку с подходящей вам версией;
3. Сохраните архив на ваш компьютер

Шаг 2. Установка

1. Распакуйте архив в каталог на компьютере, где будет установлен сервер (именно к этому каталогу в дальнейшем будет обращаться серверный клиент)

2. Открыть файл Web.config в текстовом редакторе

3. Указать следующие параметры сервера:

• ID Сервера - по умолчанию данный параметр равен 

  Highlight
  color Lavender
  "1"

  , в случае ,если на вашем компьютере находится один сервер

  БИТ.Мобайл

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

  
  

  Блок кода
  language c#
  <add key="BitMobileServerIdGrotemServerId" value="1"/>

  
  

• 
  

• Пароль -

  Блок кода
  language c#
  <add key="RootPassword" value="12321"/>

  
  

• Версия используемого .NET Framework - по умолчанию сервер использует Net.Framework 4.5. Если на компьютере установлен .NET Framework 4.0 - следует отредактировать строку, указав корректный
  

  Блок кода
  language c#
  <compilation debug="true" targetFramework="4.5"/>

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

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

• Открываем командную строку

• Пишем указанную ниже команду

  Блок кода
  language c#
  > c:\windows\system32\regsvr32.exe Synchronization21.dll.

  При регистрации на 64 разрядных Windows

  Блок кода
  language c#
  > c:\windows\syswow64\regsvr32.exe Synchronization21.dll

• в структуре перейти на "Default Web Site"
• в контекстном меню выбрать пункт "Добавить приложение..."
• в поле "Псевдоним" указать GrotemServer
• в поле "Пул приложений" выбрать ранее созданный пул "grotem_pool"
• в поле "Физический путь" указать путь до каталога "gateway", внутри распакованного архива сервера Grotem.MobileImage Added

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

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

 "Jwt": {

   "Issuer": "Identity.API",

   "Audience": "http://localhost",

   "Key": "{some_big_key_value_here_secret}"

 },

 "Urls": {

   "Synchronization": "http://localhost:5001",

   "BitMobile": "http://localhost:5000"

 },

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

По аналогии создать и заполнить файл ocelot.json, где для секций BitMobile указать:

   "Host": "localhost",

   "Port": 5000

для секций Synchronization:

  "Host": "localhost",

   "Port": 5001

для секций Fiscal:

  "Host": "localhost",

   "Port": 5002

а также:

  "BaseUrl": "http://localhost/grotemserver"

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

Шаг 3. Настройка Internet Information Services (IIS)

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

Image Added

Правой кнопкой нажимаем на Default Web Site и выбираем пункт "Добавить приложение"
Image Removed

В открывшемся окне

заполняем параметры сервера и нажимаем "OK"
- Псевдоним - указываем псевдоним, по которому в дальнейшем будет происходить обращение. Например, mobileserver
- Физический путь - указываем директорию, в которую ранее был распакован архив с сервером
- Пул приложений - указываем пул приложений, который будет использоваться сервером. Например, ASP.NET 4.0

заполнить параметры:

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

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

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

Порт – 5000

Image Added

Для настройки сервера внести изменения в конфигурацию приложения (пункт "Редактор конфигурации")

Image Added

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

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

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

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

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

Image Added

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

После окончания настроек, убедитесь, что для пула "bitmobile" установлена версия среды CLR.NET версии 4

Image Added

а в "дополнительных параметрах" разрешен запуск 32-разрядных приложений и в поле "Удостоверение" указан ранее созданный пользователь с ролью администратора

Image Added

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

Переходим в настройки выбранного на предыдущем этапе пула
Image Removed
Указываем в настройках значение "True", для параметра "Разрешены 32-разрядные приложения"
Image Removed

Шаг 4. Права доступа

• Учетная запись под которой работает пул приложений Internet Information Services должна иметь права создания базы на сервере БД
  . После развертывания решения права могут быть понижены до db_owner
• У учетной записи,  под которой работает пул приложений IIS, должны быть полные права на папку самого сервера и папку с решениями. Если специальная учетная запись для сервера не указывалась, эти права должны быть у группы IIS_IUSRS
  
  

Шаг 5. Перезапустить Internet Information Services