Работа с утилитой Kaspersky Update Utility 4 для Linux из командной строки
В этой статье описана работа с утилитой Kaspersky Update Utility (далее KUU) из командной строки: ручной запуск утилиты и настройка запуска по расписанию.
Работа с утилитой через графический интерфейс описана в отдельной статье.
Как скачать KUU и начать ее использовать
- Скачайте архив с утилитой на устройство в директорию /tmp.
- Распакуйте архив и задайте владельца директории, например /opt/kaspersky/kuu и root:root, с помощью команд:
mkdir /opt/kaspersky/kuucd /opt/kaspersky/kuucp /tmp/<Имя_архива_KUU>.tar.gz ./tar -xvf ./<Имя_архива_KUU>.tar.gzchown root:root ./ -R
Как запустить утилиту из командной строки
Запустите утилиту с помощью команды:
Возможные параметры утилиты описаны ниже.
Например, чтобы запустить утилиту в тихом режиме с файлом конфигурации filename.ini и записью отчета трассировки в файл report.txt, выполните команду:
Перед первым запуском утилиты мы рекомендуем настроить список языков для скачиваемых обновлений, чтобы снизить объем загружаемых данных. Выберите только используемые на устройстве языки. Для этого в файле updater.ini укажите значения параметра DownloadLocalizations через «;» (например: ru; en). Список доступных языков для Kaspersky Endpoint Security для Linux смотрите в статье. Если утилита должна загрузить базы для семейства приложений Kaspersky Security для Windows Server, Kaspersky Industrial CyberSecurity for Nodes для Windows версии 4.0 и ниже, Kaspersky Embedded Systems Security для Windows версии 3.4 и ниже, добавьте также значение LangNone (например: ru; en; LangNone).
При первом запуске утилиты с параметром -u внимательно прочитайте Лицензионное соглашение «Лаборатории Касперского» и Политику конфиденциальности для Продуктов и Сервисов в файле license.txt, а также Положение о Kaspersky Security Network в файле ksn.txt. Если вы согласны со всеми пунктами, нажмите Y на клавиатуре.
Чтобы изменить решение об участии в Kaspersky Security Network, откройте в текстовом редакторе файл updater.ini и укажите значение параметра AgreedWithKsn:
- true, если согласны с Положением о Kaspersky Security Network;
- false, если не согласны с Положением о Kaspersky Security Network.
Как настроить запуск утилиты по расписанию в cron
Шаг 1. Обновите информацию о новых версиях приложений в файле updater.ini
Конфигурационный файл утилиты updater.ini содержит список поддерживаемых приложений. Этот список обновляется при каждой успешной загрузке обновлений, но только в режиме графического интерфейса.
Вы можете обновить файл одним из этих способов:
- Способ 1 (подходит для устройств с графическим интерфейсом): запустите утилиту в режиме графического интерфейса на устройстве и выполните обновление. Выбирать приложения в списке не нужно.
- Способ 2 (подходит для устройств без графического интерфейса):
- Выполните обновление вручную через командную строку, чтобы скачался файл updater.xml, с помощью команды:
./uu-console.sh -s -u -o -t -r
- Откройте для чтения файл updater.xml и посмотрите точное название версии приложения, которое вы планируете автоматически обновлять.
Например, Kaspersky Endpoint Security для Linux версии 12.1 будет называться KasperskyEndpointSecurityForLinux_12_1_0:<element>
<name>KasperskyEndpointSecurityForLinux_12_1_0</name>
<version>12.1.0.1274</version>
(...)
</element> - Откройте файл updater.ini и добавьте в раздел [ComponentSettings] последней строкой значение:
<Название_версии_приложения>=trueНапример:KasperskyEndpointSecurityForLinux_12_1_0=true
- Выполните обновление вручную через командную строку, чтобы скачался файл updater.xml, с помощью команды:
- Способ 3 (подходит для устройств без графического интерфейса при наличии другого устройства с графическим интерфейсом):
- На стороннем устройстве с графическим интерфейсом:
- Запустите утилиту для Linux или для Windows в режиме графического интерфейса и выполните обновление. Выбирать приложения в списке не нужно.
- Откройте файл updater.ini и полностью скопируйте содержимое раздела [ComponentSettings].
- На устройстве, на котором вы планируете запускать утилиту по расписанию в cron:
- Выполните обновление вручную через командную строку, чтобы скачался файл updater.xml, с помощью команды:
./uu-console.sh -s -u -o -t -r
- Откройте файл updater.ini и замените содержимое раздела [ComponentSettings] на скопированное ранее с другого устройства.
- Выполните обновление вручную через командную строку, чтобы скачался файл updater.xml, с помощью команды:
- На стороннем устройстве с графическим интерфейсом:
Шаг 2. Укажите дополнительные параметры в файле updater.ini
Чтобы задать директорию для хранения файлов обновлений, укажите следующие значения в файле updater.ini для параметров MoveToCurrentFolder, MoveToCustomFolder и UpdatesFolder:
MoveToCustomFolder=true
TempFolder=
UpdatesFolder=/var/opt/kaspersky/kuu
Мы рекомендуем загружать файлы обновлений в директорию, доступную всем пользователям, например в /var или в /tmp, при этом не рекомендуем указывать для этого директории внутри /opt, /home и /root.
Также мы рекомендуем настроить список языков для скачиваемых обновлений, чтобы снизить объем загружаемых данных. Выберите только используемые на устройстве языки. Для этого в файле updater.ini укажите значения параметра DownloadLocalizations через «;» (например: ru; en). Список доступных языков для Kaspersky Endpoint Security для Linux смотрите в статье. Если утилита должна загрузить базы для семейства приложений Kaspersky Security для Windows Server, Kaspersky Industrial CyberSecurity for Nodes для Windows версии 4.0 и ниже, Kaspersky Embedded Systems Security для Windows версии 3.4 и ниже, добавьте также значение LangNone (например: ru; en; LangNone).
Шаг 3. Настройте запуск утилиты по расписанию
- Внимательно прочитайте Лицензионное соглашение «Лаборатории Касперского» и Политику конфиденциальности для Продуктов и Сервисов в файле license.txt, а также Положение о Kaspersky Security Network в файле ksn.txt.
- Запланируте загрузку обновлений каждые четыре часа с помощью команд:
sudo echo "* */4 * * * /opt/kaspersky/kuu/uu-console.sh --accepteula --acceptprivacypolicy --acceptksn -u" > ./cron.txtsudo crontab ./cron.txt
Параметры утилиты
Вы можете запустить утилиту со следующими параметрами:
| Параметр | Описание |
|---|---|
| --accepteula | Принять положения Лицензионного соглашения «Лаборатории Касперского». Текст Лицензионного соглашения входит в комплект поставки утилиты (файл license.txt). Согласие с положениями Лицензионного соглашения является необходимым условием для использования утилиты. Если вы не задали этот параметр, утилита запросит ваше согласие в командной строке. Чтобы продолжить использовать утилиту, примите условия положений Лицензионного соглашения, нажав Y на клавиатуре. |
| --acceptprivacypolicy | Принять Политику конфиденциальности для Продуктов и Сервисов. Текст Политики конфиденциальности входит в комплект поставки утилиты (файл license.txt). Согласие с Политикой конфиденциальности является необходимым условием для использования утилиты. Если вы не задали этот параметр, утилита запросит ваше согласие в командной строке. Чтобы продолжить использовать утилиту, примите условия Политики конфиденциальности, нажав Y на клавиатуре. |
| --acceptksn | Согласиться участвовать в Kaspersky Security Network (KSN). Текст Положения о Kaspersky Security Network входит в комплект поставки утилиты (файл ksn.txt). Если вы не задали этот параметр, утилита запросит ваше согласие в командной строке. Чтобы согласиться участвовать в KSN, нажмите Y на клавиатуре. |
| --declineksn | Отказаться участвовать в Kaspersky Security Network (KSN). Если вы не задали этот параметр, утилита запросит ваше согласие в командной строке. Чтобы отказаться участвовать в KSN, нажмите N на клавиатуре. |
| -u | Выполнить обновление. |
| -o <filename>
-c <filename> |
Задать файл конфигурации. Если этот параметр не указан, используется файл конфигурации updater.ini. |
| -t | Включить запись трассировки работы утилиты. |
| -d | Включить создание дампа при падении утилиты. |
| -s | Включить тихий режим без вывода сообщений. |
| -r | Включить создание отчета. |
| -h | Вызвать описание параметров. |
| --proxy_login <login> | Установить логин прокси-сервера. |
| --proxy_password <password> | Установить пароль прокси-сервера. |
Хранение учетных данных пользователя для доступа к прокси-серверу
KUU для Linux сохраняет учетные данные пользователя для доступа к прокси-серверу в каталоге текущего пользователя <home_path>/.kuu/updater_s.ini. Если вы не хотите сохранять учетные данные на диске, воспользуйтесь консольной версией утилиты и передайте их на время работы утилиты, используя параметры командной строки:
- --proxy_login <login>
- --proxy_password <password>
Запускайте KUU от специально созданного для нее непривилегированного пользователя. Подробнее в
Коды возврата
После выполнения команды в командной строке отобразится значение кода возврата. Используйте таблицу ниже, чтобы убедиться в успешной работе утилиты или выявить причину проблемы, если возникнет ошибка.
| Код возврата в Linux | Значение |
|---|---|
| 0 | Обновления скачаны |
| 1 | Нет новых обновлений для скачивания |
| 255 | Ошибка при обработке команды в командной строке |
| 254 | Ошибка в работе утилиты обновления (исключение или другая ошибка, в том числе неверные параметры) |
| 251 | Ошибка во время обновления (не все компоненты обновлены, не найден файл в источнике обновления, недопустимая подпись файла, поврежден индексный файл, недопустимая структура XML в файле, файл не найден) или ошибка сети |
| 250 | После обновления базы неконсистентны |
| 253 | Другое |