User Guide

Satellite Upgrade from 4.24 to 4.25

This guide will lead you through the steps specific for upgrading a NetEye Satellite installation from version 4.24 to 4.25. 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.25 is possible only from 4.24; 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.

Breaking Changes

Tags and new neteye node tags command

Release 4.24 introduced RHEL 8 as new underlying operating system together with automatic registration and Red Hat Insights.

This means that, if the NetEye Single Node, Cluster, or Satellite has not yet been registered to Red Hat using the neteye node tags set command, the upgrade process will temporarily stop and ask for a few data (Customer ID, contract number, type of installation and deployment, see Section neteye node tags set for more information).

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

NetEye Satellite Upgrade Procedure

Prerequisites

Be sure to meet the following requirements before starting:

  1. NetEye Master must be version 4.25 fully updated

  2. NetEye Satellite must be version 4.24 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

Recall that if you still did not provide tags for registration to Red Hat and Red Hat Insights, the upgrade process will be stopped to allow you to set them. 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.