Обновление ПроАТМ

Внимание

ПроАТМ можно обновить только на более новую версию.
По истечении срока действия SSL-сертификата ПроАТМ небходимо обновить.

Обновление с помощью мастера установки

  1. Запустите программу установки ProATMInstall.exe. Откроется окно выбора устанавливаемых компонентов. Компоненты, выбранные во время предыдущей инсталляции, запоминаются системой. При этом доступно удаление и добавление новых компонентов.

    ../_images/update-add_and_remove_part.jpg

    Рисунок 3. Добавление и удаление_компонентов

  2. В окне выбора кастомизационного пакета можно указать путь к новому пакету. Для этого поставьте галочку Установить кастомизацию.

    ../_images/update-choose_customisation.jpg

    Рисунок 4. Выбор кастомизационного пакета

    Если установка нового кастомизационного пакета не требуется, уберите галочку Установить кастомизацию. Если же при предыдущей инсталляции устанавливался кастомизационный пакет, то он будет использован и при обновлении. По умолчанию поле Установить кастомизацию отмечено, и выполняется поиск кастомизации в текущей папке. ПО ПроАТМ в процессе работы создает определенный набор файлов и параметров реестра, которые необходимо сохранить при обновлении, а также в ряде случаев, определенные настройки вносятся вне кастомизационных пакетов, поэтому в процессе обновления некоторый набор файлов и настроек переносится в обновленную версию.

    Примечание

    При планировании обновлений учитывайте следующую особенность: если при обновлении ПроАТМ не указывается новый пакет кастомизации, то установщик сначала применяет кастомизационный пакет, а затем импортирует набора параметров предыдущей установки. Если устанавливается новый кастомизационный пакет, то сначала импортируется набор параметров предыдущей установки, а затем применяется новый кастомизационный пакет.

  3. После окна выбора кастомизационного пакета процесс обновления аналогичен процессу установки.

Удаленное обновление из командной строки

ПО ПроАТМ поддерживает удаленное обновление. То есть имеется возможность запуска обновления внешней системой. При этом установка ПО производится полностью автономно, без вмешательства оператора. Все необходимые параметры передаются в командной строке.

Во избежание появления ошибок следует иметь в виду, что:

  • удаленное обновление должно быть запущено из-под учетной записи с правами администратора;

  • все процессы, препятствующие удалению/установке ПроАТМ, должны быть прекращены – программа установки автоматически завершает такие процессы;

  • путь к пакету кастомизации должен быть указан корректно.

По окончании установки окно автоматически не закрывается, так как УС необходимо перезагрузить для корректного запуска ПроАТМ. Предполагается, что процесс перезагрузки должна инициировать та же внешняя система, которая инициировала процесс обновления.

Для удаленного обновления ПО из командной строки воспользуйтесь ключом /i установщика Windows. Удаленное обновление запускается следующей командой:

<Путь к файлу>\ProAtmInstall.exe /i %s /qn /lvx* "<Путь для сохранения файла логирования установки>" CUSTOMIZATION_PATH="<Путь к папке с новой кастомизацией>"

Пример:

ProAtmInstall.exe /i %s /qn /lvx* "ProAtmInstall_SilentInstall.log" CUSTOMIZATION_PATH="C:\Install\Custom".

Если параметр CUSTOMIZATION_PATH не задан, то будет использован ранее установленный кастомизационный пакет.

Автоматическое обновление

По согласованию с конечным пользователем в состав пакета кастомизации может входить настройка автоматического обновления терминального ПО (ПроАТМ, ПроАТМ/XFS, Firmware устройств).

Порядок работы автоматического обновления

При входе в систему под гостевой учетной записью специальное задание и утилита Starter.cmd параллельно проверяют наличие файлов ProAtmInstall.exe и ProAtmXfsInstall.exe в папке обновлений.

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

Если в папке обнаружен exe-файл, то запуск терминального ПО прекращается и выполняется переустановка ПО. Во время обновления пользователь видит заставку «Выполняется обновление». После завершения установки ПО exe-файл удаляется и система перезагружается.

Примечание

Завершение установки обновлений ПроАТМ/XFS и ПроАТМ фиксируется в системных журналах записями «Перезагрузка после обновления ПроАТМ/XFS.» и «Перезагрузка после обновления ПроАТМ.» соответсвенно.

Примечание

После трех неудачных попыток переустановить ПроАТМ exe-файл удаляется. Работа продолжается на прежней версии.

Если в папке одновременно есть и ProAtmInstall.exe и ProAtmXfsInstall.exe, то они выполняются последовательно, между их выполнением система перезагружается (приоритет отдается обновлению ПроАТМ/XFS).

Если в папке обновлений обнаружено несколько файлов обновления, то они выполняются последовательно.

Если в автоматическое обновление включено обновление прошивки купюроприемника (CashCode, DORS 210BA, DORS 820BA), то утилита FS365.Starter.exe настраивается и проверяет наличие Firmware-файлов в папке обновлений. Если такой файл обнаружен, то запуск терминального ПО приостанавливается и выполняется обновление прошивки купюроприемника под пользовательской учетной записью. После выполнения файлы Firmware удаляется и продолжается запуск терминального ПО.

Настройка системы для автоматического обновления

При установке пакета настроек создаются ограниченные учетные записи (модули кастомизации Security и UserAccountLimited), в shell гостевой учетной записей проиходит замена базового файла explorer.exe на файл starter.cmd. Starter.cmd запускает утилиту FS365.Starter.exe. В планировщике заданий создается задание. Это задание:

  • перед запуском терминального ПО проверяет в специальной папке наличие обновлений;

  • запускает сценарий обновления ПроАТМ и ПроАТМ/XFS под учетной записью администратора;

  • после обновления удаляет файлы ProAtmInstall.exe и ProAtmXfsInstall.exe.

Параметры задания:

  • имя задания – «Update_ATM»;

  • при выполнении задачи использовать системную учетную запись;

  • условие запуска – при входе в систему под гостевой учетной записью «Loader»;

  • действия – запуск update_atm.cmd (сценарий обновления ПроАТМ и ПроАТМ/XFS), путь к папке, где должны лежать обновления указывается в поле Аргумент.

В конфигурационный файл CustomStart.xml утилиты FS365.Starter.exe добавляется вызов файла update_misc.cmd, в параметрах ссылки на который указан путь к папке, где должны лежать обновления (см. Редактирование файла CustomStart.xml и Параметры реестра).

Задание, если находит exe-файл, то запускает его под системной учетной записью. Утилита FS365.Starter.exe запускает cmd-файл под пользовательской учетной записью.

Файл update_misc.cmd:

  • Проверяет наличие файлов update_DORS*.cmd.

  • Если обнаружены файл update_DORS*.cmd, то update_misc.cmd приостанавливает запуск терминального ПО и последовательно запускает обнаруженный файлы update_DORS*.cmd. Каждый запускаемый файл update_DORS*.cmd, после выполнения команд удаляется.

  • После завершения работы и удаления всех файлов update_DORS*.cmd запуск терминального ПО продолжается.

Если в автоматическое обновление включено обновление прошивки купюроприемника, то в файл CustomStart.xml добавляется вызов файла update_firmware_*.cmd. Файл update_firmware_*.cmd проверяет наличие Firmware-файлов в папке обновлений. Если такие файлы обнаружены, то update_firmware_*.cmd запускает обновление firmware. После обновления прошивки Firmware-файлы удаляются.

Выполнение пользовательских команд

Для запуска команд и приложений рекомендуется использовать систему запуска терминального ПО DORS (утилита FS365.Starter.exe). При необходимости использования повышенных или пониженных привилегий можно воспользоваться планировщиком заданий ОС. Также можно использовать любые другие доступные инструменты (папка автозагрузки, реестр и др.).

Переход с ПроАТМ версии 5.6.1 или более ранней на версию 5.7.x

При переходе с ПроАТМ версии 5.6.1 или более ранней на версию 5.7.x удаляются некоторые конфигурационные файлы и параметры реестра. Если необходимо использовать старые конфигурационные файлы и параметры реестра для новой версии ПроАТМ, выполните следующие действия:

  1. Выйдите из обслуживания следующими способами:

  • отправкой из фронтальной системы на переход в состояние OutOfService;

  • применить входящую в комплект компонентов ПроАТМ утилиту changestate.exe, выполнив C:\FS365\Applications\changestate.exe с параметрами -outofservice и -wait 60.

  1. Завершите работу терминального ПО следующими способами:

  • нажать клавишу Esc и подтвердить завершение работы ПО;

  • выполнить C:\FS365\Starter\FS365.Starter.exe с параметром -SHUTDOWN.

  1. Закройте все фоновые процессы: XFS-драйверы и приложения. Чтобы остановить XFS-драйвер, кликните правой кнопкой мыши по иконке драйвера на панели задач и в контекстном меню выберите пункт Exit. Повторите это действие для каждого запущенного XFS-драйвера.

    ../_images/update-stop_XFS.jpg

    Рисунок 5. Остановка XFS-драйверов

    Также XFS-драйвера можно остановить, выполнив команду:

    C:\FS365\XFS\shqShutdown.exe CIM IDC PIN PRR SIU Redlabel
    

    Примечание

    Можно также с помощью диспетчера задач завершить следующие процессы: Ogre.exe; Agent247.exe; MonitoringAgent.exe; rlsrvc.exe. Или же выполнить команду taskkill с параметрами /f, /im и указанием имени закрываемого приложения, например, Ogre.exe.

  2. Сохраните конфигурационные файлы и параметры:

    • сохраните во временной папке файлы C:\FS365\Application\TransactAuth.db и C:\FS365\Application\OgreProtect.dll.

    • экспортируйте разделы реестра [HKLM\SOFTWARE\FS365\OperCycles], [HKLM\SOFTWARE\FS365\NDC\Config] и [HKLM\SOFTWARE\FS365\Statistics].

  3. Удалите ПроАТМ:

    • Для УС производства NCR остановите следующие службы:

      • NCRRootProc;

      • NCRSilentDebug;

      • NCRCiController;

      • AptraResourceManager;

      • AptraUSERCDI.

    • Остановите сервис, зайдя в пункт Панель управления > Администрирование > Службы или выполнить команду net stop с указанием имени останавливаемого сервиса.

    • Удалите ПроАТМ по инструкции в соответствии с рекомендациями, предлагаемыми Мастером установки ПроАТМ.

  4. После успешного удаления ПроАТМ перезагрузите УС.

  5. Установите ПроАТМ версии 5.7.0 и выше с помощью мастера установки или выполните командуProAtmInstall.exe с параметрами:

    ProAtmInstall.exe /i %s /qn /lvx* "<Путь для сохранения файла логирования установки>" CUSTOMIZATION_PATH="<Путь к папке с кастомизацией>"
    
  6. Восстановите старые настройки.

    • войдите в РОП как администратор и активируйте протокол NDC («СЕРВИС МОДУЛИ» > «АВТОРИЗАЦИЯ» > «АКТИВИРОВАТЬ NDC»);

    • закройте терминальное ПО;

    • восстановите сохраненные параметры реестра.

  7. Перезагрузите УС. После перезагрузки системы терминальное ПО запустится автоматически.