Avamar: Error 52001 (Communications Module Scanner Error) due to an unexpected switch firmware version

The following error is reported in the Avamar User Interface or mccli:

67678 2025-03-10 16:17:58 GMT ERROR 52001 SYSTEM  PROCESS /     Communications Module Scanner Error 

The switch monitoring log shows similar output to the below. Note the "Unexpected firmware version," although the specific version numbers seen may differ:

admin@avamar:~/>: grep -B1 -i 'mccli' /usr/local/avamar/var/log/switch_monitoring.log
...
2025/02/13-14:19:59 INFO: switches version_mismatch_found_cnt=2
2025/02/13-14:20:01 INFO: publish() cmd="mccli event publish --code=52001 " successful
...
2025/02/13-16:55:00 INFO: switches version_mismatch_found_cnt=2
2025/02/13-16:55:02 INFO: publish() cmd="mccli event publish --code=52001 " successful
...
2025/03/12-11:40:20 WARN: Unexpected firmware version "10.5.6.3" on switch A, expected version is one of ["10.5.1.1P1"], the rest of switch output parsing code may return incorrect results

The switch monitoring script has not been updated with the newest firmware versions, so it does not recognize the firmware.

For an Avamar Gen5A system, download and install "Dell-switch-monitoring-hotfix for GEN5A (Hotfix 949660)" from the Avamar Gen5A product page.

For an Avamar Gen4T system, follow the below procedure.

1. Download the updated version of the switch_monitoring.rb script from Central, and upload it to the affected Avamar Utility Node. Place it in the /home/admin directory.
2. Log in to the affected Avamar Utility Node as the admin user, and elevate to the root user:

   su -

3. Make a backup copy of the existing switch_monitoring.rb script:

   mv /usr/local/avamar/lib/dpnnetutil/switch_monitoring.rb /usr/local/avamar/lib/dpnnetutil/x-switch_monitoring.rb.$(date -I)

4. Move the new switch_monitoring.rb script in place:

   mv /home/admin/switch_monitoring.rb /usr/local/avamar/lib/dpnnetutil/switch_monitoring.rb
   chown root:root /usr/local/avamar/lib/dpnnetutil/switch_monitoring.rb
   chmod 755 /usr/local/avamar/lib/dpnnetutil/switch_monitoring.rb

5. Run check_switch.rb and verify it exits with code 0:

   ruby /usr/local/avamar/bin/check_switch.rb; echo $?