User Guide

Satellite Upgrade from 4.23 to 4.24

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

Warning

Remember that you must upgrade sequentially without skipping versions, therefore an upgrade to 4.24 is possible only from 4.23; for example, if you have version 4.14, you must first upgrade to the 4.15, then 4.16, 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.

Breaking Changes

Neteye Setup

Tags and new neteye node tags command

Release 4.23 introduced RHEL 8 as new underlying operating system, together with (optional) Red Hat Insights, while release 4.24 added automatic registration to both.

This means that a NetEye Single Node, Cluster, or Satellite must record a few information (Customer ID, contract number, type of installation and deployment, see Section neteye node tags set for more details) that will be used for registering the node to Red Hat.

The command neteye node tags set, used to record the data required, will be installed during the upgrade. This means that the Upgrade process will interrupt to allow you to use the command and register the data, after which you can resume the upgrade.

Make sure to have all these data at hand during the Upgrade process; if you do not know some or all of them, please refer to the official channels: sales, consultants, or support portal to receive them.

NetEye Satellite Upgrade Procedure

Prerequisites

Be sure to meet the following requirements before starting:

  1. NetEye Master must be version 4.24 fully updated

  2. NetEye Satellite must be version 4.23 fully updated

  3. The 4.24 NetEye Satellite configuration archive is present in the path /root/satellite-setup/config/4.24/satellite-config.tar.gz. To generate and send the Satellite configuration archive see the section Satellite Configuration.

Note

Recall that the upgrade process will be stopped to allow you to provide tags for registration to Red Hat and Red Hat Insights. Refer to Section Breaking Changes for more information.

To automatically download the latest upgrade you can run the following command on the Satellite:

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

The command updates the NetEye repositories to the newer NetEye version, installs all the RPMs of the newer version, and upgrades the NetEye’s yum groups.

Please check for any .rpmnew and .rpmsave files (see the Migrate RPM Configuration section for further information).

If the command is successful, a message will inform you that it is possible to continue the upgrade procedure.

Execute the command below to setup the Satellite with the new upgrade:

sat# neteye satellite setup

Complete the satellite upgrade process by launching the following script:

sat# neteye_finalize_installation

Note

You should launch the finalize command only if all previous steps have been completed successfully. If you encounter any errors or problems during the upgrade process, please contact our service and support team to evaluate the best way forward for upgrading your NetEye System.