Vintasoft Web TWAIN сервис (Linux версия)
В этом разделе
VintaSoft Web TWAIN service (Linux версия) - это Linux сервис, который предоставляет веб-API для доступа к локальным TWAIN и SANE сканерам для всех пользователей 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 сканерам изображений.
Доступ к 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.0.5.deb по ссылке: https://www.vintasoft.ru/zip/VintasoftWebTwainService-15.0.5.deb
-
Выполнить следующую команду в консоли:
sudo dpkg -i VintasoftWebTwainService-15.0.5.deb
Файлы Vintasoft Web TWAIN сервиса (Linux версия) будут установлены в папку "/opt/vintasoft/VintasoftWebTwainService/".
2. Деинсталляция Vintasoft Web TWAIN сервиса (Linux версия) с локального Debian/Ubuntu компьютера
Для деинсталляции Vintasoft Web TWAIN сервиса (Linux версия) с Debian/Ubuntu компьютера, необходимо выполнить следующие действия:
-
Выполнить следующую команду в консоли:
sudo dpkg -r VintasoftWebTwainService
3. Installation of Vintasoft Web TWAIN service (Linux версия) to a Fedora computer
Для инсталляции Vintasoft Web TWAIN сервиса (Linux версия) на Fedora компьютер, необходимо выполнить следующие действия:
-
Загрузить RPM-пакет VintasoftWebTwainService-15.0.5.rpm по ссылке: https://www.vintasoft.ru/zip/VintasoftWebTwainService-15.0.5.rpm
-
Выполнить следующую команду в консоли:
sudo rpm -i VintasoftWebTwainService-15.0.5.rpm
Файлы Vintasoft Web TWAIN сервиса (Linux версия) будут установлены в папку "/opt/vintasoft/VintasoftWebTwainService/".
4. Деинсталляция Vintasoft Web TWAIN сервиса (Linux версия) с локального Fedora компьютера
Для деинсталляции Vintasoft Web TWAIN сервиса (Linux версия) с Fedora компьютера, необходимо выполнить следующие действия:
-
Выполнить следующую команду в консоли:
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.
-
TWAINLOGGING - определяет режим ведения журнала работы сервиса. Параметр может иметь следующие значения: 0 - ведение журнала отключено; 1 - включено ведение журнала работы; 2 - включено ведение журнала работы с расширенной информацией. По умолчанию значение равно 0.
Если ведение журнала включено, служба сохраняет лог-информацию в лог-файл "/opt/vintasoft/VintasoftWebTwainService/logs/VintasoftAspNetCoreTwainService64-debug.log".
6. Получение информации о статусе Vintasoft Web TWAIN сервиса (Linux версия)
Vintasoft Web TWAIN сервис (Linux версия) состоит из веб TWAIN сервиса (файлы VintasoftAspNetCoreTwainService64 и VintasoftAspNetCoreTwainService64.dll), который обслуживает запросы к локальным TWAIN и SANE устройствам.
Информация о статусе веб 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", если включено ведение журнала веб сервиса.
7. Устранение неполадок
7.1 VintaSoft Web TWAIN сервис (Linux версия) не доступен
Если Вы установили VintaSoft Web TWAIN сервис (Linux версия) на Ваш компьютер, но всё ещё видите сообщение об ошибке, что сервис не доступен, пожалуйста, выполните следующие действия:
-
Отмените регистрацию Vintasoft Web TWAIN сервиса (Linux версия) используя следующую консольную команду:
sudo /opt/vintasoft/VintasoftWebTwainService/VintasoftAspNetCoreTwainService64 /unregister
-
Зарегистрируйте Vintasoft Web TWAIN сервис (Linux версия) используя следующую консольную команду:
sudo /opt/vintasoft/VintasoftWebTwainService/VintasoftAspNetCoreTwainService64 /register
- Откройте URL "https://localhost:25329/api/VintasoftTwainApi/Status" и посмотрите информацию о онлайн статусе Vintasoft Web TWAIN сервиса.
7.2. TWAIN/SANE сканер не работает
Если VintaSoft Web TWAIN сервис (Linux версия) работает, но у Вас возникли проблемы с TWAIN сканером, мы рекомендуем попробовать следующие действия:
-
Получите последнюю версию TWAIN драйвера для TWAIN сканера с веб-сайта производителя TWAIN сканера и переустановите TWAIN драйвер.
-
Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Linux версия).
-
Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
Нам необходимо:
- Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
- Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.
Если VintaSoft Web TWAIN сервис (Linux версия) работает, но у Вас возникли проблемы с SANE сканером, мы рекомендуем попробовать следующие действия:
-
Установите приложение "xsane", если "xsane" не устанволен на Linux компьютере. Запустите приложение "xsane" и попробуйте получить изображения от SANE сканера с помощью "xsane".
-
Если "xsane" не может получить изображения от SANE сканера, Вам нужно попробовать обновить SANE драйвер для Вашего SANE сканера изображений.
-
Если "xsane" может получить изображения от SANE сканера, убедитесь что Вы используете последнюю версию VintaSoft Web Twain сервиса (Linux версия).
-
Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
Нам необходимо:
- Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
- Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.