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 : 

  1. Ping   

  1. Trace Route 

  1. Url Checking  

  1. Interfaces List  

  1. TCP Port connectivity  

  1. Show routing table  

  1. Force ACS  

  1. Packet Capture  

  1. Up/Down Port  

  1. 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.