Перед установкой
Ознакомьтесь со структурой платформыПроверьте, соответствует ли ваш компьютер(мобильный телефон) требованиям к аппаратному и программному обеспечению
На компьютере должны быть установлены следующие компоненты:
Интерактивный режим установки серверного приложения (рекомендуется)
Шаг 1. Загрузка
- Зайдите на страницу загрузки дистрибутива сервера;
- Найдите ссылку с подходящей вам версией;
- Если на компьютере уже установлены компоненты SQL,SSMS,IIS,Net Framework, тогда скачать из папки "Only Installer"
- Если на компьютере отсутствуют компоненты, скачать Full Install, страница помощи при установки компонентов(link)
- Сохраните установочный файл на ваш компьютер
Шаг 2. Установка
1. Запустить exe
2. Нажать клавишу "Далее"
3. Появится окно со следующими данными, менять не желательно:
- Корневая директория "C:\inetpub\wwwroot\bitmobile\"
- Установить приложение на веб сайт "Default Web Site"
- Указать имя приложения - "bitmobile"
- Указать пул приложений: "DefaultAppPool"
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)
Удостоверьтесь, что на компьютер установлены требуемые компоненты
открывшемся окне заполняем параметры сервера и нажимаем "OK"
- Псевдоним - указываем псевдоним, по которому в дальнейшем будет происходить обращение. Например, mobileserver
- Физический путь - указываем директорию, в которую ранее был распакован архив с сервером
- Пул приложений - указываем пул приложений, который будет использоваться сервером. Например, ASP.NET 4.0
Переходим в настройки выбранного на предыдущем этапе пула
Шаг 4. Права доступа, Настройка IIS
Потребуется создать учетную запись, под которой будет работать пул приложений IIS.
Для этого потребуется зайти в Пуск → Управление компьютером → Локальный пользователи → Пользователи → В контекстном меню нажать "Новый пользователь"В полях написать следующие данные(для примера) :
- Пользователь - "bitmobileuser"
- Полное имя - "bitmobileuser"
- Описание - "bitmobileuser"
- Пароль - "12321"
- Подтверждение - "12321"
- Убрать галку "Требовать смены пароля"
- Поставить галку "Срок действия пароля неограничен"
Потребуется создать пользователя, который имеет права на создание базы на сервере БД
Для этого потребуется зайти в Microsoft SQL Management Studio → законнектиться к БД
В таблице Logins вызвать контекстное меню и выбрать "New Login..."
В поле "Login Name" ввести имя пользователя, для примера "bitmobileuser"
В графе "Server roles" выставить у значения dbcreator "True" (поставить галочку в чекбоксе) . Нажать "ок"
При использовании SSPI в строке подключения, пул приложений следует запускать от пользователя, который имеет права на MSSQL
- Находим пул приложений
2. Жмем Advanced Settings (Дополнительные настройки), находим пункт Identity (Идентификация), жмем на многоточие.
3. Выбираем Custom Account и забиваем данные нашего пользователя (bitmobileuser - 12321)
4. В итоге должно быть так
Неинтерактивный режим установки серверного приложения
Шаг 1. Загрузка
- Зайдите на страницу загрузки дистрибутива сервера;
- Найдите ссылку с подходящей вам версией;
- Сохраните архив на ваш компьютер
Шаг 2. Установка
Распакуйте архив в каталог на компьютере, где будет установлен сервер (именно к этому каталогу в дальнейшем будет обращаться серверный клиент)
Открыть файл Web.config в текстовом редакторе
Указать следующие параметры сервера:
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.Mobile
Рекомендуется установить пользователя с ролью администратора по кнопке "Подкл. как..." и затем выполнить "Тест настроек", чтобы убедиться в корректной работе.
Далее, в проводнике 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"
5. Установить Microsoft Sync FrameworkШаг 3. Настройка Internet Information Services (IIS)
В "Диспетчере служб IIS" правым кликом по папке "Сайты" вызвать контекстное меню, в котором выбрать - "Добавить веб-сайт".
Правой кнопкой нажимаем на Default Web Site и выбираем пункт "Добавить приложение"
В открывшемся окне
заполняем параметры сервера и нажимаем "OK"- Псевдоним - указываем псевдоним, по которому в дальнейшем будет происходить обращение. Например, mobileserver
- Физический путь - указываем директорию, в которую ранее был распакован архив с сервером
- Пул приложений - указываем пул приложений, который будет использоваться сервером. Например, ASP.NET 4.0
заполнить параметры:
Имя сайта - bitmobile (пул оставить такой же)
Физический путь - путь до каталога с сервером Grotem, из вышеприведенной структуры - bitmobile3
Подключить как - указать ранее созданного пользователя (в примере - grotem)
Порт – 5000
Для настройки сервера внести изменения в конфигурацию приложения (пункт "Редактор конфигурации")
DataBaseServer - параметры соединения с БД (указать параметры в строке соединения)
для смешанной авторизации на SQL строка подключения будет иметь вид
server=localhost;User Id=<username>;Pwd=<password>;Connection Timeout=3600
для Windows-авторизации:
server=localhost;Integrated Security=SSPI;Connection Timeout=3600
SolutionsFolder - указать каталог для создания решений
- BitMobileServerId - в случае необходимости - изменить префикс сервера
- RootPassword - установить пароль для доступа к серверу
Либо эти параметры можно изменить путем редактирования файла Web.config в каталоге сервера bitmobile3.
После окончания настроек, убедитесь, что для пула "bitmobile" установлена версия среды CLR.NET версии 4
а в "дополнительных параметрах" разрешен запуск 32-разрядных приложений и в поле "Удостоверение" указан ранее созданный пользователь с ролью администратора
Перезапустите пул "bitmobile". Серверное приложение готово к развертыванию мобильных решений.
Переходим в настройки выбранного на предыдущем этапе пулаУказываем в настройках значение "True", для параметра "Разрешены 32-разрядные приложения"
Шаг 4. Права доступа
- Учетная запись под которой работает Учетная запись под которой работает пул приложений Internet Information Services должна иметь права создания базы на сервере БД должна иметь права создания базы на сервере БД. После развертывания решения права могут быть понижены до db_owner
- У учетной записи, под которой работает пул приложений IIS, должны быть полные права на папку самого сервера и папку с решениями. Если специальная учетная запись для сервера не указывалась, эти права должны быть у группы IIS_IUSRS
Шаг 5. Перезапустить Internet Information Services
Например,
color | Lavender |
---|
Шаг 6. Проверка работоспособности
Проверить правильно ли настроен сервер можно выполнив любую команду, с помощью utils.exe.
Например, команда запроса версии сервера
Блок кода | ||
---|---|---|
| ||
> utils.exe -ver -host http://localhost/bitmobileGrotemServer -p pAss3087 |
Установка и настройка мобильного клиента
Android
Шаг 1. Загрузка
- Зайдите на страницу загрузки дистрибутива мобильного клиента;
- Найдите ссылку с подходящей вам версией;
- Сохраните установочный файл на ваш мобильный телефон
Шаг 2. Установка
- Найдите установочный файл, в файловой система вашего устройства
- Запустите установку мобильного клиента
- Подтвердите выдачу разрешений, необходимых для мобильного клиента
- Дождитесь завершения установки
Шаг 3. Настройка
- Перейдите в настройки приложения
В открывшемся меню введите адрес подключения к серверу.
Например,Highlight color Lavender http://192.168.0.1/mobileserver/firstsolution
iOS
Шаг 1. Установка
- Зайдите на страницу загрузки дистрибутива мобильного клиента;
- Найдите ссылку с подходящей вам версией;
- Установите приложение на ваш мобильный телефон
Дождитесь завершения установки
Шаг 2. Настройка
Информация |
---|
При установке на некоторые версии iOS необходимо дать дополнительные разрешения для запуска приложения.
Информация | ||
---|---|---|
| ||
|