Interacting with Collaboration Endpoints via SSH using Python – Configuring SNMP & Syslog

There are limitations on the values that can be configured via Cisco Unified Communications Manager Administration for Cisco Video Conference devices. For example, In order to configure SNMP monitoring you would need to login to the endpoint and configure the settings manually which can can take a considerable amount of time for a large number of endpoints.

The following code demonstrates how you can configure the appropriate settings using SSH. The program utilises a csv input file of VC unit FQDN’s or Ip’s in this instance as I had exported a number of other pieces of data such as the device description and Mac address for visibiltiy when running through large numbers of devices. I have also structured the application so that we can take advantage of Pythons multiprocessing support and divide the work up amongst multiple processes.

Commands Applied
 
  1. xConfiguration Logging Internal Mode: On
  2. xConfiguration Logging External Mode: On
  3. xConfiguration Logging External Protocol: Syslog
  4. xConfiguration Logging External Server Port: 514
  5. xConfiguration Logging External Server Address: 2.2.2.2
  6. xconfiguration NetworkServices SNMP Mode: ReadOnly
  7. xconfiguration NetworkServices SNMP CommunityName: mysnmpcommunity
  8. xConfiguration NetworkServices SNMP Host 1 Address: 1.1.1.1
  9. xConfiguration NetworkServices SNMP Host 2 Address: 1.1.1.2
  10. xConfiguration NetworkServices SNMP Host 3 Address: 1.1.1.3
Full Code
 
  2. from netmiko import ConnectHandler
  3. import csv
  4. import time
  5. from multiprocessing import Pool
  7. # Define the SSH Credential
  8. ssh_user = ""
  9. ssh_pass = ""
  11. # Define the VC Hosts File
  12. vc_hosts_file = "vchosts.csv"
  14. # Define the VC Commands File
  15. vc_config_commands = "vccommands.txt"
  17. # Open the input host file
  18. vc_hosts = open(vc_hosts_file, "r")
  20. # Open the input commands file
  21. commands = open(vc_config_commands, "r").read().splitlines()
  23. # Create a list of csv reader objects
  24. hosts = [row for row in csv.DictReader(vc_hosts)]
  26. # Function to return our data object to be passed to the ConnectHandler.
  27. def create_data(ip):
  28. return {
  29. 'device_type': 'cisco_tp',
  30. 'host': ip,
  31. 'username': ssh_user,
  32. 'password': ssh_pass,
  33. }
  35. # Returns a Netmiko ConnectHandler object configured with our parameters.
  36. def create_handler(data):
  37. return ConnectHandler(**data)
  39. # Function actually applies the configuration commands via the ConnectHandler.
  40. def configure_host(handler, commands):
  41. # Define the error place holder
  42. error = None
  44. # Iterate through the commands that we want to apply
  45. for command in commands:
  47. print(f"Sending Command = {command}")
  49. # Send the command to the device via the handler, using "send_command_timing", this function
  50. # will wait an additional two seconds to receive a response from the device.
  51. response = handler.send_command_timing(command)
  53. # Successful commands will receive text containing "OK".
  54. # Print the output if we received an error.
  55. if "OK" not in response:
  57. # print out the
  58. error = response
  60. # Break out of the command loop if an error was received
  61. break
  63. # Return the error value
  64. return error
  66. def run(host):
  67. print("#" * 100)
  68. print(f"Device {hosts.index(host)} / {len(hosts)}")
  70. # Try and Except Block
  71. try:
  73. # Break out the MAC
  74. mac = host["Mac"]
  76. # Break Out the Description
  77. description = host["Description"]
  79. # Break out the IP
  80. ip = host["Ip"]
  82. print(f"Configuring Host - {mac} - {description} - {ip}")
  84. # Create the Data Dictionary for the connect handler
  85. data = create_data(ip)
  87. # Create a handler for each host
  88. handler = create_handler(data)
  90. # Configure the device with the saved commands
  91. error = configure_host(handler, commands)
  93. # Check the value of error
  94. if error != None:
  95. print("Error Received", error)
  96. else:
  97. print("Success")
  99. # Disconnect the Handler
  100. handler.disconnect()
  102. # Exception
  103. except Exception as e:
  104. print(str(e))
  105. pass
  107. def main():
  109. # Define a process pool
  110. pool = Pool(processes=4)
  112. # Map the pool to our function
  113. pool.map(run, hosts)
  115. if __name__ == "__main__":
  116. main()
Mitch

Author Mitch

I am an independent IT Consultant with specialities in Software Development, Enterprise Unified Communication, Network and Security platforms. In addition to my day to day work, I develop bespoke applications and I hope that through ucdevops.com I can build relationships with clients, business partners and fellow engineers by providing solutions to complex problems through the use of programming.

More posts by Mitch
"