8. Updating procedure

8.1. Prerequisites

To deploy the GCap V2.5.4.1 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.

The GCap must be in the installed V2.5.3.106, V2.5.3.107 or V2.5.4.0 version.

For 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 if your GCap is in version V2.5.3.X:

• 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.1/gcap/), download:

   • the gwp file of the new version available

   • the associated sha256 gwp.sha256 file

Important

Two GCenter versions are available:

• If the GCenter is in V2.5.3.102 and the GCap is in V2.5.3.X, use the following package: https://update.gatewatcher.com/upgrade/2.5.4.1/gcap/gcap-bios_2.2.4.1-gcenter_v2.5.3.102.gwp

• If the GCenter is in V2.5.3.102 and the GCap in version 2.5.4.0, it is necessary to first update the GCenter to V2.5.3.103

• If the GCenter is in V2.5.3.103, use the following package: https://update.gatewatcher.com/upgrade/2.5.4.1/gcap/gcap-bios_2.5.4.1.gwp

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 Administration-Updates / Software Update menu.

4. 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)

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

For any questions about these items, please contact Gatewatcher Technical Support

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

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

   • GCap restarts automatically

   • SSH session is down

5. Once the GCap has restarted twice, 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. 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 the Hunting > Network Metadata menu that there is no more data.

   For any questions about these items, please contact 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).

8. Restart the GCap with the system restart command (GCAP-CLI)

   SSH session is down

9. Once the GCap has restarted twice, 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).

In case of problem, please contact Gatewatcher Technical Support.

---