VintaSoft Web TWAIN service (Linux версия) - это Linux сервис, который предоставляет веб-API для доступа к TWAIN, SANE и eSCL сканерам изображений для всех пользователей Linux компьютера.

VintaSoft Web TWAIN service (Linux версия) - это родное Linux приложение, которое скомпилировано с помощью .NET 8.0, и может быть использовано на Linux компьютере (Ubuntu 23/22/20/18; Debian 12/11/10; Fedora 39/38/37/36).

VintaSoft Web TWAIN service (Linux версия) предоставляет доступ к 64-х битным TWAIN и SANE сканерам изображений, eSCL сканерам изображений.

Доступ к VintaSoft Web TWAIN сервису (Linux версия) может осуществляться через HTTPS протокол с использованием URL "https://localhost:25329/api/VintasoftTwainApi" или через HTTP протокол с использованием URL "http://localhost:25319/api/VintasoftTwainApi".
Сетевые порты 25319 и 25329 могут быть изменены после инсталляции VintaSoft Web TWAIN сервиса (Linux версия).

1. Инсталляция Vintasoft Web TWAIN сервиса (Linux версия) на локальный Debian/Ubuntu компьютер

Для установки сервиса VintaSoft Web Twain (версия для Linux) на компьютер с Debian/Ubuntu выполните следующие действия:

• Загрузить DEB-пакет VintasoftWebTwainService-15.4.0.deb по ссылке: https://www.vintasoft.ru/zip/VintasoftWebTwainService-15.4.0.deb
• Выполнить следующую команду в консоли:
  
  • Console

  sudo dpkg -i VintasoftWebTwainService-15.4.0.deb
  

  
  Файлы Vintasoft Web TWAIN сервиса (Linux версия) будут установлены в папку "/opt/vintasoft/VintasoftWebTwainService/".

2. Деинсталляция Vintasoft Web TWAIN сервиса (Linux версия) с локального Debian/Ubuntu компьютера

Для удаления сервиса VintaSoft Web Twain (версия для Linux) с компьютера с Debian/Ubuntu выполните следующие действия:

• Выполнить следующую команду в консоли:
  
  • Console

  sudo dpkg -r VintasoftWebTwainService
  

3. Инсталляция Vintasoft Web TWAIN сервиса (Linux версия) на локальный Fedora компьютер

Для установки сервиса VintaSoft Web Twain (версия для Linux) на компьютер с Fedora выполните следующие действия:

• Загрузить RPM-пакет VintasoftWebTwainService-15.4.0.rpm по ссылке: https://www.vintasoft.ru/zip/VintasoftWebTwainService-15.4.0.rpm
• Выполнить следующую команду в консоли:
  
  • Console

  sudo rpm -i VintasoftWebTwainService-15.4.0.rpm
  

  
  Файлы Vintasoft Web TWAIN сервиса (Linux версия) будут установлены в папку "/opt/vintasoft/VintasoftWebTwainService/".

4. Деинсталляция Vintasoft Web TWAIN сервиса (Linux версия) с локального Fedora компьютера

Для удаления сервиса VintaSoft Web TWAIN (версия для Linux) с компьютера Fedora выполните следующие действия:

• Выполнить следующую команду в консоли:
  
  • Console

  sudo rpm -e VintasoftWebTwainService
  

5. Инициализация Vintasoft Web TWAIN сервиса (Linux версия)

Vintasoft Web TWAIN сервис (Linux версия) имеет файл инициализации - файл "VintasoftWebTwainService.ini", который размещается в папке "/opt/vintasoft/VintasoftWebTwainService/".
Файл "VintasoftWebTwainService.ini" может содержать следующие параметры:

• HTTPSERVICEPORT - определяет сетевой порт для веб-сервера, который обслуживает HTTP-запросы к сервису. По умолчанию значение равно 25319.
• HTTPSSERVICEPORT - определяет сетевой порт для веб-сервера, который обслуживает HTTPS-запросы к сервису. По умолчанию значение равно 25329.
• ISTWAINSUPPORTENABLED - определяет значение, указывает на включение поддержки TWAIN. 0 - поддержка TWAIN отключена; 1 - поддержка TWAIN включена.
• ISSANESUPPORTENABLED - определяет значение, указывает, включена ли поддержка SANE. 0 - поддержка SANE отключена; 1 - поддержка SANE включена.
• ISESCLSUPPORTENABLED - определяет значение, указывает на включение поддержки eSCL. 0 - поддержка eSCL отключена; 1 - поддержка eSCL включена.
• LOGGING - определяет режим ведения журнала для службы. Этот параметр может принимать следующие значения: 0 - ведение журнала отключено; 1 - ведение журнала включено; 2 - расширенное ведение журнала включено. Значение по умолчанию - 0.
  Если ведение журнала включено, служба сохраняет информацию журнала для устройств TWAIN в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64-debug.log".
  Если ведение журнала включено, служба сохраняет информацию журнала для устройств SANE в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebSaneService64-debug.log".
  Если ведение журнала включено, служба сохраняет информацию журнала для устройств eSCL в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebEsclService-debug.log".
• ALLOWABLESESSIONINACTIVITYTIME - определяет интервал в миллисекундах, в течение которого сеанс должен быть обновлен, т.е. помечен как активный. Значение по умолчанию - 120000 миллисекунд (2 минуты). Минимальное значение - 100, максимальное значение - 3600000.

6. Получение информации о статусе Vintasoft Web TWAIN сервиса (Linux версия)

Vintasoft Web TWAIN сервис (Linux версия) состоит из веб TWAIN сервиса (файлы VintasoftAspNetCoreTwainService64 и VintasoftAspNetCoreTwainService64.dll), который обслуживает запросы к TWAIN, SANE и eSCL сканерам изображений.

Информация о статусе веб TWAIN сервиса сохраняется в лог-файле "/opt/vintasoft/VintasoftWebTwainService/logs/VintasoftAspNetCoreTwainService64.log".

Отладочная информация о работе с 64-битными TWAIN устройствами сохраняется в лог-файле "/opt/vintasoft/VintasoftWebTwainService/logs/VSWebTwainService64-debug.log", если включено ведение журнала веб сервиса.
Отладочная информация о работе с 64-битными SANE устройствами сохраняется в лог-файле "/opt/vintasoft/VintasoftWebTwainService/logs/VSWebSaneService64-debug.log", если включено ведение журнала веб сервиса.
Отладочная информация о работе с устройствами eSCL сохраняется в лог-файле "/opt/vintasoft/VintasoftWebTwainService/logs/VSWebEsclService-debug.log", если включено ведение журнала TWAIN.

7. Устранение неполадок

7.1 Сервис VintaSoft Web TWAIN (версия для Linux) недоступен

Если вы установили сервис VintaSoft Web TWAIN (версия для Linux) на свой Linux компьютер, но видите сообщение об ошибке, что сервис недоступен, откройте веб-страницу " https://localhost:25329/api/VintasoftTwainApi/Status " и посмотрите информацию о сервисе VintaSoft Web TWAIN.
Если веб-страница недоступна, проверьте, установлен​ли сервис VintaSoft Web TWAIN на вашем Linux компьютере.
Если веб-страница доступна, но вы видите предупреждение о подключении от веб-браузера - у вас проблема с SSL-сертификатом для веб-сайта "localhost".
Если вы не можете решить проблему самостоятельно, обратитесь в службу поддержки VintaSoft.

7.2. Проблемы со сканерами изображений TWAIN

Если вы не видите сканер изображений TWAIN в списке устройств, выполните следующие действия:

1. Запустите команду "lsusb" в консоли и проверьте, содержит ли выводимый список USB-устройств имя TWAIN сканер изображений. Если название сканера изображений TWAIN отсутствует в списке USB-устройств, проверьте USB-соединение со сканером изображений TWAIN.
2. Убедитесь, что у вас установлен драйвер TWAIN для вашего сканера изображений TWAIN.

Если вы видите сканер изображений TWAIN в списке устройств, но он работает некорректно, выполните следующие действия:

1. Получите последнюю версию TWAIN драйвера для TWAIN сканера с веб-сайта производителя TWAIN сканера изображений и переустановите TWAIN драйвер.
2. Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Linux версия).
3. Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
   Нам необходимо:
   • Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
   • Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса (Linux версия) в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.

7.3. Проблемы со сканерами изображений SANE

Если сканер изображений SANE не отображается в списке устройств или работает некорректно, выполните следующие действия:

1. Установите приложение "xsane", если "xsane" не устанволен на Linux компьютере. Запустите приложение "xsane" и попробуйте получить изображения от SANE сканера с помощью "xsane".
2. Если "xsane" не может найти ваш сканер изображений или не может получить изображения с вашего устройства SANE, вам необходимо попробовать установить/обновить драйвер SANE для вашего сканера изображений SANE.
3. Если "xsane" может получать изображения с вашего SANE сканера изображений, убедитесь, что у вас установлена последняя версия VintaSoft Web Twain сервиса (Linux редакция).
4. Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
   Нам необходимо:
   • Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
   • Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса (Linux версия) в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.

7.4. Проблемы со сканерами изображений eSCL

Если вы не видите сканер изображений eSCL в списке устройств, выполните следующие действия:

1. Получите IP-адрес вашего Linux компьютера, получите IP-адрес сканера изображений eSCL и убедитесь, что оба IP-адреса принадлежат одной и той же сети.
2. Попробуйте использовать команду "ping" для проверки сетевого соединения со сканером изображений eSCL.

Если вы видите сканер образов eSCL в списке устройств, но он работает некорректно, выполните следующие действия:

1. Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Linux версия).
2. Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
   Нам необходимо:
   • Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
   • Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса (Linux версия) в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.