OpenSimSearch

OpenSimSearch makes it possible to have working Search included in OpenSim. At this moment only the Popular Places, Places, Landsales are fully activate but we're still working on Events, Classifieds and in the future the "New" search that works with HTML pages.

How to setup OSS

• Make sure you have a Apache/PHP/MySQL configuration ready else Search won't work!!

You can grab the latest version of OpenSimSearch through SVN:

svn checkout http://forge.opensimulator.org/svn/ossearch

Using the Binary

• In the trunk/bin folder you can find the latest binary release which you can include into your OpenSim.Just grab the 2 binary files and place them in the bin folder of OpenSim.

• Copy all files in the trunk/webroot to your webserver

• Import the SQL file ossearch.sql into your database and make sure you change the databaseinfo.inc file to reflect your settings.

<?php
$DB_HOST = "<servername>";
$DB_USER = "<username>";
$DB_PASSWORD = "<password>";
$DB_NAME = "<database>";
?>

• Search needs the DataSnapShot module to be activated, here's how to get it activated:

[DataSnapshot]
; The following set of configs pertains to search.
; Set index_sims to true to enable search engines to index your searchable data
; If false, no data will be exposed, DataSnapshot module will be off, and you can ignore the rest of 
; these search-related configs
index_sims = true
; The variable data_exposure controls what the regions expose:
;    minimum: exposes only things explicitly marked for search
;    all: exposes everything
data_exposure = minimum
; If search is on, change this to your grid name; will be ignored for standalones
gridname = "<yourgridname>"
; Period between data snapshots, in seconds. 20 minutes, for starters, so that you see the initial changes fast.
; Later, you may want to increase this to 3600 (1 hour) or more
default_snapshot_period = 1200
; This will be created in bin, if it doesn't exist already. It will hold the data snapshots.
snapshot_cache_directory = "DataSnapshot"
; This semicolon-separated string serves to notify specific data services about the existence 
; of this sim. Uncomment if you want to index your data with this and/or other search providers.
data_services="http://<yourserver>/search/register.php"

• Add the following 2 lines to your OpenSim.ini file to get Search activated

[Search]
SearchURL = http://yourserver/search/query.php

• Startup your region server and check your MySQL database table hostregister if the regionserver registered itself. If it registers, that means the DataSnapShot Module is working and you can use Search.

Note

In the trunk/webroot folder there's a file called parser.php. This file is the parser of the info from the DataSnapShot Module. This file needs to be run with cron or some other way. If this file isn't run, the search tables won't be filled and you won't see anything.