Initial Setup Guide for Qorvus Qnode
updated 1/18/2007 V3.18

Qorvus Qcode is a completely re-engineered and re-written branch of the legacy Linux openAP and LW meshAP projects, with numerous added proprietary patches and various plug-ins for built-in local management, improved bandwidth, multiple Atheros and Prism radio support, and greatly enhanced reliability. It is interoperable with several central client-access management systems including FeedPro and Airpath, as well as existing meshAP installations and the wiana public radius & monitoring system. While we strongly recommend managing all Qcode settings using the built-in GUI, it is also possible to register the node with the WIANA system for passive system monitoring, remote RADIUS & automac support, and optional node-to-node RSA encryption. The code can also be configured using the GUI, to interact with your own Radius servers for customer authentication and classful bandwidth managment.

Getting your nodes to mesh and pass traffic is quite easy. The following guide is designed to show you the steps necessary to initially setup a wireless node equipped with Qorvus Qcode software.


Step 1:

  1. Attach one of your node's ethernet port to a local-area-network router and apply power to the node. The node will automatically start up as a gateway node and look for a DHCP address. If you are using a QnodeJr or a pc-engines WRAP board, wait for all three LED's to light up. You can then look at your router's DHCP table to determine the ethernet IP address assigned.

    If there is no DHCP server found, the ethernet interface will default to a 192.168.1.2 IP address with a 255.255.255.0 subnet

    If you don't want to use a router and instead are connecting directly from a laptop via a cross-over cable, the node can be found at the default IP address.

    From a wired connection you can access the management pages via a web browser at the IP address http://192.168.x.y:81/ . If you want to use ssh, just surf to https://192.168.x.y:82/

  2. From a wireless connection you must select the ESSID of the node you want to associate with. The default is "QMESH" for radio 1, and QMESH2 for radio 2. In dual-radio systems, radio 2 is usually the customer-access (2.4 Ghz) radio.

    Then type the 1.x.x.x address that is assigned to the radio, or look up the gateway for the DHCP address you were assigned by the node (ipconfig on Windows XP boxes). It should be a 192.168.x.1 address where ".x." is the cell ID for the node you are currently working on.

  3. If you have a VPN user name and password established locally or in the WIANA realm manager then you can use any PPTP client to connect to the outside address for your system.

    If you are a VPN client you can connect to any downstream wireless nodes that are meshed with the gateweay node, by typing in the 1.x.x.x address for that node.

    As of Qcode 2.5 VPN is controlled locally in each node and is setup in the auto access list at the bottom of the page.
The default user name for the management page is admin / terra7. (admin / wsxedc as of Qcode 3.15) Please change this for your own system.

click for larger image
Step 2:

If you have received the system on a preloaded CF and it was not preregistered for your network,

You will be prompted to register with Qorvus. Please enter the user ID that came with your package to access the management pages. For more information please call Qorvus at 360.243.7371

For Internet downloads, disregard this step.

click for larger image

Step 3:

When the system is registered the first page you will come to is the current status page. Here you will find all the important information about your system available in real time.

Welcome to the Qcode system!

In order to get meshing right away, you will need the following on each node.

  1. The same ESSID on your backhaul radio (usually radio 1 on a dual-radio system) as your other nodes.
  2. A unique name or IP for each node (automatically generated on initial boot-up)
  3. At least one gateway node and one wireless node is the smallest mesh you can have, otherwise the gateway will simply act as a hotspot
  4. Adequate signal and radio link between the nodes. Make sure the channel on each node is set the same unless you are using a dual radio setup.
  5. We can't stress enough the importance of professional wireless installation techniques, with respect to antenna selection and installation, lightning and surge protection, and the availability of a stable, properly secured and installed power supply. Make sure that all nodes and associated antennas are properly grounded and waterproofed! If you don't do all these things, the system either won't work, or may work for a short while and then mysteriously fail or become intermittent.
  6. If you are using Prism radios for backhaul, the default radio setting will mesh. Atheros radios will need to be set either for ad-hoc mode (peer-to-peer) or master / managed modes. More information on radio settings is available here: http://www.qorvus.com/downloads/Qcode_3.1_setup.pdf
  7. Your nodes should now see and mesh with each other. If you click on the Wireless tab on the GUI, you can change the default radio settings if needed.
  8. Leave WEP keys off unless you intend to run a private network.
  9. During initial setup, leave the Internal Watchdog (under System tab in the GUI) to its default value of OFF. After you've completed the installation, turn it ON on all nodes for best reliability and uptime! Optionally, you can also turn on the Use Yahoo function on your gateway node (that's hooked up directly to the internet).
  10. Once one or more nodes are powered up and meshing, a client laptop that is within radio range of a node equipped with a 2.4 Ghz radio, will be able to associate, receive a DHCP address from the node, and surf the net, if (and only if) you have at least one of the nodes set up as a gateway (that is, hooked up to an internet-connected router / switch). One a client has associated, if they then try to go to their home page, they will instead be directed to a captive portal webpage and asked for their name and password, or asked to log on as a guest. Once they hit the guest button, they will be able to surf the net. All of this behavior is highly configurable by using the Captive Portal setup page in the GUI under the Advanced tab.
For more information please refer to our help guide and bulletin board system.