Installing and Compiling UCAN: ----------------------------- As soon as you download the zipped UCAN distribution, unzip and untar the file. gunzip ucan.tar.gz tar -xvf ucan.tar This wil create the uCAN directory. Modify the Makefile in the uCAN/src directory to point to the uCAN directory. Eg: If uCAN is downloaded in /home/guest_user/ UCAN_PATH=/home/test_user/uCAN UCAN_VAR=UCAN_PATH=\"/home/test_user/uCAN\" Type "BUILD_ALL" in the UCAN directory - this will uncompress and compile all the libraries requried (by invoking the makefile). ---- For debugging, in case of errors: Typing "make" in the uCAN directory will compile all subdirectories recursively. About UCAN ---------- UCAN stands for Unified Collaboratory for Analyzing Networks. The idea is to encapsulate network testing, SNMP queries and application performance visualization in a single tool. This way results of these different network operations can be viewed in the context of each other. UCAN is also fully collaborative. Users can log on to a group session, with the 'collaborate' option and all user interfaces which drive network operations in UCAN can be shared with a remote user. These interfaces can also be remotely controlled - enabling remote users to run tests and snmp queries on the network, with the permission of the network administrator So, in a nutshell, the features that are supported are: 1) Active testing framework with an example of the netperf test 2) Network management with SNMP queries 3) Performance monitoring of applications with a 3D visualization of performance, using a CAVE based program called Qosimoto 4) Collaboration - ability to share and remotely control interfaces About the libraries used by UCAN: --------------------------------- UCAN is itself a collection of programs for network analysis. UCAN is basically built over the QUANTA networking library developed at EVL and the FLTK open source GUI library libs. The network tools used are 1. netperf - developed by HP (for bandwidth measurement) 2. qosimoto - developed at EVL (for performance visualization) 3. ucd-snmp (or net-snmp) - developed orginally by University of California-Davis(for snmp queries) More instructions and information: Quanta- http://www.evl.uic.edu/cavern/quanta FLTK - http://www.fltk.org NET-SNMP - http://net-snmp.sourceforge.net/ Netperf - http://www.netperf.org Qosimoto - http://www.evl.uic.edu/cavern/qosimoto Using uCAN ----------- The "RUN" script in the uCAN directory starts the main uCAN program. The file README.RUN gives exact instructions to run the programs and explains some sample scenarios The things to know about the programs that are as follows: 1. Active testing with netperf ------------------------------ Netperf requires two programs - netserver and testDaemon to be run on the machines between which the bandwidth test has to be run. The test will be run as an rpc by the test daemon, which communicates with the netserver and runs the test. The result of the tests can be viewed by a 2 dimensional graphical visualizer the machines used for testing should have the uCAN distribution and the other libraries installed 2. SNMP queries --------------- The UCAN SNMP queries are sent to a UCAN snmpDaemon, which should be run first. SNMP queries can be made on any machine and they are made through this UCAN snmp daemon. (this makes the SNMP queries ubiquitous, while only one machine has to be authorized to send snmp queries to the daemon residing in machines) Things needed for this are a. start the machine's snmp daemon(this is part of the kernel) on the machine which has to be queried b. authorize one machine to run queries - this is mostly done by modifying the snmpd.auth file c. modify the .snmpDaemon file in the CONFIG directory to indicate the machine ip on which the snmpdaemon is run d. run the UCAN snmpDaemon(program called snmpDaemon in distribution) on the machine e. use the Network management GUI from the UCAN main menu to run queries 3. Performance monitoring ------------------------- UCAN uses Qosimoto, a 3D visualization program developed to monitor performance of networked applications built using Quanta. The examples DEMO_SERVER and DEMO_CLIENT demonstrate performance monitoring (more details in the README.RUN file) The steps needed are a. A Quanta performance daemon has to be run on any machine. Type START_PERFDAEMON b. DEMO_SERVER can be used to log performance data and stream to the performance daemon. It sends events that notify high jitter values in the application higher than the threshold given c. DEMO_CLIENT should be modified to connect to the IP of the machine on which DEMO_SERVER is run d. Qosimoto can be started from the monitor GUI from the UCAN main menu (enter the host name where the perf daemon(netlogd) is run) More specific information is given in the README.Qosimoto file 4. Collaborate -------------- With any of the above operations, connect to a db_server run on a seperate machine and share the interfaces by clicking on the share view button in each interface Refer README.RUN for the instructions to run these programs, and README.Qosimoto for specific intructions to run Qosimoto. Mail all questions, comments, bug reports to Naveen Krishnaprasad naveen@evl.uic.edu