Инсталлятор обновлений АвтоПарк

Инсталлятор ASU.exe предназначен для исполнения обновлений АвтоПарк как в открытом, так и в запакованном виде.

Обновление в открытом виде - это просто набор файлов; часть из них имеет специальное значение, о чем будет сказано ниже. Обновление в запакованном виде - это самораспаковывающийся архив, подготовленный при помощи WinZip Self-Extractor, снабженный цифровой подписью и имеющий расширение ".ASU". Расширение ".ASU" регистрируется сетевым инсталлятором АвтоПарк и считается "безопасным вложением", при открытии файлов с таким расширением по умолчанию запускается ASU.exe c ключом -RunAs.

Запакованное обновление выполняется следующим образом. По открытию ASU-файла запускается установленный у клиента ASU.exe c ключом -RunAs. Он проверяет цифровую подпись как файла обновления, так и собственного исполняемого файла ASU.exe, а затем позволяет выбрать, от имени какого пользователя выполнить обновление. Далее от имени выбранного пользователя запускается автоэкстрактор самораспаковывающегося архива, который извлекает исходные файлы обновления во временную папку в профиле пользователя и вновь запускает ASU.exe - на сей раз для выполнения распакованного обновления.

Цифровая подпись запакованного обновления играет двойную роль.

1. Дает гарантию безопасности пользователя. ASU-файл - это исполняемый файл, при передаче через Интернет он может быть испорчен или заражен вирусами. Перед запуском ASU-файла установленный у пользователя инсталлятор обновлений ASU.exe проверит цифровую подпись; если она не соответствует содержимому, инсталлятор не позволит выполнить обновление.
2. Некоторые почтовые программы (например Outlook Express) при попытке открытия файла из окна сообщения показывают издателя файла, т.е. автора цифровой подписи. Пользователь видит, что издатель обновления - "Polak IT", а не подозрительный "неизвестный издатель".

Начиная с версии 1.18 перед выполнением обновления от имени другого пользователя под Windows Vista и выше инсталлятор обновлений проверяет, не находится ли ASU-файл обновления в профиле текущего пользователя. Если ASU-файл находится в профиле, инсталлятор предложит скопировать его в папку "$(ReceiveRoot)\" (см. ниже) и выполнить обновление на копии, поскольку другой пользователь может не иметь прав чтения в профиле текущего пользователя.

Начиная с версии 1.21 под Windows Vista и выше инсталлятор обновлений проверяет, не находится ли ASU-файл обновления в кэше защищенного режима Internet Explorer (так будет, если обновление открывается из браузера). Запускать автоэкстрактор непосредственно из кэша защищенного режима IE нельзя, иначе процесс будет создан с низким уровнем доступа, т.е. без прав записи. Поэтому когда ASU-файл находится в кэше защищенного режима IE, инсталлятор обновлений копирует его в папку $(ReceiveRoot) и запускает оттуда.

Синтаксис командной строки ASU.exe

ASU.exe {<Ключи>}

Допустимы ключи:

• -RunAs ASUFile - распаковка и выполнение запакованного обновления от имени выбранного пользователя.
• -Run ASUFile - распаковка и выполнение запакованного обновления текущим пользователем.
• -RunWait ASUFile - распаковка и выполнение запакованного обновления текущим пользователем с ожиданием завершения.
• -ChkSign:None|Asu|Both - режим проверки цифровой подписи запакованного обновления: None - не проверять, Asu - проверять подпись только у ASU-файла обновления, Both - проверять подписи и ASU-файла и исполняемого файла ASU.exe.
• -AtHome - задает "домашний" режим выполнения обновления, о чем см. ниже. В отсутствие данного ключа предполагается "нормальный" режим выполнения обновления.
• -WaitOkTime:Infinite|Seconds - задает время ожидания нажатия OK в случае успешного завершения обновления, значение Infinite предполагает бесконечное (нетаймированное) ожидание.
• -ClientRedFile:ClientRedFilePath - задает путь к RED-файлу клиентской части проекта. Для множественных проектов всегда имеется ввиду клиентский RED-файл основного проекта.
• -SourceDir:SourceDir - задает путь к папке, в которой находятся файлы обновления в открытом виде. Если ключ не указан, предполагается, что файлы обновления находятся в текущей папке.

Коды завершения ASU.exe:

• 0 - обновление выполнено успешно;
• 1 - обновление не завершено, проект находится в нецелостном состоянии;
• 2 - обновление не выполнено, проект находится в состоянии до обновления, т.е. в целостном состоянии;
• 3 - неверная командная строка.

Специальные файлы обновления

Некоторые файлы обновления являются специальными, инсталлятор обновлений ASU.exe знает их имена, формат, использует их предопределенным образом при выполнении обновления.

Файл инструкции Readme.txt

Представляет собой обязательный текстовый файл в кодировке OEM 866. В инструкции должно быть указано следующее.

1. Назначение обновления.
2. Что нужно сделать перед выполнением обновления (если нужно).
3. Какой учетной записью следует выполнять обновление.
4. Что необходимо сделать после выполнения обновления (если нужно).

Поскольку инструкция дублируется в тексте e-mail сообщения, ASU.exe никак не использует этот файл и не проверяет его наличие. Поведение может быть изменено.

Файл предупреждения от автора обновления Warning.txt

Необязательный текстовый файл в кодировке OEM 866. Если среди исходных файлов обновления присутствует файл Warning.txt, перед выполнением скрипта обновления пользователь получит сообщение с текстом из Warning.txt и кнопками "OK" и "Отмена". Обычно таким образом дублируется некий особо важный пункт инструкции, который необходимо выполнить перед запуском обновления.

Файл регистрационной информации обновления Reg_card.ini

Представляет собой INI-файл (в кодировке ANSI 1251, как и все INI-файлы). Для инсталлятора обновлений имеют значение только перечисленные ниже параметры из секции "Autopark Software Upgrade".

1. _CLI_ - имя проекта (до 256 символов).
2. _CHN_ - имя канала обновлений (2 символа).
3. _PRV_ - номер (5 десятичных цифр) предыдущего обновления в канале.
4. _CUR_ - номер (5 десятичных цифр) данного обновления в канале.
5. _PRJ_ - числовой параметр, задает режим работы с множественными проектами и номер части проекта для тех же множественных проектов. Если параметр имеет пустое значение или вовсе отсутствует, предполагается, что все части множественного проекта используют общие программные файлы (ASL, FRM, MNU, WDO, XLA, ...). Физически перечисленные файлы располагаются внутри клиентской части основного проекта. Если же параметр _PRJ_ определен и не пуст, предполагается, что каждая часть множественного проекта имеет собственную копию программных файлов. Когда параметр имеет значение "0", обновление предназначено для одинарного проекта; значения "1", "2", ..., "10" предполагают множественный проект и задают часть, для которой будет выполнено обновление.
6. _ASB_ - флаг обновления ASB. Значение "1" является признаком обновления ASB.
7. _RBC_ - флаг сравнения DBD и DBP-файлов перед выполнением обновления. Начиная с версии 1.16 параметр игнорируется, сравнение не производится. До версии 1.16 значение "1" включало сравнение.

Файл скрипта обновления AsuScrpt.aus

Скрипт обновления AsuScrpt.aus - текстовый файл в кодировке OEM 866; каждая команда скрипта располагается на отдельной строке. Допускаются пустые строки. Строки, начинающиеся со слова Rem, считаются комментариями и игнорируются.

Команды скрипта имеют фиксированное количество параметров. Параметры отделяются от команды и друг от друга пробелами. Текст параметра можно заключить в кавычки. Если текст параметра содержит пробелы, кавычки обязательны. Имена команд и макросов распознаются регистронезависимо. В тексте параметров допускается применение предопределенных макросов, например:

UpdFile $(ClientProjectRoot)\ASL\TEST.ASL TEST.ASL

В процессе исполнения обновления текущей является папка исходных файлов обновления.

Форматы команд и полный список макросов приведены ниже.

Форматы команд

Имя целевого и исходного файлов в командах AddFile и UpdFile не обязано совпадать и этим фактом можно пользоваться. Известно, например, что автоэкстрактор WinZipSE не позволяет использовать кириллические имена файлов архива, для таких файлов можно выполнить транслитерацию.

Макросы периода выполнения

Как видно из таблицы, от номера проекта $(_PRJ_) зависят значения только двух папок: $(ClientProjectRoot) и $(ServerProjectRoot). Соответственно, только эти макросы и могут употребляться с префиксом проекта. Все остальные путевые макросы определяются из RED-файла основного проекта.

Порядок выполнения обновления

1. Считывание регистрационной информации обновления из файла "Reg_card.ini".
2. Определение папок проекта(ов).
3. Открытие для записи протокола выполнения обновлений.
   Протокол выполнения обновлений ведется в файле "$(MainProject.ClientProjectRoot)\Def\Upgrade.log". Защита от параллельного выполнения обновлений осуществляется на режиме открытия файла протокола.
4. Сравнение исполняемого файла ASU.exe с образцовым "$(ClientASBRoot)\ASU.EXE".
   Если ASU.exe запущен не из папки исходных файлов обновления (т.е. собственно ASU.exe не обновляется), размер и время модификации исполняемого файла сравнивается с размером и временем модификации файла, находящегося в папке "$(ClientASBRoot)\ASU.EXE".
5. Считывание и трансляция скрипта обновления AsuScrpt.aus.
   На данном этапе в частности выполняется замена макросов в параметрах команд скрипта на реальные значения. Если не определен макрос ApSrvASBRoot (папка сервера приложений ASB), содержащие его команды будут проигнорированы (будут считаться комментариями). Если не определен любой другой макрос, пользователь получит соответствующее сообщение, а обновление выполняться не будет. Сервер приложений ASB используется далеко не у всех клиентов, отсюда неоднотипное поведение.
6. Проверка порядка исполнения обновлений.
   Обновления должны выполняться в том порядке, в каком они были отправлены. Каждое обновление после успешного завершения оставляет файл-маркер "$(MainProject.ClientProjectRoot)\Def\$(_CHN_)_$(_CUR_).upd". Соответственно, каждое обновление перед выполнением проверяет наличие файла-маркера предыдущего обновления "$(MainProject.ClientProjectRoot)\Def\$(_CHN_)_$(_PRV_).upd". Начиная с версии 1.21, если маркер предыдущего обновления отсутствует, разыскивается существующий маркер. Если номер существующего маркера больше номера текущего обновления, предполагается, что текущее обновление уже выполнено.
7. Генерация файла-маркера текущего обновления "$(_CHN_)_$(_CUR_).upd".
   Файл-маркер не обязан присутствовать среди исходных файлов обновления. Он в любом случае будет создан автоматически в текущей папке (т.е. в папке исходных файлов обновления).
8. Предупреждение от автора обновления.
   Если среди файлов обновления присутствует файл Warning.txt, пользователь получит сообщение с текстом из Warning.txt и кнопками "OK" и "Отмена". Обычно таким образом дублируется некий особо важный пункт инструкции, который необходимо выполнить перед запуском обновления. Предупреждение отображается в том числе и в "домашнем" режиме.
9. Встроенные (автоматические) предупреждения.
   В обновлении, содержащем команду Rebuild, пользователь получит предупреждение о преобразовании структуры данных. В обновлении ASB - требование прекращения работы всех пользователей в АвтоПарке и, возможно, требование останова служб "ASB Server" и/или "ASB Application Server". Под Windows 2000/XP/2003/Vista/2008/7 при необходимости службы будут остановлены автоматически.
10. Проверка доступности файлов, участвующих в данном обновлении.
    На этой стадии все добавляемые, обновляемые и удаляемые файлы последовательно открываются для записи. Если не удается открыть файл, отображается предупреждение с вариантами "Повторить"/"Отменить". Т.о. минимизируется риск неполного выполнения обновления из-за недоступности файлов. Начиная с версии 1.18 для занятых исполняемых файлов (.ael, .dll, .exe, .ocx, .olb) предлагается еще один вариант помимо перечисленных: переименовать и удалить занятый файл. В версии 1.21 были приняты меры для предотвращения выполнения обновления без подачи сигнала сброса кэша программ. Чтобы проверить подключение к серверу, выполняется утилита USR. В случае неудачи обновление выполняться не будет.
11. Копирование файлов обновления в папку "$(ReceiveRoot)\$(_CHN_)_$(_CUR_)\".
12. Определение папки для сохранения прежних версий обновляемых файлов.
    По умолчанию принимается папка "$(SaveRoot)\$(_CHN_)_$(_CUR_)". Если эта папка не пуста, принимается подпапка с именем, сформированным из текущего времени: "$(SaveRoot)\$(_CHN_)_$(_CUR_)\YYNNDDHH.MMS".
13. Выполнение скрипта обновления.
    Особенности выполнения скрипта.
    • Перед исполнением команд AddFile, UpdFile, DelFile, RemFile, SetINI и DelINI прежняя версия целевого файла копируется в папку для сохранения прежних версий. Если выясняется, что в папке прежних версий уже существует файл с таким именем, к имени файла добавляется подстрока "[уникальный_номер]", например "Autoexec[1].asl" вместо "Autoexec.asl". Разумеется, в протокол заносится фактически использованное имя.
    • В "домашнем" режиме скрипт обновления ASB не выполняется.
    • В "домашнем" режиме вместо команды "Rebuild patternDbdFile" фактически выполняется команда "UpdFile $(ServerProjectRoot)\SDEF\$(_CLI_).dbd patternDbdFile".
    • В "нормальном" режиме для множественных проектов с общими программными файлами команда Rebuild выполняется n раз по числу проектов. Не рекомендуется использовать эту возможность для внешних проектов.
14. Регистрация успешного выполнения обновления.
    В папку "$(MainProject.ClientProjectRoot)\Def" помещается файл-маркер "$(_CHN_)_$(_CUR_).upd". После выполнения данного действия обновление считается успешно выполненным. Затем удаляется файл-маркер предыдущего обновления "$(_CHN_)_$(_PRV_).upd".
15. Сигнал сброса кэша программ (NPM).
    Если обновлением были затронуты ASL, MNU или WDO-файлы, подается сигнал NPM, чтобы пользователи перечитали программные файлы. В домашнем режиме операция пропускается. Фактически запускается клиент ASB с ключом -NPM на скрытой консоли с перехваченным стандартным выводом. В режиме общих программных файлов для множественных проектов клиент ASB запускается n раз по числу проектов. Если первой командой обновления была команда Rebuild, на подключение к проекту может быть затрачено значительное время из-за загруженности ASB-сервера переиндексацией. Начиная с версии 1.21, если сигнал сброса кэша программ подать не удалось, администратор получит сообщение, а в протокол upgrade.log будет прописано предупреждение.
16. Только для обновлений ASB: запуск остановленных ранее служб ASB и разрешение входить в АвтоПарк всем пользователям.
17. Ожидание нажатия кнопки OK.
    По умолчанию в домашнем режиме ожидание ограничено двумя секундами, после чего ASU.exe завершается. В нормальном режиме ожидание неограничено. Поведение при ожидании может быть изменено ключом командной строки -WaitOkTime.