Contents
Updating the Integration Server and Integration Server Console
The Integration Server and Integration Server Console must be updated using an account that belongs to local administrator group.
Close the Integration Server Console before starting the update.
The update is performed by installing the new version of the Integration Server and the Integration Server Console.
Updating requires at least 4 GB of free space on the drive containing the %ProgramData% folder on the device where the previous version of the Integration Server and Integration Server Console are installed.
You can remove the Integration Server and Integration Server Console in one of the following ways:
- If you use a Windows-based Kaspersky Security Center to manage Kaspersky Security, and in accordance with the recommendations of Kaspersky specialists, you used the Kaspersky Security Components Installation Wizard to install the Integration Server and Integration Server Console, we recommend to also perform the update using the wizard.
You can update the Integration Server and Integration Server Console by using the Kaspersky Security Components Installation Wizard in interactive mode or in silent mode.
During the update, you can save a backup copy of the database and settings and the Integration Server certificate of the previous version.
If you want to save a backup copy of the database and settings of the Integration Server of the previous version, the upgrade requires additional space on the drive containing the %ProgramData% folder.
The backup copy of the Integration Server database and settings contains the following data:
- Accounts for connecting the Integration Server Console, SVM, and Light Agents to the Integration Server.
- Settings for connecting the Integration Server to the virtual infrastructure and the Kaspersky Security Center Administration Server.
- If the solution is used in multitenancy mode: a list of registered tenants and protection statistics of the tenant virtual machines is displayed.
- Configuration files that define the Integration Server operation settings.
The backup copy is used to revert to the previous version of the Integration Server if the update produces errors in the operation of the Integration Server. The backup copy of the database and settings of the Integration Server can be deleted automatically when removing the Integration Server, or you can delete it manually. The default path is %ProgramData%\Kaspersky Lab\VIISLA\Backup\VIISData(1). The number in the folder name is incremented by 1 each time an update is done.
- If you use Kaspersky Security Center Linux to manage Kaspersky Security, the Kaspersky Security Components Installation Wizard cannot be used to update the Integration Server and Integration Server Console. The update is performed by manually installing the new version of the Integration Server and the Integration Server Console.
After upgrading the Integration Server, we recommend to replace the self-signed SSL certificate of the Integration Server with a more secure certificate. You can create a new certificate and install it using the certificate management tool included with the solution.
Updating in interactive mode using the wizard
We recommend to close the Kaspersky Security Center Administration Console before starting the update.
To update the Integration Server and Integration Server Console in interactive mode using the wizard:
- On the device where the Administration Console and Kaspersky Security Center Administration Server are installed, run the ksvla-components_<version number>_mlg.exe file, where <version number> is the version number of the solution in X.X.X.X format. This file is included in the distribution kit.
Kaspersky Security components installation Wizard starts.
- Select the localization language of the Wizard and of the Kaspersky Security components that you are installing and proceed to the next step of the Wizard.
By default, the localization language of the operating system installed on the device where the Wizard was started is used.
- Make sure that the Install management components option is selected and proceed to the next step of the Wizard.
- If you want to save a backup copy of the database and settings and the certificate of the previously installed Integration Server, select the Create a backup copy of the Integration Server database, settings, and certificate check box. The default path is %ProgramData%\Kaspersky Lab\VIISLA_Backup\VIISData(1). The number in the folder name is incremented with each subsequent update attempt.
The Wizard checks the amount of free space on the drive that contains the %ProgramData% folder. If there is insufficient free space on the drive, the Wizard displays an error message and you cannot proceed to the next step of the Wizard. If this is the case, close the Wizard, free up space on the drive, and restart the Kaspersky Security Components Installation Wizard.
- In the next step, read the Kaspersky Security End User License Agreement, which is concluded between you and Kaspersky, and the Privacy Policy, which describes the processing and transmission of data.
To continue the installation, you must confirm that you have fully read and accept the terms of the End-User License Agreement and the Privacy Policy. To confirm, select both check boxes in the window of the Wizard.
Proceed to the next step of the wizard.
- Create the password of the Integration Server administrator (
admin
) account. Theadmin
account is used to connect the Integration Server Console to the Integration Server if the device on which the Integration Server Console is installed is not part of the Microsoft Windows domain.Enter a password in the Password and Confirm password fields. The account name cannot be edited.
A password must be no longer than 60 characters. You can use only letters of the Latin alphabet (uppercase and lowercase letters), numerals, and the following special characters:
! # $ % & ' ( ) * " + , - . / \ : ; < = > _ ? @ [ ] ^ ` { | } ~
. For security purposes, you are advised to set a password that is at least 8 characters long and use at least three of the four categories of characters: lowercase letters, uppercase letters, numerals, and special characters.Proceed to the next step of the wizard.
- Review the information about the actions that the wizard will perform and click the Install button to begin performing the listed actions.
- Wait for the wizard to finish.
If an error occurs during wizard operation, the wizard rolls back the changes made.
- Click Finish to close the Wizard window.
Information about the work of the Wizard is written to trace files of the Kaspersky Security Components Installation Wizard. If the wizard completed with an error, you can use these files when contacting Technical Support.
After the update is complete, in Kaspersky Security Center Administration Console, in the workspace of the Administration Server <server name> node on the Monitoring tab, the Deployment section displays a Manage Kaspersky Security for Virtualization <version number> Light Agent link (where <version number> is the number of the updated version of the Kaspersky Security solution). This link is used to start the Integration Server Console.
Page topUpdating in silent mode using the wizard
We recommend to close the Kaspersky Security Center Administration Console before starting the update.
To update the Integration Server and Integration Server Console in silent mode using the wizard,
Run the following command:
ksvla-components_<
version number
>_mlg.exe -q --lang=<
language ID
> --accept-EulaAndPrivacyPolicy=yes --viisPass=<
password
> [--log-path=<
file path
>] [--createBackup] [--backupFolder=<
folder path
>]
where:
<
solution version
>
is the version number of the solution in X.X.X.X format.-q
is an option specifying that the update is performed in silent mode. If you want to run the update interactively from the command line, do not specify this option.--lang=<
language ID
>
is the identifier of the language of the components to install.The language ID must be indicated in the following format: ru, en, de, fr, zh-Hans, zh-Hant, ja. It is case-sensitive.
--accept-EulaAndPrivacyPolicy=yes
means that you accept the terms of the Kaspersky Security End User License Agreement, concluded between you and Kaspersky, and the Privacy Policy, which describes the processing and transmission of data. By setting this parameter toyes
, you confirm the following:- You have fully read, understood and accept the terms and conditions of the Kaspersky Security End User License Agreement.
- You have fully read and understood the Privacy Policy, you are aware and agree that your data will be handled and transmitted (including to third countries) as described in the Privacy Policy.
The text of the End User License Agreement and Privacy Policy is included in the solution's distribution kit. Accepting the terms of the End User License Agreement and Privacy Policy is a prerequisite for updating the Integration Server and Integration Server Console.
You can read the text of the End-User License Agreement and the Privacy Policy by executing the following command:
ksvla-components_<
solution version
>_mlg.exe --lang=<
language ID
> --show-EulaAndPrivacyPolicy
The text of the End-User License Agreement and the Privacy Policy is output to the license_<language ID>.txt file in the tmp folder.
--viisPass=<
password
>
is the password of the Integration Server administrator account (admin
). Theadmin
account is used to connect the Integration Server Console to the Integration Server if the device on which the Integration Server Console is installed is not part of the Microsoft Windows domain.A password must be no longer than 60 characters. You can use only letters of the Latin alphabet (uppercase and lowercase letters), numerals, and the following special characters:
! # $ % & ' ( ) * " + , - . / \ : ; < = > _ ? @ [ ] ^ ` { | } ~
. For security purposes, you are advised to set a password that is at least 8 characters long and use at least three of the four categories of characters: lowercase letters, uppercase letters, numerals, and special characters.--log-path=<
path to file
>
is the path to the file where information about update results is saved.Optional parameter. If the path is not specified, update results are logged to trace files saved at %temp%\Kaspersky_Security_for_Virtualization_<version number>_Light_Agent_BundleInitialInstall_logs_<date and time>.zip, where:
- <version number> refers to the number of the installed version of the Kaspersky Security solution;
- <date and time> refers to the date and time when the update was completed, in the dd_MM_yyyy_HH_mm_ss format.
--createBackup
Optional parameter. Indicates that it is necessary to save a backup copy of the database and settings and the certificate of the previously installed Integration Server. By default, the data is saved in the %ProgramData%\Kaspersky Lab\VIISLA_Backup\VIISData(1) folder. The number in the folder name is incremented each time an update is done. You can select the path for saving this data using the
--backupFolder
option:--backupFolder=<
path to folder
>
is the path to the folder where the backup copy of the database and settings and certificate of the previously installed Integration Server will be saved.Optional parameter. If this option is not specified, the data will be saved to the default folder.
To view a description of all available command line parameters for installing and updating Kaspersky Security components, use the --help
parameter.
Updating the Integration Server and Integration Server Console takes some time.
After the update is complete, in Kaspersky Security Center Administration Console, in the workspace of the Administration Server <server name> node on the Monitoring tab, the Deployment section displays a Manage Kaspersky Security for Virtualization <version number> Light Agent link (where <version number> is the number of the updated version of the Kaspersky Security solution). This link is used to start the Integration Server Console.
Page top