User Guide

Single Node Upgrade from 4.28 to 4.29

This guide will lead you through the steps specific for upgrading a NetEye Single Node installation from version 4.28 to 4.29.

Upgrading a NetEye Single Node takes a nontrivial amount of time. Granted the environment connectivity is seamless, the upgrade procedure may take up to 30 minutes.

Warning

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

Breaking Changes

Tenant Display Name

A prerequisite for the upgrade to NetEye 4.29 is the definition of the display-name for each tenant present in your system.

You can follow the procedure described in neteye tenant config create for correctly update your tenant config files.

GLPI Custom Entities

In the NetEye 4.29 collecting assets is performed by means of GLPI Agents, while OCSInventory is deprecated. In order to continue using existing tenants in the same relation to GLPI Entities, the latter should be migrated before the upgrade to 4.29 is run.

Note! The GLPI Entities migration should be performed on all NetEye installations with Assetmanagement on board.

NetEye 4.29 will take with it the automatic GLPI Entity creation for all the defined tenants of the system, starting from the previously described display-name.

In order to avoid creation of a default entity, please follow the instruction in neteye tenant config create to add the custom-override-glpi-entity param in the tenant config file for relative tenants.

Once the migration of all your entities is done, please flag it as completed in the Assetmanagment module configuration page. This will enable the NetEye upgrade and allow your system switch to the automatic entity creation.

Prerequisites

Before starting the upgrade, you should read very carefully the latest release notes on NetEye’s blog and check out the features that will be changed or deprecated after the upgrade.

  1. All NetEye packages installed on a currently running version must be updated according to the update procedure prior to running the upgrade.

  2. NetEye must be up and running in a healthy state.

1. Run the Upgrade

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

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

After the command was executed, the output will inform if the upgrade was successful or not:

  • In case of successful upgrade you might need to restart NetEye to properly apply the upgrades. If the reboot is not needed, please skip the next step.

  • In case the command fails refer to the troubleshooting section.

2. Reboot

Restart NetEye to apply the upgrades correctly.

neteye# neteye node reboot

3. Additional Tasks

In this release, no additional task is required.