Single Node Upgrade from 4.26 to 4.27¶

This guide will lead you through the steps specific for upgrading from a NetEye Single Node installation from version 4.26 to 4.27. You must have successfully completed the Update Procedure before attempting to start the upgrade procedure.

Warning

Remember that you must upgrade sequentially without skipping versions, therefore an upgrade to 4.27 is possible only from 4.26; for example, if you have version 4.21, you must first upgrade to the 4.22, then 4.23, and so on.

Before starting an upgrade, you should very carefully read the latest release notes on NetEye’s blog and check the feature changes and deprecations specific to the version being upgraded. You should check also the whole section Breaking Changes below.

The remainder of this section is organised as follows. Section Breaking Changes introduces substantial changes that users must be aware of before starting the upgrade procedure and may require to carry out some tasks before starting the upgrade; section NetEye Single Node Upgrade Procedure presents the actual procedure, and finally section Additional Tasks shows which tasks must be executed after the upgrade procedure has been successfully executed.

Breaking Changes¶

RedHat Insights Registration¶

Starting with NetEye 4.27 release, to identify a NetEye installation a unique NUUID is used instead of contract_number. To identify the installation, re-execute neteye node tags set command and provide the new NUUID for the Insights.

Important! The upgrade can only be completed with the NUUID set. Please refer to the consultants, or support portal to obtain the NUUID and customer_id associated to your NetEye installation.

Telegraf consumer configurations¶

Starting with NetEye 4.27, the configurations of the telegraf consumers are now managed during the tenant creation and they are re-generated and overwritten during the neteye_secure_install. If you would like to personalize the configuration of the consumers, you can add the desired configurations in the .d folders as described in Telegraf Configuration.

NetEye Single Node Upgrade Procedure¶

To perform the upgrade, run from the command line the command:

neteye# (nohup neteye upgrade &) && tail --retry -f nohup.out

All the tasks carried out by the command are listed in section neteye upgrade; a dedicated section provides directions in case the command fails.

Additional Tasks¶

This section lists the tasks that must be carried out manually, because they are not part of the neteye upgrade command.

In this release, no additional task is required.