8. Updating procedure

8.1. Prerequisites

To deploy the GCap V2.5.4.0 update from the GCenter GUI, the GCenter must be in the installed V2.5.3.102-HF3 version.
If the GCenter is in a previous version, it will need to be updated (for versions below V2.5.3.102-HF3).
If you have any questions about these items, please contact Gatewatcher Technical Support.

Important

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. Data deleted

Important

The following data will be deleted:

  • Local rules for Sigflow (local-rules)

  • Local XDP filters
    please postpone the configuration of these filters at GCenter level using the GCap Profiles > Packet filters) menu

8.4. Installation procedure via the GCenter

On GCenter:

  1. From the platform https://update.gatewatcher.com/upgrade/ (directory 2.5.4.0/gcap/), download:

    • 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 on Browse and select the . gwp (previously uploaded image) to make it available on GCenter.

  5. Validate by clicking on the Choose button.

  6. Validate the upload by clicking on 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. If needed, stop the monitoring-engine with the command monitoring-engine stop (GCAP-CLI).

  3. Use the command system upgrade list to get the package list from the GCenter (GCAP-CLI).

  4. Use the command system upgrade apply [image_name] confirm (GCAP-CLI).

    • GCap must restart automatically.

    • SSH session is down

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

  6. Check the current version with the show status command (GCAP-CLI).

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

In case of problem, please contact Gatewatcher Technical Support.

8.5. 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.4.0/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. Open a terminal and log in via SSH on the GCap with the setup account.

  5. If needed, stop the monitoring engine with the monitoring-engine stop command (GCAP-CLI).

  6. Open a terminal and log in via SSH on the GCap with a privileged account.

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

  8. Restart the GCap with the system restart command (GCAP-CLI)
    SSH session is down

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

  10. Check the current version with the show status command (GCAP-CLI).

  11. Start the monitoring engine with the monitoring-engine start command (GCAP-CLI).

If you have any problems, please contact Gatewatcher Technical Support.