Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
install_22_4_coova [2024/02/08 17:55] systeminstall_22_4_coova [2024/02/08 18:21] (current) system
Line 153: Line 153:
 </panel> </panel>
  
-  * Use the following /etc/chilli/config file as a guideline to configure CoovaChilli+  * Use the following /etc/chilli/config file as a guide for configuring CoovaChilli
 <code bash> <code bash>
 HS_WANIF=enp0s3              # WE ALSO Need to specify this HS_WANIF=enp0s3              # WE ALSO Need to specify this
Line 188: Line 188:
 </code> </code>
  
-  * Comment the following line out of ///etc/chilli/defaults//.+  * Comment out the following line in ///etc/chilli/defaults//.
 <code bash> <code bash>
-  Same principal goes for HS_UAMHOMEPAGE.+ The same principle applies to HS_UAMHOMEPAGE.
 #HS_UAMHOMEPAGE=http://\$HS_UAMLISTEN:\$HS_UAMPORT/www/coova.html #HS_UAMHOMEPAGE=http://\$HS_UAMLISTEN:\$HS_UAMPORT/www/coova.html
 </code> </code>
Line 216: Line 216:
  
 ===== Test it out ===== ===== Test it out =====
-  * Restart CoovaChilli for the latest changes to be effected.+  * Restart CoovaChilli so that the latest changes take effect.
 <code bash> <code bash>
 sudo systemctl stop chilli sudo systemctl stop chilli
Line 223: Line 223:
  
 </code> </code>
-  * Confirm it started fine+  * Confirm that it has started properly
 <code bash> <code bash>
 sudo systemctl status chilli sudo systemctl status chilli
Line 250: Line 250:
 </code> </code>
  
-  * Reboot the system and make sure CoovaChilli started up fine+  * Reboot the system and make sure that CoovaChilli has started properly
  
 ===== Troubleshooting tips ===== ===== Troubleshooting tips =====
-  * When things does not work is can be a bit tricky to figure out which part does not work+  * If something is not working, it can be a bit difficult to figure out which part is not working
-  * It might help if you see the captive portal as a mini router with a WAN side and a LAN side. +  * It might help if you think of the Captive Portal as a mini router with a WAN side and a LAN side. 
-  * So then there are a couple of important things to check.+  * So there are a few important things to check.
  
 ==== Are you getting an IP address ==== ==== Are you getting an IP address ====
-  * The captive portal also serve as a DHCP server and a device connecting to it with DHCP enabled should get an IP address from it.+  * The Captive Portal also serves as a DHCP server and a device connecting to it with DHCP enabled should get an IP address from it.
   * You can check both sides (server and client)   * You can check both sides (server and client)
-  * To check on the server issue the following command.+  * To check the server, enter the following command.
 <code bash> <code bash>
 sudo chilli_query list sudo chilli_query list
Line 267: Line 267:
 </code> </code>
   * You can read more about the **chilli_query** command here: [[https://coova.github.io/CoovaChilli/chilli_query(1).html|Chilli Query]]   * You can read more about the **chilli_query** command here: [[https://coova.github.io/CoovaChilli/chilli_query(1).html|Chilli Query]]
-  * After consulting the documentation we can conclude that the captive portal has two clients connected but none has been authenticated.+  * After reading the documentationwe can see that two clients are connected to the captive portal, but neither of them has been authenticated.
   * This means that they 'should' be redirected to a login page.   * This means that they 'should' be redirected to a login page.
-  * If you are not redirected to a login page we can try the following procedure which basically comes down to two things that is not working as intended. +  * If you are not redirected to a login pagewe can try the following procedurewhich essentially boils down to two things not working as intended. 
-        * The routing between the LAN and WAN is not working correct+        * The routing between the LAN and the WAN is not working properly
-        * The DNS on the setup is not working correct.+        * The DNS on the setup is not working properly.
  
-==== Forcing the login page to display ==== +==== Forcing the login page to be displayed ==== 
-  * CoovaChilli has a special URL which will log you out and redirect you to the login page.+  * CoovaChilli has a special URL that logs you out and redirects you to the login page.
   * The URL is http://1.0.0.0   * The URL is http://1.0.0.0
-  * If you do get a login page you can next try to test the routing and the DNS.+  *  If you get a login page, the next thing you can try is to test the routing and DNS.
  
 ==== Test the routing  ==== ==== Test the routing  ====
Line 292: Line 292:
 08-00-27-8C-D3-32 10.1.0.2 dnat 157706713900000001 0 08-00-27-8C-D3-32 0/0 0/0 0/0 0/0 0 0 0/0 0/0 - 08-00-27-8C-D3-32 10.1.0.2 dnat 157706713900000001 0 08-00-27-8C-D3-32 0/0 0/0 0/0 0/0 0 0 0/0 0/0 -
 </code> </code>
-  * On the client you can now try to go to an IP Address that is reachable on the WAN side. I tried to get to the IP Address of my DSL router (192.168.1.1) and could reach it. This means that the traffic flow between the LAN of my captive portal to the LAN of the captive portal is fine. +  * On the clientyou can now try to get to an IP address that is reachable on the WAN side. I tried to reach the IP address of my DSL router (192.168.1.1) and was able to reach it. This means that the traffic flow between the LAN of my captive portal and the LAN of the captive portal is fine. 
-  * I can now again log this client off using the chilli_query command+  * I can now log off this client again with the chilli_query command
 <code bash> <code bash>
 sudo chilli_query logoff ip 10.1.0.3 sudo chilli_query logoff ip 10.1.0.3
Line 304: Line 304:
  
 ==== Test the DNS  ==== ==== Test the DNS  ====
-  * DNS traffic has to flow regardless of a client being authurised (pass) or not (dnat). +  * DNS traffic must flow regardless of whether a client is authorized (pass) or not (dnat). 
-  * In order for the client to magically pop up the login page, DNS has also to work correct+  * In order for the client to magically access the login page, DNS must also work correctly
-  * A common problem is that sometimes the client has their own DNS servers specified and then (depending on the configuration settings of CoovaChilli) it might not allow the DNS traffic to those server through. (Leaving things broken). +  * A common problem is that sometimes the client has specified its own DNS servers and then (depending on the configuration settings of CoovaChilli) does not allow DNS traffic through to these server. (This causes disruptions). 
-  * After you confirmed that the client does not have any hard defined DNS servers you can try a ping test. +  * Once you have confirmed that the client does not have any fixed DNS serversyou can perform a ping test. 
-  * With a ping test you just want to test and confirm that the DNS is working correct on the client. +  * With a ping testyou only want to test and confirm that the DNS is working correctly on the client. 
-  * You can try and ping any known FQDN and see if the system resolve that to an IP address. +  * You can try to ping any known FQDN and see if the system resolves it to an IP address. 
-  * Here I try to ping www.radiusdesk.com. As you can see the name resolution worked correct, but since I am not yet authorized (still in dnat state) the pings are not going through which is fine.+  * Here I am trying to ping www.radiusdesk.com. As you can seethe name resolution worked correctly, but since I am not yet authorized (still in dnat status)the pings are not going throughwhich is fine.
 <code bash> <code bash>
 ping www.radiusdesk.com ping www.radiusdesk.com
Line 320: Line 320:
  
 ==== Conclusion  ==== ==== Conclusion  ====
-  * By using these check points on the captive portal setup, you can now point to a component which does not work as intended and try to resolve it.+  * Using these checkpoints for the captive portal setup, you can now point to a component that is not working as intended and try to resolve the issue.
         * Be it the login page.         * Be it the login page.
         * The routing between WAN and LAN.         * The routing between WAN and LAN.
         * The DNS service.         * The DNS service.
  • install_22_4_coova.1707407729.txt.gz
  • Last modified: 2024/02/08 17:55
  • by system