main contributors - Robin Jones. Last edited on 10 May 2008 by Pascale Blyth

Getting Started!

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

Network

The management interface for a group of nodes with a common user list and portal

Node

Nodes are defined as a single installation of the WiFiDog Gateway and is usually referred to as a hotspot.

Virtual Host

The fully qualified domain name for a server also containing a google API key which can be sourced from  http://code.google.com

Authentication Parameters

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 Authentication

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?'

Network properties

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?

Access rights

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.

GIS data

Latitude

Longitude

Zoom level - use a value from 1 to 20 finding the right zoom to encompass all of your nodes.

Map type

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.