Skip to main content

Установка Локального агента на Windows

Цель

Установить Локальный агент мониторинга на рабочую станцию Windows с подключённым локальным МФУ для учёта заданий печати.

Предусловия

    Сервер Мониторинга установлен и доступен по сети. Получен клиентский ключ из панели администратора Мониторинга (см. ниже "Подготовка: получить клиентский ключ"). Командная строка запущена от имени администратора.

    Что потребуется

      Дистрибутив Локального агента, содержащий 5 файлов в одной директории:
        установочный msi-пакет файл конфигурации в формате XML: Printum.JobTracking.WindowsService.exe.config. скрипт установки: install.bat скрипт удаления: uninstall.bat файл редактирования реестра: word_hotfix.reg IP-адрес (или имя) сервера Мониторинга и порт (8000 для http, 8001 для https). Клиентский ключ из раздела "Клиентские ключи" в панели администратора Мониторинга.

        Подготовка: получить клиентский ключ

          Войдите в панель администратора Мониторинга. Перейдите в раздел "Локальные принтеры" → "Клиентские ключи", нажмите кнопку «Добавить». Заполните поля:
            Название — имя ключа (любое значение). Ключ — произвольная строка формата UUID ( ********-****-****-****-************ ), например 5f17bc69-e37e-47ce-b025-60a57dcd20b1. Заполнять не требуется — генерируется автоматически. Описание — подробная информация (необязательное поле). Включен — должен быть активирован (установлена галочка). Компания — выбрать компанию, к которой будет привязан ключ. Нажмите кнопку "Сохранить". Ключ отобразится в таблице "Клиентские ключи".

            Шаги установки

            Шаг 1. Сохранить файлы дистрибутива

            Сохраните на локальный диск компьютера, к которому подключено устройство, файлы локального агента. Все 5 файлов должны находиться в одной директории.

            Шаг 2. Настроить конфигурационный файл

            Откройте конфигурационный файл Printum.JobTracking.WindowsService.exe.config и отредактируйте параметры:

            <setting name="PrintumURL" serializeAs="String">
<value>http://127.0.0.1:8000/localprinter/</value>
</setting>
<setting name="PrintumClientKey" serializeAs="String">
<value>cb074c67-30a3-43c2-9ffc-26753f6441c2</value>
</setting>

            где:

              PrintumURL — замените http://127.0.0.1:8000 на IP-адрес (или имя) системы мониторинга и действующий порт. Порт может быть 8000 для http или 8001 для https схемы подключения. PrintumClientKey — замените cb074c67-30a3-43c2-9ffc-26753f6441c2 на значение, полученное в разделе "Подготовка: получить локальный ключ". SerialNumber — серийный номер МФУ, генерируется автоматически. Заполнять не нужно.

              Для работы по протоколу и порту https-8001 добавьте CA-сертификат из сервера с Мониторингом. Текущий используемый CA-сертификат находится в директории /home/printum/certs/ca/printum_ca.crt . Сохраните файл.

              Шаг 3. Запустить установку

              Запустите от имени администратора установщик install.bat.

              При успешном завершении установки в консоли появится сообщение:

              Install finished. Msiexec log saved in install.log.

              Шаг 4. Проверить работоспособность

              Запустите печать любого документа на подключённом устройстве.

              Зайдите в Личный кабинет, раздел "Управление" → "Устройства". В панели фильтров укажите период, в который попадает сегодняшний день. Проверьте, что устройство появилось в списке.

              Зайдите в Личный кабинет, раздел "Аналитика" → "Отчеты по устройствам". Проверьте, что напечатанные страницы были учтены.

              Устройства, подключённые по USB, в конце строки помечаются значком USB.

              Ожидаемый результат

                Установка завершается с сообщением Install finished. Локальный МФУ отображается в Личном кабинете Мониторинга с отметкой USB. Задания печати учитываются.

                Как проверить установку

                Распечатать тестовый документ и убедиться, что устройство появилось в Личном кабинете → "Управление" → "Устройства", задание появилось в Личном кабинете → "Управление" - "Задания".

                Примечание: В некоторых версиях MS Word (например, v.14, MS Office 10 32-bit) неправильно прописывается число копий, отправленных на печать. Microsoft рекомендует устанавливать последние сервис-паки, либо самостоятельно добавлять ключ в реестр Windows. Для этого в состав пакета установки включён файл правки реестра word_hotfix.reg — необходимо отредактировать его в соответствии с установленной версией MS Word и запустить от имени администратора. После этого перезапустить MS Word.

                Типовые ошибки

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

                Для исправления:

                  Откройте командную строку с правами администратора, передите в C:\Windows\System32\spool\PRINTERS. Остановите спулер: 
                  net stop spooler
                    Удалите файлы: 
                    del *.shd
del *.spl
                      Запустите спулер: 
                      net start spooler

                      Связанные страницы

                        Локальный агент — справка по компоненту Установка Локального агента на Windows — групповые политики Обновление Локального агента на Windows Удаление Локального агента на Windows
                        Back to top