8. Updating procedure
8.1. Prerequisites
Important
8.2. Retained data
The following data and configurations are 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/ or /data/cache/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)
8.4. Installation procedure via the GCenter
On GCenter:
From the platform https://update.gatewatcher.com/upgrade/ (directory 2.5.4.2/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.2/gcap/gcap-bios_2.2.4.2-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.2/gcap/gcap-bios_2.2.4.2.gwp for the BIOS version or https://update.gatewatcher.com/upgrade/2.5.4.2/gcap/gcap-uefi_2.5.4.2.gwp for the UEFI version (new generation 16 hardware)
Check the image (sha256sum command) and check the value obtained with the contents of the gwp.sha256 file
Log on to the GCenter WebUI via a web browser and go to the Administration-Updates / Software Update menu.
Upload the GCap package.
A progress bar is displayed.
If you encounter a problem, try another browser.
On GCap:
Open a terminal and log into SSH on GCap with the setup account.
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.
Use the command system upgrade list (GCAP-CLI) to get the package list from the GCenter.
Use the command system upgrade apply '[image_name]' confirm (GCAP-CLI).
GCap restarts automatically
SSH session is down
Once the GCap has restarted twice, log in to SSH with the setup account to verify that the update was successfully applied.
Check the current version with the show status command (GCAP-CLI).
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
Download the newly available version and the associated sha256 on the https://update.gatewatcher.com/upgrade/ platform (directory 2.5.4.2/gcap/).
Check the image (sha256sum command) and check the value obtained with the contents of the gwp.sha256 file.
Copy the image (.gwp) to the /data/ directory of the GCap using a privileged account.
Open a terminal and log into SSH on GCap with the setup account.
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.Open a terminal and log in via SSH on the GCap with a privileged account.
Start the upgrade with the command gcap-upgrade/data/file_name (SHELL).
- Restart the GCap with the system restart command (GCAP-CLI).SSH session is down.
Once the GCap has restarted twice, log in to SSH with the setup account to verify that the update was successfully applied.
Check the current version with the show status command (GCAP-CLI).
Start the monitoring engine with the monitoring-engine start command (GCAP-CLI).
In case of problem, please contact Gatewatcher Technical Support.