Deploying UFM Telemetry
UFM telemetry is packaged in a docker image that should be loaded and deployed on a Linux machine with docker installed (as a prerequisite). This chapter describes how to deploy UFM telemetry on a Linux machine.
To deploy the UFM telemetry:
Connect to the Linux machine via SSH.
Ensure the docker is installed on the Linux machine. Run:
Start the docker service. Run:
Pull the image. Run:
Create the default .ini files and place them in the local directory mapped to /config in the container and initialize the container configuration. Run:
This collects port counter data every 5 minutes, uses HCA mlx5_0, and collects cable info on the 1st, 3rd, and 5th day of the week at midnight.
- sample_rate: Frequency of collecting port counters
- hca: Card to use
- cable_info_schedule: Time of collecting cable info data (optional)
Create a container of UFM telemetry. Run:
- Verify that UFM Telemetry is running:
Ensure the UFM telemetry container is up. Run:
If the container name exists, access the shell of the container. Run:
Run "ps -fade" and verify that the list of running processes includes agx, clx, supervisord, agx_manager.py, agx_server.py, launch_ibdiagnet.py, launch_retention.py, launch_compression.py, launch_cableinfo.py.
- Review your configurations under "/config/launch_ibdiagnet_config.ini".
To view the UFM telemetry configuration files. Run:
To watch and review the execution of each component, there is a log file for each component located under the path "/var/log".
- To exit the UFM Telemetry docker context, run "exit" to return to the Linux machine context.
To access the UFM Telemetry CLI, run the following on the Linux machine:
- For settings and configuration instructions, see Settings and Configuration.
Upgrading UFM Telemetry Software
Upgrading UFM Telemetry requires removing the previous ufm-telemetry container, pulling the new version of the UFM telemetry image, configuring the telemetry, and starting a new container from the new image.
- Connect to the Linux machine via SSH.
Stop the previous ufm-telemetry container. Run:
Pull the new UFM Telemetry image. Run:
Configure UFM Telemetry using based on new configurations. Run:
Create a container for new UFM Telemetry. Run: