Приложение. дополнительная информация о распространении ПО

В данной главе поясняется использование LANDesk Management Suite для распространения программного обеспечения (SWD) и файлов на устройства через сеть.

В этой главе вы изучите следующее:

Обработка пользовательских сценариев
Руководство по сценариям для файлов сценариев развертывания (.ini)
Описание кодов ошибок распространения ПО

Обработка пользовательских сценариев

Пользовательские сценарии, которые управляют запланированными задачами (Сервис > Распространение > Запланированные задачи) (Tools > Distribution > Scheduled tasks), обрабатываются в трех разделах:

Предварительный (Premachine): Предварительный раздел пользовательского сценария обрабатывается первым и только один раз — при запуске задачи. Используйте данный раздел для задач без целевых устройств и/или для Targeted Multicast. В предварительном разделе сценария следует использовать только локальные команды LOCxxx.
Компьютер (Machine): Команды в данном разделе сценария запускаются во вторую очередь и только один раз для целевого устройства. Эти команды могут использовать удаленные или локальные исполнительные команды и в основном используются для удаленного выполнения SDCLIENT.EXE. Перед выполнением команд в данном разделе сценария на целевых устройствах необходимо установить агент SWD.
Посткомпьютер (Postmachine): Данный раздел обрабатывается последним и тоже только один раз — после обработки всех устройств. Функция распространение ПО не добавляет команды к данный раздел, кроме того, он поддерживает только локальные команды LOCxxx. Обработка команд в данном разделе не выполняется, если устройствам в задаче не удается выполнить их. Сценарий InventoryScanner.ini, который входит в состав Management Suite, содержит подробные сведения об этих командах сценариев.

Команды пользовательского сценария

Пользовательские сценарии поддерживают различные локальные и удаленные команды:

LOCEXEC: Команда локального выполнения, которая используется для выполнения приложения на локальном устройстве, которым всегда является главный сервер.
LOCDEL: Команда локального удаления, которая удаляет файл на локальном устройстве.
LOCMKDIR: Команда локального создания папки, которая создает папку на локальном устройстве.
LOCRD: Команда локального удаления папки, которая использует для удаления папки на локальном устройстве.
REMCOPY: Команда удаленного копирования, которая копирует файл с локального устройства на удаленное устройство.
REMEXEC: Команда удаленного выполнения, которая выполняет приложение на указанном удаленном устройстве.
REMDEL: Команда удаленного удаления, которая удаляет файл на удаленном устройстве.
REMMKDIR: Команда удаленного создания папки, которая создает папку на удаленном устройстве.
REMRD: Команда удаленного удаления папки, которая удаляет папку на удаленном устройстве.

Параметры командной строки

Распределение ПО упрощается благодаря использованию сценария развертывания. SDCLIENT.EXE управляет пакетами с помощью параметров командной строки из переданного в приложение файла сценария.

SDCLIENT.EXE поддерживает следующие параметры командной строки:

sdclient.exe /p="<путь к пакету>" [/g=<guid пакета>] [/All] [/R] [/N] [/An] [/Ac] [/Ab] [/fui] [/msi] [/exe] [/bw=xxx] [/E]

Параметр	Описание
/p=<путь к пакету>	Путь к пакету. Его необходимо указать независимо от типа пакета. Этот параметр определяет путь UNC или URL к пакету, который требуется установить на локальном устройстве.
/g=<guid пакета>	Идентификатор GUID пакета. Для пакетов распространения ПО (SWD) или автоустановки (AutoInstall). Данный параметр указывает идентификатор GUID пакета. Идентификатор GUID пакета используется для проверки кэша локальных файлов .cfg на наличие копии файла .cfg пакета.
/All	Флаг удаления. Этот флаг указывает на то, что соответствующий пакет SWD или MSI необходимо удалить, а не установить. Вводить флаг следует с учетом регистра (вариант "/all" не работает).
/R	Флаг обязательной перезагрузки. Это флаг указывает на то, что после установки пакета устройство всегда должно быть перезагружено. Данная рекомендация относится не ко всем пакетам MSI.
/N	Флаг запрета перезагрузки. Это флаг указывает на то, что устройство не должно перезагружаться после установки пакета.
/An	Флаг автоматической установки. Этот флаг указывает на то, что установка должна проводиться в автоматическом режиме. Это значит, что во время установки не должен отображаться никакой интерфейс пользователя, включая его самые мельчайшие элементы.
/Ac	Флаг отключения отмены. Этот флаг отключает для пользователя возможность отмены установки.
/Ab	Флаг отсутствия фона. Этот флаг применяется только к пакетам SWD. Он отключает отображение голубого фона при установке пакета.
/fui	Флаг полного пользовательского интерфейса. Этот флаг указывает на то, что для устаревших пакетов и пакетов MSI следует использовать полный пользовательский интерфейс.
/msi	Флаг пакета MSI. Этот флаг указывает на то, что путь к пакету приведен для файла пакета MSI.
/exe	Флаг исполняемого пакета. Этот флаг указывает на то, что путь к пакету приведен для устаревшего пакета или обычного исполняемого файла.
/bw=xxx	Требования к пропускной способности. Указывает минимальные требования к пропускной способности для запуска сценария пакета.
/F	Флаг общего файла. Этот флаг принуждает SDCLIENT.EXE загрузить файл в папку LDClient.
/msg=""	Этот флаг отправляет сообщение на главный сервер во время выполнения задачи. Сообщение отображается в состоянии задачи в столбце Сообщение (Message) окна Запланированные задачи (Scheduled tasks).

Пути HTTP и UNC

Ниже приведены примеры файлов .ini распространения ПО, отражающие различия между файлами сценариев с путями HTTP и UNC.

Файл сценария с путем HTTP:

; Этот файл был создан диспетчером настольных систем

[MACHINES]

REMEXEC0=C:\Program Files\LANDesk\LDClient\sdclient.exe -p=http://<web-сервер>/packages/test package.exe -g={6DD454C0-11D3A0D1-a000B3B5-9BACBBC99CFC6D-9CE3504801A0D4B2FZ0829F08} -Ac -Ab

Файл сценария с путем UNC:

; Этот файл был создан диспетчером настольных систем

[MACHINES]

REMEXEC0=C:\Program Files\LANDesk\LDClient\sdclient.exe -p=\\sample_core\onefile\test package.exe -g={6DD454C0-11D3A0D1-a000B3B5-9BACBBC99CFC6D-9CE3504801A0D4B2FZ0829F08} -Ac -Ab

Обратите внимание на то, что оба файла .ini содержат схожие элементы. В разделе MACHINES параметр -P обозначает путь, по которому устройство загрузит пакет ПО. В примере HTTP используется путь http://<web-сервер>/packages/test package.exe.

Далее идет параметр -G, обозначающий GUID — уникальный идентификационный номер для каждого из пакетов. Этот идентификатор создается компоновщиком и позволяет во время установки различать пакеты с одинаковыми именами.

Руководство по сценариям для файлов сценариев развертывания (.ini)

Вам не требуется использовать окно Создание сценария распространения ПО (Create software distribution script) для создания файла сценария развертывания. Файл развертывания представляет собой файл .ini с настройками, которые устройство должно использовать при установке пакета. При необходимости можно создавать собственные файлы развертывания в текстовом редакторе, таком как Блокнот.

Файл сценария .ini для развертывания ПО содержит следующие компоненты:

[MACHINES]

REMEXEC0=C:\Program Files\LANDesk\LDClient\sdclient.exe

/p="http://computer_name/95Packages/Acro32_95.exe"

/g={281B46C0-11D3766F-a0008bab-F9751AC966F808-66E3BC2DF01A0D4B2F88670DE4}

/Ac

Параметры команды REMEXEC0

Параметры для команды REMEXEC0 были помещены на отдельные строки, чтобы облегчить восприятие компонентов. В файле .ini команда должна записываться в одну строку.

REMEXEC0 является командой удаленного выполнения. Если в одном файле сценария требуется использовать несколько команд REMEXEC0, увеличивайте числовой индекс команды при каждом использовании. Например, если в одном файле .ini используется три вызова REMEXEC, они должны называться REMEXEC0, REMEXEC1 и REMEXEC2. Увеличение числового индекса команд не требуется, если они используются в разных файлах.

Параметр C:\Program Files\LANDesk\LDClient представляет собой правильный путь к агенту SWD.

Описание кодов ошибок распространения ПО

На правой панели в окне Запланированные задачи (Scheduled tasks) консоли отображается состояние задачи. Если щелкнуть надпись "Сбой" (Failed) под задачей, можно просмотреть устройства, на которых произошел сбой задания, и соответствующие сообщения и журналы. Состояние и ошибки регистрируются в следующих файлах:

Если ошибка произошла при попытке доступа к пакету, она записывается в файл AICLIENT.LOG.
Если ошибка произошла при обработке пакета (например, при копировании файлов), она записывается в файл INST32.LOG.
В файле SDCLIENT.LOG содержится общая сводная информация о каждом запросе установки, полученном от главного сервера.

Эти файлы журналов сохраняются на каждом устройстве. В приведенной далее таблице указаны коды ошибок, которые могут содержаться в этих файлах.

Код ошибки	Определение
101	Установка отменена пользователем.
102	Доступ к файлу запрещен.
103	Использован неверный пароль.
104	Сеть не найдена, или указан неверный путь.
105	Ошибка загрузки.
106	Не удалось создать сокет.
107	Не удалось открыть сеанс HTTP.
108	Ошибка загрузки CFG.
109	Ошибка сохранения CFG.
110	Не существует папки сохраненных CFG.
111	Ошибка доступа к файлу.
112	Ошибка получения CFG.
113	Не удалось создать резервную копию CFG.
114	Ошибка порождения подпроцесса, поскольку другой пакет уже устанавливается.
117	Не удалось создать каталог резервного копирования.
180	Сетевая ошибка. Не удается выполнить инициализацию.
188	Тайм-аут во время загрузки по HTTP.
189	HTTP-соединение прервано.
191	Узел не найден.
197	Файл HTTP не найден.
201	Не удается найти файл UNC.
202	Файл не найден на диске установки.
203	Не удалось создать файл в указанном месте.
204	Недостаточно дискового пространства на целевом диске установки.
205	Указан неверный диск, или требуемый для данной установки диск недоступен.
206	Файл имеет слишком длинное имя и его не удалось установить с помощью 16-разрядной программы установки. Вы можете продолжить установку остальных файлов.
207	Указанный файл не является исполняемым.
208	В реестре существует несколько записей удаления с использованием одинакового исходного пути.
209	Не удалось найти исполняемый файл удаления.
210	Обнаружен неверный сжатый файл, или произошла ошибка HTTP.
211	Перед использованием API необходимо успешно выполнить команду AFXSOCKETINIT.
212	Ошибка подсистемы сети.
213	Доступных дескрипторов файла больше нет.
214	Не удалось создать сокет. Не было доступного пространства буферов.
215	Указанный адрес уже используется.
216	Попытка подключения отклонена.
217	Указан неверный адрес узла.
218	В настоящее время сеть недоступна с данного узла.
219	Тайм-аут при попытке подключения, причем соединение не установлено.
220	Виртуальное соединение прервано из-за тайм-аута или другой ошибки.
221	Виртуальное соединение сброшено на удаленной стороне.
222	Неустановленная ошибка HTTP.
223	Ошибка HTTP; файл не открыт для чтения.
224	Ошибка HTTP; не указан параметр длины содержимого.
225	Ошибка HTTP; недостаточно памяти.
226	Ошибка распределения памяти.
227	Не удалось прочитать файл.
228	Недостаточно памяти.
229	В файле .cfg имеется ошибка в строке XX.
240	Указан неверный временный путь. Не удалось получить доступ или создать. В целевом компьютере проблема с конфигурацией.
301	Это приложение никогда не было установлено на данном компьютере; его нельзя удалить.