Customers have full root access on the appliance and can therefore execute OS/Security updates at any point in time. During these yum updates/upgrades it may happen that  GreenLight (built on docker) can not be successfully started up anymore because of the changes.

This article explains several cases which you can use in order to resolve your problem.
Please note that the docker daemon version has to be between v20 and v23  (docker -v)

After yum update, GreenLight can not be started any more

Very likely the docker storage driver got updated (overlay2) by the docker daemon update. GreenLight however still uses the previous driver: overlay.

How to resolve?

If you are on GreenLight >= v4.5.7

  • Modify the GL config file
vim /opt/panagenda/appdata/gl/config

## Add the following line
PANAGENDA_DOCKER_STORAGE_DRIVER=overlay2


  • execute: gl customize
  • Restart GreenLight


If you are on GreenLight smaller than v4.5.7

  • Modify the GL config file

vim /opt/panagenda/appdata/gl/config

## Add the following line
PANAGENDA_DOCKER_STORAGE_DRIVER=overlay2


  • Run the GreenLight Upgrade to minimum v4.5.7  >> ./gl-upgrade-offline.sh
  • Restart GreenLight


In case GreenLight still doesn't work (docker bridge issues, etc..) , do the following:


## Execute the following commands in a sequence


firewall-cmd --zone=trusted --remove-interface=docker0
firewall-cmd --zone=trusted --remove-interface=docker0 --permanent
systemctl restart docker


What to do if yum update fails ?

To resolv this it fully depends on the error you get.  If you get a clamav-server error , please do the following:


## Execute the following commands in a sequence

yum clean all
yum remove clamav-server
yum update
yum install clamav