SCENARIO : Client Debug Logging via Controller
CATEGORY : Troubleshooting
PURPOSE / USE CASE : Capture logs for client connection failures or roaming issues
STEPS TO TEST : Enable debug logging for target client MAC, recreate issue
Client Debug Logging via Controller is a troubleshooting feature in many enterprise Wi-Fi systems (including RayOS) that lets you collect detailed logs for a specific client device from the controller’s point of view.
Debugging Utilities that are present in RAY OS :
Ping
Trace Route
Url Checking
Interfaces List
TCP Port connectivity
Show routing table
Force ACS
Packet Capture
Up/Down Port
Miscellaneous
You can find this option in RAY controller in Appliances section by click on respected device as shown in below given screen capture.
1. PING :
WHAT IT DOES : SENDS ICMP PACKETS TO A TARGET IP/HOSTNAME.
USE : TEST CONNECTIVITY BETWEEN AP/CONTROLLER AND ANOTHER HOST.
Step 1: Configuration
Need to select ping command and enter the IP which you want to ping. Select the Network Interface (LAN/WAN). Enter number of packet and click run.
Step 2 : Result
Screen will pop this type of tab which display ping result.
2. TRACE ROUTE :
WHAT IT DOES : MAPS THE PATH PACKETS TAKE TO A DESTINATION (SHOWS HOPS).
USE : IDENTIFY WHERE DELAYS OR FAILURES HAPPEN IN THE NETWORK PATH.
Step 1: Configuration
Need to select trace route command and enter the destination IP. Select Network interface and click run.
Step 2 : Result
Screen will pop this type of tab which display trace route result.
3. URL CHECKING :
WHAT IT DOES : SENDS AN HTTP/HTTPS REQUEST TO A GIVEN URL.
USE : VERIFY INTERNET OR SPECIFIC WEB SERVICE REACHABILITY.
Step 1: Configuration
Need to select URL checking command and enter destination url which you want to check. Select network Interface.
Step 2 : Result
Screen will pop this type of tab which display result.
4. INTERFACES LIST :
WHAT IT DOES : SHOWS ALL NETWORK INTERFACES (WIRED/WIRELESS) WITH STATUS, IP, MAC, SPEED.
USE : SEE IF PORTS ARE UP AND WHAT IPS THEY HAVE.
Step 1: Configuration
Need to select interface List command.
Step 2 : Result
Screen will pop this type of tab which display result.
5. TCP Port connectivity :
WHAT IT DOES : Attempts a TCP connection to a given IP and port.
USE : Check if a service (e.g., DNS on port 53) is reachable.
Step 1: Configuration
Need to select TCP port connectivity command, select destination IP source IP and Port number you want check.
Step 2 : Result
Screen will pop this type of tab which display result.
6. SHOW ROUTING TABLE :
WHAT IT DOES : DISPLAYS CURRENT ROUTING TABLE ENTRIES.
USE : SEE WHERE TRAFFIC IS BEING SENT FOR DIFFERENT NETWORKS.
Step 1: Configuration
Need to select Show routing table command.
Step 2 : Result
Screen will pop this type of tab which display result.
7. Force ACS :
WHAT IT DOES : Forces Automatic Channel Selection (scans & picks best channel).
USE : Fix performance/interference issues immediately.
Step 1: Configuration
Need to select Force ACS command.
Step 2 : Result
This action will create job which you can see in JOB section of cloud controller.
8. Packet Capture :
WHAT IT DOES : Captures live network packets from selected interface(s).
USE : Deep troubleshooting of protocol or connectivity problems.
Step 1: Configuration
Need to select Packet Capture command. Select type and network interface. Type name of TCP / UDP port name so that system can filter packets of that particular port.
Step 2 : Result
This action will create packet capture files which you can download.
9. Up/Down Port :
WHAT IT DOES : Manually enable/disable a network interface/port.
USE : Test failover, isolate a device, or reset a stuck link.
Step 1: Configuration
Need to select Up/Down port command. Select action you want to make for selected port. Select Network interface which you want to make up or down by this action.
Step 2 : Result
This action will create job which you can see in JOB section of cloud controller.
10. Miscellaneous :
WHAT IT DOES : Extra maintenance/debug commands that don’t fit other categories.
USE : Can execute other commands like IP A, IP RO LS etc.
Step 1: Configuration
Need to select Miscellaneous command and enter any command that is not available. For example we taking this command (ip ro ls) which is used to fetch routing table.
Step 2 : Result
Screen will pop this type of tab which display result.