//========================================== UKP USAGE TOTURIAL ==============================================//

ПЕРВИЧНЫЕ ДЕЙСТВИЯ:
 Если вы используйте UKAIP для того что-бы пропачить IceWarp Merak ОБЯЗАТЕЛЬНО немедленно заблокируйте SMTP доступ на
 icewarp.com и полностью перекройте доступ к licenseprocessor.icewarp.com

1)Скопируйте бинарник UAKIP в папку инсталляции KWR/KMS/KCN/Merak.
2W)[Windows Only]
   Откройте коммандную строку(cmd.exe):
   cd "Your-KMS_KCN_MERAK_OR_KWR_installation_folder"
3)Сгенерируйте себе лицензию таким образом:
  [KWR]
  ukaip86.exe winroute.exe -l license.key
  /ukaip_i686 winroute.exe -l ./license.key
  [KMS/KCN]
  ukaip86.exe mailserver.exe -l license.key
  /ukaip_i686 ./mailserver -l ./license.key
  [ICEWARP MERAK]
  ukaip86.exe {ONE_OF_SERVICE_PROGS,CONFIG_APP,SETUP} -l license.key
  ./ukaip_i686 {ONE_OF_SERVICE_PROGS,TOOL_APP} -l license.key
    Например: ukaip86.exe smtp.exe -l license.key
              ukaip86.exe setup.exe -l license.key(См ниже про установщик).
              ./ukaip_i686.exe ./pop3 -l license.key
              ./ukaip_i686.exe ./tool -l license.key
4)Запустите UKAIP с помощью следующей процедуры чтобы пропачить KMS/KCN/KWR/Merak:
  Примечание: Если ваша Ось 64-ёх разрядная то вы можете использовать соответствующие бинарники(т.е ukaip64.exe вместо ukaip86.exe
        и/или ./ukaip_amd64 вместо ./ukaip_i686) 
  Мастдай:
   [KWR]: ukaip86.exe winroute.exe
   Примечание: Если вы хотите использовать WinRoute вместе с WebFilter используя файл лицензии то запустите пачинг так(Смешанный режим Анлим Триал+Лицензия):
          ukaip86.exe winroute.exe -force-trial-kwf-with-lic
   [KMS] ukaip86.exe mailserver.exe
   [ICEWARP MERAK] ukaip86.exe cal.exe config.exe control.exe fastisapi.exe im.exe pop3.exe smtp.exe sendmail.exe
   Примечание: Если вы хотите использовать лицензию уже в процессе установки/обновления IceWarp Merak-а то ван нужно пропачить
   так-же и инсталлятор.Откройте файл icewarp-%version%-%date_and_build_in_nightlies%.exe который вы слили с сайта разработчика(примерно 70 метров) используя 7-zip и извлеките оттуда файл с незаурядным названием "[0]".
   Теперь откройте этот странный файл [0] в 7-zip и расапкуйте архив. В расапкованной папке вы найдёте дюжину файлов включая 4-ёх метровый setup.exe. Пропачьте его с помощью UKAIP:
    ukaip86.exe setup.exe
   Установите Мерак запустив setup.exe(Не забываем после установки тормознуть и пропачить все сервисы+ютилиту настройки+fastisapi).      
  Пингвинсяны:
   [KMS] ./ukaip_i686 ./mailserver
   [KWR] ./ukaip_i686 ./winroute
   Примечание: Если вы хотите использовать WinRoute вместе с WebFilter используя файл лицензии то запустите пачинг так(Смешанный режим Анлим Триал+Лицензия):
               ./ukaip_i686 winroute.exe -force-trial-kwf-with-lic
   [ICEWARP MERAK] ./ukaip_i686 ./cal ./control ./icewarpd ./im ./pop3 ./smtp ./sendmail ./tool


ЕСЛИ ВЫ используете IceWarp UCS 10.X то пропустите этот шаг.
5) Запустите UKP с помощью следующей процедуры чтобы пропачить McAfee:
  Мастдай:
  ukaip86.exe "%Relative_Path_From_Installation_Folder_To_AV_Plugins_Folder%\avir_mcafee.dll"

    Пример для KWR:
     ukaip86.exe avirplugins\avir_mcafee.dll
  Пингвинсяны:
  ukaip_i686 ./rel_path_to_avplugs/avir_mcafee.so

  ПРИМ:
   Если у вас в сети есть собственное локальное(Внутреннее) зеркало с обновлениями макаки то вы можете использовать его при пачинге:
     Мастдай:
      ukaip86.exe "%Relative_Path_From_Installation_Folder_To_AV_Plugins_Folder%\avir_mcafee.dll" -use-custom-mirror-for-mcafee
     Пингвинсяны:
      ./ukaip_i686 "%Relative_Path_From_Installation_Folder_To_AV_Plugins_Folder%/avir_mcafee.so" -use-custom-mirror-for-mcafee
     UKP вопросит вас ввести DNS имя вашего сервера и относительный путь к папке обновлений.

6) Если вы установили WinRoute и вам нужен WebFilter то выполните следующие шаги для регистрации триала:
  5а)Останавливаете сервис WinRoute. 
  5б)Пачите winroute.exe/winroute с UKP со свичем -force-trial-kwf-with-lic. 
   5b1)На стадии пачинга с номером [11] вы получите сгенерированный Trial-ID.
   5b2)Пропишите его в своём файле winroute.cfg ,в строке <variable name="TrialId">Ваш_ID</variable>.
   5b3)На стадии пачинга с номером [12] UKAIP попросит вас ввести серийный номер E-Soft.(Вы его получите когда прийдёт время).
   5b4)UKAIP продолжит свою магию пачинга и попути отложит в своей ппаке файлик getkey.php.
   5b5)Положите этот файлик на локальный HTTP сервер(С активированным PHP на 80-ом порту) в виртуальную папку /kwfp0wnz/.
       NOTE: Вы можете поменять URL(по умолчанию http://localhost/kwfp0wnz/) используя свич -advanced в UKAIP.
             Если вы меняете сервер по умолчанию на сервер HTTPS(SSL) то заранее предупреждаю что Керио требует серверного
             сертификата с цифровой подписью мировых CA. 
  5в)Пачите avir_mcafee.dll/avir_mcafee.so с помощью UKP.   
  5д)Запускаете сервис WinRoute. 
  
  5к)Тестируете функциональность Kerio WebFilter.

7)Установка лицензии:
  Kerio: Положите файл license.key в папку %Директория_Установки_Кери%\license\.
  IceWarp: Положите файл license.key в папку %Директория_Установки_Мерака\config\.
       ПРИМЕЧАНИЕ: ДАЖЕ НЕ ДУМАЙТЕ ИСПОЛЬЗОВАТЬ ВКЛАДКУ "ЛИЦЕНЗИЯ" В ЮТИЛИТЕ НАСТРОЙКИ МЕРАКА. ЮТИЛИТА НАСТРОЙКИ УСТАНАВЛИВАЕТ ДО-АКТИВАЦИОННУЮ
                   ЛИЦЕНЗИЮ В ТО ВРЕМЯ КАК МЫ СТАВИМ УЖЕ АКТИВИРОВАННУЮ.

       ПРИМЕЧАНИЕ 2(ДЛЯ ПИГВИНОВОДОВ):
             LI1)Тормозим демон IceWarp -> /etc/rc.d/init.d/icewarp stop
             LI2)Пихаем сгенерированную лицензию в %папка_установки%/config/ с названием license.key
                 С установочным путём по умолчанию конечный путь будет: /opt/icewarp/config/
             LI3)Пусакем демона IceWarp -> /etc/rc.d/init.d/icewarp start
             Для проверки успешности установки нашей лицензии делаем следующее:
              LI4)Находясь в папке установки IceWarp-а запускаем: ./tool display system c_license_xml
                 Если видим крохотную строку: c_license_xml=
                             Значит сервак нас послал с нашей лицензией
                 Если же виидм c_license_xml= Куча текста и данных
                             Значит всё пучком :) 
8) Вот и всё мои беспонтовые малыши :)
  
ПРИМЕЧАНИЕ:

Если требуется оставить файл источник нетронутым можно воспользоваться опцией -o. В этом случае изменённые данные будут сохранены в новый файл.

ukaip86 winroute.exe.ORG -o winroute.exe
Файл winroute.exe.ORG будет использоваться как фафйл-Источник и модификаций над ним производиться не будет , в то время как все изменения сохранятся в новом файле winroute.exe.

Патчинг нескольких файлов за одно выполнение:
Cmd:
ukaip86 winroute.exe avirplugins\avir_mcafee.dll
Пропачит оба файлика :)

Более сложная комманда (Используем файлы оригиналы с опцией -o):
ukaip86 winroute.ORG -o winroute.exe avira_backup\makaka.dll -o avirplugins\avir_mcafee.dll


И ещё кое-что:

Специальная опция -autoquit может быть использована для автоматизации процесса работы UKP(Например создание Bathch файла) - С этой опцией UKP выйдет как закончит свою работу и не будет ждать пока
вы нажмёте клавишу. 



Успехов товарищи :)