


                 ООО "Доктор Веб"

                Dr.Web(R) для Linux
               Обновление компонентов

              Руководство администратора

                   Версия 5.0.0

===================================================================
Материалы, приведенные в данном документе, являются собственностью
ООО "Доктор Веб" и не могут быть использованы ни в каких публикациях
без письменного разрешения ООО "Доктор Веб" и ссылки на источник.

Dr.Web - зарегистрированный товарный знак ООО "Доктор Веб"

Остальные упоминаемые названия продуктов являются товарными знаками
или зарегистрированными товарными знаками соответствующих фирм.

В программное обеспечение могут вноситься изменения, не отраженные в
данной документации. Исправленные и дополненные редакции документа
оперативно размещаются на веб-сайте www.drweb.com.
===================================================================

(C) 2003-2009 ООО "Доктор Веб"
Россия, Москва - Санкт-Петербург
http://www.drweb.com/


          СОДЕРЖАНИЕ

1. ВВЕДЕНИЕ
2. МОДУЛЬ ОБНОВЛЕНИЯ Dr.Web Updater
  2.1. Запуск модуля обновления. Параметры командной строки.
  2.2. Конфигурационный файл. Параметры модуля обновления.
3. КОНТАКТЫ

                         1. ВВЕДЕНИЕ

Компоненты программ Dr.Web нуждаются в регулярном обновлении.
Также для успешной работы антивируса и программы фильтрации трафика
должны регулярно обновляться базы данных вирусов и тематические
черные и белые списки интернет-ресурсов.

Антивирусная база состоит из нескольких файлов с расширением vdb,
представляющих собой отдельные ее части. На серверах обновлений эти файлы
могут лежать также в lzma-архивах. При появлении новых вирусов выпускаются
небольшие, размером в один или несколько килобайтов, файлы (дополнения),
которые содержат фрагменты базы, описывающие эти вирусы.

Дополнения являются едиными для всех поддерживаемых платформ и делятся
на два вида: ежедневные "горячие" обновления (drwtoday.vdb) и еженедельные
регулярные обновления (drwXXXYY.vdb), где XXX - номер версии антивируса,
а YY - порядковый номер обновления, начиная с номера 00 (например, файл
первого регулярного обновления для версии 5.0.0 именуется drw50000.vdb).

"Горячие" обновления выпускаются ежедневно или несколько раз в день для
оперативной реакции на новые вирусные угрозы. Особенность установки "горячих"
дополнений связана с тем, что в промежутке между выходом регулярных
(нумерованных) дополнений файл drwtoday.vdb пополняется новыми записями,
т.е. его необходимо устанавливать вместо имевшегося ранее.

В момент выхода очередного регулярного дополнения все записи из этого файла
переписываются в регулярное дополнение, а сам он очищается (выпускается файл
drwtoday.vdb, не содержащий ни одной записи базы данных).

Следовательно, при обновлении базы вручную необходимо устанавливать
все отсутствующие у пользователя регулярные дополнения, после чего
переписывать файл "горячего" дополнения вместо имевшегося ранее.

Чтобы подключить дополнение к основной вирусной базе, соответствующий файл
должен быть помещен в каталог /var/drweb/bases или иной каталог,
определенный в конфигурационном файле программы.

Сигнатуры, позволяющие обнаруживать и предотвращать распространение
вирусоподобных вредоносных программ (рекламных, программ дозвона,
программ взлома и т.п.), поставляются в виде двух отдельных вирусных баз
с аналогичной структурой - drwrisky.vdb и drwnasty.vdb. К этим базам также
поставляются регулярные обновления dwrXXYYY.vdb и dwnXXYYY.vdb, а также
"горячие" обновления dwrtoday.vdb и dwntoday.vdb.

Периодически (в частности, в связи с появлением радикально новых
вирусных и антивирусных технологий) выпускаются новые версии пакета с
обновленными алгоритмами, заложенными в антивирусное ядро.
Одновременно с этим сводятся воедино все ранее выпущенные дополнения
базы, и новая версия комплектуется актуализированной основной базой,
содержащей описания всех известных на момент ее выхода вирусов. Как
правило, при переходе на новую версию пакета сохраняется
преемственность формата баз, т.е. новые базы могут быть подключены к
старому антивирусному ядру. Однако при этом не гарантируется обнаружение
или излечение новых вирусов, для борьбы с которыми потребовались
обновленные алгоритмы антивирусного ядра.

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

- drwebase.vdb - основная база, получаемая вместе с новой версией
  пакета;
- drwXXXXX.vdb - еженедельные регулярные дополнения вирусной базы;
- drwtoday.vdb - "горячие" дополнения;
- drwnasty.vdb - основная база вредоносных программ, получаемая вместе
  с новой версией пакета;
- dwnXXXYY.vdb - еженедельные регулярные дополнения базы вредоносных программ;
- dwntoday.vdb - "горячие" дополнения базы вредоносных программ;
- drwrisky.vdb - основная база потенциально опасных программ, получаемая
  вместе с новой версией пакета;
- dwrXXXYY.vdb - еженедельные регулярные дополнения базы потенциально опасных
  программ;
- dwrtoday.vdb - "горячие" дополнения базы потенциально опасных программ.

Тематические черные и белые списки адресов интернет-ресурсов состоят из файлов
с расширением dws. На серверах обновлений эти файлы также могут лежать в
lzma-архивах.

- dwfXXXNN.dws - черный список, где XXX - трехбуквенное сокращение темы списка
  (например, prn для "porno", mlw для "malware"), а NN - порядковый номер
  списка из одной темы.
- white_dwfXXX.dws - белый список, где XXX - трехбуквенное сокращение темы
  списка.

Для автоматизации получения и установки дополнений вирусной базы и
тематических черных и белых списков следует использовать модуль обновления,
подробно описанный ниже.

          2. МОДУЛЬ ОБНОВЛЕНИЯ Dr.Web Updater

2.1. Запуск модуля обновления. Параметры командной строки

Модуль обновления представляет собой написанный на Perl скрипт update.pl
и находится в каталоге, содержащем исполняемые файлы программы.

Настройки модуля обновления хранятся в главном конфигурационном файле
(drweb32.ini по умолчанию), который находится в каталоге /etc/drweb/. Для
использования другого конфигурационного файла полный путь к нему необходимо
указать параметром командной строки при запуске скрипта.

Команда его запуска имеет следующий вид:

> /opt/drweb/update.pl [параметры]

В качестве параметра командной строки может быть указан параметр
not-need-restart. Возможны три варианта его использования:

a. Если данный параметр не задан, то по завершении работы модуля обновления
   update.pl будут перезагружаться все демоны (maild, icapd и drwebd), для
   которых в процессе обновления был изменен/удален/добавлен хотя бы один
   компонент.
b. Если просто указать параметр not-need-restart, не задав значения, то
   по завершении работы модуля обновления update.pl демоны maild, icapd
   и drwebd перезагружаться не будут, даже если были обновлены в процессе.
c. Если при задании параметра --not-need-restart в качестве его значения были
   указаны названия демонов (через запятую, без пробелов, регистр не важен),
   то соответствующие демоны перезагружаться не будут, а все остальные -
   будут при наличии обновлений.

Допустимые названия в значении параметра not-need-restart: maild, icapd,
drwebd.

Примеры использования:
    1) /opt/drweb/update.pl -not-need-restart
    2) /opt/drweb/update.pl -not-need-restart=maild,icapd
    3) /opt/drweb/update.pl -not-need-restart=drwebd

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

ЗАМЕЧАНИЕ. Указание компонента программы для обновления существенно
в тех случаях, когда Демон и Сканер имеют разный номер версии или 
установлены в различные каталоги.

В настоящее время поддерживаются две версии формата параметров командной
строки модуля обновления. В первой версии может быть указан только один
параметр - полное имя используемого конфигурационного файла. Во второй
версии могут быть указаны в любом порядке следующие параметры (или любой
из них):

--ini=полное_имя_конф_файла

--what=компонент_для_обновления

Если имя конфигурационного файла не задано, используется
/etc/drweb/drweb32.ini.
Параметр "компонент_для_обновления" может принимать значения scanner или
daemon.

Обновление происходит следующим образом:

- модуль обновления читает конфигурационный файл;

- из конфигурационного файла используются параметры, находящиеся в секции
  [Updater] (описание параметров см. ниже), а также параметры:

  EnginePath - служит для определения версии демона и каталога, в который
  помещается обновленный файл drweb32.dll;

  VirusBase - служит для определения каталога, в который помещаются обновления
  вирусных баз;

  UpdatePath - служит для определения каталога, в который помещаются все
  остальные принятые файлы;

  PidFile  - служит для определения файла, из которого читается идентификатор
  процесса drwebd, использующийся для перезагрузки демона;

- модуль запрашивает с сервера список обновлений, затем - lzma-архивы
  соответствующих баз, и в случае отсутствия последних, скачивает базы в виде
  vdb и dws файлов. Для распаковывания lzma-архивов используется утилита
  lzma, путь к которой задается значением параметра LzmaDecoderPath в секции
  [Updater].

- обновления раскладываются по каталогам, как это описано выше (при этом
  принимаются все файлы для текущей версии Dr.Web; если в списке обновлений
  будут найдены секции от более поздних версий, для них будут приняты
  только *.vdb).


2.2. Конфигурационный файл. Параметры обновления

Конфигурационный файл представляет собой текстовый файл (что позволяет
редактировать его удобным вам редактором), построенный по следующему
принципу:

--- начало файла ---
[Имя секции 1]
Параметр1 = значение1, ..., значениеK
.....
ПараметрM = значение1, ..., значениеK

......

[Имя секции X]
Параметр1 = значение1, ..., значениеK
.....
ПараметрY = значение1, ..., значениеK
--- конец файла ---

Если строка начинается с символов ";" или "#", она считается строкой
комментариев - такие строки пропускаются при чтении
параметров из конфигурационного файла.

Если какой-либо параметр не задан либо закомментирован, то это не означает,
что у него нет значения. В таких случаях берется вшитое в код значение
по умолчанию. Лишь некоторые параметры являются необязательными или
не имеют значений по умолчанию, и об этом сообщается явным образом.

Значения могут быть заключены в кавычки (и должны быть заключены в
кавычки, если содержат пробелы). Некоторые параметры могут иметь
несколько значений, разделителем является "," (запятая), при описании
параметра это будет сказано явно. Если в поле значения параметра в
данном описании значения заключены в {}, то параметр может принимать
только одно из этих значений.

Имя секции настроек для скрипта обновления - [Updater].

Параметры будут описываться следующим образом:

ИмяПараметра = ПсевдоЗначениеПараметра
        Описание параметра
        {Может ли иметь несколько значений}
        Значение по умолчанию: 
                {значение | отсутствует}

Ниже приведено описание параметров в порядке их следования в файле
конфигурации, создаваемом при установке программы.

UpdatePluginsOnly = {Yes | No}
        Значение Yes предписывает модулю не производить обновление Демона
         и Сканера, а ограничиться только обновлением плагинов.
        Значение по умолчанию: 
                No

Section = {Daemon | Scanner}
        Указывает, настройки из какой секции будут использоваться
        для определения версии программы, путей к вирусным базам и т.п.
        Настройка может быть переопределена при запуске скрипта 
        при помощи параметра командной строки --what= 
        Значение по умолчанию: 
                Daemon

ProgramPath = {путь к файлу}
        Путь к Демону/Сканеру. Используется системой обновлений Dr.Web
        для получения информации о версии и API установленного
        исполняемого файла.
        Значение по умолчанию:
                /opt/drweb/drwebd

SignedReader = {путь к файлу}
        Эта программа используется системой обновлений Dr.Web для
        чтения подписанных файлов.
        Значение по умолчанию:
                /opt/drweb/read_signed

LzmaDecoderPath = {путь к файлу}
        Путь к файлу программы для распаковывания lzma-архивов.
        Значение по умолчанию:
                /opt/drweb

LockFile = {путь к файлу}
        Путь к файлу, предназначенному для предотвращения совместного
        использования некоторых файлов на время их обработки модулем
        обновления.
        Значение по умолчанию:
                /var/drweb/run/update.lock

CronSummary = {Yes | No}
        При указании значения Yes модуль обновления выдает сообщение о 
        результатах каждой сессии в файл stdout. Этот режим может
        использоваться для оповещения по электронной почте администратора,
        если скрипт запускается при помощи демона cron.
        Значение по умолчанию: 
                Yes

DrlFile = {путь к файлу}
        Путь к файлу, содержащему список серверов обновления. Модуль
        обновления выбирает сервера обновления из этого списка случайным
        образом. Данный файл подписан ООО "Доктор Веб", не подлежит
        редактированию пользователем и обновляется автоматически.
        Значение по умолчанию:
                /var/drweb/bases/update.drl


DrlDir = {путь к каталогу}
        Указывает путь к каталогу, содержащему подписанные ООО "Доктор Веб"
        *.drl файлы со списками серверов обновления для каждого из плагинов.
        Значение по умолчанию: 
                /var/drweb/drl/

Ниже описываются параметры конфигурационного файла, используемые
скриптом обновления для управления системной утилитой wget:

Timeout = {число в секундах}
        Задает значение параметра --timeout утилиты wget.
        Значение актуально для одной сессии загрузки, а не для
        всей процедуры обновления. Пустое значение или отсутствие
        параметра означает неопределенное значение таймаута.
        Значение по умолчанию: 
        90

Tries = {численное значение}
        Количество попыток установки соединения модулем обновления.
        Значение по умолчанию: 
        3

ProxyServer = {имя или IP-адрес прокси-сервера}
        Имя или IP-адрес используемого прокси-сервера.
        Значение по умолчанию: 
                пусто (прокси-сервер не используется)

ProxyLogin = {имя}
        Задает значение параметра --proxy-user утилиты wget.
        Значение по умолчанию: 
                пусто 

ProxyPassword = {пароль}
        Задает значение параметра --proxy-passwd утилиты wget.
        Значение по умолчанию:
                пусто 

Ниже указываются настройки ведения протокола обновления.

LogFileName = {имя файла}
        Имя файла отчета. В качестве имени можно указать syslog, тогда
        отчет будет вестись средствами системного сервиса syslogd. При
        использовании syslog нужно обратить внимание на параметры
        SyslogFacility и SyslogPriority. Поскольку syslog имеет несколько
        файлов для протоколирования разных событий и разных степеней их
        важности, то, основываясь на этих двух параметрах и содержимом
        конфигурационного файла syslog (обычно /etc/syslogd.conf), можно
        определить, куда будет писаться отчет программы.
        Значение по умолчанию: 
                /var/drweb/log/updater.log

LogLevel = {Debug | Verbose | Info | Warning | Error}
        Задает степень детальности протоколирования.
        Значение по умолчанию: 
                Verbose

                         3. КОНТАКТЫ

Компоненты программного комплекса Dr.Web находятся в постоянном развитии.
Наиболее свежую информацию об обновлениях и новости можно получить на сайте:
http://www.drweb.com 

Отдел продаж: 
http://buy.drweb.com
e-mail: sales@drweb.com

Консультации пользователей осуществляются по следующим адресам:
http://support.drweb.com 
e-mail: support@drweb.com 

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

- полное название и версию дистрибутива UNIX-системы;
- версию программного комплекса Dr.Web.
