8. V102 to V103 upgrade procedure

8.1. Prerequisites

To install the V2.5.3.103 update:

  • The GCenter must be running V2.5.3.102-HF3 or higher

  • The GCap will need to be version V2.5.4.0 or higher

  • If you have any questions about these items, please contact the Gatewatcher Technical Support

    Important

    For the update to V2.5.3.103, it is imperative to use the following package in order to avoid some migration issues: https://update.gatewatcher.com/upgrade/2.5.3.103/gcenter/gcenter-bios_2.5.3.103-hf1.gwp.

    Important

    It is highly recommended to have an iDRAC type connection in order to be able to connect post-upgrade if a problem occurs during the process. Otherwise, you'll need a physical access to the equipment (screen, keyboard).

    Important

    Before proceeding with the update, it is strongly recommended to backup the GCenter configuration in the `Administrators > Backup / Restore > Operations menu and save the file to an external server in a directory indicating the current GCenter version (example: 2.5.3.102-XXXX-HFX).

8.2. Retained data

The set of the GCenter configuration and data is retained.
Metadata and alerts on the GCenter prior to migration to version 2.5.3.103 will only be available in the `Discover` menu of the `Hunting` interface.

8.3. Installation procedure with data retention

  1. Make sure the GCap probes are in version V2.5.4.0 or higher, otherwise refer to the following update procedure: https://releases.gatewatcher.com/en/gcap/2.5.4/V0/8_upgrade_procedure.html

  2. Download the newly available version of the GCenter and the associated sha256 on the https://update.gatewatcher.com/upgrade/ platform (directory 2.5.3.103).

  3. Check the image with the associated sha256.

  4. Connect to the GCenter WebUI and go to the menu `Admin > GUM > Software update`.

  5. In the `Uploading a new software update` section, click on the `Click to upload` button, select the new GCenter version previously uploaded and click `Submit`.

  6. Connect to the GCap with the SSH account setup.

  7. Shut down the monitoring engine with the following command: `monitoring-engine stop`.

  8. Change the compatibility mode using the following command: `set compatibility-mode 2.5.3.103`.

  9. Start the monitoring engine with the following command: `monitoring-engine start`.

  10. To keep data already being processed at the GCenter, check in the menu `Hunting > Metadata` that there is no further processing.

  11. In the `Saved package list` section, at the location of the previously sent update, click on the `Apply` button.

  12. Once the operation is complete, restart the GCenter by connecting via SSH with the setup account and then going to the `Restart` menu.

  13. Once the GCenter is restarted, connect to the WebUI and check whether new events appear in the `Hunting` section.