| CUWB Logger Manual Rev 1.0 |  |
Installation
Follow the instructions below for CDP Logger installation. When prompted in the “CUWB Applications Selection”, ensure that CUWB Logger is selected for installation. Note, the CDP Player is bundled with the CDP Logger, both tools will be installed as a part of the CUWB Logger package.
- Follow best practices and review the install.sh script.
-
Paste into an Ubuntu 16.04/18.04 terminal and press Enter:
bash <(wget -qO- https://cuwb.io/install.sh)
- Paste into an Ubuntu 16.04/18.04 terminal and press Enter
Launching CDP Logger
Once the CDP Logger has been installed, launch the application by typing the following into a terminal window:
cdp-logger
CDP Logger Command Line Options
The command line options supported by the system are as follows:
| Option | Parameters | Arguments | Description |
|---|---|---|---|
| Debug | -d, –debug | none | Activates debug mode. |
| File | -f, –file | name_of_file | File where the CDP packets will be logged. If this option is not provided, it will default to cdp-log-<date>.00 |
| Help | -h, –help | none | Prints the help message. |
| Interface Address | -i, –iface | iface_addr | Log will be recorded on network interface with the specified IP address. |
| Split Hours | –splithours | number_of_hours | How often, in hours, to split and log to a new file. Value can be entered as decimal. |
| Rotating Files | -r, –rotate | number_of_files | The logger will rotate through the specified number of log files, moving to the next after each split. |
| UDP Stream | -u | udp_stream | Packets will be recorded from the specified UDP stream (ip:port). Default value is 239.255.76.67:7667. |
| Version | –version | none | Print the version. |
Network Configuration
By default, the CDP logger will log all incoming CDP data on the following network settings:
| IP | 239.255.76.67 |
| port | 7667 |
| interface | 0.0.0.0 |
To change network settings, use the UDP Stream command line option (-u) to set the IP and port, and use the Interface Address command line option (-i) to set the network interface. For example, the following command will set up the CDP logger to log data on IP=239.255.76.66, port=7665, and interface=127.0.0.1 (localhost):
cdp-logger -u 239.255.76.66:7665 -i 127.0.0.1
Note, the CDP Player network configuration is the same as the CDP Logger. The above obtions applies to the CDP Player as well.
Log Playback
Once a log file has been captured using the CDP Logger, the CDP Player can be used to play the log back. The player will emit the logged CDP packets over the selected network settings with the same timing with which the data was logged. The CDP Player can be launched by typing the following into a terminal window:
cdp-player
CDP Player Command Line Options
The command line options supported by the system are as follows:
| Option | Parameters | Arguments | Description |
|---|---|---|---|
| Debug | -d, –debug | none | Activates debug mode. |
| End Time | –end | end_time | cdp-player will end playback at end_time seconds. |
| File | -f, –file | name_of_file | Log file containing CDP data that will be played back. If this option is not provided, it will default to default.log |
| Help | -h, –help | none | Prints the help message. |
| Interface Address | -i, –iface | iface_addr | Log will be recorded on network interface with the specified IP address. |
| Loop | -l, –loop | none | replay continuously in a loop until the player is terminated. |
| Speed | -s, –speed | speed_multiplier | Speed to play back the log (default is 1x). Can be a decimal number. |
| Start Time | –start | start_time | The cdp-player will start playback at start_time seconds through the log. |
| UDP Stream | -u | udp_stream | Packets will be recorded from the specified UDP stream (ip:port) Default value is - 239.255.76.67:7667 |
| Version | –version | none | Print the version. |
CDP Logger Manual Manual Change Log
| Version | Date | Change Description |
|---|---|---|
| 1.0 | 2018-06-13 | Initial Public Release |
| CUWB Logger Manual Rev 1.0 | |