8. Updating procedure

8.1. Prerequisites

To deploy the GCap V2.5.3.109 update from the GCenter GUI, the GCenter must be at least in the installed V2.5.3.102 version.
If the GCenter is in a lower version, it will need to be updated first.
If you have any questions about these items, please contact Gatewatcher Technical Support.
It is mandatory to have an iDRAC connection so that you can connect post-upgrade if a problem occurs during the process. Otherwise, physical access to the equipment (screen, keyboard) will be required.

8.2. Retained data

The following data is retained:

  • the GCenter pairing,

  • the network configuration,

  • the SSH key of the root account,

  • the password of the root account,

  • the log files,

  • the pcap files in the /data/pcaps/ directory.

8.3. Installation procedure via the GCenter

On GCenter:

  1. Download from the platform https://update.gatewatcher.com/upgrade/ (directory 2.5.3.109/gcap/):

    • the gwp file of the new version available

    • the associated sha256 gwp.sha256 file

  2. Check the image (sha256sum command) and check the value obtained with the contents of the gwp.sha256 file

  3. Log on to the GCenter WebUI via a web browser and go to the Admin > Gum > Software Update menu.

  4. In the Upload a software update section, click Browse and select the . gwp (previously uploaded image) to make it available on GCenter.

  5. Validate by clicking the Choose button.

  6. Validate the upload by clicking the Submit button.

    • A progress bar is displayed.

    • If you encounter a problem when making the image available, try another browser.

On GCap:

  1. Open a terminal and log into SSH on GCap with the setup account.

  2. Launch the graphical configuration utility with the gui command.

  3. Stop the monitoring-engine with the command monitoring-engine stop (GCAP-CLI) and check that there are no more eve-logs and files to transmit to the GCenter.

  4. Go to the system/upgrade menu.

  5. Validate the update by selecting 'Yes, upgrade this GCap'.

    • GCap must restart automatically.

  6. Once the GCap has restarted, log into SSH with the setup account to see if the update has been correctly applied.

  7. Restart the monitoring-engine with the command monitoring-engine start (GCAP-CLI).

In case of problem, please contact Gatewatcher Technical Support.

8.4. Installation procedure directly from the GCap

  1. Download the newly available version and the associated sha256 on the https://update.gatewatcher.com/upgrade/ platform (directory 2.5.3.109/gcap/).

  2. Check the image (sha256sum command) and check the value obtained with the contents of the gwp.sha256 file.

  3. Copy the image (.gwp) to the /tmp/ directory of the GCap using a privileged account.

  4. Stop the monitoring engine with the monitoring-engine stop command (GCAP-CLI).

  5. Start the upgrade with the command gcap-upgrade /tmp/file_name (SHELL).

  6. Restart the GCap with the system restart command (GCAP-CLI): be careful, the SSH connection will be interrupted.

  7. Log in to SSH with the setup account to verify that the update was successfully applied.

  8. Restart the monitoring engine with the monitoring-engine start command (GCAP-CLI).

If you have any problems, please contact Gatewatcher technical support.