|Version 4 (modified by pascale, 5 years ago)|
main contributors - Robin Jones. Last edited on 10 May 2008 by Pascale Blyth
Congratulations - you now have a working wifidog installation but need to configure the last few parameters for your network.
The aim of this document is to provide you with enough knowledge to setup the auth server successfully. This document is still being completed. In addition, there are plans afoot to eventually integrated setup instructions with hover help.
You first need to log on as administrator to your network (at http://yournetwork'sipaddress or www.yournetwork'sdomain if you have already configured DNS resolution).
At the top of the screen, you will be presented with a menu with the following options: find hotspots, network administration, node administration, server administration, user administration.
Mouseovering the options shows submenu options. How to use these to complete a basic wifidog configuration/customization will be explained below.
First, a few definitions
The management interface for a group of nodes with a common user list and portal
Nodes are defined as a single installation of the WiFiDog Gateway and is usually referred to as a hotspot.
The fully qualified domain name for a server also containing a google API key which can be sourced from http://code.google.com
The way in which a network handles its users, this can be with the local database, radius, LDAP or no user list.
Configuring a server for a single network setup with 1 node
for the moment, please see http://dev.wifidog.org/wiki/doc/admin/PortalAdministration
Multiple networks with many nodes
Creating a new network
Go to Network Administration > Add a new Network on this server.
You will need to add a Network ID (A unique identifier - this should contain no spaces or special characters) e.g. MyFirstNetwork? then click "Create Network".
You will now need to enter details about the network
Information about the network
Network name - a Friendly name for the network, the website on where the site will be hosted e.g. " http://auth.wifidog.org"
Technical support email - a support email address e.g. "support@…"
Network authenticator class - for the moment, please leave this as "AuthenticatorLocalUser?", more advanced methods will be explained in another document.
Authenticator parameters - Please enter the same name as you did for Network ID encased in single quotes e.g. 'MyFirstNetwork?'
Is this network the default network? - GOOD EXPLANATION NEEDED!!!
Theme Pack - At the moment there is only one theme pack which controls the look of WiFiDog, Please see http://dev.wifidog.org/wiki/doc/developer/PortalCustomization for information on how to create one. this option can be left blank for the moment.
Network's node properties
Splash-only nodes - Are nodes allowed to be set as splash-only (no login)?
Portal page redirection - Are nodes allowed to redirect users to an arbitrary web page instead of the portal?
Network's user verification
Validation grace period - The length of the validation grace period in seconds. A new user is granted Internet access for this period check his email and validate his account. the default is "1200" which is 20 minutes.
This will be the from address of the validation email - e.g. validation@…
Multiple connections - Can an account be connected more than once at the same time?
In this area you can define people who will be able to manage this network using the "Edit NetworkNameHere?". the username of the person must already exist, this can be done by clicking the "Create new account" in the top left hand corner.
Zoom level - use a value from 1 to 20 finding the right zoom to encompass all of your nodes.
Creating a new node
Go to Node administration > Add Node
You will need to enter a Node ID (A unique identifier - this should contain no spaces or special characters), Address details, geographical information and a small amount of options.