Kaspersky Next XDR Expert

Reinstalling Kaspersky Next XDR Expert after a failed installation

If the installation of Kaspersky Next XDR Expert failed, you can restart the installation. Installation failure may occur during installation of Bootstrap or installation of Kaspersky Next XDR Expert components. The steps needed to reinstall Kaspersky Next XDR Expert depends on whether the Kubernetes cluster was deployed when the installation error occurred.

To determine the stage at which the installation failed,

Run the following command to view the list of all installed Kaspersky Next XDR Expert components:

./kdt status

If the Bootstrap installation error occurs, KDT displays a message that Bootstrap is not installed. In this case, you have to manually uninstall the directories created during the deployment.

If Bootstrap is installed successfully, it will have the Success status in the command output. This means that a Kaspersky Next XDR Expert components installation error occurred. In this case, you have to reinstall the components that were not installed correctly or reinstall the entire solution. In the command output, such components have the Failed status.

Reinstalling Kaspersky Next XDR Expert if Bootstrap is not installed

To restart the Kaspersky Next XDR Expert installation:

  1. Go to the directory with the KDT utility, and view the installation logs of the Bootstrap component.

    If a failure occurred during the Bootstrap installation stage, this will be reflected in the log. In this case, Bootstrap has not been installed and the Kubernetes cluster has not been created.

  2. Manually uninstall the directories created during the deployment.
    1. On the administrator host, go to the .kdt directory, and then remove the cluster.config file.
    2. Remove the contents of the following directories:

      • Required directories:

        • /etc/k0s/
        • /var/lib/k0s/
        • /usr/libexec/k0s/
        • /usr/local/bin/ (remove only the k0s file)
      • Optional directories:

        • /var/lib/containerd/
        • /var/cache/k0s/
        • /var/cache/kubelet/
        • /var/cache/containerd/

        You can remove the /var/lib/containerd/ and /var/cache/containerd/ directories if the containerd service is used only for the function of Kaspersky Next XDR Expert. Otherwise, data contained in the /var/lib/containerd/ and /var/cache/containerd/ directories may be lost.

        The contents of the /var/cache/k0s/, /var/cache/kubelet/, and /var/cache/containerd/ directories are automatically removed after you restart the target host. You do not have to clear these folders manually.

    3. Restart all target hosts.
  3. Restart the installation of Kaspersky Next XDR Expert.

Reinstalling Kaspersky Next XDR Expert if Bootstrap is installed

To reinstall incorrectly installed Kaspersky Next XDR Expert components:

  1. View the full installation log of the incorrectly installed Kaspersky Next XDR Expert component by using the command:

    ./kdt status -l <component_name>

    You can also output all diagnostic information about Kaspersky Next XDR Expert components by using the command:

    ./kdt logs get --to-archive

  2. Troubleshoot an installation error on your own or with the help of Kaspersky Technical Support.
  3. Reinstall incorrectly installed Kaspersky Next XDR Expert components.
    • If you did not modify the configuration file, run the following command, and then specify the same transport archive that was used for the Kaspersky Next XDR Expert installation:

      ./kdt apply -k <full_path_to_transport_archive>

    • If you need to change the installation parameters, export the configuration file, modify it, and then run the following command with the transport archive and the updated configuration file:

      ./kdt apply -k <full_path_to_transport_archive> -i <full_path_to_configuration_file>

    KDT reinstalls only the incorrectly installed Kaspersky Next XDR Expert components.

  4. Restart the installation of Kaspersky Next XDR Expert by using the command:

    ./kdt apply --force -k <full_path_to_XDR_updates_archive> -i <full_path_to_configuration_file>

If reinstalling the components did not fix an installation error, you can uninstall the entire solution.

To restart the Kaspersky Next XDR Expert installation:

  1. Output all diagnostic information about Kaspersky Next XDR Expert components by using the following command:

    ./kdt logs get --to-archive

  2. Troubleshoot an installation error on your own or with the help of Kaspersky Technical Support.
  3. Uninstall Kaspersky Next XDR Expert. On the administrator host, run the command:

    ./kdt remove --all

  4. Restart the installation of Kaspersky Next XDR Expert by using the command:

    ./kdt apply --force -k <full_path_to_XDR_updates_archive> -i <full_path_to_configuration_file>