8. Updating procedure

8.1. Prerequisites

To deploy the GCap V2.5.3.105 update from the GCenter GUI, the GCenter must be in the installed V2.5.3.101-HF3 version.

If the GCenter is in a previous version, it will need to be updated (for versions below V2.5.3.101) or it will need to have the necessary administrator privileges at the GCap level to be able to deploy the image directly from the command line (for version V2.5.3.101-HF2).

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

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

  2. Check the image with the associated sha256.

  3. Connect to the GCenter WebUI and go to the menu Administrators > GUM > Upgrade.

  4. In the Upload an upgrade section, click on choose a file and then select the previously uploaded image to make it available on the GCenter. If you encounter a problem uploading the image, please try using a different browser.

  5. Connect to the GCap with the SSH account SETUP.

  6. Run the graphical configuration utility with the gui command.

  7. Deactivate the monitoring engine and make sure that there are no more eve-logs and files to be transmitted to the GCenter.

  8. Go to the Upgrade menu.

  9. Confirm the upgrade by selecting “Yes, upgrade this GCap”. The GCap should restart automatically.

  10. Log in to SSH with the SETUP account to verify that the update was successfully applied.

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

If you have any problems, 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.105).

  2. Check the image with the associated sha256.

  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. Re-enable the monitoring engine with the monitoring-engine start command (GCAP-CLI).

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