Basic Concepts
When Cisco Crosswork Data Gateway is deployed and establishes a connection to Crosswork Cloud, the Crosswork Cloud acts as the controller pushing the needed containers and configurations to the Cisco Crosswork Data Gateway.
Cisco Crosswork Data Gateway Components
Cisco Crosswork Data Gateway has the following five main components or services:
Controller Gateway
Controller Gateway is the component responsible for all the interaction between a Cisco Crosswork Data Gateway instance and its controller application. It manages the session creation with the controller application and makes sure all the payloads and responses are signed and verified for integrity. Components such as Image Manager, Vitals Monitor, and Route manager interact via Controller Gateway with the controller application to exchange the details those components need.
Note |
When the Controller Gateway stops, any alerts are not updated in cdg-alerts.log. However, when it starts, it sends an alert that it has started. This is because all the alerts go through the Controller Gateway and if it is down, the controller application won't receive the alerts. To access log files, see Run show-tech. |
Image Manager
The Image Manager starts up when Cisco Crosswork Data Gateway VM boots. It downloads the functional images from the repository as instructed by the controller application and brings up the services.
It has the following responsibilities:
-
Periodically pull boot-config file from the controller application via Controller Gateway.
-
Based on the boot-config and local images metadata cache, determine if the functional images and docker-compose file need to be downloaded.
-
Send appropriate alerts to the controller application, if there are issues while processing the boot-config.
-
Stop and remove any services that are no longer called for in the latest boot-config.
-
Cleanup the local images metadata cache to keep it synchronized with the latest boot-config received from the controller application.
-
Downloads collectors environment and other files that facilitate establishment of connection between collectors and Crosswork.
-
Downloads system device packages and MIB packages required by the collectors from Crosswork.
-
Downloads custom software to the collectors when uploaded via Crosswork UI.
Note |
Functional images are downloaded only when there is a change in boot-config response. |
Vitals Monitor
The Vitals Monitor monitors the start and stop status of the container services running on the Cisco Crosswork Data Gateway VM. It sends alerts to the controller when container services start or stop.
For more information, see Monitor Cisco Crosswork Data Gateway Health.
Route Manager
Route Manager configures static routes. It is utilized by downloaded functional images to create static routes to direct traffic to devices on different networks based on routes. Appropriate alerts are sent to the controller application if there is any failure in processing routes configuration.
Docker IPv6nat
docker-ipv6nat is a special process that programs ipv6 routes for docker containers.