granindb / tcpprintservice Goto Github PK

Сервис предназначен для эмуляции сетевого принтера.

1. Скомпилировать проект.
2. Скопировать TCPPrintService.exe в любой каталог.
3. Скопировать нужные библиотеки Qt.
4. Создать файл настроек. 
	Для Windows 10 C:/ProgramData/TCPPrintService/settings.json
5. Установить сервис TCPPrintService.exe -install. Установку производить от имени администратора.
	5.1 Для проверки запуска сервиса запустить его с параметром -exec. В консоль будет выведена информация по запуску.
6. Если необходимо, настроить сервис для автоматического запуска.
7. Открыть входящие порты (9100 ...).
8. Запустить сервис из консоли "Службы", либо командой TCPPrintService.exe без параметров.


Возможен запуск как приложения командой TCPPrintService.exe -exec.
Все сообщения и отладочная информация выводятся в консоль.

Пример запуска
	$ TCPPrintService.exe -exec
	Info   Config file name is "C:/ProgramData/TCPPrintService/settings.json"
	Info   Logging type "textfile"
	Info   Log file name is C:/ProgramData/TCPPrintService/TCPPrintService.log
	Info   Folder created - C:/ProgramData/TCPPrintService/jobs/HP Universal Printing PCL 5 (v6.1.0)
	Info   Listen address for printer "HP Universal Printing PCL 5 (v6.1.0)" is 192.168.0.1 port 9100
	Info   Listen address for printer "HP3524" is 0.0.0.0 port 9101
	Info   Service started successful

По умолчанию (если параметр не указан) все сообщения сервис записывает в event log - "logtype": "system".
Для того, чтобы сообщения записывались в файле настроек необходимо указать параметр "logtype": "textfile"  

{
  "logtype: "system",
  "printers": [
	{
	  "listen": "192.168.0.1",
	  "interfacewaittime" : 120,
	  "localname": "HP Universal Printing PCL 5 (v6.1.0)",
	  "active": true,
	  "port": 9100,
	  "subnets": "192.168.1.0/24, ::/32",
	  "log": "ape",
	  "storejobs": true,
	  "jobspath": "jobs/HP Universal Printing PCL 5 (v6.1.0)"
	},
	{
	  "localname": "HP3524",
	  "active": true,
	  "port": 9101,
	  "subnets": "",
	  "log": "p",
	  "storejobs": false,
	  "jobspath": ""
	}
  ]
}
listen				- Регистрируется только на указанном адресе. Если не указано, или указана пустая строка, 
						то сервис прослушивает на всех интерфейсах, но только с протоколом IPv4.
						Для работы по протоколу IPv6 необходимо указать адрес IPv6 для прослушивания.
						Работа по протоколу IPv6 не проверялась.
interfacewaittime	- Время ожидания сетевого интерфейса в секундах. Иногда сервис стартует раньше, что сетевая карта получает IP адрес.
						Этот параметр позволяет задержать привязку сервиса к интерфейсу.
						Значение по умолчанию - 60 секунд.
logtype				- Тип журнала "system" - event log, "textfile" - Для Windows 10 это файл C:/ProgramData/TCPPrintService/TCPPrintService.log.
localname 			- Имя локального принтера в системе.
active				- Активность сервиса для указанного принтера (true/false).
port				- Номер порта для указанного принтера.
subnets				- Подсети с которых разрешен досут к принтеру (подсети указываются через запятую)
						Если указана пустая строка, то проверка не производится.
log					- Логирование (a - access, p - print, e - error, d - debug).
storejobs			- Сохранять файлы заданий в файл (true/false).
jobspath			- Путь, по которому будут сохраняться задания. Если указан относительный путь, то папка будет создана относительно
						папки "C:/ProgramData/TCPPrintService/" для Windows 10.