Changing the Docker IP Ranges

Opengear includes Docker, which powers the NetOps platform within the Lighthouse product.

By default Docker and NetOps utilize the 172.17.0.0/16 and 172.18.0.0/16 subnets. This has the potential to cause collisions inside of some networks. 

To ensure that this can be averted, we have included the ability to quickly and easily change these settings.

To update Dockers subnet you need to alter 2 parameters, Docker's default subnet and the NetOps modules subnet. To do so, please follow the instructions below.

Note: The network mask selected for these subnets limits the maximum number of containers that can run on Lighthouse.  NetOps currently runs up to approximately 10 containers.

1. Login to the Lighthouse shell CLI as a Lighthouse Administrator or the root user
2. Ascertain the number of running containers to ensure you select an appropriate subnet size

   • sudo docker ps -q | wc -l

3. Open a config CLI session on the Lighthouse Server and run the following to enter configuration management

   • ogconfig-cli

4. Set the IP Range of the Docker subnet in CIDR format. This particular config, the format required is the first usable IP address in the range.

   • set services.nom.default_subnet "10.123.17.1/24"

5. Set the IP Range of the NetOps subnet in CIDR format

   • set services.nom.netops_subnet "10.123.18.0/24"

6. Push the config to become the running config

   • push

7. Exit the configuration management

   • exit

8. Restart Docker

   • sudo /etc/init.d/docker.init restart

9. Restart the NetOps Module(s). This must be run on the primary and all secondary Lighthouses.

   • sudo /etc/init.d/docker.init reset

Please note these parameters are available starting with the 2019.Q3.0 release.