WIANA Setup Guide for Qorvus Qnode
updated 4/21/2005 V2.0
Qorvus Qcode is a re-engineered and re-written version of the openAP and LW meshAP projects with additional proprietary plug-ins for built-in local management and greatly enhanced reliability and performance . It is interoperable with legacy meshAP installations and with the WIANA community wireless management system. While we strongly recommend managing the Qcode locally or via remote VPN using the GUI, it is possible to register the unit to the WIANA system for passive system monitoring, RADIUS, automac, and customer managment support, and local RSA encryption key generation.
Basic centralized monitoring for your mesh network, including email alerts and Google mapping is provided by the Qcode User System. In addition, there are several other supported commercial services including Feedpro and Airpath. However, the WIANA community wireless managment system is free to join and we will show you how in the following steps.
click for larger image
Step 1a:
First, you must register for a WIANA account.
You must register your email address with the WIANA system at http://www.wiana.org/. Click on the link at the top of the page that says "Register for Address Space". Here you will be taken to the page shown in step 1b.
If you currently have a WIANA account, then you can move to the next step.
click for larger image
Enter in your email address in the following submission form. Once this step is done you will receive a confirmation email that will need to be answered in order to setup your account.
In the second email you receive you will have a default password that you can use to access your new WIANA account. This can be changed later within the management area.
Once logged into the system go to the realm manager and create a new realm to be used by the captive portal system to let users log in to your system.
If you currently have a WIANA account, then you can move to the next step.
click for larger image
click for larger image
Step 2:
By default your system will be set to start up as a gateway and it will search for a DHCP address. If you have the system connected to a monitor you will see the wired IP address assigned to your node. Please keep track of this number because you will need it in later steps.
Use an SSH terminal like putty (download here) or the built in terminal of the Mac OS X system. You then SSH to the node by entering the IP address into the system and be sure to check that your request id being sent as SSH on port 22.
click for larger image
You will now get a Linux prompt where you can setup your system further.
The first command we issue will check into the WIANA system so that you can prepare to register it.
Type at the prompt "remotemanagement"
click for larger image
The system will output information about the check in and return to the prompt.
The next step is to register the system.
Type at the prompt "wianaregister"
click for larger image
Type at the prompt the email address / login you used to create the WIANA account and hit enter.
If the registration was successful. You will be informed that your node was claimed successfully and it will appear in the WIANA management page.
We have found that it is best to do this management process via a remote terminal. Sometimes the registration script will not function properly if it is a new node and done locally via a keyboard and terminal directly connected to the motherboard.
click for larger image
Step 6:
To speed up the registration process we recommend that you force the system to make its encryption key. This is done automatically by the system on the next check in but those are randomly determined by the system on boot up and occur every 30 minutes.
Type at the prompt "makelocalkey". This will generate a SSL certificate signing request that is sent to WIANA. The program "getlocalkey" will then by automatically started in the background and will check every 5 minutes to see if the key has been issued.
You can check to see if you have a key yet by using the command /hj/certip. If an 1.x.x.x address appears you know you have a certified IP.
Step 7:
Login to the WIANA system and switch to the Realm manager system. Here you can setup a user database and/or create tickets for indivduals to use to gain access to your system.
click for larger image
Now you will need to update the WIANA settings for the system by typing remotemanagement again. It will then say "RUN" and it will download the new settings.
You may need to try this several times until the system downloads your new settings.
This is all that you need to do with WIANA now. In order to prevent problems with future parameter changes from the WIANA system, we recommend that you lock out wiana changes to the system. This is the bottom radio button in the General page of the Qorvus management menu.