Перейти к содержанию

Локальная установка без настройки IIS

Для проверки работы системы или для разработки расширений можно не прибегать к настройке IIS, и вместо этого настроить временную инсталляцию сервера приложений. Такая установка возможна на любой системе, которая удовлетворяет следующим требованиям:

  1. ОС Windows x64: Windows 7 SP1 или старше, в т.ч. редакция Home

  2. Установка .NET Core не требуется, версия .NET Framework не является важной

  3. Локально установлены PostgreSQL или SQL Server (подойдёт редакция Express Edition), или обеспечен сетевой доступ к серверу СУБД (настройки в строке подключения в конфигурационных файлах, см. ниже)

Warning

Рекомендации, приведённые в этом разделе, подходят только для тестовой (временной) установки системы или для локальной установки для разработки расширений. Не используйте эти рекомендации, чтобы настроить тестовый или продуктовый серверы.

Установка системы

Установка выполняется следующим образом:

  1. В файле Services\app.json в папке со сборкой укажите пустую строку в настройке "GuyFawkesAuth": ""

  2. В этом же файле укажите адрес для подключения с именем создаваемой базы данных в настройке ConnectionStrings -> default, подробности по настройкам указаны в следующем разделе.

  3. В файлах Chronos\app.json и Tools\app.json укажите такую же строку подключения, как в Services\app.json в п.2.

  4. Разместите файл лицензии в папках сборки Chronos и Services, укажите имя этого файла в конфигурационных файлах app.json в соответствующих папках (настройка LicenseFile).

  5. Запустите приложение веб-сервисов Services\web\Tessa.Web.Server.exe

    1. По умолчанию приложение запустится и будет слушать локальный порт 5000.

    2. Если окно консоли откроется и тут же закроется, то возникла ошибка.

      1. Откройте командную строку cmd: сочетание клавиш Win+R, введите cmd.exe, нажмите Enter.

      2. Перейдите в папку cd полный_путь_до_папки_со_сборкой\Services\web

      3. Запустите Tessa.Web.Server.exe

    3. Если в сообщении об ошибке будет информация о недоступности порта 5000 (обычно, если порт уже занят), то укажите адрес с другим портом, например, запустив Tessa.Web.Server.exe /a:http://localhost:5001

  6. Запустите скрипт Setup.bat для установки системы.

    1. Введите адрес http://localhost:5000 и нажмите Enter (укажите другой порт, если его изменяли при запуске Tessa.Web.Server.exe). Убедитесь, что вы ввели именно http://, а не https://. В случае ошибки ввода закройте окно консоли и заново запустите скрипт Setup.bat.

    2. Введите имя создаваемой базы данных и нажмите Enter, например: tessa

    3. Введите путь к папке с файлами, которая доступна на чтение и запись для текущего пользователя, и нажмите Enter, например: C:\Tessa\Files

    4. Нажмите любую клавишу и дождитесь окончания установки. Закройте окно консоли.

  7. Запустите сервис фоновых процессов Chronos, для этого запустите приложение Chronos\Chronos.exe

  8. Запустите приложение TessaClient, чтобы проверить работоспособность инсталляции. Для этого в файле Applications\TessaClient\app.json настройте базовый адрес BaseAddress, указав http://localhost:5000 (укажите другой порт, если его изменяли при запуске Tessa.Web.Server.exe).

    1. В появившемся окне введите логин admin и пароль admin для пользователя системы, созданного по умолчанию.

    2. В дальнейшем стандартным образом можно создать других сотрудников с типом “Пользователь Tessa” и любыми логинами/паролями.

  9. Web-клиент доступен в браузере по адресу http://localhost:5000 (укажите другой порт, если его изменяли при запуске Tessa.Web.Server.exe).

  10. Помимо запуска приложений TessaClient и TessaAdmin вручную, также их можно опубликовать и использовать для запуска менеджер приложений Tessa Applications.

    1. Отредактируйте файлы Applications\publish_client_demo.bat и Applications\publish_admin_demo.bat, указав адрес подключения: вместо /a:https://localhost/tessa пропишите /a:http://localhost:5000 (порт может отличаться), после чего сохраните и запустите файлы. Дождитесь окончания публикации.

  11. Установите Tessa Applications, выполнив Setup\ru-RU\x64\TessaApplications.msi.

    1. Для этого потребуются права локального администратора Windows на вашем компьютере.

    2. При установке укажите адрес http://localhost:5000 вместо адреса по умолчанию (укажите другой порт, если его изменяли при запуске Tessa.Web.Server.exe).

    3. После запуска Tessa Applications введите логин admin и пароль admin для пользователя системы по умолчанию.

    4. Чтобы не вводить логин/пароль каждый раз, его можно указать в настройках сервера. Для этого перейдите на вкладку “Серверы”, дважды кликните по строке с сервером, задайте логин и пароль, и нажмите кнопку “Сохранить” внизу окна.

  12. Чтобы завершить работу сервера приложений Tessa, нажмите Ctrl+C в окнах консоли с запущенными Tessa.Web.Server.exe и Chronos.exe, и дождитесь окончания их работы.

  13. Когда снова потребуется использовать эту локальную инсталляцию, запустите окна приложений Tessa.Web.Server.exe и Chronos.exe, как это описано выше.

  14. После установки при необходимости вы можете скопировать папки, используемые системой, в произвольные места на вашем компьютере, к которым у текущего пользователя есть доступ на чтение и запись. Запуск Chronos.exe и Tessa.Web.Server.exe можно настроить по ярлыкам. Скопируйте папки:

    1. Chronos

    2. Services

    3. Applications\TessaClient и Applications\TessaAdmin (не требуется, если выполнялась публикация приложений с их последующим запуском посредством Tessa Applications).

Ограничения локальной установки

Локальная установка имеет следующие ограничения:

  1. В desktop-клиенте и в web-клиенте не работают автоматическая Windows аутентификация или аутентификация ADFS.

  2. Для функционирования веб-сервисов должно быть запущено окно консоли Tessa.Web.Server.exe. Консоль можно в любой момент закрыть, нажав Ctrl+C, или снова открыть, запустив соответствующий .exe-файл.

  3. Для функционирования фоновых сервисов Chronos должно быть запущено окно консоли Chronos.exe. Консоль можно в любой момент закрыть, нажав Ctrl+C, или снова открыть, запустив соответствующий .exe-файл.

  4. Веб-сервисы доступны только на том же компьютере по адресу localhost независимо от того, какие порты открыты и какие сетевые настройки выполнены на вашем компьютере.

  5. Веб-сервисы доступны только по протоколу http, доступ по https невозможен.

  6. Запуск любых приложений должен выполняться с указанием адреса и порта http://localhost:5000 одним из следующих способов:

    1. Запуском .exe-файла с адресом подключения, который предварительно настроен, это настройка BaseAddress в файле app.json.

    2. Из командной строки, например: TessaClient.exe /a:http://localhost:5000 /u:admin /p:admin

    3. Посредством установленного на том же компьютере приложения Tessa Applications при условии, что TessaClient и/или TessaAdmin опубликованы по адресу веб-сервисов для этой инсталляции. Такая публикация описана выше.

Back to top