Wifi

Revision as of 05:32, 5 August 2010

Wifi - A Simple Account Management Front-end

"Wifi" stands for "Web Interface For... I" :-)

This is an add-on module that IS NOT IN THE CORE of OpenSim. It is provided by Diva Canto and can be added to OpenSim 0.7 onwards. Please do not ask the core OpenSim team for support.

 Diva adds on 4-Aug-2010: it's fresh out of the oven, and still needs some love;
 don't use the latest source yet, because there's a tricky bug deep down in the
 C# web server code we're using that may cause pain :)

Introduction

Initial information is available from http://www.metaverseink.com/blog/?p=37 and is taken here pretty much verbatim for now...

Wifi provides an embedded Web application for handling user registrations. Wifi is a set of components that can be loaded up by both standalone simulators and Robust servers. It's features include:

• Account creation, optionally controlled by the administrator
• Configurable default avatars for new accounts
• Account updates by both users and administrator
• Account deletion by administrator
• Password recovery via email
• Simple user inventory management
• Welcome page which can be used as viewer -loginpage

Wifi has a few interesting properties that make it a good fit for small-to-medium OpenSimulator-based virtual worlds.

• First of all, it doesn’t require the installation of Apache or other Web servers; it’s all done within the OpenSimulator code base.
• Second, using the OpenSimulator code base brings many technical benefits. This isn’t an immediate benefit, but it is a benefit in the long run. Unlike the Apache-based Web apps that interface with the DB directly, Wifi interfaces with the OpenSimulator services layer using the core code, and therefore it is isolated from future changes to the OpenSimulator DB schema.
• Third, technically, Wifi is a set of components that can be loaded up by both standalone simulators and Robust servers.

Diva Distribution

Wifi is included and enabled by default in the Diva Distribution:

• Documentation: http://wiki.github.com/diva/d2/wifi
• Blog Description: http://www.metaverseink.com/blog/
• Downloads and binary distribution: http://github.com/diva/d2/downloads
• Source Code: http://github.com/diva/diva-distribution/

Adding Wifi to your OpenSim Setup

TBA - notes here are guesswork at present. Hoping to clarify what is needed and where its available.

Additions to Standard OpenSim Distribution (from 0.7 onwards)

Source Code Approach

Get Diva Distribution which contains the Wifi modules from http://github.com/diva/diva-distribution/

Extract the following into your standard OpenSim distribution:

• addon-modules/Wifi/*
• addon-modules/1WifiScriptEngine/*
• add-on-modules/Modules/*
• WifiPages/*

Use addon-modules/Wifi/Wifi.ini.example as a basis for what to add to the relevant OpenSim.ini and either Robust.ini or Robust.HG.ini depending on your architecture.

Or is a custom Wifi.ini going to be used?

Binary Approach

Partial trial to see what is needed. Not working yet.

Obtain the required modules from the Diva Distribution and place them in the equivalent locations in your OpenSim directory:

• bin/Diva.Modules.dll
• bin/Diva.Wifi.dll
• bin/Diva.Wifi.ScriptEngine.dll
• WifiPages/*
• doc/WIFI.txt
• Additional licence or readme text needed?

Setting Configuration Parameters

The complete example file is here: http://github.com/diva/diva-distribution/blob/master/addon-modules/Wifi/Wifi.ini.example

Is a custom included file Wifi.ini going to be used rather than changes elsewhere?

Additions to Robust.ini or Robust.HG.ini for Grids or to OpenSim.ini for Standalones

 ServiceConnectors = "Diva.Wifi.dll:WifiServerConnector"

Additions to OpenSim.ini

 [WifiService]
   GridName = "grid name"
   LoginURL = "<hostname>:9000|http://<hotsname>:9000 "
   WebAddress = "<hostname>:9000|http://<hostname>:9000 "
      
   ;; The Wifi Administrator account
   AdminFirst = "Wifi"
   AdminLast = "Admin"
   AdminEmail = "you@example.com"
   
   ;; Do you want to be able to control grid registrations?
   AccountConfirmationRequired = false
   
   FemaleAvatarAccount = "Female Avatar"
   MaleAvatarAccount = "Male Avatar"
   NeutralAvatarAccount = "Neutral Avatar"
   
   ;; Variables for your mail server
   ;; Users will get email notifications from this account.
   SmtpHost = "mail.example.com"
   SmtpPort = "587"
   SmtpUsername = "your_account_in_this_mail_server"
   SmtpPassword = "your_password_in_this_mail_server"

Problems with HTTP ports

Some network setups and ISPs will not allow HTTP to be served on port 80. It is usual to use an alternative port such as 8080 or a custom port in that case. You can do this by adding this line to the [Network] sectionof (where? OpenSim.ini?)

 [Network]
    port = 8080

Wifi URLs When Operational

• Sample Grid: http://yourgridhostname:8002/wifi
• Sample Standalone: http://yourstandalonehostname:9000/wifi

Examples

• Diva Tagus Test World (temporary August 2010): http://tagus.ics.uci.edu:9000/wifi