Updating the anti-virus database in HTTP mode

With default configuration, Kaspersky Scan Engine uses the anti-virus database from the ./bin/bases directory. You can update the anti-virus database by sending a signal or an HTTP request to Kaspersky Scan Engine.

When the anti-virus database is updated, the encrypted user agent string of Kaspersky Scan Engine is transferred to Kaspersky. For the list of transferred data, see section "Data transferred to Kaspersky during an update".

Updating the database on demand

If you want to update the database manually, use updating on demand.

To update the database on demand in Linux by using signals:

  1. Before starting the kavhttpd service, specify the update setting in kavhttpd.xml.
  2. Start the kavhttpd service.
  3. Send a SIGUSR2 signal to the kavhttpd service.

    If the client and Kaspersky Scan Engine are installed and running on the same computer, you can send an HTTP request to the /api/v3.0/update/start address to update the database. Note that if you send this request from a different computer, Kaspersky Scan Engine will throw a 405 Method Not Allowed error. If the database update has been successfully initiated, the HTTP response will contain the following JSON object:

    {

    "status": "update started"

    }

    To learn how to track the database update status, see subsection "Getting the database update status" below.

To update the database on demand in Linux by using the sample HTTP client,

Call the sample HTTP client with the -d option:

kavhttp_client -j -d

To update the database on demand in Windows,

Call the sample HTTP client with the -d option:

kavhttp_client.exe -j -d

For details on scheduling automatic database updates, see section "Configuring updating in HTTP mode", subsection "Scheduling automatic database updates."

Getting the database update status

If you want to obtain the database update status, send a GET request to the /api/v3.0/update/status address or the /api/v3.1/update/status address.

You can only send this request if the client and Kaspersky Scan Engine are installed and running on the same computer.

When Kaspersky Scan Engine receives the request, it returns a response in the following format:

{

"status": "%UPDATE_STATUS%",

"progress": "%UPDATE_PROGRESS%",

"last_update_result": "%UPDATE_RESULT%",

"last_update_time": "%UPDATE_TIME%",

}

where:

Additional fields in KAV protocol version 3.1

If you send a GET request to the /api/v3.1/update/status address, you can get more information about the database update process. Some database updates can be used only after a reboot of the operating system or a restart of KAV SDK. In this case a response of KAV HTTPD has the extended format:

{

"status": "%UPDATE_STATUS%",

"progress": "%UPDATE_PROGRESS%",

"last_update_result": "%UPDATE_RESULT%",

"last_update_time": "%UPDATE_TIME%",

"action_needed": "%ACTION_NEEDED%",

"action_apply_period": "%APPLY_PERIOD%"

}

Here:

Page top