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

Возможные проблемы

Не загрузились расширения

Если какие-либо расширения не загрузились, то необходимо проверить:

  • Не заблокировал ли файлы с расширениями .dll или рядом лежащий файл extensions.xml антивирус:

    В папке веб-сервиса tessa (C:\inetpub\wwwroot\tessa\tessa), или в папке клиента (в которую можно перейти, нажав на пункт контекстного меню "Открыть папку приложений..." в Tessa Applications).

  • Не заблокировал ли файлы Windows:

    В таком случае в окне свойств файла будет флаг "Разблокировать". Его надо поставить и нажать ОК:

Не работает предпросмотр PDF в Windows 7/8.1/10/11

При отключении встроенного предпросмотра PDF и при использовании приложения Acrobat Reader версий 10, 11 (XI) и DC (указанные версии могут работать на 32-битной Windows, но они точно несовместимы с Tessa для 64-битной Windows).

Возможные методы решения:

  • Включить встроенный предпросмотр PDF.

  • Установить Foxit Reader (32 бит), он совместим с Windows 10/Windows 11 и у него нет проблем с предпросмотром.

  • Установить бесплатную (free) версию приложения PDF Architect.

  • Использовать старую версию Adobe Reader 9.

При запуске Tessa Applications долго показывает экран загрузки, и затем ошибка

При запуске Tessa Applications долго отображается экран загрузки, и затем появляется ошибка “Не удалось подключиться к серверу аутентификации”.

При этом точно есть доступ по 443 порту к серверу аутентификации. Проблема возникла из-за установленной версии КриптоПро. В теории должна возникать только при невалидном ключе сервера. При установленной в составе КриптоПро библиотеке pkivalidator, они дополняют алгоритм проверки сертификата и делают это криво. Вот обсуждение на их форуме.

Возможные методы решения:

  • Удалить КриптоПро.

  • Установить более новую версию КриптоПро.

  • Удалить регистрацию в реестре CLSID\\{1FDD1FC3-6347-49DF-BDAB-E465BF32AD92}\\InprocServer32

Не работает Windows Authentication в домене

Проблема скорее всего связана с некорректными SPN.

Установка на версии Windows, не поддерживающей Windows Authentication

При установке TESSA на версии Windows, в составе которых нет компонента Windows Authentication для IIS, например, Windows 10 Home, необходимо учесть следующие отличия относительно типовой установки:

  1. Т.к. Windows аутентификация работать не будет, то все приложения необходимо запускать с ключами /u /p для указания имени пользователя и пароля.

    TessaClient.exe /u:username /p:password
    


    TessaAdmin.exe /u:username /p:password

    Можно указать фиктивные имя пользователя и пароль, тогда при запуске система выведет диалог ввода логина\пароля.

  2. В Tessa Applications логин\пароль указываются индивидуально для каждого сервера на вкладке “Серверы”. Запущенные оттуда приложения TessaAdmin и TessaClient проходят аутентификацию с использованием тех же параметров подключения.

Периодически возникает ошибка с CardMetadataCache при запуске приложений TessaClient или TessaAdmin

Периодически при запуске приложений TessaClient или TessaAdmin возникает исключение примерно следующего вида:

Resolution of the dependency failed, type = "Tessa.Cards.Metadata.CardMetadataCache", name = "(none)".
Exception occurred while: Calling constructor Tessa.Cards.Metadata.CardMetadataCache(System.String instanceName, Tessa.Platform.Services.IUnityDisposableContainer container).
Exception is: UnauthorizedAccessException - Отказано в доступе по пути "Invalidated.EventMutex.07e0663a744fa4f2c873ce76039037933919b186e848ba9e82ca8be547997e3c..6b8529df30919b9a82302b68b5bd1699174df646181b16db91345643bc899cd3".
At the time of the exception, the container was:



Resolving Tessa.Cards.Metadata.CardMetadataCache,(none)
  Calling constructor Tessa.Cards.Metadata.CardMetadataCache(System.String instanceName, Tessa.Platform.Services.IUnityDisposableContainer container)

Обычно такая ошибка возникает, если со стороны сервера приложений установлено два экземпляра веб-сервисов Tessa, которые работают в разных пулах приложений (что правильно). Например, на одном и том же сервере запущены веб-сервисы для тестового и production серверов.

Для исправления задайте различные значения настройки ServerCode в файле веб-сервиса app.json для каждой из папок. Например, в папке, относящейся к production-серверу, укажите значение prod, а в папке, относящейся к тестовому серверу, укажите значение qa.

"Settings": {
    "ServerCode": "prod",
    ...
}

Аналогичную настройку рекомендуется установить для Chronos в конфигурационных файлах app.json в папке рядом с Chronos.exe.

Проблемы с производительностью клиента, когда в сети предприятия отключён доступ в Интернет

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

Запустите Fiddler и посмотрите трафик при работающем приложении. Если появляется вот такой запрос, который может обрабатываться 10 секунд с последующим редиректом:

GET http:// ctldl.windowsupdate.com/msdownload/update/v3/static/trustedr/en/disallowedcertstl.cab?ab903fbe32ee4be1 HTTP/1.1
Accept: */*
User-Agent: Microsoft-CryptoAPI/6.1
Connection: Keep-Alive
Host: ctldl.windowsupdate.com

То необходимо отключить локальные политики, из-за которых приложение периодически обращается к Windows Update за проверкой сертификатов SSL/TLS. Подробнее описано в статье: https://support.microsoft.com/en-us/kb/2677070

  • Откройте редактор политики: пуск - выполнить - gpedit.msc

  • Перейдите в: Локальные политики безопасности - Политики открытого ключа – Политики подтверждения пути сертификата

  • Далее на вкладке “Получение по сети” поставьте флажок “определить параметры…”

  • И снимите флажок “автоматически обновлять сертификаты…”

В результате настройки должны быть как на скриншоте:

Проблемы с производительностью клиента, когда на компьютере пользователя установлен КриптоПро

При установленном плагине КриптоПро CAdESCOM в приложениях TessaClient и TessaAdmin могут наблюдаться проблемы с запуском и значительное снижение производительности (высокая нагрузка на процессор и постепенно увеличивающиеся объёмы занятой памяти).

Это связано с тем, что Tessa отправляет HTTPS-запросы на сервер штатными средствами ОС, а драйвер КриптоПро вмешивается в этот процесс и нарушает работу системы.

Проблему можно решить одним из способов:

  1. Удалите плагин КриптоПро, если он не требуется на этом компьютере.

  2. Удалите регистрацию библиотеки pkivalidator (ПО КриптоПро) из реестра по пути CLSID\\{1FDD1FC3-6347-49DF-BDAB-E465BF32AD92}\InprocServer32

Переполнение перемещаемого профиля пользователя

В некоторых случаях пользователи, работающие на множестве серверов и использующие много приложений, могут столкнуться с трудностями, связанными с тем, что перемещаемый профиль пользователя Windows начинает занимать слишком много места. Это происходит, потому что старые версии приложения Tessa Applications кэшируют загруженные приложения в папке %AppData%\tessa\applications (обычно это путь вида C:\Users\ivan\AppData\Roaming\tessa\applications). В некоторых инфраструктурах размер этой папки может быть ограничен.

Для решения это проблемы можно или обновить Tessa Applications до сборки 3.5.0 или старше, используя msi-пакет, или настроить его для кеширования загруженных приложений в другой папке. Эта настройка задается в файле настроек пользователя %AppData%\tessa\settings\application_catalogs.xml (например, C:\Users\ivan\AppData\Roaming\tessa\settings\application_catalogs.xml). Этот файл создается автоматически при первом запуске пользователем приложения Tessa Applications путем копирования аналогичного файла, находящегося в папке установки.

В указанное в примере место нужно добавить атрибут AppPath="%LocalAppData%\tessa" и в значении прописать папку, в которую вы хотите сохранять загруженные приложения. Система создаст по указанному пути подпапку “applications” и в нее будут сохраняться загруженные приложения.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<AppManager AppPath="%LocalAppData%\tessa">
  <ApplicationCatalogs IsAppManagerUpdateService="platform">
    <ApplicationCatalog Alias="platform" Path="https://localhost/tessa" OpenTimeOut="0" />
  </ApplicationCatalogs>
</AppManager>

В примере выше использован путь для хранения приложений в неперемещаемом профиле пользователя. Вы можете использовать стандартные переменные окружения, например AppData, LocalAppData.

Ошибка “HTTP Error 503. The service is unavailable.” при открытии web-клиента

В журнале событий системы в этом случае может присутствовать примерно такая запись

Имя журнала:   System
Источник:      Microsoft-Windows-WAS
Дата:          30.01.2017 13:54:12
Код события:   5021
Категория задачи:Отсутствует
Уровень:       Предупреждение
Ключевые слова:Классический
Пользователь:  Н/Д
Компьютер:
Описание:
Неверное удостоверение пула приложений tessaWeb. Возможно, неправильно указаны заданные для удостоверения имя пользователя или пароль, либо пользователь не имеет права на пакетный вход. Если удостоверение неверно, пул приложений будет отключен, как только пул приложений получит свой первый запрос. Если возникает проблема с правами на пакетный вход, необходимо заменить имя пользователя в хранилище конфигураций IIS после получения прав перед тем, как служба активации Windows (WAS) сможет выполнить повторный вход в систему. Если удостоверение останется неверным после обработки первого запроса пула приложений, пул будет отключен. Поле данных содержит номер ошибки.

Проверьте корректность аккаунта\пароля, под которым запускается пул приложений. Также можете запустить пул приложений от встроенной учетной записи ApplicationPoolIdentity. В этом случае в строке подключения к MS SQL Server нужно будет указать логин/пароль учётной записи MS SQL Server с правами dbo на базу данных tessa.

Ошибка “Необходимо заново войти в систему” или зависание после неактивности в Google Chrome

Такая проблема наблюдается, если к web-клиенту выполняется подключение по адресу с localhost, причём в настройках браузера Google Chrome установлен флаг для доверия сертификату с localhost: chrome://flags/#allow-insecure-localhost.

В этом случае браузер после неактивности начинает игнорировать любые запросы от объектов service worker (используемых в приложении Tessa для кэширования), в результате чего web-клиент может перестать отображать данные представлений (вечная надпись “загрузка”), зависнуть на открытии/создании карточки (вечная загрузка с крутящимся progress bar-ом) или выбросить с ошибкой.

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

Для исправления используйте один из вариантов:

  • Подключитесь по http и укажите вместо localhost IP-адрес (например, 192.168.0.1, но не 127.0.0.1).

  • Подключитесь по https с самоподписанным сертификатом (проверка которого в браузере завершится неудачно), и укажите IP-адрес (в т.ч. подойдёт 127.0.0.1).

В этих случаях функционал service worker будет отключён, это можно будет увидеть в правой боковой панели в плитке “О программе”.

Ошибка “Failed to fetch metadata” при открытии веб-клиента после перехода на новую версию платформы

Это означает, что в браузере у пользователя, у которого произошла ошибка, надо сбросить cookies и кэш браузера. Обратитесь к документации браузера, чтобы узнать, как это сделать.

Ошибка “При выполнении операции произошла ошибка. Имя файла \?С:\inetpub\wwwroot\tessa\web\web.config”

Данная ошибка наблюдается, если на сервере .NET Hosting bundle был установлен раньше, чем IIS. Чтобы исправить ошибку необходимо выполнить исправление .NET Hosting bundle:

Перейдите в Панель управления\Программы\Программы и компоненты. И там выберите “изменить” на последней версии .NET Hosting bundle. После этого нажмите repair. Для применения изменений необходимо перезагрузить компьютер.

Ошибка в логе сервера приложений при соединении с СУБД: “error: 40 - Could not open a connection to SQL Server –→ System.ComponentModel.Win32Exception: Access is denied”

Ошибка может возникать при использовании Kerberos-аутентификации совместно с протоколом named pipes для общения между серверов приложений и СУБД. При возникновении такой ошибки явно укажите порт 1433 для использования протокола TCP/IP в строке подключения к СУБД (в файлах app-db.json веб-сервиса, Chronos и tadmin). Например:

  "ConnectionStrings": {
        "default": "Server=COMPUTER_NAME,1433; Database=tessa; Integrated Security=true; Connect Timeout=200; pooling='true'; Max Pool Size=200; MultipleActiveResultSets=true;"
  }

Если ваш СУБД использует другой номер порта для протокола TCP/IP, то замените 1433 на актуальный номер порта. Также может потребоваться настроить firewall для трафика по протоколу TCP и этому номеру порта.

Ошибка “Unable to read session token from cookies. Check if there is other software using token cookies for the site”.

Ошибка возникает, когда сервер TESSA не может прочитать токен авторизации. Причиной может быть конфликт с другим приложением на стороне пользователя. В этом случае необходимо изменить в файле настроек app.json значение параметра TokenCookiesName, который определяет имя cookies для авторизации. См. документацию по настройке production сервера.

Service Worker не работает в Firefox, несмотря на корректный сертификат

Если в окне “О программе” указано “Service Worker не доступен”, при этом HTTPS-сертификат отмечен как корректный (зелёный значок “замка” слева от текущего адреса), то для браузера Firefox проверьте следующую настройку:

  1. Откройте страницу со специальными настройками, указав в адресной строке: about:config

  2. Найдите в поиске настройку: dom.serviceWorkers.enabled

  3. Если указано значение false, то двойным кликом замените его на true, после этого страницу можно закрывать - изменения сохранены

  4. Обновите страницу браузера с web-клиентом системы. В окне “О программе” теперь должно быть указано “Service Worker доступен”

Эта настройка обычно по умолчанию включена, но в Firefox в CentOS и некоторых других ОС возможно, что потребуется включить настройку вручную. Функциональность Service Worker заметно уменьшает количество трафика, загружаемого с сервера в момент открытия страницы web-клиента.

При использовании функций Deski в Firefox появляется ошибка “NetworkError when attempting to fetch resource.”

Если в окне “О программе” написано “Deski доступен”, но при выборе таких функций в контекстном меню файлов, как “Открыть для чтения”, “Открыть для редактирования”, “Открыть для редактирования в папке” и др., отображается сообщение об ошибке: Error: NetworkError when attempting to fetch resource.

Откройте консоль браузера (клавиша [F12], вкладка Console). Нажмите повторно на пункт контекстного меню. В консоли может появиться сообщение следующего вида:

Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at [http://127.0.0.1:7711/api/setappinfo?app=https%3A%2F%2Flocalhost.](http://127.0.0.1:7711/api/setappinfo?app=https%3A%2F%2Flocalhost.) (Reason: CORS request did not succeed).

Если это так, то вы столкнулись с ошибкой Firefox: https://bugzilla.mozilla.org/show_bug.cgi?id=1488740

Она повторяется в версиях Firefox 58-68. Некоторые ОС, такие как CentOS 8, содержат в репозиториях версию с долгосрочной поддержкой Firefox 68, в которой также эта проблема присутствует.

Варианты решения:

  1. Обновите версию Firefox, если есть такая возможность. В Windows браузер Firefox обновляется сам через меню. В Linux вы также можете скачать Firefox с сайта в виде архива (не в репозитории), и запускать новую версию Firefox параллельно с поддерживаемой версией из репозитория.

  2. Используйте другой поддерживаемый браузер. В Linux это Google Chrome или его открытая версия Chromium, которая также может быть в репозиториях вашего дистрибутива.

При запуске Deski в Linux ничего не происходит или не появляется иконка в области уведомлений

Откройте окно консоли и запустите deski. Если архив был распакован в домашнюю папку, то для этого выполните команду:

~/deski/deski

Если отображается сообщение “Deski is running” и открывается окно браузера со страницы “Deski запущен”, то остановите Deski нажатием [Ctrl]+[C] и перейдите к следующему абзацу. Если же в консоли выводится ошибка об отсутствии библиотеки, то ваш дистрибутив Linux по умолчанию не содержит необходимой библиотеки, и её должен установить пользователь с правами администратора. Например, в CentOS 7/8 требуется установить библиотеку libappindicator-gtk3, введя в консоли следующие команды:

su
yum -y install epel-release && yum -y install libappindicator-gtk3
exit

Если не отображается иконка Deski, то, возможно, также отсутствует расширение оконного менеджера GNOME или KDE для поддержки иконок в области уведомлений. Нам известно о такой проблеме в CentOS. Для её разрешения, откройте магазин приложений “Software”, найдите приложение с именем “KStatusNotifierItem/AppIndicator Support”, установите его и перезагрузите компьютер (или оконный менеджер). Подробнее по расширению можно прочитать в репозитории: https://github.com/ubuntu/gnome-shell-extension-appindicator

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

Ошибка “Can’t acquire or create Linux mutex, error code is -28.” при установке или работе СЭД TESSA на ОС Linux

Ошибка появляется в случае, если был исчерпан лимит на семафоры (SEMMNS и SEMMNI). Посмотреть текущий лимит можно, введя следующую команду:

ipcs -ls

max semaphores system wide (SEMMNS) и max number of arrays (SEMMNI) рекомендуется установить равным 32000. Чтобы увеличить его, обратитесь к документации вашего дистрибутива.

Плагин FileConverterPlugin сервиса Chronos внезапно завершает свою работу

Такая проблема воспроизводилась на CentOS версии 7.6. После перезапуска сервиса Chronos, при следующем техобслуживании плагин FileConverterPlugin сразу же завершает свою работу. При этом, остальные плагины и сервис Chronos продолжают свою работу.

Для решения проблемы, обновите CentOS до версии 7.7 или выше. Это можно сделать, введя следующую команду:

Warning

Команда, указанная ниже, вместе с ОС обновит все пакеты, установленные на сервере. Перед её выполнением крайне рекомендуется остановить все запущенные службы.

sudo -y yum update

На сервере приложений Linux наблюдается аномальная загрузка CPU и зависание при подключении к веб-сервису

Такая проблема возникает при использовании дистрибутива Linux с системой инициализации System D версии 212 и старше, если сервер приложений запущен от имени несистемной учетной записи.

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

В качестве альтернативного решения необходимо добавить строку в файл /etc/systemd/logind.conf:

RemoveIPC=no

После этого перезагрузите сервер.

Ошибка “Full-Text Search is not installed, or a full-text component cannot be loaded.” при установке СЭД TESSA на ОС Linux

Такая проблема возможна, если при установке СУБД MS SQL Server на Linux отсутствует компонент полнотекстового поиска. Установите его согласно документации по установке Microsoft.

Проблема скачивания нескольких выбранных файлов в Chrome/Atom/Firefox

Если при попытке скачать два и более выделенных файла загружается только один из них, то значит, что заблокированы всплывающие окна. Решить такую проблему можно изменением настроек безопасности в браузере.

Для Chrome/Atom необходимо:

  1. Ввести в адресной строке: chrome://settings/content/popups .

  2. Добавить домен на котором работает Tessa в блок разрешенных.

  3. Перезапустить браузер.

Более подробно о настройке всплывающих окон в Chrome можно прочитать в справочном центре Google Chrome или справочном центре Mail.ru для Atom.

Для Firefox необходимо:

  1. Ввести в адресной строке: about:preferences#privacy .

  2. Найти блок настроек “Разрешения” и добавить в исключения домен, на котором работает Tessa.

  3. Перезапустить браузер.

Более подробно о настройке всплывающих окон в Firefox можно прочитать в справке Firefox.

Окно терминала Deski не закрывается на Windows 10/11

Пользователю отображается окно терминала с Deski и возможностью открыть новую вкладку (это признак того, что используется Windows Terminal).

Это актуально, если терминалом по умолчанию выбран Windows Terminal, а не Командная строка (Windows Console Host). Это значение может быть изменено с обновлениями Windows или задано по умолчанию для вновь установленной ОС.

Покажем, как можно скрыть это окно.

Вариант 1: установите терминалом по умолчанию Windows Console Host.

  1. Откройте Windows Terminal, по кнопке со стрелкой рядом с добавлением вкладки выберите Settings.

  2. На первой странице Startup укажите консоль Windows Console Host в качестве приложения по умолчанию (Default terminal action).

Вариант 2: настройте закрытие терминала.

  1. Убедитесь, что установлен Deski версии v2.2 или старше. Версию можно увидеть как в окне терминала, так и по кнопке “Открыть в браузере” в контекстном меню на иконке в трее.

  2. Если всё равно терминал отображается, например, с ошибкой открытия приложения, то укажите закрытие окна терминала по завершению работы приложения.

    • Откройте Windows Terminal, откройте настройки Settings, выберите слева вкладку профиля “Командная строка” (Command Prompt).
    • Нажмите кнопку “Дополнительно” в нижней части окна (Advanced settings -> Advanced).
    • Выберите поле с поведением при закрытии приложения “Profile termination behavior” как закрытие при любом завершении процесса “Close when process exits, fails, or crashes”.

Back to top