8. Updating procedure

8.1. Prerequisites

To deploy the GCap V2.5.5.0 update from the GCenter GUI, the GCenter must be in the installed V2.5.3.103-HFX version.
If the GCenter is in a previous version, it will need to be updated.
The GCap must be one of the following versions: V2.5.4.0, V2.5.4.1, V2.5.4.2, V2.5.4.3
If you have any questions about these items, please contact the 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 and configurations are retained:

  • pairing with GCenter

  • 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/cache/pcaps directory

8.3. Installation procedure via the GCenter

On GCenter:

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

  • The gwp file of the new version available

  • The associated sha256 gwp.sha256 file

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

  2. Log on to the GCenter WebUI via a web browser and go to the Administration-Updates / Software Update menu.

  3. Upload the GCap package.

    • A progress bar is displayed.

    • If you encounter a problem, try another browser.

On GCap:

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

  2. Stop the monitoring-engine with the command monitoring-engine stop (GCAP-CLI) and wait for the files to be processed.

Important

If GCap is under load, please wait before performing upgrade.
Check on the GCenter WebUI in Hunting > Network Metadata that there is no more data.
If you have any questions about these items, please contact the Gatewatcher Technical Support.

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

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

    • GCap restarts automatically

    • SSH session is down

  3. After GCap has restarted, log in via SSH with the setup account to see if the update has been applied correctly.

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

  5. Start 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 new version and the associated sha256 from the platform https://update.gatewatcher.com/upgrade/ (directory 2.5.5.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 /data/ directory of the GCap using a privileged account.

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

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

    Important

    If GCap is under load, please wait before performing upgrade.
    Check on the GCenter WebUI in Hunting > Network Metadata that there is no more data.
    If you have any questions about these items, please contact the Gatewatcher Technical Support.

  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/data/file_name (SHELL).

    • GCap restarts automatically

    • SSH session is down

  8. After GCap has restarted, log in via SSH with the setup account to see if the update has been applied correctly.

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

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

In case of problem, please contact Gatewatcher Technical Support.