Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-quick-start:checks_and_troubleshooting [2019/03/08 11:29] mdvthudocs:guide-quick-start:checks_and_troubleshooting [2020/09/01 10:59] – [Troubleshooting your first steps with the new OpenWrt device] related links vgaetera
Line 1: Line 1:
-===== Internet connectivity and troubleshooting ===== +====== Internet connectivity and troubleshooting ======
   * For a first quick Internet access test: If you have an existing router, connect the WAN port of your OpenWrt device to a LAN port of that router and confirm internet connectivity of your OpenWrt device with the following steps:   * For a first quick Internet access test: If you have an existing router, connect the WAN port of your OpenWrt device to a LAN port of that router and confirm internet connectivity of your OpenWrt device with the following steps:
-     * In the OpenWrt admin web GUI, go to Network -> Diagnostics and Click on "ping" button+     * In the OpenWrt admin web interface, go to Network -> Diagnostics and Click on "ping" button
      * or, if using OpenWrt SSH command line, you can use the command ''ping openwrt.org''       * or, if using OpenWrt SSH command line, you can use the command ''ping openwrt.org'' 
      * This should return "0% packet loss" if everything is alright with your Internet connection      * This should return "0% packet loss" if everything is alright with your Internet connection
-     A common source of error is your OpenWrt and upstream WAN routers having conflicting IP address ranges. To correct this, adjust the OpenWrt router subnet by changing the [[docs:guide-user:base-system:basic-networking|network settings]] in the file ''/etc/config/network''+     If your device has two (or more) ethernet ports, maybe OpenWrt and upstream WAN routers having conflicting IP address ranges. To correct this, adjust the OpenWrt router subnet by changing the [[docs:guide-user:base-system:basic-networking|network settings]] in the file ''/etc/config/network'' 
 +     * if the device has a single port, it's probably configured as a router anyway because that's what OpenWrt usually does so it has a static IP 192.168.1.1, no gateway or dns server set up so it won't connect to the Internet (or even local network if it is not 192.168.1.x) in this state. Connect to Luci web interface at the mentioned IP address and change the LAN interface settings to add the IP of your router as gateway and DNS server. If you have only SSH or console access, please see the [[docs:guide-quick-start:ssh_connect_to_the_internet_and_install_luci|Use SSH to connect to the internet and install Luci Web interface]] article. 
 +     * if the device has a single port and you can't access it from the default IP address of 192.168.1.1 then it was set by default with a dynamic address (some NAS devices in OpenWrt have that default setting), and you need to check your modem/router's "connected devices" page to see what IP your OpenWrt received from it. In this case the device should be able to access the internet because it has received the IP, gateway and dns setting from the line above.
   * Decide whether you want to use OpenWrt [[docs:guide-user:network:switch_router_gateway_and_nat| as a switch, router, or gateway]]   * Decide whether you want to use OpenWrt [[docs:guide-user:network:switch_router_gateway_and_nat| as a switch, router, or gateway]]
   * When using your OpenWrt device as a Wi-Fi access point, **please remember to initially set your country code in the OpenWrt Wi-Fi configuration, to properly comply with your country's Wi-Fi legal regulations!**, e.g. see here for a first [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]].   * When using your OpenWrt device as a Wi-Fi access point, **please remember to initially set your country code in the OpenWrt Wi-Fi configuration, to properly comply with your country's Wi-Fi legal regulations!**, e.g. see here for a first [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]].
Line 11: Line 12:
   * Install custom software packages that you might be interested in.   * Install custom software packages that you might be interested in.
  
-====Troubleshooting your first steps with the new OpenWrt device:==== +===== Troubleshooting your first steps with the new OpenWrt device ===== 
-  * If you have flashed a development/snapshot firmware of OpenWrt, you first need to manually enable the admin web GUI: [[docs:guide-quick-start:developmentinstallation|development installation guide]]. Or verify the result on snapshot builds by SSH-connecting to your OpenWrt device IP 192.168.1.1+  * If OpenWrt is configured as a router with default settings, you can access [[docs:guide-quick-start:walkthrough_login|LuCI web interface]] and [[docs:guide-quick-start:sshadministration|SSH command-line interface]] by [[http://openwrt.lan/|domain name]]. If OpenWrt is configured as a network client, switch or access point, use its IP-address explicitly. You can utilize a network scanner or status page of your main router to find out OpenWrt IP-address. 
 +  * If you have flashed a development/snapshot firmware of OpenWrt, you first need to [[docs:guide-quick-start:developmentinstallation|manually enable the web interface]]. Or verify the result on snapshot builds connecting to OpenWrt via [[docs:guide-quick-start:sshadministration|SSH]].
   * You can consult the troubleshooting section of the [[docs:guide-user:start|User Guide]], if you think that resetting OpenWrt's settings might help.   * You can consult the troubleshooting section of the [[docs:guide-user:start|User Guide]], if you think that resetting OpenWrt's settings might help.
   * You can consult the [[https://forum.openwrt.org/c/installation|Installing and Using OpenWrt forum section]], if something went wrong. Please provide specific details of your device and what you did so far and what you have attempted to fix it.   * You can consult the [[https://forum.openwrt.org/c/installation|Installing and Using OpenWrt forum section]], if something went wrong. Please provide specific details of your device and what you did so far and what you have attempted to fix it.
   * Do not worry if the 5 GHz Wi-Fi does not seem to start immediately after having enabled it. It might be busy for 1-10 min scanning for weather radar, see [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]] for more background info.   * Do not worry if the 5 GHz Wi-Fi does not seem to start immediately after having enabled it. It might be busy for 1-10 min scanning for weather radar, see [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]] for more background info.
   * Note that you can always run ''logread'' on the SSH command line, to gain more insight into what the device is currently doing or to diagnose any kind of problems.    * Note that you can always run ''logread'' on the SSH command line, to gain more insight into what the device is currently doing or to diagnose any kind of problems. 
-  * If needed, you can also take a look at [[docs:guide-quick-start:ts-internetconnectivity|Troubleshooting internet connectivity]].+  * If needed, you can also take a look at [[docs:guide-quick-start:troubleshooting_internetconnectivity|Troubleshooting internet connectivity]]. 
  • Last modified: 2023/10/12 17:31
  • by micw