Docker Engine(Daemon) and GL Update

The following steps explain what to do in order to perform a Docker Daemon Update.

Cases when an update is needed

• very old outdated engine version
• storagedriver deprecation
• gl_tomcat is unhealthy  → There is insufficient memory for the Java Runtime Environment
• ....

Please take a look to this article too because it may happen that the daemon got already updated automatically in the background whichz could cause issues when you upgrade GL : How to downgrade and lock-in a certain docker daemon version

Online Update

• Make sure that GreenLight is stopped
  • gl stop
    
    
• yum update  
  
  • this will update all apps - incl. Docker
• nmcli con delete docker0 
• firewall-cmd --zone=trusted --remove-interface=docker0
• firewall-cmd --zone=trusted --remove-interface=docker0 --permanent
• systemctl restart docker      (if you get an error, retry it again after 1 minute)
  
  

If you are already on >= GreenLight version 4.5.7

• adjust the GL config file
  • vim /opt/panagenda/appdata/gl/config
  • Add the following line
    PANAGENDA_DOCKER_STORAGE_DRIVER=overlay2
• gl customize
• restart GreenLight Appliance

If you are on < GreenLight 4.5.7

• adjust the GL config file
  • vim /opt/panagenda/appdata/gl/config
  • Add the following line
    PANAGENDA_DOCKER_STORAGE_DRIVER=overlay2
• Perform the GL Upgrade
  
• restart GreenLight Appliance

Offline Update

If Greenlight can not pull the repo from the Internet, you need to download and prepare all necessary files.

• Make sure that GreenLight is stopped
  • gl stop
    
    
• Download and extract the content onto the Appliance /tmp/docker_repo/      (the download contains Docker-CE 24.x)
  https://files.panagenda.com/GreenLight/dockerEngineOffline20.x/docker_repo.zip
  
  
• yum localinstall /tmp/docker_repo/*.rpm
  • all the required files (incl. dependencies) are part of this folder, therefore the system should not try to access any external repo
  • After this step, the docker daemon will likely not run
• nmcli con delete docker0 
• firewall-cmd --zone=trusted --remove-interface=docker0
• firewall-cmd --zone=trusted --remove-interface=docker0 --permanent
• systemctl restart docker    (if you get an error, retry it again after 1 minute)
  
  

If you are already on >= GreenLight version 4.5.7

• adjust the GL config file
  • vim /opt/panagenda/appdata/gl/config
  • Add the following line
    PANAGENDA_DOCKER_STORAGE_DRIVER=overlay2
• gl customize
• restart GreenLight Appliance

If you are on < GreenLight 4.5.7

• adjust the GL config file
  • vim /opt/panagenda/appdata/gl/config
  • Add the following line
    PANAGENDA_DOCKER_STORAGE_DRIVER=overlay2
• Perform the GL Upgrade
  
• restart GreenLight Appliance