OpenSimulator - User contributions [en]

MediaWiki talk:Titleblacklist

2012-03-31T03:42:50Z

MakoBot:

<p>Might be less tedious and troublesome to disable account creation for now and set it to e-mail verification.
Updating MediaWiki to the latest version may also be of benefit as it has some better goodies to protect the system. See here @ http://lists.wikimedia.org/pipermail/mediawiki-announce/2012-March/000110.html
</p><p>These Bitcoin buffoons are seriously in need of some med's, legal or otherwise.
</p><p>EDIT:
Another option to consider, not only to protect the wiki and all of OpenSimulator.org would be to update Apache Server and mod the httpd.conf and reflect it in .htaccess There are major lists of "Bad Bots" which you can further add in here but the material here is a darned good start to blocking the trashers & spammers as well as getting rid of the scrapers which can seriously slow down the website & server response times.
</p><p><code>
</p>
<pre class="_fck_mw_lspace"> # --- LINE 237 in apache\conf\httpd.conf
# Controls who can get stuff from this server.
#
Order allow,deny
Allow from all
#
# Good Bots
SetEnvIfNoCase User-Agent .*google.* search_robot
SetEnvIfNoCase User-Agent .*yahoo.* search_robot
# SetEnvIfNoCase User-Agent .*bot.* search_robot
SetEnvIfNoCase User-Agent .*ask.* search_robot
#
# Nasty IP's that hit us looking for things they shouldn't
Deny from 188.40.231.165
Deny from 50.22.21.218
Deny from 66.135.49.5
Deny from 60.231.215.42
Deny from 220.181.108.123
#
# BAD BOTS added by WS as they changed a little
SetEnvIfNoCase User-Agent ^$ bad_bot
SetEnvIfNoCase User-Agent "^Baiduspider+" bad_bot
SetEnvIfNoCase User-Agent "^Yandex" bad_bot
SetEnvIfNoCase User-Agent "^Exabot" bad_bot
SetEnvIfNoCase User-Agent "^Cityreview" bad_bot
SetEnvIfNoCase User-Agent "^Dotbot" bad_bot
SetEnvIfNoCase User-Agent "^Sogou" bad_bot
SetEnvIfNoCase User-Agent "^Sosospider" bad_bot
SetEnvIfNoCase User-Agent "^Twiceler" bad_bot
SetEnvIfNoCase User-Agent "Python-urllib/2.4" bad_bot
SetEnvIfNoCase User-Agent "^whitehat" bad_bot
SetEnvIfNoCase User-Agent "^BitKinex" bad_bot
SetEnvIfNoCase User-Agent "^w00tw00t^" bad_bot
SetEnvIfNoCase User-Agent "^ZmEu" bad_bot
SetEnvIfNoCase User-Agent "ZmEu" bad_bot
SetEnvIfNoCase User-Agent "Morfeus" bad_bot
#
# this ruleset is for unwanted useragents... possibly email harvesters
SetEnvIfNoCase User-Agent "^AESOP_com_SpiderMan" bad_bot
SetEnvIfNoCase User-Agent "^Alexibot" bad_bot
SetEnvIfNoCase User-Agent "Anonymouse.org" bad_bot
SetEnvIfNoCase User-Agent "^asterias" bad_bot
SetEnvIfNoCase User-Agent "^attach" bad_bot
SetEnvIfNoCase User-Agent "^BackDoorBot" bad_bot
SetEnvIfNoCase User-Agent "^BackWeb" bad_bot
SetEnvIfNoCase User-Agent "Bandit" bad_bot
SetEnvIfNoCase User-Agent "^Baiduspider" bad_bot
SetEnvIfNoCase User-Agent "^BatchFTP" bad_bot
SetEnvIfNoCase User-Agent "^Bigfoot" bad_bot
SetEnvIfNoCase User-Agent "^Black.Hole" bad_bot
SetEnvIfNoCase User-Agent "^BlackWidow" bad_bot
SetEnvIfNoCase User-Agent "^BlowFish" bad_bot
SetEnvIfNoCase User-Agent "^Bot\ mailto:craftbot@yahoo.com" bad_bot
SetEnvIfNoCase User-Agent "^BotALot" bad_bot
SetEnvIfNoCase User-Agent "Buddy" bad_bot
SetEnvIfNoCase User-Agent "^BuiltBotTough" bad_bot
SetEnvIfNoCase User-Agent "^Bullseye" bad_bot
SetEnvIfNoCase User-Agent "^BunnySlippers" bad_bot
SetEnvIfNoCase User-Agent "^Cegbfeieh" bad_bot
SetEnvIfNoCase User-Agent "^CheeseBot" bad_bot
SetEnvIfNoCase User-Agent "^CherryPicker" bad_bot
SetEnvIfNoCase User-Agent "^ChinaClaw" bad_bot
SetEnvIfNoCase User-Agent "Collector" bad_bot
SetEnvIfNoCase User-Agent "Copier" bad_bot
SetEnvIfNoCase User-Agent "^CopyRightCheck" bad_bot
SetEnvIfNoCase User-Agent "^cosmos" bad_bot
SetEnvIfNoCase User-Agent "^Crescent" bad_bot
SetEnvIfNoCase User-Agent "^Curl" bad_bot
SetEnvIfNoCase User-Agent "^Custo" bad_bot
SetEnvIfNoCase User-Agent "^DA" bad_bot
SetEnvIfNoCase User-Agent "^DISCo" bad_bot
SetEnvIfNoCase User-Agent "^DIIbot" bad_bot
SetEnvIfNoCase User-Agent "^DittoSpyder" bad_bot
SetEnvIfNoCase User-Agent "^Download" bad_bot
SetEnvIfNoCase User-Agent "^Download\ Demon" bad_bot
SetEnvIfNoCase User-Agent "^Download\ Devil" bad_bot
SetEnvIfNoCase User-Agent "^Download\ Wonder" bad_bot
SetEnvIfNoCase User-Agent "Downloader" bad_bot
SetEnvIfNoCase User-Agent "^dragonfly" bad_bot
SetEnvIfNoCase User-Agent "^Drip" bad_bot
SetEnvIfNoCase User-Agent "^eCatch" bad_bot
SetEnvIfNoCase User-Agent "^EasyDL" bad_bot
SetEnvIfNoCase User-Agent "^ebingbong" bad_bot
SetEnvIfNoCase User-Agent "^EirGrabber" bad_bot
SetEnvIfNoCase User-Agent "^EmailCollector" bad_bot
SetEnvIfNoCase User-Agent "^EmailSiphon" bad_bot
SetEnvIfNoCase User-Agent "^EmailWolf" bad_bot
SetEnvIfNoCase User-Agent "^EroCrawler" bad_bot
SetEnvIfNoCase User-Agent "^Exabot" bad_bot
SetEnvIfNoCase User-Agent "^Express\ WebPictures" bad_bot
SetEnvIfNoCase User-Agent "Extractor" bad_bot
SetEnvIfNoCase User-Agent "^EyeNetIE" bad_bot
SetEnvIfNoCase User-Agent "^FileHound" bad_bot
SetEnvIfNoCase User-Agent "^FlashGet" bad_bot
SetEnvIfNoCase User-Agent "^Foobot" bad_bot
SetEnvIfNoCase User-Agent "^flunky" bad_bot
SetEnvIfNoCase User-Agent "^FrontPage" bad_bot
SetEnvIfNoCase User-Agent "^GetRight" bad_bot
SetEnvIfNoCase User-Agent "^GetSmart" bad_bot
SetEnvIfNoCase User-Agent "^GetWeb!" bad_bot
SetEnvIfNoCase User-Agent "^Go!Zilla" bad_bot
SetEnvIfNoCase User-Agent "Google\ Wireless\ Transcoder" bad_bot
SetEnvIfNoCase User-Agent "^Go-Ahead-Got-It" bad_bot
SetEnvIfNoCase User-Agent "^gotit" bad_bot
SetEnvIfNoCase User-Agent "Grabber" bad_bot
SetEnvIfNoCase User-Agent "^GrabNet" bad_bot
SetEnvIfNoCase User-Agent "^Grafula" bad_bot
SetEnvIfNoCase User-Agent "^Harvest" bad_bot
SetEnvIfNoCase User-Agent "^hloader" bad_bot
SetEnvIfNoCase User-Agent "^HMView" bad_bot
SetEnvIfNoCase User-Agent "^httplib" bad_bot
SetEnvIfNoCase User-Agent "^HTTrack" bad_bot
SetEnvIfNoCase User-Agent "^humanlinks" bad_bot
SetEnvIfNoCase User-Agent "^ia_archiver" bad_bot
SetEnvIfNoCase User-Agent "^IlseBot" bad_bot
SetEnvIfNoCase User-Agent "^Image\ Stripper" bad_bot
SetEnvIfNoCase User-Agent "^Image\ Sucker" bad_bot
SetEnvIfNoCase User-Agent "Indy\ Library" bad_bot
SetEnvIfNoCase User-Agent "^InfoNaviRobot" bad_bot
SetEnvIfNoCase User-Agent "^InfoTekies" bad_bot
SetEnvIfNoCase User-Agent "^Intelliseek" bad_bot
SetEnvIfNoCase User-Agent "^InterGET" bad_bot
SetEnvIfNoCase User-Agent "^Internet\ Ninja" bad_bot
SetEnvIfNoCase User-Agent "^Iria" bad_bot
SetEnvIfNoCase User-Agent "^Jakarta" bad_bot
SetEnvIfNoCase User-Agent "^JennyBot" bad_bot
SetEnvIfNoCase User-Agent "^JetCar" bad_bot
SetEnvIfNoCase User-Agent "^JOC" bad_bot
SetEnvIfNoCase User-Agent "^JustView" bad_bot
SetEnvIfNoCase User-Agent "^Jyxobot" bad_bot
SetEnvIfNoCase User-Agent "^Kenjin.Spider" bad_bot
SetEnvIfNoCase User-Agent "^Keyword.Density" bad_bot
SetEnvIfNoCase User-Agent "^larbin" bad_bot
SetEnvIfNoCase User-Agent "^LeechFTP" bad_bot
SetEnvIfNoCase User-Agent "^LexiBot" bad_bot
SetEnvIfNoCase User-Agent "^lftp" bad_bot
SetEnvIfNoCase User-Agent "^libWeb/clsHTTP" bad_bot
SetEnvIfNoCase User-Agent "^likse" bad_bot
SetEnvIfNoCase User-Agent "^LinkextractorPro" bad_bot
SetEnvIfNoCase User-Agent "^LinkScan/8.1a.Unix" bad_bo
SetEnvIfNoCase User-Agent "^LNSpiderguy" bad_bott
SetEnvIfNoCase User-Agent "^LinkWalker" bad_bot
SetEnvIfNoCase User-Agent "^lwp-trivial" bad_bot
SetEnvIfNoCase User-Agent "^LWP::Simple" bad_bot
SetEnvIfNoCase User-Agent "^Magnet" bad_bot
SetEnvIfNoCase User-Agent "^Mag-Net" bad_bot
SetEnvIfNoCase User-Agent "^MarkWatch" bad_bot
SetEnvIfNoCase User-Agent "^Mass\ Downloader" bad_bot
SetEnvIfNoCase User-Agent "^Mata.Hari" bad_bot
SetEnvIfNoCase User-Agent "^Memo" bad_bot
SetEnvIfNoCase User-Agent "^Microsoft.URL" bad_bot
SetEnvIfNoCase User-Agent "^Microsoft\ URL\ Control" bad_bot
SetEnvIfNoCase User-Agent "^MIDown\ tool" bad_bot
SetEnvIfNoCase User-Agent "^MIIxpc" bad_bot
SetEnvIfNoCase User-Agent "^Mirror" bad_bot
SetEnvIfNoCase User-Agent "^Missigua\ Locator" bad_bot
SetEnvIfNoCase User-Agent "^Mister\ PiX" bad_bot
SetEnvIfNoCase User-Agent "^moget" bad_bot
SetEnvIfNoCase User-Agent "^Mozilla/3.Mozilla/2.01" bad_bot
SetEnvIfNoCase User-Agent "^Mozilla.*NEWT" bad_bot
SetEnvIfNoCase User-Agent "^NAMEPROTECT" bad_bot
SetEnvIfNoCase User-Agent "^Navroad" bad_bot
SetEnvIfNoCase User-Agent "^NearSite" bad_bot
SetEnvIfNoCase User-Agent "^NetAnts" bad_bot
SetEnvIfNoCase User-Agent "^Netcraft" bad_bot
SetEnvIfNoCase User-Agent "^NetMechanic" bad_bot
SetEnvIfNoCase User-Agent "^NetSpider" bad_bot
SetEnvIfNoCase User-Agent "^Net\ Vampire" bad_bot
SetEnvIfNoCase User-Agent "^NetZIP" bad_bot
SetEnvIfNoCase User-Agent "^NextGenSearchBot" bad_bot
SetEnvIfNoCase User-Agent "^NG" bad_bot
SetEnvIfNoCase User-Agent "^NICErsPRO" bad_bot
SetEnvIfNoCase User-Agent "^NimbleCrawler" bad_bot
SetEnvIfNoCase User-Agent "^Ninja" bad_bot
SetEnvIfNoCase User-Agent "^NPbot" bad_bot
SetEnvIfNoCase User-Agent "^Octopus" bad_bot
SetEnvIfNoCase User-Agent "^Offline\ Explorer" bad_bot
SetEnvIfNoCase User-Agent "^Offline\ Navigator" bad_bot
SetEnvIfNoCase User-Agent "^Openfind" bad_bot
SetEnvIfNoCase User-Agent "^OutfoxBot" bad_bot
SetEnvIfNoCase User-Agent "^PageGrabber" bad_bot
SetEnvIfNoCase User-Agent "^Papa\ Foto" bad_bot
SetEnvIfNoCase User-Agent "^pavuk" bad_bot
SetEnvIfNoCase User-Agent "^pcBrowser" bad_bot
SetEnvIfNoCase User-Agent "^PHP\ version\ tracker" bad_bot
SetEnvIfNoCase User-Agent "^Pockey" bad_bot
SetEnvIfNoCase User-Agent "^ProPowerBot/2.14" bad_bot
SetEnvIfNoCase User-Agent "^ProWebWalker" bad_bot
SetEnvIfNoCase User-Agent "^psbot" bad_bot
SetEnvIfNoCase User-Agent "^Pump" bad_bot
SetEnvIfNoCase User-Agent "^QueryN.Metasearch" bad_bot
SetEnvIfNoCase User-Agent "^RealDownload" bad_bot
SetEnvIfNoCase User-Agent "Reaper" bad_bot
SetEnvIfNoCase User-Agent "Recorder" bad_bot
SetEnvIfNoCase User-Agent "^ReGet" bad_bot
SetEnvIfNoCase User-Agent "^RepoMonkey" bad_bot
SetEnvIfNoCase User-Agent "^RMA" bad_bot
SetEnvIfNoCase User-Agent "Siphon" bad_bot
SetEnvIfNoCase User-Agent "sitecheck.internetseer.com" bad_bot
SetEnvIfNoCase User-Agent "^SiteSnagger" bad_bot
SetEnvIfNoCase User-Agent "^SlySearch" bad_bot
SetEnvIfNoCase User-Agent "^SmartDownload" bad_bot
SetEnvIfNoCase User-Agent "^Snake" bad_bot
SetEnvIfNoCase User-Agent "^Snapbot" bad_bot
SetEnvIfNoCase User-Agent "^Snoopy" bad_bot
SetEnvIfNoCase User-Agent "^sogou" bad_bot
SetEnvIfNoCase User-Agent "^SpaceBison" bad_bot
SetEnvIfNoCase User-Agent "^SpankBot" bad_bot
SetEnvIfNoCase User-Agent "^spanner" bad_bot
SetEnvIfNoCase User-Agent "^Sqworm" bad_bot
SetEnvIfNoCase User-Agent "Stripper" bad_bot
SetEnvIfNoCase User-Agent "Sucker" bad_bot
SetEnvIfNoCase User-Agent "^SuperBot" bad_bot
SetEnvIfNoCase User-Agent "^SuperHTTP" bad_bot
SetEnvIfNoCase User-Agent "^Surfbot" bad_bot
SetEnvIfNoCase User-Agent "^suzuran" bad_bot
SetEnvIfNoCase User-Agent "^Szukacz/1.4" bad_bot
SetEnvIfNoCase User-Agent "^tAkeOut" bad_bot
SetEnvIfNoCase User-Agent "^Teleport" bad_bot
SetEnvIfNoCase User-Agent "^Telesoft" bad_bot
SetEnvIfNoCase User-Agent "^TurnitinBot/1.5" bad_bot
SetEnvIfNoCase User-Agent "^The.Intraformant" bad_bot
SetEnvIfNoCase User-Agent "^TheNomad" bad_bot
SetEnvIfNoCase User-Agent "^TightTwatBot" bad_bot
SetEnvIfNoCase User-Agent "^Titan" bad_bot
SetEnvIfNoCase User-Agent "^toCrawl/UrlDispatcher" bad_bot
SetEnvIfNoCase User-Agent "^True_Robot" bad_bot
SetEnvIfNoCase User-Agent "^turingos" bad_bot
SetEnvIfNoCase User-Agent "^TurnitinBot" bad_bot
SetEnvIfNoCase User-Agent "^URLy.Warning" bad_bot
SetEnvIfNoCase User-Agent "^Vacuum" bad_bot
SetEnvIfNoCase User-Agent "^VCI" bad_bot
SetEnvIfNoCase User-Agent "^VoidEYE" bad_bot
SetEnvIfNoCase User-Agent "^Web\ Image\ Collector" bad_bot
SetEnvIfNoCase User-Agent "^Web\ Sucker" bad_bot
SetEnvIfNoCase User-Agent "^WebAuto" bad_bot
SetEnvIfNoCase User-Agent "^WebBandit" bad_bot
SetEnvIfNoCase User-Agent "^Webclipping.com" bad_bot
SetEnvIfNoCase User-Agent "^WebCopier" bad_bot
SetEnvIfNoCase User-Agent "^WebEMailExtrac.*" bad_bot
SetEnvIfNoCase User-Agent "^WebEnhancer" bad_bot
SetEnvIfNoCase User-Agent "^WebFetch" bad_bot
SetEnvIfNoCase User-Agent "^WebGo\ IS" bad_bot
SetEnvIfNoCase User-Agent "^Web.Image.Collector" bad_bot
SetEnvIfNoCase User-Agent "^WebLeacher" bad_bot
SetEnvIfNoCase User-Agent "^WebmasterWorldForumBot" bad_bot
SetEnvIfNoCase User-Agent "^WebReaper" bad_bot
SetEnvIfNoCase User-Agent "^WebSauger" bad_bot
SetEnvIfNoCase User-Agent "^WebSite" bad_bot
SetEnvIfNoCase User-Agent "^Website\ eXtractor" bad_bot
SetEnvIfNoCase User-Agent "^Website\ Quester" bad_bot
SetEnvIfNoCase User-Agent "^Webster" bad_bot
SetEnvIfNoCase User-Agent "^WebStripper" bad_bot
SetEnvIfNoCase User-Agent "^WebWhacker" bad_bot
SetEnvIfNoCase User-Agent "^WebZIP" bad_bot
SetEnvIfNoCase User-Agent "^Wget" bad_bot
SetEnvIfNoCase User-Agent "Whacker" bad_bot
SetEnvIfNoCase User-Agent "^Widow" bad_bot
SetEnvIfNoCase User-Agent "^WISENutbot" bad_bot
SetEnvIfNoCase User-Agent "^WWWOFFLE" bad_bot
SetEnvIfNoCase User-Agent "^WWW-Collector-E" bad_bot
SetEnvIfNoCase User-Agent "^Xaldon" bad_bot
SetEnvIfNoCase User-Agent "^Xenu" bad_bot
SetEnvIfNoCase User-Agent "^Zeus" bad_bot
SetEnvIfNoCase User-Agent "^Zyborg" bad_bot
</Directory>
</pre>
<p></code>
.htacess to match above
<code>
</p>
<pre class="_fck_mw_lspace"> Order Allow,Deny
Allow from all
Deny from env=bad_bot
Allow from env=search_robot
</pre>
<p></code>
</p>

:I agree that it would be a lot less tedious, and would most likely stop these bitcoiners dead in their dumb tracks.
:Unfortunately, i can't change how accounts are created/verified, i would need higher privileges for that.
:You may want to make thise suggestion to [[User:Makopoppo]], who does have such permissions.
:I do fully support the idea though. Just let them verify their account through email, it will take care of at least 90% of all spam, if not more!
:--[[User:Fritigern|Fritigern]] 13:10, 28 March 2012 (PDT)

::Unfortunately, since I have no account on the server hosting this wiki, so I can't do that. And, this page is ignored by wiki until it have title blacklist extension (http://www.mediawiki.org/wiki/Extension:TitleBlacklist). Remember that updating wiki and installing any extension needs *server* account, not wiki's. Anyway, I'll poke Justin about this issue. -- [[User:Makopoppo|Makopoppo]] 15:09, 28 March 2012 (PDT)

:::Hi folks. I'll look to install TitleBlacklist soon and update mediawiki in that priority order. Thanks! -- [[User:Justincc|Justincc]] 19:41, 29 March 2012 (PDT)

::::Spam seems to have ceased. I don't know who did what, but it's peaceful time now. Thank you, someone! -- [[User:Makopoppo|Makopoppo]] 03:34, 30 March 2012 (PDT)

:::::Just in case it comes back I've now installed the TitleBlacklist extension. Please let me know if there are any issues. I've also badgered coyled to upgrade :) -- [[User:Justincc|Justincc]] 18:08, 30 March 2012 (PDT)

::::::I tested it on this account. It works fine now. Thank you! -- [[User:MakoBot|MakoBot]] 20:42, 30 March 2012 (PDT)

REST

2012-03-04T07:54:16Z

MakoBot:

__NOTOC__
{{Quicklinks}}
<br />
{{warning|These interfaces are not currently functional in OpenSimulator}}

The following is taken from Alan M Webb's ''OpenSim REST Support'' Draft document dated 8/18/08. The information here and specification are works in progress but provide the basis for useful OpenSimulator integrations including content input and retrieval without direct DB access. --[[User:MoHax|MoHax]] 00:10, 10 October 2008 (UTC)

There are a number of REST interfaces implemented within OpenSimulator. This document describes the work done to support specific interactions required in support of external application integration. XML is used to encode the payloads associated with these requests. The specific XML used is documented as an appendix, this is an interim specification.

== What is REST? ==

The notion of Representational State Transfer (REST) was introduced by Roy Fielding in his doctoral dissertation in 2000. It is essentially an architectural concept rather than a protocol, and this has led to a variety of implementations, all of which might claim to be compliant REST implementations.

A REST interface is built upon the HTTP protocol, making use of the four principle methods defined therein: GET, PUT, POST, and DELETE. A fifth method HEAD is also supported, but that is really just a semantic variation of GET. The TRACE and OPTIONS methods have a less fundamental role. No other protocol is involved.

Note that REST does not specify the nature of the payload either sent or received. The interface associated with this document uses XML meta-data to manage an arbitrary payload. The need for a schema document to give form to this XML will be dealt with as a separate discussion.

Of particular significance is the understood meaning of the methods themselves, which is (and must be) as defined by the HTTP specification:

* '''GET''' retrieves the information identified by the associated URI and returns it to the requester. GET is idempotent. If the URI identifies a process, then it is the output of that process which is returned, and not the source text of that process. GET is conditional when the headers include any of the If headers. GET is partial if a range related header is included. The results of GET may be able to be cached.

* '''HEAD''' is functionally equivalent to GET except that the payload is not included in the response. The result of a HEAD request may be able to be cached.

* '''POST''' requests that the server accept the payload as a new entity, subordinate to the existing entity identified by the URI. POST places requirements upon session capabilities in the server insofar as it requires persistent connection and flow control capabilities.

* '''PUT''' indicates that the payload should be stored on the server under the resource named by the URI. If the named resource already exists, then the payload is considered to be a modified version of that resource. If the named resource does not exist, then it should be created by the server.

* '''DELETE''' requests that the server delete the resource identified by the URI.

Other methods (TRACE, OPTIONS, CONNECT) may be supported, but are not fundamental to the principles of REST. Use of these methods also implies specific requirements in terms of how the response codes should be used.

== REST Inventory Support ==

The REST support in OpenSimulator is separated into a number of functional components, all of which live in the OpenSimulator/ApplicationPlugins/Rest hierarchy.

# Plug-in management. E.g. RestPlugin.cs and Inventory/RestHandler.cs
# Service management: Inventory/RestHandler.cs
# REST implementation: RequestData.cs, Rest.cs
# Service implementations: Inventory/RestInventoryServices.cs, Inventory/RestAssetServices.cs, etc.

This separation serves a number of purposes:

* it limits the sensitivity of each component to implementation changes in the others
* it simplifies the task of service implementation by “hiding” infrastructure
* it helps make services consistent by sharing a single implementation of REST related tasks

The design intention is that each subdirectory in the REST hierarchy, I.e. Inventory, corresponds to a distinct REST handler assembly consisting of service management and one or more service implementations. The Inventory directory is one example of such an assembly.

=== Configuration Parameters ===

In order for the REST handlers to be loaded and effective, statements must be added to the OpenSimulator.ini file. OpenSimulator reads the initialization file during start-up. This file is partitioned into various functional domains, e.g.

<pre>
[Startup]
gridmode = false
physics = basicphysics

[RestPlugins]
enabled = false

[RestHandler]
enabled = false
</pre>

The <tt>RestPlugins</tt> partition affects REST handlers in general and supports the following entries:

<pre>
[RestPlugins]
enabled = true|false || false
god_key = <string> || “”
prefix = <string> || “/admin”
</pre>

Only <tt>enabled=true</tt> is necessary to enable REST processing.

Additionally, REST inventory processing currently requires that the following partition be defined:

<pre>
[RestHandler]
enabled = true|false || false
authenticate = true|false || true
extended-escape = true|false || true
realm = <string> || “OpenSim REST”
dump-asset = true|false || false
dump-line-size = int%8 || 32
path-fill = true|false || false
</pre>

The partition name corresponds to the <tt>ConfigName</tt> value specified in the plug-in subclass, I.e. RestHandler.cs.

Again, only the enabled=true entry must be provided to enable the inventory handler; all other defaults are acceptable for normal operation. The meanings of these values will become apparent in the rest of the document.

When the server starts, the REST handler will publish several messages indicating which configuration values are in effect.

=== Effective URI ===

From a REST perspective, the path component of the URI is viewed as a resource identification, the precise significance of which depends upon the HTTP method being used. There are subtleties here, in some cases a prefix of the path may be viewed as a functional qualification of the authority, with the remainder of the URI being a resource identification within the domain of that authority. In this document, the notion of a service corresponds to the functional qualification mechanism just described.

The <tt>prefix</tt> value in the configuration file is used to construct the server's base prefix for REST services, as illustrated in the description of the inventory services prefix shown below:

<pre>
http://<host>:<port>/admin/inventory
^^^^^
</pre>

In this URI <tt>/admin</tt> is the base prefix, and <tt>/inventory</tt> is a prefix extension that identifies the inventory service handler.

All requests that have an <tt>/admin/inventory</tt> prefix will be passed to the inventory handler. The prefix must be followed by the name of the avatar that owns the inventory in question. For example:

<pre>
http://localhost:9000/admin/inventory/Alan Webb
</pre>

Assuming the GET method, then this will return Alan Webb's inventory catalog, as XML data in the response payload, for example:

<pre>
<Inventory>
<Folder name = “My Inventory” uuid=”11111111-...-111111111111” ....
<Folder name=”Objects” uuid=....
....
</Folder>
</Folder>
</Inventory>
</pre>

In this case <tt>/admin/inventory</tt> identiifes the service, and <tt>/Alan Webb</tt> is the resource specification component of the path.

== Implementation Overview ==

The REST implementation being described is manifest in a subset of the files contained in the <tt>ApplicationPlugins/Rest</tt> file hierarchy. It is logically partitioned into three domains:

* Plugin and configuration management
* REST implementation services
* REST service providers

The objective here being to separate functionality so that the task of the service provider is made as straightforward as possible while ensuring that all services implemented using the interface are consistent in both approach and behavior.

[[Image:RESTOverallDataFlowModel.jpg|center|thumb|400px|Illustration 1: Overall Data Flow Model]]

As shown in Illustration 1: Overall Data Flow Model all requests originate, and are eventually returned to, the OpenSimulator HTTP server. The handler is isolated from this implementation by the <tt>IHttpAgentHandler</tt> interface and the OSHTTP data-types. After matching, the request is passed to the appropriate handler; this relationship is defined by the <tt>IRest</tt> interface and the <tt>RequestData</tt> data-type.

=== Changes to BaseHttpServer ===

The existing OpenSimulator HTTP server class was modified to support plug-in modules that conform to the <tt>IHttpAgentHandler</tt> interface. Three new subroutines were added: <tt>AddHttpAgentHandler</tt>, <tt>RemoveHttpAgentHandler</tt>, and <tt>TryHttpAgentHandler</tt>; this is consistent with the way in which existing handlers are managed.

Additionally, the <tt>HandleRequest</tt> method was extended to include support for the <tt>IHttpAgentHandler</tt> interface.

The processing of existing handlers is not affected by the new support.

=== Plugin and Configuration Management ===

<tt>IHttpAgentHandler</tt> describes the interface between OpenSimulator's base HTTP server and the REST implementation, a plug-in must implement this interface. Any class that exports this interface, and that registers its handlers using the appropriate (not defined by an interface) methods in the base HTTP server can act as a handler. Note that while the usage described here is intended to support REST, the interface itself is agnostic and may be used as the basis for any HTTP request handler.

<tt>'''RestPlugin.cs'''</tt> provides a basic agent-handling superclass. An implementation of this class represents a handler from the point of view of the base HTTP server. This class implements the <tt>IHttpAgentHandler</tt> interface. A given implementation class need only be differentiated from the others in terms of the agent name it uses when it registers. At present, a duplicate agent (based upon supplied agent name) will not be registered; how such a failure is handled depends upon the implementation class. Aside from the name used, a given handler should be differentiated in terms of the set of request patterns that it will match; overlap is undesirable as the first match will win, and at present the order in which OpenSimulator loads modules is non-deterministic. The <tt>RestHandler</tt> class in the Inventory sub-directory is an example of an implementation class for ''RestPlugin.cs''.

<tt>'''Inventory/RestHandler.cs'''</tt> implements the plug-in interface described above, and also implements a local model of integrating a set of services within a single handler instance. It does this by scanning the classes included in the assembly for those that implement the <tt>IRest</tt> interface; each such class is then initialized. This provides implementation independence from a development standpoint (adding a new service is as simple as adding a single class) whilst avoiding unnecessary overt modularization in OpenSimulator. This class also takes care of global configuration and initialization of the basic REST environment, i.e. It sets basic references for the OpenSimulator communications manager, user services, inventory services, and asset management.

For performance reasons, and as an obligation to the <tt>IHttpAgentHandler</tt> definition, this class also implements the Match function, using pattern information registered by the individual services when they were initialized1.

This class contains no REST specific, or service specific functionality beyond some basic initialization. This class can be used in multiple assemblies without change.

<tt>'''Rest.cs'''</tt> provides both state and functionality in support of the REST implementation. Most of the state is static and constant, a small set of static values are initialized by the <tt>RestHandler</tt> when the plug-in is loaded. This class will only change as the REST implementation evolves and becomes more complete. I''t must not contain any service sensitive elements.'' This class may be sub-classed by a given assembly to provide global additions required by a specific set of services.

<tt>'''RequestData.cs'''</tt> serves as a carrier for the state associated with a request. It may be sub-classed by a given service provider in order to add service specific state and functionality, for example the inventory services currently utilize an XML extension to handle inventory specific payload interpretation and generation.

The remaining classes in the Inventory directory provide different classes of service.

=== Adding A New REST Service To An Existing Handler ===

The process for adding a new service is straightforward. The file <tt>RestTestServices.cs</tt> serves as an example1 of what a new services class must minimally include. Key points to note are:

# Each service class should have an associated value for <tt>qPrefix</tt>. This should be unique for each service, as it represents the relative extension of the URI that will be matched by this service. The value supplied here may be absolute, but this is discouraged. The constructor will automatically update a relative value to reflect the absolute prefix set globally during initialization.
# In the case of test services the constructor loads a set of classes from a sub-directory, each of which represents a specific service implementation. For example, these may be method-related, or based upon other values contained in the supplied URI.
# The services constructor must register itself with the <tt>RestHandler</tt>. It provides three values at registration time: a reference to the service method, the URI prefix that this service will match, and a reference to an <tt>RequestData</tt> allocation method that will return an appropriately sub-classed instance of the <tt>RequestData</tt> class.
# Implementation of the service and allocation methods described above must be provided.

Other methods definitions are simply part of the overall infrastructure and would be unique to a given service implementation.

''Note that a given services class may implement zero or more services, according to its intended function. A class providing shared functionality to other services may be loaded but not register any actual handling methods. Similarly, a single services class could register multiple handling methods.''

== REST Implementation Classes ==

This section provides additional documentation of the state and services provided by <tt>Rest.cs</tt> and <tt>RequestData.cs</tt> files.

=== Rest.cs ===

The eponymous class provides a collection of ''request independent'' services and state definitions. Any functions directly dependent upon the HTTP request and response elements are provided in <tt>RequestData.cs</tt>.

==== State ====

The <tt>Log</tt> declaration provides local access to the <tt>log4net</tt> facility. Though apparently complex it simply resolves to a static, read-only reference that can be used to pass messages to the logging facility.

The value of <tt>DEBUG</tt> reflects whether or not debug messages have been enabled in the OpenSimulator log. If they have, then <tt>DEBUG</tt> will be enabled, if not, then they will not. Being a static declaration it is anticipated that the JIT compiler will be able to make efficient code generation assumptions. This is only of real significance where some substantial operation is performed solely in support of debugging.

The <tt>Plugin</tt> reference is set by <tt>RestHandler</tt> during initialization. It eliminates the need for a services class to have direct awareness of how it was activated. For example, this reference is used to locate the <tt>AddPathHandler</tt> method needed to register its interface.

The main reference is set by the <tt>RestHandler</tt> during initialization. Its value is a reference to the simulator's base class. It is provided to the plug-in interface and is stored for that reason. It is not currently used except by <tt>RestHandler</tt> to locate the communications manager during initialization.

<tt>Comms</tt> provides a globally accessible reference to the simulator's communications manager. It is initialized by <tt>RestHandler</tt> during initialization and is currently only used by <tt>RestHandler</tt> to locate other, commonly needed, simulator services.

<tt>InventoryServices</tt>, <tt>UserServices</tt>, and <tt>AssetServices</tt> are references to the corresponding simulator service interfaces. This list may grow as common service requirements expand.

<tt>Prefix</tt> is the common URI prefix associated with all handlers within a given assembly. In the case of inventory services it is obtained from the global REST configuration. It is currently /admin. This is a configurable attribute. Typical this should be set to whatever is considered to be the standard prefix for REST services in a given URI, it will be combined with scheme and authority information to construct a valid URL.

<tt>Config</tt> is a saved reference to the configuration file used by this assembly. The configuration partition is identified by the <tt>ConfigName</tt> string supplied by the <tt>RestHandler</tt> implementation. This is currently only used by the <tt>RestHandler</tt>, but it could be used by a service implementation to access attributes unique to the service.

<tt>GodKey</tt> is a string obtained from the configuration file which contains the password for the God user. This user has unfettered access to all administrative functions. This is a temporary mechanism and will eventually be replaced by something more secure. This is a configurable attribute.

<tt>Authenticate</tt> indicates whether or not user authentication is required by this handler. This is a configurable attribute, true by default.

<tt>Secure</tt> indicates whether or not the HTTP session should be secured. Secure sessions are currently not available to OpenSimulator. This is a configurable attribute, true by default.

<tt>ExtendedEscape</tt> controls whether or not the URI is processed for parsing extensions such as “+” in place of spaces. This is a configurable attribute, true by default.

<tt>DumpAsset</tt> controls whether or not the content of an incoming asset should be dumped to the trace file after decoding has completed. This is only intended to be used when there is some indication of a problem with the decoding process. It may produce a significant amount of trace output depending upon the quantity of asset data being uploaded. This is configurable and is normally false.

<tt>Fill</tt> controls whether or not the server will automatically generate intermediate folder names when handling a POST request; it is not currently considered appropriate for PUT. This is not presently implemented.

<tt>FlushEnabled</tt> indicates that the server will completely flush an inbound data stream before responding. This accommodates clients that can not handle the case where a socket error is generated as a result of an early termination of the inbound data stream (due to an authentication failure for example). This mechanism is vulnerable to DOS attacks and can be selectively enabled/disabled.

<tt>Realm</tt> is a string that may be used to distinguish the authentication realm associated with the handler, in place of the URI prefix. This corresponds directly to the realm token included in the WWW-Authenticate response header. This is a configurable option, and is set to 'OpenSim REST' by default. Clients may use this value to determine if additional authentication is necessary, or to select appropriate cached credentials.

<tt>DumpLineSize</tt> indicates the line length to use for any data dumps (e.g. <tt>DumpAsset</tt>) during runtime. The default is 132. This is a configurable option.

<tt>statusHead</tt> contains the standard HTML header used for reporting request status. Similarly, <tt>statusTail</tt> is used to provide a standard suffix. These are both used by the standard status reporting mechanisms.

<tt>HttpStatusDesc</tt> is an array which, when indexed by an appropriate HTTP status code, will return a corresponding status description.

<tt>CreationDate</tt> (property) provides a single consistent reference for creation data value needed when introducing new items into the inventory.

<tt>MsgId</tt> (property) provides a consistent message prefix for log messages generated by the handler. Although static, the value is thread specific, so it is actually unique per request.

<tt>RequestId</tt> (property) provides a unique, monotonically incrementing request counter for processed requests.

<tt>Encoding</tt> provides a standard encoding reference (UTF8) for all data handled by the handler.

<tt>Version</tt> and <tt>Name</tt> are intended to uniquely identify the REST implementation represented by this particular class. Version information should be updated if any significant changes to the REST interface are implemented. This is not currently exploited, but should be. We should have an extended header that indicates the REST version that the client is expecting, and the Match process should be sensitive to this. In this way we can provide concurrent support for multiple REST versions.

The extensive list of constant values are all held to be self-explanatory and should be used wheresoever the value they represent is required in a service implementation. This ensures consistency between the REST implementation and the REST service implementations.

==== Functions ====

<tt>StringToBase64</tt> provides a standard Base64 encoding mechanism for service implementations.

<tt>Base64ToString</tt> provides a standard Base64 decoding mechanism for service implementations.

<tt>Hex2Int</tt> provides a standard mechanism for converting a hexadecimal string of arbitrary length into an integer.

<tt>Int2hex8</tt> converts an integer into an 8 character hexadecimal number. This is not currently used, and as such should not be trusted.

<tt>NonceGenerator</tt> is a simple nonce producer that ensures uniqueness by simply converting a newly generated UUID into a Base64 string. This function is called each time the user is called upon to authenticate, which is not necessarily that often, provided the client caches credentials based upon realm.

<tt>Dump</tt> provides a general purpose facility for generating an interpreted hexadecimal data dump to the log file. It is currently used by the DumpAsset debug facility. But it may be used by anybody requiring such data dumping services.

=== RequestException ===

This class provides an extended exception that can be distinguished from regular, system generated, exceptions. A <tt>RequestException</tt> does not indicate a programming failure, rather it indicates that the received request could not be validly processed, for example, the URI was invalid. This exception should only be used in those cases where request processing is to be immediately terminated in conjunction with normal response processing. Principally it allows the handler to differentiate between a failure in processing, which should be logged, and a normal response to an invalid request, which should not.

=== RequestData.cs ===

This file, and its eponymous class provides consistent support for request specific REST processing. When the <tt>RestHandler</tt> has successfully matched a handler to a request, the registered allocate method for that service interface is called to allocate an instance of this class either directly, or as a super class of some service specific extension. This description deals only with the base implementation.

With a single instance of a service class per handler, it is necessary to encapsulate request/response specific data in this way. Those functions that operate over that data are included here for convenience and represent part of the previously mentioned REST implementation encapsulation.

==== Members ====

When an instance of this class is created, the constructor always does the following:

# The parameters are not validated. Their validity is considered to be a precondition and as such the natural exception mechanism is an efficient and effective way to deal with invalid argument values.
# The supplied request and response object references are cached, as is the supplied request prefix.
# The effective encoding is obtained from the supplied request if possible, or the Rest default (UTF8) is applied.
# A lower case copy of the request method is stored.
# <tt>InitUrl</tt> is called to decompose the supplied URI into its basic components: query, path, host name, and port.
# <tt>InitParameters</tt> is called to create an array of strings, each of which represents a separated portion of whatever URI remains after the handler's selection prefix is removed. This list may be empty.

In the interests of laziness, constructor processing is kept to a minimum.

The <tt>IsAuthenticated</tt> property checks to see if the user is currently authenticated, and if not, then invokes that authentication mechanism. This allows a service request handler so simply test this boolean and reject the request if the result is false. This is an example of a failure that should not normally be logged, as the client is expected to respond to the challenge with an appropriate set of credentials.

The <tt>PathNodes</tt> property is an array that contains a normalized list of elements in the absolute path provided in the URI. It does not differentiate the elements.

The <tt>Parameters</tt> property is an array that contains only those URI path elements that are not a part of the service selection prefix (i.e. <tt>/admin/inventory</tt>). This simplifies service processing by providing a prefix-independent base for request parameter indeces.

<tt>Complete</tt> allows a service provider to indicate the manner in which a request has completed. Called with no arguments, this corresponds to a status code of 200 indicating a normal completion. In many cases the service provider must necessarily indicate a more specific code. The message associated with this call may be arbitrarily complex, it is used, as-is, as the message body in the response.

<tt>Redirect</tt> allows a service provider to indicate that the requester should be redirected to an alternative URL. Redirection may be permanent or temporary as indicated by the boolean argument.

Variations on <tt>Fail</tt> allow a service to abandon request processing. This call constructs an appropriate HTTP failure response, including any specified message body, generates the response, adds request information to an instance of <tt>RestException</tt> and finally throws the exception. It is important that a service provider allow <tt>RestException</tt> events to pass through transparently, (i.e. re-throw any that are inadvertently trapped).

<tt>Reject</tt> encapsulates whatever processing is appropriate for requests that attempted processing that is not implemented.

<tt>Respond</tt> allows a service provider to generate a response and complete processing with respect to the current HTTP request and response. This call is mandatory for any request that is considered to have been processed successfully.

<tt>AddHeader</tt> allows a service provider to add a header to the set of response headers that will be included when the response is finally generated. The Rest constants should be used when specifying the header name. The header value is treated as an arbitrary string.

<tt>RemoveHeader</tt> allows a service provider to remove a header that was previously added to the response header set.

<tt>DumpHeaders</tt> causes a list of the currently effective headers to be sent to the log. This is a DEBUG option.

== RestInventoryServices ==
This file, and the classes it contains, provide a monolithic implementation of all of the services provided in support of inventory processing. If required, authentication is established before any processing of inventory data. The following abnormal completion codes may be returned:

* 301 indicating that a permanently applicable alternative URI for a specified resource has been provided.
* 400 indicating a bad request. Information about the nature of the request error is included in the status information returned to the client. Currently this is textual, but when a proper schema document for the interface is established, a more quantitative status will be returned.
* 401 indicating that the client must authenticate.
* 409 indicating that an ambiguous or conflicting request was received.

=== Inventory Resource Identification ===

An avatar's inventory is a catalog of the assets 'owned' by the avatar; the inventory contains only of meta-data and depends upon the asset data base for whatever actual data represents the perceived content. References to inventory in this document normally refer to the meta-data rather than the content. An inventory consists of two types of element: ''folders'' and ''items''. In both cases, a given element is uniquely identified by an assigned UUID. An associated name is also provided for human convenience, but such names are not required to be unique and are insufficient to ensure an exact identification. The URI used in inventory related requests allows either UUID or name to specified for each element in a resource identification path, ''if any ambiguity arises then the request will be failed''.

The avatar's inventory can contain a private catalog, and one or more shared, or public, catalogs. Currently only the private catalog is processed. When support for the shared catalogs is introduced it will do so by adding by prefixing any path as follows:

<pre>
/admin/inventory/shared/[<libname>]/
</pre>

This allows all global inventory, or a specific library to be referenced.
For all requests, specifying an avatar name implies the private inventory.
In all cases, if additional path information is provided, then the root directory name may be inferred (but accepted if specified explicitly). So

<pre>
/admin/inventory/Alan Webb/My Inventory/Clothing
</pre>

and

<pre>
/admin/inventory/Alan Webb/Clothing
</pre>

are semantically equivalent. This is a convenient and harmless special case. Note that the folder names are case-sensitive. Where no additional path information is provided, as in

<pre>
/admin/inventory/Alan Webb
</pre>

then the root directory may still be inferred for GET and POST, but can not be allowed for PUT. PUT requires the URI to identify the element that is being updated, so inference in this case could be extremely damaging. Explicit specification of the root inventory name is therefore required for all PUT requests. Given that this is an interface normally used only by programmed clients, the additional verbosity is not expected to be an issue. If this proves to be contentious, then the only viable approach would be to drop the inference altogether.

=== Supported Services ===

==== GET ====

<tt>GET</tt> allows the client to retrieve all, or some sub-tree of, the inventory associated with a specified avatar's inventory. Inventory information is returned in an XML payload. This request is guaranteed not to affect the state of the avatar's inventory. Possible normal completions are:

* 200 indicating normal completion of the request. The payload will contain an XML representation of the avatar's inventory.

==== PUT ====

<tt>PUT</tt> allows a resource, explicitly nominated in the URI, to be created or replaced. I.e. the URI identifies an instance rather than a context. Possible normal completions are

* 200 if the nominated resource was successfully updated
* 201 if the nominated resource was successfully created.
* 204 if no content change (but the resource was recognized and valid)

==== POST ====

<tt>POST</tt> allows a new resource to be created in the context identified by the URI. It follows from this that the resource identified by a POST request should always be a folder. Normal completions are:

* 200 if some portion of the context was modified.
* 201 if the new data was entirely new.

==== DELETE ====

<tt>DELETE</tt> allows a named resource to be deleted. If the resource is a folder, then the entire sub-tree will be removed. Normal completion codes are:

* 200 if the specified resource was deleted.

Both PUT and POST allow any assets upon which the inventory catalog depends, to be included in-line with the XML catalog data.

OSSL Script Library/OpenSim Radio

2012-03-04T07:48:43Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

A basic parcel radio, using OSSL functions to read a notecard, cointaining a list of stations.

* Open access, so anyone can change stations.
* Very basic, and much could be added or improved.
* Demonstrates the use of OSSL functions to read a notecard.

'''Updates'''
* 0.12 - Selected station choice is now saved in the object description, and will be re-applied to the land/parcel upon script stert.
* 0.11 - Improved menu system
* 0.10 - Initial version

=== Notecard ===
Name the notecard "stations" and place it in your prim.
Here are some example stations, copy and pase these exatly into your notecard:

Public Domain Jazz=http://82.197.167.138:80
Digital Gunfire=http://radio1-uk.digitalgunfire.com:8000
Salsa and Latin=http://205.188.215.231:8010
Retro=http://scfire-ntc-aa03.stream.aol.com:80/stream/1013

More stations can be found at http://www.shoutcast.com

=== OpenSimulator Radio ===
<source lang = "lsl">
// ######################################
// Radio for OpenSim, by Fritigern Gothly
// Version 0.12 - Oct 08, 2011
//
// Add your name and date to these
// comments if you alter this script in
// any way.
// If you put this in your own build,
// make sure to mention BOTH me and you!
// ######################################

integer dchannel; // Will be a random number.
key toucher;
string stationcard = "stations"; // Name for the notecard. Change this is you want to use a different name.
integer cardlines;
integer n;
integer i;
list names;
list uris;
list page;
integer pagenum;

// ----------------------
// Needed user functions.
// ----------------------

initialize()
{
//Clear the values to prevent problems
names =[];
uris=[];
page = [];
pagenum=0;
cardlines=0;
// Now get all stations (again)
cardlines = osGetNumberOfNotecardLines(stationcard);
for(n=0;n<cardlines;++n)
{
// Use llStringTrim to get rid of additional spaces around the
// string. Makes this script a little more forgiving.
string line = llStringTrim(osGetNotecardLine(stationcard,n), STRING_TRIM);
if(llGetSubString(line,0,0)=="#" || line == "")
{
// Skip comments and empty lines
} else {
integer seperator = llSubStringIndex(line, "=");
uris += [llStringTrim(llGetSubString(line,seperator+1,llStringLength(line)), STRING_TRIM)];

// Make sure that the button names fit on the buttons. Names
// can be up to 24 characters (but only a few will show),
// Doing this will let you put really long station names in
// the notecard without problems.
string desc = llStringTrim(llGetSubString(line,0,seperator-1), STRING_TRIM);
if(llStringLength(desc) >= 23) desc = llGetSubString(desc,0,23);
names += [desc];
}
}

// Get all entries from the list of station names and put them in a string
// in groups of nine, and put them in a new list..
string btn;
for(n=0;n<llGetListLength(names);n=n+9)
{
for(i=n;i<(n+9);++i) // Get 9 buttons....
{
if(n>llGetListLength(names)) return;
btn += llList2String(names,i)+",";
}
page += [btn]; // ...And put them in a list again! (As a string, not as list items!)
btn="";
}
llOwnerSay("Notecard loaded. "+(string)llGetListLength(names)+" stations in "+llGetListLength(page)+" pages.");
}

dialog(string buttons)
{
list b = ["< Prev","Cancel","Next >"]+llParseString2List(buttons,",","");
string txt = "\nShowing stations "+(string)((pagenum*9)+1)+" to "+(string)((pagenum*9)+llGetListLength(llParseString2List(buttons,",","")))+
" of "+(string)llGetListLength(names)+" loaded.\n"+
"\nPage "+(string)(pagenum+1)+" of "+(string)llGetListLength(page);
llDialog(toucher, txt+"\nChoose a station:", b, dchannel);
b=[]; // Clear the list, and save some memory.
}

default
{
state_entry()
{
dchannel = llFloor(llFrand(9999999)); // Choose a random channel.
initialize();
if(llGetObjectDesc() != (integer)llGetObjectDesc()||llGetObjectDesc() == "")
{
llSetText("OpenSimulator Radio\nClick to choose a station", <1,1,1>,1);
} else {
integer index = (integer)llGetObjectDesc();
llSetText(llList2String(names,index)+"\n"+llList2String(uris,index),<1,1,0>,1);
llSetParcelMusicURL(llList2String(uris,index)); // Sometimes the parcel's audio settings don't survive a restart or server upgrade. So we'll set it again, just to make sure.
}
// llOwnerSay("Ready");
}

touch_start(integer numdet)
{
toucher = llDetectedKey(0);
llListen(dchannel, "","","");
dialog(llList2String(page,pagenum));

}

listen(integer channel, string name, key id, string msg)
{
if(msg == "< Prev")
{
--pagenum;
if(pagenum<0) pagenum = llGetListLength(page)-1;
dialog(llList2String(page,pagenum));
}
else if(msg == "Next >")
{
++pagenum;
if(pagenum>=llGetListLength(page)) pagenum = 0;
dialog(llList2String(page,pagenum));
}
else if(msg == "Cancel")
{
pagenum = 0;
return;
}
else {
// If none of the predefined buttons were clicked, it must be a station name.
integer index = llListFindList(names,msg);
llSetParcelMusicURL(llList2String(uris,index));
llSay(0,"Station changed to "+llList2String(names,index)+" ("+llList2String(uris,index)+")");
llSetText(llList2String(names,index)+"\n"+llList2String(uris,index),<1,1,0>,1);
llSetObjectDesc((string)index);
}
}

changed(integer ischanged)
{
//If something changed in the inventory, go and read the list with stations again!
if(ischanged & CHANGED_INVENTORY) initialize();
}
}</source>

[[Category:Scripts]]

0.6.6-release

2012-03-04T07:43:47Z

MakoBot:

__NOTOC__
{{Quicklinks}}
<br />

=== Version 0.6.6-release is SVN r9962 ===
------------------------------------------------------------------------
r9961 | sdague | 2009-06-30 22:50:12 +0900 (Tue, 30 Jun 2009) | 5 lines

From: Chris Yeoh <yeohc@au1.ibm.com>

Ooops, sorry there was a bug in the patch and causes an exception
on some system (I think it only happens on windows since it didn't
occur during my testin). I've attached a one liner which fixes the problem.
------------------------------------------------------------------------
r9960 | ckrinke | 2009-06-30 06:47:47 +0900 (Tue, 30 Jun 2009) | 5 lines

Thank you kindly, Snowdrop, for a patch that solves:
The current API for MRM is quite sparse, this patch
supplies basic support for accessing the task
inventory of object.

------------------------------------------------------------------------
r9959 | arthursv | 2009-06-30 04:24:43 +0900 (Tue, 30 Jun 2009) | 2 lines

Thanks StrawberryFride, for a patch that fixes MSSQL migration:
Minor tweak to a region migration SQL script for the OAR DateTime field - SQL Server syntax slightly different from MySQL (and there is no unsigned in MSSQL, sadly)
------------------------------------------------------------------------
r9958 | arthursv | 2009-06-30 04:24:30 +0900 (Tue, 30 Jun 2009) | 2 lines

* C# compiler is not smart enough to understand ClientLoop is under very heavy usage and inline DebugPacket, so DebugPacket is run as a method, causing Packet
to be constantly pushed and popped uselessly, if you are not debugging packets. This showed some really big difference in a mock test, let's see how it behaves here.
------------------------------------------------------------------------
r9957 | ckrinke | 2009-06-30 03:07:30 +0900 (Tue, 30 Jun 2009) | 2 lines

Thank you kindly, Snowdrop/Snowcrash for a patch that:
This patch makes the worn attachments accessible to MRM scripting
------------------------------------------------------------------------
r9956 | arthursv | 2009-06-30 01:55:00 +0900 (Tue, 30 Jun 2009) | 1 line

* Changing List to Dictionary in PacketQueue.Dequeue for great justice (and performance)
------------------------------------------------------------------------
r9955 | chi11ken | 2009-06-30 00:40:00 +0900 (Tue, 30 Jun 2009) | 1 line

Update svn properties, add copyright header, formatting cleanup.
------------------------------------------------------------------------
r9954 | sdague | 2009-06-30 00:05:12 +0900 (Tue, 30 Jun 2009) | 6 lines

From: Chris Yeoh <yeohc@au1.ibm.com>

Attached is a patch that changes the oar file saving of creation date/time to an integer
instead of a string. I did this after justincc emailed me saying there is a problem
with internationalisation doing it the old way and I said I'd fix it. Its been
tested with MySQL and I've made the changes for MSSQL but that hasn't been well tested.
------------------------------------------------------------------------
r9953 | ckrinke | 2009-06-29 23:01:08 +0900 (Mon, 29 Jun 2009) | 7 lines

Thank you kindly, Godfrey, for a patch that:
The new IRCd module causes an error when multiple instances of OpenSimulator
are run on the same machine; since the port number (6666) is hardcoded,
the second and subsequent instances crash upon startup because the port
is already in use. Attached is a patch which adds a Port specifier to the
[IRCd] section of the config file, which defaults to 6666 if not present.

------------------------------------------------------------------------
r9952 | ckrinke | 2009-06-29 03:19:11 +0900 (Mon, 29 Jun 2009) | 5 lines

Thank you kindly, Grumly57 for a patch that solves:
When a sit position is modified by llSitTarget and the
sim is restarted, the object sit position is lost until
llSitTarget is applied again.

------------------------------------------------------------------------
r9951 | mw | 2009-06-28 20:07:26 +0900 (Sun, 28 Jun 2009) | 1 line

Removed the List<NewForce> m_forceList from ScenePresence, as there wasn't any need for a list, as only the last entry in it was acted on. So it now has a single NewForce m_nextVelocity , which is updated (rather than a NewForce object being created every AgentUpdate). So as well as cutting out all the adds and clearing of the list, it also removes the creation of upto 100+ new objects per second per avatar.
------------------------------------------------------------------------
r9950 | dahlia | 2009-06-27 16:49:10 +0900 (Sat, 27 Jun 2009) | 1 line

Make cleartext authentication case sensitive. Thanks jhurliman for spotting this.
------------------------------------------------------------------------
r9949 | chi11ken | 2009-06-27 13:31:49 +0900 (Sat, 27 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9948 | mw | 2009-06-26 21:30:54 +0900 (Fri, 26 Jun 2009) | 1 line

Fixed null bug, which was making unit tests fail
------------------------------------------------------------------------
r9947 | mw | 2009-06-26 21:09:43 +0900 (Fri, 26 Jun 2009) | 2 lines

Extracted the code that handles the sending of prim updates to the client, from ScenePresence into ISceneViewer/SceneViewer. Currently ScenePresence "has" a ISceneViewer, although if we had a proper Node based scenegraph then it would most likely be attached directly to the nodes.
By extracting this code, it should make it easier to experiment with different ways of managing the update process. [Next step to make this module based, could be to create a SceneViewerFactoryModule]
------------------------------------------------------------------------
r9946 | melanie | 2009-06-26 20:32:36 +0900 (Fri, 26 Jun 2009) | 2 lines

Enable the RemoteAdmin module to save regions as ini files rather than XML

------------------------------------------------------------------------
r9945 | melanie | 2009-06-26 09:00:20 +0900 (Fri, 26 Jun 2009) | 3 lines

Make delete-region delete the section from an ini file. Will delete the whole
file if it has no sections left.

------------------------------------------------------------------------
r9944 | melanie | 2009-06-26 08:31:55 +0900 (Fri, 26 Jun 2009) | 4 lines

Make create region save the new region to ini file format if the name
specifies an ini file.
If the ini file exists, the region will be added.

------------------------------------------------------------------------
r9943 | melanie | 2009-06-26 02:53:03 +0900 (Fri, 26 Jun 2009) | 7 lines

From this version onwards, all new region files created automatically will
be created as new style INI files.
This doesn't yet affect create region, but it does affect first starts of
OpenSim.exe
Because master avatars are slated to be replaced by estate owners, this now
allows regions to be created without any master avatar data.

------------------------------------------------------------------------
r9942 | melanie | 2009-06-26 01:05:59 +0900 (Fri, 26 Jun 2009) | 2 lines

Add a comment and an example region config file

------------------------------------------------------------------------
r9941 | melanie | 2009-06-26 00:48:54 +0900 (Fri, 26 Jun 2009) | 3 lines

Allow the reading of ini files instead of xml files when reading region
definitions from the file system

------------------------------------------------------------------------
r9940 | mw | 2009-06-25 22:12:48 +0900 (Thu, 25 Jun 2009) | 1 line

Added a note to the ScenePresence.UpdateMovement() method, to remind everyone that the so called "forces" are actually velocities.
------------------------------------------------------------------------
r9939 | mw | 2009-06-25 21:26:23 +0900 (Thu, 25 Jun 2009) | 2 lines

Applied patch from mantis #3820 which changed the clearing of the ScenePresence.m_forcesList, so it used the List.Clear method rather than doing a loop through the list and manually removing each item. Thanks dslake.
I also fixed the issue where the code also loops through the m_forcesList and copies each force to the ScenePresence's movementVector. Which resulted in only the last force in the list actually be acted on. As each copy overrode the last one. So now it only copies the last force in the list.
------------------------------------------------------------------------
r9938 | drscofield | 2009-06-25 20:30:31 +0900 (Thu, 25 Jun 2009) | 3 lines

moving the m_PendingAcksMap.Remove() out of the foreach and clearing
it instead after the foreach as we are going through the whole
m_PendingAcks list anyhow
------------------------------------------------------------------------
r9937 | drscofield | 2009-06-25 20:30:16 +0900 (Thu, 25 Jun 2009) | 1 line

have to clear m_PendingAcks not m_PendingAcksMap
------------------------------------------------------------------------
r9936 | drscofield | 2009-06-25 19:26:10 +0900 (Thu, 25 Jun 2009) | 2 lines

hmph: missing '{'/'}', thx to nebadon for reporting it and rob smart
for spotting it!
------------------------------------------------------------------------
r9935 | drscofield | 2009-06-25 17:28:59 +0900 (Thu, 25 Jun 2009) | 1 line

fixing windows specific compile error.
------------------------------------------------------------------------
r9934 | drscofield | 2009-06-25 17:17:37 +0900 (Thu, 25 Jun 2009) | 13 lines

From: Alan Webb <alan_webb@us.ibm.com>

After noticing on several occasions that the thread counts
we see when running OpenSIm were bordering on the astronomical
I decided to seriously investigate.

After much poking I discovered that the problem is actually very
simple. The XEngine secition of the example ini says that the
timeout for an iden thread is in seconds, and an example value
of 60 is specified. In fact, this is actually resulting in a 60mS
idle timeout, which is not normally enough for a smart thread
to survive. I have added a multiplier to the XEngine constructor
so that the number now matches the published behavior.
------------------------------------------------------------------------
r9933 | drscofield | 2009-06-25 17:01:02 +0900 (Thu, 25 Jun 2009) | 1 line

cosmetic change
------------------------------------------------------------------------
r9932 | drscofield | 2009-06-25 17:00:43 +0900 (Thu, 25 Jun 2009) | 1 line

streamlining m_NeedAck logic
------------------------------------------------------------------------
r9931 | drscofield | 2009-06-25 17:00:18 +0900 (Thu, 25 Jun 2009) | 2 lines

streamling m_PendingAcks logic to get rid of gratuitous List<...>
instantiations and object copies.
------------------------------------------------------------------------
r9930 | drscofield | 2009-06-25 16:59:58 +0900 (Thu, 25 Jun 2009) | 1 line

commenting out expensive bits (who in the world even uses SetClientInfo()?)
------------------------------------------------------------------------
r9929 | drscofield | 2009-06-25 16:59:47 +0900 (Thu, 25 Jun 2009) | 2 lines

changing DropSend()'s foreach loop so that it does not copy the
LLQueItem m_NeedAck queue each time.
------------------------------------------------------------------------
r9928 | drscofield | 2009-06-25 16:59:38 +0900 (Thu, 25 Jun 2009) | 5 lines

commenting out rather expensive bits of GetClientInfo() --- the only
bit of GetClientInfo that is actually used seems to be userEP as part of the
OSSL osGetAgentIP() script function. Now commented are the parts where
we serialize and copy out the *entire* packet queue of the client
(locking the packet handler in the process).
------------------------------------------------------------------------
r9927 | drscofield | 2009-06-25 16:59:25 +0900 (Thu, 25 Jun 2009) | 8 lines

more efficient way of checking for already seen packets:
- uses Environment.TickCount for all timestamps (instead of more
costly Util.UnixTimeSinceEpoch()
- takes care of Environment.TickCount overflow (which will happens
after 24.8 days of system uptime)
- avoids instantiating List copies for each check
- gets rid of one lock() invocation
- moves calculation of loop invariant variable out of the loop itself
------------------------------------------------------------------------
r9926 | drscofield | 2009-06-25 16:50:19 +0900 (Thu, 25 Jun 2009) | 1 line

adding logging statement for receive buffer size
------------------------------------------------------------------------
r9925 | drscofield | 2009-06-25 16:50:02 +0900 (Thu, 25 Jun 2009) | 9 lines

- adds the possibility of setting the socket receive buffer size
option for LLUDPServer. On windows .NET the default socket receive
buffer size is 8192 bytes, on recent linux systems it's about
111K. both value can be a bit small for an OpenSimulator instance serving
many clients. The socket receive buffer size can be configured via
an OpenSim.ini config option

- adds a general catch clause to LLUDPServer.OnReceivedData() to
prevent it submerging when an unexpected Exception occurs.
------------------------------------------------------------------------
r9924 | drscofield | 2009-06-25 16:42:06 +0900 (Thu, 25 Jun 2009) | 37 lines

From: Alan Webb <alan_webb@us.ibm.com>

This change moves texture send processing out of the main
packet processing loop and moves it to a timer based
processing cycle.

Texture packets are sent to the client consistently over
time. The timer is discontinued whenever there are no
textures to transmit.

The behavior of the texture sending mechanism is controlled
by three variables in the LLCLient section of the config
file:

[1] TextureRequestRate (mS) determines how many times per second
texture send processing will occur. The default is 100mS.
[2] TextureSendLimit determines how many different textures
will be considered on each cycle. Textures are selected
by priority. The old mechanism specified a value of 10 for
this parameter and this is the default
[3] TextureDataLimit determines how many packets will be sent for
each of the selected textures. The old mechanism specified a
value of 5, so this is the default.

So the net effect is that TextureSendLimit*TextureDataLimit
packets will be sent every TextureRequestRate mS.

Once we have gotten a reasonable feeling for how these parameters
affect overall processing, it would be nice to autonmically manage
these values using information about the current status of the
region and network.

Note that this also resolves the pathologcal problem that
previously existed which was that a seated avatar generated very
few in-bound packets (theoretically) and would therefore be the
least able to retrieve the images being displayed by a
projector script.
------------------------------------------------------------------------
r9923 | drscofield | 2009-06-25 16:39:48 +0900 (Thu, 25 Jun 2009) | 4 lines

- fixes a "collection out of sync" exception in the ODE physics
engine, caused by an "avatar infinite position" occurring under
heavy load.
- fixes "value too small" exception in ChatModule
------------------------------------------------------------------------
r9921 | melanie | 2009-06-25 08:45:21 +0900 (Thu, 25 Jun 2009) | 4 lines

Allow "Take Copy" with copy only permissions if you own the object. Trans
is only required when taing an object you don't own, now.
Fixes Mantis #3838

------------------------------------------------------------------------
r9920 | melanie | 2009-06-24 18:49:49 +0900 (Wed, 24 Jun 2009) | 4 lines

Reading GroupPosition, but setting OffsetPosition in undo doesnt' seem right.
This may fix the Mantii where individual prims ctrl-z to nirvana, but
it's not tested.

------------------------------------------------------------------------
r9919 | chi11ken | 2009-06-24 13:51:15 +0900 (Wed, 24 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9917 | melanie | 2009-06-24 07:11:34 +0900 (Wed, 24 Jun 2009) | 2 lines

Also fix group role membership packet sizes to stay safely below MTU

------------------------------------------------------------------------
r9915 | melanie | 2009-06-24 06:17:20 +0900 (Wed, 24 Jun 2009) | 2 lines

Can I be this dumb?

------------------------------------------------------------------------
r9913 | melanie | 2009-06-24 05:27:35 +0900 (Wed, 24 Jun 2009) | 3 lines

Fix an error in group membership sending when the memebr count exceeds 60
Also reduce limit to 40 to allow for last logon dates and titles

------------------------------------------------------------------------
r9911 | melanie | 2009-06-23 23:37:51 +0900 (Tue, 23 Jun 2009) | 3 lines

Allow the member list of groups with more than 70 members to be viewed
without crashing

------------------------------------------------------------------------
r9910 | melanie | 2009-06-23 18:04:30 +0900 (Tue, 23 Jun 2009) | 2 lines

Add RegionSecret to user data structure to provide data update security

------------------------------------------------------------------------
r9909 | melanie | 2009-06-23 17:56:45 +0900 (Tue, 23 Jun 2009) | 3 lines

Commenting out the jhurliman fix, since our libOMV doesnt' have those fields
yet.

------------------------------------------------------------------------
r9908 | melanie | 2009-06-23 17:51:35 +0900 (Tue, 23 Jun 2009) | 3 lines

Correct an uninitialized field in a packet. Thanks, jhurliman.
Fixes Mantis #3831

------------------------------------------------------------------------
r9907 | melanie | 2009-06-23 17:37:12 +0900 (Tue, 23 Jun 2009) | 5 lines

Fix the AssetServiceBase bug I introduced by reordering configuration load
order. Thanks, Grumly57, for pointing it out.
The point of the original change was to let the more specific setting override
the less specific one, actually, I disabled the use of the less specific one.

------------------------------------------------------------------------
r9906 | sdague | 2009-06-23 04:27:38 +0900 (Tue, 23 Jun 2009) | 1 line

update README to specify the correct mono revisions
------------------------------------------------------------------------
r9905 | melanie | 2009-06-22 22:25:47 +0900 (Mon, 22 Jun 2009) | 2 lines

Forgot a file

------------------------------------------------------------------------
r9904 | melanie | 2009-06-22 22:14:48 +0900 (Mon, 22 Jun 2009) | 3 lines

Committing RemoteUserServiceConnector out connector, local user service
connector and the glue code.

------------------------------------------------------------------------
r9903 | melanie | 2009-06-22 21:18:04 +0900 (Mon, 22 Jun 2009) | 2 lines

Committing the meat of the user server interface and the bones of the service implementation

------------------------------------------------------------------------
r9902 | chi11ken | 2009-06-22 20:04:09 +0900 (Mon, 22 Jun 2009) | 1 line

Formatting cleanup, ignore some generated files.
------------------------------------------------------------------------
r9901 | chi11ken | 2009-06-22 19:07:27 +0900 (Mon, 22 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9900 | lbsa71 | 2009-06-22 17:34:50 +0900 (Mon, 22 Jun 2009) | 1 line

* Panda no like LongRunningAttribute, no? Me now reverting minuscule fix, yes? Panda happy, eh?
------------------------------------------------------------------------
r9899 | lbsa71 | 2009-06-22 16:40:31 +0900 (Mon, 22 Jun 2009) | 1 line

* Minuscule CC fix
------------------------------------------------------------------------
r9898 | lbsa71 | 2009-06-22 16:40:00 +0900 (Mon, 22 Jun 2009) | 1 line

* Ignored some gens
------------------------------------------------------------------------
r9897 | lbsa71 | 2009-06-22 16:39:36 +0900 (Mon, 22 Jun 2009) | 1 line

* Fixed some prebuild ref issues
------------------------------------------------------------------------
r9896 | lbsa71 | 2009-06-22 16:39:04 +0900 (Mon, 22 Jun 2009) | 3 lines

* Added SceneTests and SceneBaseTests
* Changed some fields to protectesd to enable faking

------------------------------------------------------------------------
r9895 | melanie | 2009-06-22 07:40:21 +0900 (Mon, 22 Jun 2009) | 4 lines

Suppress exception dump when informing friends in another region about login
or logoff. Regions come and go and we can't throw just because someone
took their region off the grid, or crashed.

------------------------------------------------------------------------
r9893 | melanie | 2009-06-22 04:49:11 +0900 (Mon, 22 Jun 2009) | 2 lines

Correct the behaviro of group deeding and llGetOwner() within deeded objects

------------------------------------------------------------------------
r9892 | homerh | 2009-06-22 04:06:19 +0900 (Mon, 22 Jun 2009) | 3 lines

Do llEscapeURL with Uri.EscapeDataString instead of Uri.EscapeUriString.
Not exactly right, according to the LSL docs, but similar enough, I hope.
Fixes Mantis #3825.
------------------------------------------------------------------------
r9891 | melanie | 2009-06-22 03:38:12 +0900 (Mon, 22 Jun 2009) | 3 lines

Publish a method on ICompiler to generate the CIL assembly path
Cause group deeding to apply next owner perms

------------------------------------------------------------------------
r9888 | melanie | 2009-06-20 07:32:02 +0900 (Sat, 20 Jun 2009) | 2 lines

Properly reset a vehicle's status to VEHICLE_TYPE_NONE when requested

------------------------------------------------------------------------
r9886 | melanie | 2009-06-20 05:46:17 +0900 (Sat, 20 Jun 2009) | 6 lines

When a shared module hooks OnClientClosed, it has no way of finding
out which client connection has closed. So, in multi-region sims, things
can get messy fast.
This introduces a second parameters, which is a Scene object ref. Minor
adjustments to custom modules may be required due to this change.

------------------------------------------------------------------------
r9885 | dahlia | 2009-06-20 02:08:23 +0900 (Sat, 20 Jun 2009) | 2 lines

Thanks cmickeyb for a patch that checks for null assets in Cenome asset cache - Mantis #3819

------------------------------------------------------------------------
r9884 | sdague | 2009-06-19 21:21:33 +0900 (Fri, 19 Jun 2009) | 3 lines

From: Rob Smart <SMARTROB@uk.ibm.com>

Makes an avatars personal voice indicator work with Freeswitch (though not other avatars indicators)
------------------------------------------------------------------------
r9883 | sdague | 2009-06-19 21:21:20 +0900 (Fri, 19 Jun 2009) | 4 lines

From: Chris Yeoh <yeohc@au1.ibm.com>

This patch ensures that the touch positions are set during touch_end
events (currently only working for touch_start and touch events).
------------------------------------------------------------------------
r9882 | sdague | 2009-06-19 09:01:50 +0900 (Fri, 19 Jun 2009) | 1 line

more type clean fixes for mono 2.4.2
------------------------------------------------------------------------
r9881 | sdague | 2009-06-19 08:59:21 +0900 (Fri, 19 Jun 2009) | 1 line

mono 2.4.2 seems a little more type strict, fix some sqlite tests to pass
------------------------------------------------------------------------
r9880 | dahlia | 2009-06-19 08:02:12 +0900 (Fri, 19 Jun 2009) | 1 line

Thanks Michelle Argus for Mantis #0003742: Terrain editor - Flatten tool lowers Land
------------------------------------------------------------------------
r9879 | mw | 2009-06-19 05:18:47 +0900 (Fri, 19 Jun 2009) | 1 line

Applied patch from Mantis #3817, which fixes a error when using MSSQL. I don't use MSSQL so couldn't test this myself. But there was certainly duplicated instructions in these files...which this patch fixes. Thanks Grumly57
------------------------------------------------------------------------
r9878 | mw | 2009-06-19 05:01:37 +0900 (Fri, 19 Jun 2009) | 1 line

Applied patch from Mantis #3736 , which should stop the userserver crashing when a SL viewer version 1.23 logs in. Thanks StrawberryFride
------------------------------------------------------------------------
r9877 | arthursv | 2009-06-18 23:33:35 +0900 (Thu, 18 Jun 2009) | 2 lines

* Corrected CAPS namespaces
* "luke, use the sed"
------------------------------------------------------------------------
r9876 | diva | 2009-06-18 09:48:39 +0900 (Thu, 18 Jun 2009) | 1 line

Moved OpenSim/Framework/Communications/Capabilities up to OpenSim/Framework/Capabilities. Didn't change the namespace because VC# is not helping, and this would imply manually changing more than 50 files. So the namespace is still OpenSim.Framework.Communications.Capabilities, to be cleaned up later by someone with more energy.
------------------------------------------------------------------------
r9875 | melanie | 2009-06-18 08:46:13 +0900 (Thu, 18 Jun 2009) | 2 lines

Fix an uninitialized data block. Thanks, jhurliman

------------------------------------------------------------------------
r9874 | melanie | 2009-06-17 23:54:25 +0900 (Wed, 17 Jun 2009) | 3 lines

Add the missing resource files for MSSQL
Mantis #3800

------------------------------------------------------------------------
r9873 | diva | 2009-06-17 12:52:39 +0900 (Wed, 17 Jun 2009) | 1 line

Implementation of a simple authentication service + in connector in route to making HGInventory (client access) work in standalone again. This is the refactoring of what was/is there, but done in the new model. Not complete yet, but key authentication works. It should be enough to make HGInventory work again soon.
------------------------------------------------------------------------
r9872 | diva | 2009-06-16 08:29:00 +0900 (Tue, 16 Jun 2009) | 1 line

Moving these nice HG connectors to their homes.
------------------------------------------------------------------------
r9871 | diva | 2009-06-15 09:29:37 +0900 (Mon, 15 Jun 2009) | 1 line

Renamed two of the in connector modules, to make things consistent.
------------------------------------------------------------------------
r9870 | diva | 2009-06-15 09:17:17 +0900 (Mon, 15 Jun 2009) | 1 line

Removing the OpenSim.SimulatorServices project. All of those region modules are now in CoreModules/ServiceConnectorsIn, where they belong.
------------------------------------------------------------------------
r9869 | diva | 2009-06-15 08:00:23 +0900 (Mon, 15 Jun 2009) | 1 line

Factoring out "land_data" / RequestLandData that was hanging off of IGridServices, erroneously. Not sure when this is used, but now it is implemented in the new model of service connectors. Hopefully it works.
------------------------------------------------------------------------
r9868 | chi11ken | 2009-06-15 07:00:08 +0900 (Mon, 15 Jun 2009) | 1 line

Formatting cleanup.
------------------------------------------------------------------------
r9867 | melanie | 2009-06-15 06:44:34 +0900 (Mon, 15 Jun 2009) | 5 lines

Fixes Mantis #3793 . Committing thomax/Snoopy's patch to allow deeding of objects, with changes:
- Set OwnerID = GroupID for deeded objects.
- Close a security loophole that would have allowed a user with deed rights in a group to deed ANY object to that group, even if it's not owned by them and/or not set to that group
- Set LastOwnerID correctly. Handle objects vs. prims correctly.

------------------------------------------------------------------------
r9866 | chi11ken | 2009-06-15 06:37:50 +0900 (Mon, 15 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9865 | diva | 2009-06-15 04:44:56 +0900 (Mon, 15 Jun 2009) | 1 line

Renamed Region/CoreModules/ServiceConnectors to Region/CoreModules/ServiceConnectorsOut. No functional changes.
------------------------------------------------------------------------
r9864 | ckrinke | 2009-06-15 01:32:50 +0900 (Mon, 15 Jun 2009) | 8 lines

Thank you kindly, M1sha, for a patch that improves the treePopulator module:
(a) Implements the ICommandableModule interface to clean up the user interface
(b) Uses a specification for a 'copse' (collected group of trees) which permits via an xml file: Tree type; Tree Line (high and low), Seed point; Radius of Copse; Number of required trees; Initial size of seeded tree; maximum size of seeded tree; growth rate; freeze growth state
(c) Multiple Copse may be defined for a region
(d) Growth on individual copse may be frozen or restarted, or all growth disabled/enabled
(e) Copse definitions are persistant, they are reloaded from the trees present on a region restart
(f) All trees in a copse may be removed and the copse definition deleted in one command

------------------------------------------------------------------------
r9863 | diva | 2009-06-15 01:26:14 +0900 (Mon, 15 Jun 2009) | 1 line

Bug fix in remote neighbour connector.
------------------------------------------------------------------------
r9862 | diva | 2009-06-15 00:45:28 +0900 (Mon, 15 Jun 2009) | 1 line

And this one too...
------------------------------------------------------------------------
r9861 | diva | 2009-06-15 00:37:50 +0900 (Mon, 15 Jun 2009) | 1 line

Oops. Forgot to add this file.
------------------------------------------------------------------------
r9860 | diva | 2009-06-15 00:35:09 +0900 (Mon, 15 Jun 2009) | 1 line

Pulled out HelloNeighbour into its own service, INeighbourService, which may get more functions as we go along. It's a very simple service and service connectors, and it served primarily to establish the design of services that dependent on Scenes and that must always have a local connector. More refactoring coming, as this showed how to do it right.
------------------------------------------------------------------------
r9859 | justincc | 2009-06-13 05:00:26 +0900 (Sat, 13 Jun 2009) | 2 lines

* Temporarily resolve another problem in http://opensimulator.org/mantis/view.php?id=3741 by disabling the loading of OAR creation information

------------------------------------------------------------------------
r9858 | justincc | 2009-06-13 00:45:38 +0900 (Sat, 13 Jun 2009) | 2 lines

* minor: removing some logging stuff accidentally left in on the last commit

------------------------------------------------------------------------
r9857 | justincc | 2009-06-13 00:41:53 +0900 (Sat, 13 Jun 2009) | 4 lines

* Move standalone login setup in LLStandaloneLoginmodule to RegionLoaded() from AddRegion()
* This is necessary to avoid a dependency problem where LLStandaloneLoginModule references IInventoryService before the LocalInventoryServiceConnector is registered
* Correct some copypasta log messages in LocalInventoryServiceConnector

------------------------------------------------------------------------
r9856 | mikem | 2009-06-13 00:00:08 +0900 (Sat, 13 Jun 2009) | 5 lines

Give m_test* methods more reasonable names

Changing the names of these methods because they were being picked up by
nunit as tests even though they were marked private. Naming them Check*
after the original Test*.
------------------------------------------------------------------------
r9855 | justincc | 2009-06-12 23:37:56 +0900 (Fri, 12 Jun 2009) | 2 lines

* remove long unused interregion optional module code

------------------------------------------------------------------------
r9854 | justincc | 2009-06-12 23:29:42 +0900 (Fri, 12 Jun 2009) | 2 lines

* minor: remove one mono warning

------------------------------------------------------------------------
r9853 | justincc | 2009-06-12 23:23:31 +0900 (Fri, 12 Jun 2009) | 2 lines

* fix build break: sigh, must remember to build before committing

------------------------------------------------------------------------
r9852 | justincc | 2009-06-12 23:18:01 +0900 (Fri, 12 Jun 2009) | 2 lines

* minor: make control file loading code consistent

------------------------------------------------------------------------
r9851 | justincc | 2009-06-12 23:00:50 +0900 (Fri, 12 Jun 2009) | 2 lines

* minor: if OAR saving receives assets after timeout, just print warning, don't accidentally go on to process them

------------------------------------------------------------------------
r9850 | justincc | 2009-06-12 22:37:08 +0900 (Fri, 12 Jun 2009) | 2 lines

* minor: remove warning from unused field

------------------------------------------------------------------------
r9849 | arthursv | 2009-06-12 05:50:23 +0900 (Fri, 12 Jun 2009) | 1 line

* Fixed a few more async calls. Still not uncommented, some asserts still failing
------------------------------------------------------------------------
r9848 | diva | 2009-06-12 05:27:13 +0900 (Fri, 12 Jun 2009) | 1 line

Fixes mantis #3803. Thanks jhurliman.
------------------------------------------------------------------------
r9847 | diva | 2009-06-12 04:12:20 +0900 (Fri, 12 Jun 2009) | 1 line

Small improvement in the IAR tests, but these tests are still showing random behavior, so they are still commented out.
------------------------------------------------------------------------
r9846 | arthursv | 2009-06-12 03:27:12 +0900 (Fri, 12 Jun 2009) | 1 line

* Reinstating UserProfileCacheServiceTests. One test still fails (TestUpdateFolder)
------------------------------------------------------------------------
r9845 | diva | 2009-06-11 22:46:44 +0900 (Thu, 11 Jun 2009) | 2 lines

Changed the inventory service so that is uses exactly one DB plugin, not many. The composition of plugins can be done at the service and connector levels.
This fixes the unit tests that were failing yesterday, but I'm not committing those yet, because I'm seeing 2 of those tests having pass and fail outcomes randomly which suggests that the tests are buggy.
------------------------------------------------------------------------
r9843 | diva | 2009-06-11 12:00:25 +0900 (Thu, 11 Jun 2009) | 1 line

InterServiceInventoryService references *almost* completely removed from the simulator. Only a couple left, not important. Also updated the login tests -- Justin, this time I was able to fix this by myself :)
------------------------------------------------------------------------
r9842 | diva | 2009-06-11 10:50:52 +0900 (Thu, 11 Jun 2009) | 1 line

Removed a change in StandaloneHypergrid.ini introduced in r9838, which was incorrect.
------------------------------------------------------------------------
r9841 | diva | 2009-06-11 05:31:02 +0900 (Thu, 11 Jun 2009) | 1 line

Bug fix for creating users in standalone: the newly-created root folder was not being set in the cached profile. I suspect this bug has been around for a while.
------------------------------------------------------------------------
r9840 | diva | 2009-06-11 03:43:03 +0900 (Thu, 11 Jun 2009) | 1 line

Fixed problem in configuration for GridHypergrid.ini.
------------------------------------------------------------------------
r9839 | diva | 2009-06-11 03:02:49 +0900 (Thu, 11 Jun 2009) | 1 line

Small bug fix in HG.
------------------------------------------------------------------------
r9838 | ckrinke | 2009-06-11 02:53:06 +0900 (Thu, 11 Jun 2009) | 2 lines

Thank you kindly, BlueWall, for a patch that solves:
SQLite error on creating user.
------------------------------------------------------------------------
r9837 | diva | 2009-06-11 01:48:26 +0900 (Thu, 11 Jun 2009) | 1 line

Removing the default reading of AssetCaching on all cache modules.
------------------------------------------------------------------------
r9836 | diva | 2009-06-11 01:31:22 +0900 (Thu, 11 Jun 2009) | 1 line

Added some defaults to OpenSim.ini.example so that it works out of the box again with zero configuration.
------------------------------------------------------------------------
r9835 | melanie | 2009-06-11 00:36:44 +0900 (Thu, 11 Jun 2009) | 2 lines

Reverse the default setting in Flotsam Asset Cache. Nothing should be the default

------------------------------------------------------------------------
r9834 | diva | 2009-06-11 00:25:52 +0900 (Thu, 11 Jun 2009) | 1 line

Flipping memory cache to false (default) in Flotsam cache, because of a bug in libomv.
------------------------------------------------------------------------
r9833 | diva | 2009-06-11 00:18:07 +0900 (Thu, 11 Jun 2009) | 1 line

Commenting the IAR tests for now until we understand how to set up things in this new inventory model.
------------------------------------------------------------------------
r9832 | diva | 2009-06-10 23:15:50 +0900 (Wed, 10 Jun 2009) | 1 line

duh. wrong variable name in SceneSetup.
------------------------------------------------------------------------
r9831 | diva | 2009-06-10 22:49:13 +0900 (Wed, 10 Jun 2009) | 1 line

The previous commit was still wrong.
------------------------------------------------------------------------
r9830 | diva | 2009-06-10 22:46:38 +0900 (Wed, 10 Jun 2009) | 1 line

Attempt at fixing the inventory archiver tests.
------------------------------------------------------------------------
r9829 | diva | 2009-06-10 22:33:26 +0900 (Wed, 10 Jun 2009) | 1 line

Attempt at disabling the inventory unit tests, so I can figure out how to fix them. The test setup is broken.
------------------------------------------------------------------------
r9828 | diva | 2009-06-10 22:18:32 +0900 (Wed, 10 Jun 2009) | 4 lines

Heart surgery no.2: the inventory service hooks.
Several improvements in the connectors themselves.
Several improvements in configurations.
Needed to add a hack in IUserService and UserManagerBase, to be removed when that service is refactored.
------------------------------------------------------------------------
r9827 | drscofield | 2009-06-10 20:48:13 +0900 (Wed, 10 Jun 2009) | 6 lines

From: Alan Webb <alan_webb@us.ibm.com>

Eat collision errors --- NOTE: this fix might be naive, it seems to
have helped us getting to 81 avatars (whereas we'd crash with 20
before), but it sure would benefit from some check-over by a person
skilled in the art of ODE physics.
------------------------------------------------------------------------
r9826 | drscofield | 2009-06-10 20:29:09 +0900 (Wed, 10 Jun 2009) | 1 line

persists Estate.PublicAccess settings across reboots [re #552]
------------------------------------------------------------------------
r9825 | drscofield | 2009-06-10 20:05:44 +0900 (Wed, 10 Jun 2009) | 1 line

makes voice setting persistent [re #552]
------------------------------------------------------------------------
r9824 | drscofield | 2009-06-10 19:59:56 +0900 (Wed, 10 Jun 2009) | 2 lines

adding lastlogin information to admin_exists_user: will be 0 if the
user does not exist or hasn't logged in yet.
------------------------------------------------------------------------
r9823 | chi11ken | 2009-06-10 13:28:56 +0900 (Wed, 10 Jun 2009) | 1 line

Formatting cleanup.
------------------------------------------------------------------------
r9822 | diva | 2009-06-10 05:20:30 +0900 (Wed, 10 Jun 2009) | 1 line

Letting the Flotsam cache be enabled even when [AssetCache] section is missing. Thank you mcortez!
------------------------------------------------------------------------
r9821 | chi11ken | 2009-06-10 03:07:35 +0900 (Wed, 10 Jun 2009) | 1 line

Formatting cleanup. Ignore some generated files.
------------------------------------------------------------------------
r9820 | chi11ken | 2009-06-10 02:48:22 +0900 (Wed, 10 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9819 | drscofield | 2009-06-09 21:11:22 +0900 (Tue, 09 Jun 2009) | 4 lines

ARGH!!!! note to self: ALWAYS use String.IsNullOrEmpty(...)!

this patch fixes RemoteAdminPlugin gratuitously updating the user
password even if no update was intended.
------------------------------------------------------------------------
r9818 | melanie | 2009-06-09 17:17:06 +0900 (Tue, 09 Jun 2009) | 2 lines

Added Snoopy to CONTRIBUTIRS.txt

------------------------------------------------------------------------
r9817 | melanie | 2009-06-09 17:15:34 +0900 (Tue, 09 Jun 2009) | 5 lines

Thank you Snoopy, for a patch that implements group permissions.
Applied with changes:
- removed spammy debug message
- corrected tab formatting

------------------------------------------------------------------------
r9816 | drscofield | 2009-06-09 15:39:27 +0900 (Tue, 09 Jun 2009) | 32 lines

From: Alan Webb <alan_webb@us.ibm.com>

This change addresses two issues:

[1] It adds a flag field to the blendface call which allows the
caller to indicate whether or not the generated asset is
temporary, and whether or not the asset being replaced should
be explicitly retired fromt the memory cache. The decimal
values correspond to:
0 - Permanent asset, do not expire old asset
1 - Permanent asset, expire old asset
2 - Temporary asset, do not expire old asset
3 - Temporary asset, expire old asset
'3' corresponds to the default behavior seen today, and is
the continued behavior of the non-blendface calls.
[2] The dynamic texture routines are highly-asynchronous and can
be scheduled simultaneously on a multi-core machine. The nature
of the texture management interfaece is such that updates may
be lost, and the nature of asynchornous operation means that
they may be processed out of order. A lock has been added to
ensure that updates are at least atomic. No attempt has been
made to enforce ordering. The lock applies to the SceneObjectPart
being updated and is held for the lifetime of the TextureEntry
used to carry texture updates (the one instance carries all
faces supported by the prim).

Users of these services should remember that the dynamic texture
call is asynchronous and control will be returned *before* the
texture update has actually occurred. As a result, a isubsequent
GetTexture call may not return the expected asset id. A script
must wait for the corresponding TEXTURE_CHANGED event before
retrieving any texture information.
------------------------------------------------------------------------
r9815 | melanie | 2009-06-09 05:09:49 +0900 (Tue, 09 Jun 2009) | 3 lines

Updating the flotsam asset cache. Thank you, mcortez!
Fixes Mantis #3784

------------------------------------------------------------------------
r9814 | diva | 2009-06-09 04:35:36 +0900 (Tue, 09 Jun 2009) | 1 line

Bug fix. Adding the asset to the cache after a DB get.
------------------------------------------------------------------------
r9813 | diva | 2009-06-09 02:50:17 +0900 (Tue, 09 Jun 2009) | 1 line

That didn't quite work. Trying this instead -- prompt given in the cmd line.
------------------------------------------------------------------------
r9812 | diva | 2009-06-09 02:34:42 +0900 (Tue, 09 Jun 2009) | 1 line

Making the prompt configurable in the server shell. Default is "Server".
------------------------------------------------------------------------
r9811 | diva | 2009-06-09 02:22:23 +0900 (Tue, 09 Jun 2009) | 1 line

IInentoryDataPlugins were missing.
------------------------------------------------------------------------
r9810 | diva | 2009-06-08 12:16:55 +0900 (Mon, 08 Jun 2009) | 1 line

First draft of the inventory service IN connector. Probably won't work yet. But everything of inventory service is now checked in, first draft.
------------------------------------------------------------------------
r9809 | diva | 2009-06-08 12:09:24 +0900 (Mon, 08 Jun 2009) | 1 line

Added more functions to IInventoryService. Unsure about whether all of these are really necessary.
------------------------------------------------------------------------
r9808 | diva | 2009-06-08 04:00:55 +0900 (Mon, 08 Jun 2009) | 2 lines

First draft of inventory service connectors, and service implementation. No handlers yet, this is just the OUT part for now. It's not active and nothing in the simulator uses this yet. Just checking it in to start sharing with others. There are a couple of interesting software design points that could use other devs opinions.
Hopefully I added all needed files.
------------------------------------------------------------------------
r9807 | mikem | 2009-06-07 19:22:55 +0900 (Sun, 07 Jun 2009) | 15 lines

Skip lone ident statments or for-loop assignments

SL's LSL supports lone idents:

integer x;
x;

as well as lone idents in for-loop assignments:

for (x; x < 10; x++) { ... }

while those are errors in C# (MONO at least). This patch skips lone
idents in such places.

Fixes Mantis #3042.
------------------------------------------------------------------------
r9806 | mikem | 2009-06-07 19:22:41 +0900 (Sun, 07 Jun 2009) | 10 lines

Allow empty assignment in for-loop

For loops with no assignment are no longer syntax errors. For example,
this is now valid:

for ( ; i < 10; i++) { ... }

Corresponding changes to lsl.{lexer,parser} in r99 in opensim-libs.

Fixes Mantis #2501. Fixes Mantis #2884.
------------------------------------------------------------------------
r9805 | lbsa71 | 2009-06-07 17:51:10 +0900 (Sun, 07 Jun 2009) | 2 lines

* Reverting the test restructuring as, on second thought, this is not at all how the tests are structured.
(pt2)
------------------------------------------------------------------------
r9804 | lbsa71 | 2009-06-07 17:50:43 +0900 (Sun, 07 Jun 2009) | 2 lines

* Reverting the test restructuring as, on second thought, this is not at all how the tests are structured.
(pt1)
------------------------------------------------------------------------
r9803 | mikem | 2009-06-07 17:32:07 +0900 (Sun, 07 Jun 2009) | 6 lines

Rename private TestllAngleBetween method

It seems overloading the method TestllAngleBetween confused nunit a bit
and caused it to try running the private TestllAngleBetween method. The
method's access modified prevented that from happening, and nunit
complained.
------------------------------------------------------------------------
r9801 | diva | 2009-06-07 02:06:47 +0900 (Sun, 07 Jun 2009) | 1 line

Added Flotsam's cache config vars to configuration. Made it the default in grided sims. Made Cenome cache the default in standalone sims. More splitting in ini files, invisible to the user.
------------------------------------------------------------------------
r9799 | melanie | 2009-06-07 01:39:28 +0900 (Sun, 07 Jun 2009) | 4 lines

Correct an error where the config file name was always considered to be a
local file. This caused llHttpRequest and llSetInventoryPermsMask to fail
on regions that load their config from a web server

------------------------------------------------------------------------
r9798 | dahlia | 2009-06-06 17:41:27 +0900 (Sat, 06 Jun 2009) | 3 lines

some code cleanup
test commit with cygwin svn

------------------------------------------------------------------------
r9797 | justincc | 2009-06-06 04:53:24 +0900 (Sat, 06 Jun 2009) | 2 lines

* minor: tiny tweak just to trigger another panda build

------------------------------------------------------------------------
r9796 | justincc | 2009-06-06 04:34:35 +0900 (Sat, 06 Jun 2009) | 3 lines

* A bug fix for the last mantis 3741 bugfix
* Hopefully now, the nre should not occur and the lock should be correctly unlocked during the initial save oar process

------------------------------------------------------------------------
r9795 | justincc | 2009-06-06 04:20:31 +0900 (Sat, 06 Jun 2009) | 6 lines

* A further fix for mantis 3641 (oar saves do not complete)

* For some reason, if a null was recieved (indicating a missing asset), the code had stopped passing that on to the waiting lock, resulting in a perpetual freeze
* This change passes the null on correctly
* Many thanks to thomax for being insistent in presenting his analysis of the problem :)

------------------------------------------------------------------------
r9794 | justincc | 2009-06-06 03:44:44 +0900 (Sat, 06 Jun 2009) | 2 lines

* refactor: split out part xml writing in SceneObjectSerializer

------------------------------------------------------------------------
r9793 | justincc | 2009-06-06 02:03:44 +0900 (Sat, 06 Jun 2009) | 4 lines

* Fix unit tests so that they correctly handle 404 missing asset response

* I didn't think there were tests in this area - my bad

------------------------------------------------------------------------
r9792 | justincc | 2009-06-06 01:14:22 +0900 (Sat, 06 Jun 2009) | 7 lines

* Fix problem where known missing assets would stop save oar ever completing

* Issue was that region server was silently dropping an XmlException caused by trying to deserialize the blank asset service response
* So make asset service return http status NOT FOUND rather than OK in accordance with REST
* and interpret this correctly in the async response so that a null object is sent back
* This means that this fix won't be active until both region simulator and server reach this revision

------------------------------------------------------------------------
r9791 | justincc | 2009-06-05 22:48:43 +0900 (Fri, 05 Jun 2009) | 7 lines

* Add oar saving timeout

* If an oar save fails to get responses to all asset requests to the asset service then timeout after 60 seconds
* Timeout executes abort, since missing assets in an OAR seems bad
* This means that oar saves won't permanently hang and instead can be retried if something goes wrong with the asset service
* This is not a solution to mantis 3714. Hopefully a fix will be along shortly since I can now consistently reproduce that problem

------------------------------------------------------------------------
r9790 | melanie | 2009-06-05 18:47:42 +0900 (Fri, 05 Jun 2009) | 4 lines

Thank you, thomax, for a patch to provide finer-grained access control to
scripting.
Fixes Mantis #2862

------------------------------------------------------------------------
r9789 | lbsa71 | 2009-06-05 15:23:09 +0900 (Fri, 05 Jun 2009) | 1 line

* convenience ignores
------------------------------------------------------------------------
r9788 | lbsa71 | 2009-06-05 15:22:42 +0900 (Fri, 05 Jun 2009) | 1 line

* Restructured Scenes Tests to follow (what I conceive of as being) current directory standards. (pt 2 - thank you, svn. not.)
------------------------------------------------------------------------
r9787 | lbsa71 | 2009-06-05 15:22:08 +0900 (Fri, 05 Jun 2009) | 1 line

* Restructured Scenes Tests to follow (what I conceive of as being) current directory standards. (pt 1 - thank you, svn. not.)
------------------------------------------------------------------------
r9786 | melanie | 2009-06-05 13:58:55 +0900 (Fri, 05 Jun 2009) | 3 lines

Committing mcortez's FlotsamAssetCache after several positive reviews.
Thank you, mcortez!

------------------------------------------------------------------------
r9785 | diva | 2009-06-05 03:41:19 +0900 (Fri, 05 Jun 2009) | 1 line

Changed a comment to reflect changes in config.
------------------------------------------------------------------------
r9784 | diva | 2009-06-05 03:36:02 +0900 (Fri, 05 Jun 2009) | 1 line

Fixed placement of optional configs for CenomeAssetCache. Thank you ImazeR.
------------------------------------------------------------------------
r9783 | chi11ken | 2009-06-04 12:58:04 +0900 (Thu, 04 Jun 2009) | 1 line

Comment out unused variables / private fields to avoid compiler warnings.
------------------------------------------------------------------------
r9782 | chi11ken | 2009-06-04 10:37:31 +0900 (Thu, 04 Jun 2009) | 1 line

Comment out unused private functions to avoid compiler warnings.
------------------------------------------------------------------------
r9781 | chi11ken | 2009-06-04 10:26:31 +0900 (Thu, 04 Jun 2009) | 1 line

Fix comparison of UUID with null.
------------------------------------------------------------------------
r9780 | chi11ken | 2009-06-04 10:10:49 +0900 (Thu, 04 Jun 2009) | 1 line

Ignore some generated files.
------------------------------------------------------------------------
r9779 | chi11ken | 2009-06-04 10:09:18 +0900 (Thu, 04 Jun 2009) | 1 line

Add copyright headers.
------------------------------------------------------------------------
r9778 | chi11ken | 2009-06-04 09:51:02 +0900 (Thu, 04 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9777 | melanie | 2009-06-04 05:14:41 +0900 (Thu, 04 Jun 2009) | 2 lines

Committing the skeleton of the authentication service

------------------------------------------------------------------------
r9776 | melanie | 2009-06-04 04:54:19 +0900 (Thu, 04 Jun 2009) | 2 lines

Make AssetMetadata [Serializable] to help in binary caching

------------------------------------------------------------------------
r9775 | melanie | 2009-06-04 04:49:26 +0900 (Thu, 04 Jun 2009) | 3 lines

Committing the partial refactor of authentication services. No user functionlity
will eat your babies, etc

------------------------------------------------------------------------
r9774 | lbsa71 | 2009-06-04 02:29:21 +0900 (Thu, 04 Jun 2009) | 1 line

* Making sure we fail a bit earlier if we have no AssetService
------------------------------------------------------------------------
r9773 | drscofield | 2009-06-03 21:48:04 +0900 (Wed, 03 Jun 2009) | 29 lines

From: Chris Yeoh <yeohc@au1.ibm.com>

This patch adds oar file date and time (UTC) meta data to an oar file
when it is created. It also adds a unique ID, though this id does not
in anyway identify the machine that the oar file was created on.

When an oar file with this meta data is loaded this extra information
is saved with the region settings and available via LSL through:

- osLoadedCreationDate()
- osLoadedCreationTime()
- osLoadedCreationID()

If there is no meta data these fields will be blank. Subsequent oar
file loads will erase the information for the previous oar file
load. Persistence has only been implemented for MySQL, the other
backends need updating.

Overall this allows us to much more easily identify the specific version of
software that clients are using. Its very straightforward to edit the oar file
to change the ID string to be something more human friendly.

Included in the patch is a new file OpenSim/Data/MySQL/Resources/030_RegionStore.sql
required for the MySQL DB migration.

btw I had a chat with justincc about this a few weeks ago since he
wrote the oar file import/export and he sounded happy to accept
something that included date/time information but didn't want anything
that would silently leak private information like machine names.
------------------------------------------------------------------------
r9772 | drscofield | 2009-06-03 21:39:44 +0900 (Wed, 03 Jun 2009) | 34 lines

From: Chris Yeoh <yeohc@au1.ibm.com>

- fixes wild swings in memory usage related to usage of GetDrawStringSize()

We've been seeing wild swings in memory usage and a large chunk of
memory leak. From analysing this it's pretty clear that the mono
garbage collector is rather buggy! When exercised heavily it looks
like it frees more than its meant to resulting in crashes.

GetDrawStringSize() measures the size in pixels of text. To do this
memory for an image is allocated and used to call the GDI text
measure functions. Although no reference to the temporary memory
for the measuring is kept, it takes quite a while for the mono
garbage collector to clean up - so if lots calls to
GetDrawStringSize() are made at once there can be a spike in memory
usage. If the garbage collector is not fast enough then the GDI
layer runs out of memory. It also looks like the garbage collector
is not always reclaiming all of the memory.

I've attached an OpenSimulator patch which works around the garbage collector
issues. Instead of dynamically allocating memory for measuring
text sizes, it serialises (on a per region basis) access to a single
block of memory. The effect of this is to be nicer to the garbage
collector as it has a lot less work to do, at the cost of some
theoretical loss in performance (nothing noticeable with our tests
which hit it pretty hard).

OpenSimulator still does leak memory slowly, but it is a lot more stable
with this patch. I suspect that either the garbage collector misses
bits of freed memory or the GDI/cairo layer leaks a bit each time a
texture is created. Thats going to be a lot harder to hunt down, but
for reference if someone has OpenSimulator running on Windows it would be
interesting to see if it has the same problem as it would tell us if
its a mono/GDI problem or an OpenSimulator problem.
------------------------------------------------------------------------
r9771 | drscofield | 2009-06-03 21:21:14 +0900 (Wed, 03 Jun 2009) | 9 lines

From: Alan Webb <alan_webb@us.ibm.com>

Modify dynamic texture handling so that an explicitly targetted
face is not scheduled for immediate expiration. The requirement
for precaching explicitly requires these assets to persist. They
do however remain temporary.

This approach leaves the legacy mode of operation (ALL_SIDES)
unchanged in this respect.
------------------------------------------------------------------------
r9770 | dahlia | 2009-06-03 17:41:08 +0900 (Wed, 03 Jun 2009) | 3 lines

Thank you Imaze Rhiano for a patch that implements Cenome Memory Asset Cache (Mantis #3759)
See the files: bin/config-include/GridCommon.ini.example and bin/config-include/StandaloneCommon.ini.example to configure and enable this caching method.

------------------------------------------------------------------------
r9769 | dahlia | 2009-06-03 14:31:53 +0900 (Wed, 03 Jun 2009) | 1 line

Thanks aduffy70 for Mantis #3762: A patch to fix llGround, llGroundNormal, and llGroundSlope
------------------------------------------------------------------------
r9768 | dahlia | 2009-06-03 11:03:11 +0900 (Wed, 03 Jun 2009) | 1 line

revert r9765 due to too many errors on some compilers. Affects Mantis #3759
------------------------------------------------------------------------
r9767 | dahlia | 2009-06-03 10:27:07 +0900 (Wed, 03 Jun 2009) | 1 line

add body to an empty getter/setter
------------------------------------------------------------------------
r9766 | dahlia | 2009-06-03 10:06:00 +0900 (Wed, 03 Jun 2009) | 1 line

fix a int[] declaration
------------------------------------------------------------------------
r9765 | dahlia | 2009-06-03 07:42:47 +0900 (Wed, 03 Jun 2009) | 2 lines

Thank you Imaze Rhiano for a patch that implements Cenome Memory Asset Cache (Mantis #3759)
See the files: bin/config-include/GridCommon.ini.example and bin/config-include/StandaloneCommon.ini.example to configure and enable this caching method.
------------------------------------------------------------------------
r9764 | ckrinke | 2009-06-03 06:13:29 +0900 (Wed, 03 Jun 2009) | 7 lines

Thank you kindly, MattSetzer, for a patch that solves a Mantis:
This appears to be due to the fact that no asset cache has been
configured, possibly as a result of the configuration changes that
have been made recently. I've attached a patch to display a message
to that effect rather than throwing an error.

------------------------------------------------------------------------
r9763 | ckrinke | 2009-06-03 05:56:27 +0900 (Wed, 03 Jun 2009) | 5 lines

Thank you kindly, jonc, for a patch that:
Grid mode only. Serialization and deserialization of
byte representing Access Level is failing unless byte
is ToString'd first on Grid Server.

------------------------------------------------------------------------
r9762 | lbsa71 | 2009-06-03 03:12:34 +0900 (Wed, 03 Jun 2009) | 1 line

* Pried apart the ODE tests. This fixes mantis #3212
------------------------------------------------------------------------
r9761 | justincc | 2009-06-03 00:24:29 +0900 (Wed, 03 Jun 2009) | 2 lines

* Add simple original xml serialization test

------------------------------------------------------------------------
r9760 | melanie | 2009-06-02 17:19:32 +0900 (Tue, 02 Jun 2009) | 3 lines

Explicitly set the changed status of the prim groups affected in a delink
Mantis #2484

------------------------------------------------------------------------
r9759 | arthursv | 2009-06-02 05:51:40 +0900 (Tue, 02 Jun 2009) | 4 lines

* Allow for lowercase searching in standalone mode, when case sensitive
search fails. This allows compability to libOMV bots, that always lowercase
region names.
* Uncertain if this should/could propagate to grids
------------------------------------------------------------------------
r9758 | lbsa71 | 2009-06-02 05:17:10 +0900 (Tue, 02 Jun 2009) | 1 line

* Removed some commented-out code
------------------------------------------------------------------------
r9757 | chi11ken | 2009-06-02 03:45:36 +0900 (Tue, 02 Jun 2009) | 1 line

Only save crashes to disk if save_crashes in OpenSim.ini is true (false by default).
------------------------------------------------------------------------
r9756 | arthursv | 2009-06-02 03:34:40 +0900 (Tue, 02 Jun 2009) | 2 lines

* Making silent logoff of old hung sessions for new connections default for
StandAlone users. Not touching grid.
------------------------------------------------------------------------
r9755 | justincc | 2009-06-02 03:03:51 +0900 (Tue, 02 Jun 2009) | 2 lines

* Add simple original sog xml serialization test

------------------------------------------------------------------------
r9754 | justincc | 2009-06-02 02:38:11 +0900 (Tue, 02 Jun 2009) | 2 lines

* minor: change the name of one serialization method to match its counterpart

------------------------------------------------------------------------
r9753 | justincc | 2009-06-02 01:00:46 +0900 (Tue, 02 Jun 2009) | 2 lines

* Fix race condition in save oar

------------------------------------------------------------------------
r9752 | mw | 2009-06-01 20:41:03 +0900 (Mon, 01 Jun 2009) | 1 line

Fixed AvatarCreationModule (I think)
------------------------------------------------------------------------
r9751 | mw | 2009-06-01 20:36:58 +0900 (Mon, 01 Jun 2009) | 1 line

trying to get panda to be able to read the AvatarCreationModule
------------------------------------------------------------------------
r9750 | mw | 2009-06-01 20:34:10 +0900 (Mon, 01 Jun 2009) | 1 line

part 1 of trying to get panda to be able to read the AvatarCreationModule
------------------------------------------------------------------------
r9749 | mw | 2009-06-01 20:16:07 +0900 (Mon, 01 Jun 2009) | 1 line

Some changes to the AvatarCreationModule to reduce the number of database reads/writes. Still requires more work in this area.
------------------------------------------------------------------------
r9748 | chi11ken | 2009-06-01 15:37:14 +0900 (Mon, 01 Jun 2009) | 1 line

Minor: Change OpenSim to OpenSimulator in older copyright headers and LICENSE.txt.
------------------------------------------------------------------------
r9747 | joha1 | 2009-06-01 10:24:18 +0900 (Mon, 01 Jun 2009) | 1 line

Added cscope tag support in Makefile
------------------------------------------------------------------------
r9746 | dahlia | 2009-06-01 08:57:52 +0900 (Mon, 01 Jun 2009) | 1 line

reduce verbosity of sculpt map cache messages to reporting cache failures only
------------------------------------------------------------------------
r9745 | ckrinke | 2009-06-01 05:53:59 +0900 (Mon, 01 Jun 2009) | 9 lines

Thank you kindly, StrawberryFride for a patch that:
Added in some key code to read properties from MSSQL for user profiles
which fixes issues of users having trouble editing estate settings on a
grid where estate managers are not god, and fixes the option of enabling
grid god functionality on MSSQL grids.

I have applied this to trunk only. I need someone else to examine and apply
to 0.6.5-Post-Fixes, or give me some direction, please.

------------------------------------------------------------------------
r9744 | chi11ken | 2009-06-01 03:35:00 +0900 (Mon, 01 Jun 2009) | 1 line

Add copyright headers, formatting cleanup, ignore some generated files.
------------------------------------------------------------------------
r9743 | chi11ken | 2009-06-01 01:26:18 +0900 (Mon, 01 Jun 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9742 | afrisby | 2009-05-31 21:53:05 +0900 (Sun, 31 May 2009) | 1 line

* Adds MRM scripting commands, World.Objects.Create(Vector3 position) and World.Objects.Create(Vector3 position, Quaternion rotation). These rez a 'default box' object at the specified coordinates, and return the associated IObject.
------------------------------------------------------------------------
r9741 | mikem | 2009-05-31 20:50:42 +0900 (Sun, 31 May 2009) | 7 lines

Fix IRCd init check for config section

The IRCStackModule used Nini.Config.ConfigCollection.Contains() to
determine whether the "IRCd" section was present in the config. This
ConfigCollection, however, stores an ArrayList of IConfig objects, not
strings, so calling Contains("IRCd") always returns false since "IRCd"
is a string, not an IConfig object.
------------------------------------------------------------------------
r9740 | diva | 2009-05-31 01:30:53 +0900 (Sun, 31 May 2009) | 3 lines

Slashing trailing slashes.
https://lists.berlios.de/pipermail/opensim-dev/2009-May/006673.html

------------------------------------------------------------------------
r9739 | diva | 2009-05-31 01:22:15 +0900 (Sun, 31 May 2009) | 1 line

Forgot to add this to my last commit 2 days ago. Async in the HGBroker too.
------------------------------------------------------------------------
r9738 | mw | 2009-05-31 01:13:40 +0900 (Sun, 31 May 2009) | 2 lines

Added option (on my default) to the clone avatar function so that the clothes and attachments that the target avatar is wearing, to begin with, are removed. So the end result isn't a merger of those clothes/attachments and the ones the template avatar is wearing.
Added IPAddress ListenIPAddress property to BaseHttpServer so that the listening/binding IP can be set.
------------------------------------------------------------------------
r9737 | mw | 2009-05-31 00:20:39 +0900 (Sun, 31 May 2009) | 1 line

Made it so ( by default) the Clone avatar function, propagates the permissions on the cloned items. This needs further testing to make sure all permissions are set correctly.
------------------------------------------------------------------------
r9736 | mw | 2009-05-30 22:39:07 +0900 (Sat, 30 May 2009) | 1 line

a few small changes to AvatarCreationModule
------------------------------------------------------------------------
r9735 | mw | 2009-05-30 21:51:28 +0900 (Sat, 30 May 2009) | 6 lines

Added a AvatarCreationModule to the user server. This handles the "cloning" of a existing avatar's inventory to another avatar's inventory (the base method will also create the inventory for a new avatar if the avatar doesn't alreayd have any inventory).
The code also sets the target avatar as wearing whatever the template avatar was wearing (including attachments). The idea is to allow the use of this to give new avatars a more interesting avatar (and inventory set) than the current default.
I have include a console command that will clone the inventory from one existing user (template avatar) to another existing avatar (target avatar). The format of the command is : "clone avatar <templateAvatarFirstName> <templateAvatarLastName> <targetAvatarFirstName> <targetAvatarLastName>" (to use this console command on new accounts, the "create user" command will need to be used first)
While the code was designed for hooking up to a remote call from a web interface, I have left the hookup code out of this commit, as I believe most use cases will want to handle it differently.
Also added a "trusted handler" to the inventory server to allow the user server to create new folders in a user's inventory.
All this is in the old UGAIM servers so will need porting to the new servers.
------------------------------------------------------------------------
r9734 | afrisby | 2009-05-30 18:37:11 +0900 (Sat, 30 May 2009) | 1 line

* Tweaks to /WHO listings.
------------------------------------------------------------------------
r9733 | afrisby | 2009-05-30 16:02:38 +0900 (Sat, 30 May 2009) | 2 lines

* You are likely to be eaten by a grue.
* Enable with [IRCd] Enabled=true (will listen on port 6666).
------------------------------------------------------------------------
r9732 | afrisby | 2009-05-30 13:07:58 +0900 (Sat, 30 May 2009) | 1 line

* More Tweaks
------------------------------------------------------------------------
r9731 | afrisby | 2009-05-30 12:53:04 +0900 (Sat, 30 May 2009) | 1 line

* More IRCClientView fiddling. Now implements IClientAPI & IClientCore.
------------------------------------------------------------------------
r9730 | afrisby | 2009-05-30 12:18:09 +0900 (Sat, 30 May 2009) | 1 line

* May partially implement a C# IRCd & IRCClientStack.
------------------------------------------------------------------------
r9729 | afrisby | 2009-05-30 08:49:48 +0900 (Sat, 30 May 2009) | 2 lines

* Adds World.Audio.* to MRM
* This includes methods such as PlaySound which take a Position as an argument, allowing you to trigger sounds arbitrarily across the scene without needing a parent object in the position.
------------------------------------------------------------------------
r9728 | afrisby | 2009-05-30 07:48:34 +0900 (Sat, 30 May 2009) | 1 line

* Protip: When you click 'make public' in resharper, note to save before committing.
------------------------------------------------------------------------
r9727 | afrisby | 2009-05-30 07:44:49 +0900 (Sat, 30 May 2009) | 3 lines

* Implements Sound on Objects for IObject in MRM
* Method: IObject.Sound.Play(UUID sound, double volume)
* More feature-packed API to come soon. (I want a World.Sound with arbitrary positioning)
------------------------------------------------------------------------
r9726 | arthursv | 2009-05-30 07:38:18 +0900 (Sat, 30 May 2009) | 3 lines

* Allows standalone region users to skip the "You must wait 5 minutes to log again" message and
allow the region to kick the old user and log the new one without reporting any failure.
Default is still to show message and fail login
------------------------------------------------------------------------
r9725 | arthursv | 2009-05-30 06:12:55 +0900 (Sat, 30 May 2009) | 2 lines

* Bug fix: Fixes an exception when Scene.RemoveClient is called to remove on a
non-existing ScenePresence avatar. Also removed trailing white spaces.
------------------------------------------------------------------------
r9724 | justincc | 2009-05-30 06:10:17 +0900 (Sat, 30 May 2009) | 2 lines

* refactor: little tweaks to trigger another build

------------------------------------------------------------------------
r9723 | justincc | 2009-05-30 06:01:18 +0900 (Sat, 30 May 2009) | 2 lines

* refactor: Remove redundent prim id attribute on Scene.AddSceneObject()

------------------------------------------------------------------------
r9722 | justincc | 2009-05-30 05:20:47 +0900 (Sat, 30 May 2009) | 2 lines

* Add save xml2 serialization test

------------------------------------------------------------------------
r9721 | justincc | 2009-05-30 01:27:43 +0900 (Sat, 30 May 2009) | 2 lines

* minor: move common serialization test code into fixture setup

------------------------------------------------------------------------
r9720 | justincc | 2009-05-30 01:11:33 +0900 (Sat, 30 May 2009) | 2 lines

* Add xml2 load test

------------------------------------------------------------------------
r9719 | dahlia | 2009-05-29 17:57:10 +0900 (Fri, 29 May 2009) | 2 lines

some clean up of sculpt map caching code
remove a redundant debug message
------------------------------------------------------------------------
r9718 | dahlia | 2009-05-29 15:50:15 +0900 (Fri, 29 May 2009) | 1 line

reinstate a hopefully more robust experimental decoded sculpt map caching scheme
------------------------------------------------------------------------
r9717 | dahlia | 2009-05-29 14:42:06 +0900 (Fri, 29 May 2009) | 1 line

plumbing for future sculpt map caching
------------------------------------------------------------------------
r9716 | dahlia | 2009-05-29 14:11:50 +0900 (Fri, 29 May 2009) | 1 line

disable sculpt map caching until a better method of avoiding asset requests can be found
------------------------------------------------------------------------
r9715 | dahlia | 2009-05-29 13:29:55 +0900 (Fri, 29 May 2009) | 2 lines

null test for texture assets when using cached sculpt map
addresses mantis #3735
------------------------------------------------------------------------
r9712 | dahlia | 2009-05-29 11:46:35 +0900 (Fri, 29 May 2009) | 1 line

Experimental decoded sculpt map caching
------------------------------------------------------------------------
r9711 | diva | 2009-05-29 10:26:53 +0900 (Fri, 29 May 2009) | 2 lines

Making the delegate handlers async in async Get, to make things consistent. Them being synchronous in certain cases (asset in cache, for example) may account for slowness reported by folks in osgrid when they have the cache module on. Turns out that some of the provided handlers do non-trivial processing (the ones coming from J2KImage, for example), which means that the several asset requests that hit the cache end up being synchronous. The jury is still out on this.

------------------------------------------------------------------------
r9710 | diva | 2009-05-29 06:04:10 +0900 (Fri, 29 May 2009) | 1 line

Instrumenting GlynnTuckerCache to find out the hit rate.
------------------------------------------------------------------------
r9709 | afrisby | 2009-05-29 04:20:49 +0900 (Fri, 29 May 2009) | 1 line

* Tweak to above
------------------------------------------------------------------------
r9708 | afrisby | 2009-05-29 04:19:10 +0900 (Fri, 29 May 2009) | 1 line

* Makes grid announcements more prominent.
------------------------------------------------------------------------
r9707 | afrisby | 2009-05-29 04:03:27 +0900 (Fri, 29 May 2009) | 1 line

* Oops. Forgot Initialise needs tweaking between IRegionModule and ISharedRegionModule.
------------------------------------------------------------------------
r9706 | afrisby | 2009-05-29 03:59:18 +0900 (Fri, 29 May 2009) | 1 line

* Converts recently added OGSRadmin to IRegionModule because I cant be arsed figuring out Mono.Addins.
------------------------------------------------------------------------
r9705 | afrisby | 2009-05-29 03:27:08 +0900 (Fri, 29 May 2009) | 1 line

* Adds OGS RAdmin class. Adds primitive remote admin functions for gridservers to perform on region servers. Used for grid-wide announcements, etc.
------------------------------------------------------------------------
r9704 | afrisby | 2009-05-29 00:27:15 +0900 (Fri, 29 May 2009) | 1 line

* May make the terrain flatten brush behave like Second Life(tm)'s client expects. May break everything. You decide!
------------------------------------------------------------------------
r9703 | diva | 2009-05-29 00:05:00 +0900 (Fri, 29 May 2009) | 1 line

This may bring the missing texture back.
------------------------------------------------------------------------
r9702 | lbsa71 | 2009-05-28 03:27:28 +0900 (Thu, 28 May 2009) | 2 lines

* So, giving up on my efforts to de-duplicate the asset handlers. I'll just service commit my current state, then start over and this time concentrating only on the new handlers.
* Fixed some erroneous refs in Tests.Common
------------------------------------------------------------------------
r9701 | drscofield | 2009-05-28 03:01:06 +0900 (Thu, 28 May 2009) | 10 lines

From: Chris Yeoh <cyeoh@au1.ibm.com>

The attached patch implements llPassTouches. It has been added
to the export/import XML along with the flag for AllowedInventoryDrop.

The MySQL backend has been updated as well, though I haven't
done one of those before so could do with a check. I added
the migration mysql file as well.

The other data backends need updating as well.
------------------------------------------------------------------------
r9700 | drscofield | 2009-05-28 02:34:06 +0900 (Thu, 28 May 2009) | 2 lines

making TarArchiveReader more resilient when faced with OARs created by
ancient tars.
------------------------------------------------------------------------
r9699 | diva | 2009-05-28 01:11:23 +0900 (Thu, 28 May 2009) | 2 lines

Adding the GlynnTucker cache module as the default choice in .ini's.
Minor log message change in the module itself.
------------------------------------------------------------------------
r9698 | chi11ken | 2009-05-27 23:30:33 +0900 (Wed, 27 May 2009) | 1 line

Update svn properties.
------------------------------------------------------------------------
r9697 | sdague | 2009-05-27 21:53:29 +0900 (Wed, 27 May 2009) | 5 lines

Revert "* Added IntegrationTest Attribute and tagged the ODETestClass"

This reverts commit 8f0096cc7b112fea8f69f391224911f624482747.

To get us back to compiling on fresh checkouts.
------------------------------------------------------------------------
r9696 | sdague | 2009-05-27 21:41:18 +0900 (Wed, 27 May 2009) | 3 lines

the new Tests were defined before the Tests.Common dll in prebuild,
this causes nant to choke on a fresh checkout. This should fix the build
break
------------------------------------------------------------------------
r9695 | lbsa71 | 2009-05-27 21:36:58 +0900 (Wed, 27 May 2009) | 1 line

* Added IntegrationTest Attribute and tagged the ODETestClass
------------------------------------------------------------------------
r9694 | lbsa71 | 2009-05-27 20:54:17 +0900 (Wed, 27 May 2009) | 3 lines

* Added OpenSim.Server.Handlers.Tests project
* Added AssetServerGetHandlerTests - not really wired up yet; more to come.
* Ignored some gens
------------------------------------------------------------------------
r9693 | diva | 2009-05-27 07:39:01 +0900 (Wed, 27 May 2009) | 1 line

Catching weirdnesses on resolving External EndPoint in agent transfers. Will probably need to do more aggressively.
------------------------------------------------------------------------
r9692 | diva | 2009-05-27 06:35:24 +0900 (Wed, 27 May 2009) | 1 line

Forgot to include this on the last commit.
------------------------------------------------------------------------
r9691 | diva | 2009-05-27 06:24:18 +0900 (Wed, 27 May 2009) | 1 line

Experimental alternative cache module implementation, using GlynnTucker.Cache.dll.
------------------------------------------------------------------------
r9690 | diva | 2009-05-27 01:45:30 +0900 (Wed, 27 May 2009) | 4 lines

Changed the order of things in Scene creation. This piece of code is very jibbery, widely different results with slightly different orders. This particular order produces the best results in the UC Irvine sim in osgrid. But clearly there's something messed up here.

Addresses mantis #3707, mantis #3713, mantis #3686.

------------------------------------------------------------------------
r9689 | lbsa71 | 2009-05-27 01:18:41 +0900 (Wed, 27 May 2009) | 3 lines

* We have strand flavours.
* The version string is now reported as "OpenSimulator 0.6.5 (Dev)"
* This has to be administrated manually.
------------------------------------------------------------------------
r9688 | lbsa71 | 2009-05-27 01:01:06 +0900 (Wed, 27 May 2009) | 2 lines

* Introduced GetVersionString so we can harness the whole thing.
* Introduced 'Flavour' to spice things up.
------------------------------------------------------------------------
r9687 | lbsa71 | 2009-05-27 00:46:09 +0900 (Wed, 27 May 2009) | 1 line

* slowly getting there...
------------------------------------------------------------------------
r9686 | lbsa71 | 2009-05-27 00:43:43 +0900 (Wed, 27 May 2009) | 1 line

* Changed Version to property for great justice
------------------------------------------------------------------------
r9685 | lbsa71 | 2009-05-27 00:35:55 +0900 (Wed, 27 May 2009) | 1 line

* Added test to make sure version info is 27 chars long (still don't know exactly why it has to be that, though)
------------------------------------------------------------------------
r9684 | diva | 2009-05-27 00:26:22 +0900 (Wed, 27 May 2009) | 3 lines

Catching exceptions on Store, including timeout. Store may fail, for whatever reason, but it won't crash the sim.
Addresses mantis #3707, mantis #3713, mantis #3686.

------------------------------------------------------------------------
r9683 | diva | 2009-05-26 11:47:02 +0900 (Tue, 26 May 2009) | 1 line

Commented a log message related to users not found, because it floods the log when the sims have prims from foreign users.
------------------------------------------------------------------------
r9682 | diva | 2009-05-26 11:24:38 +0900 (Tue, 26 May 2009) | 1 line

Restoring the initial CAP Url to exactly what it used to be before Adam's changes. Adam's code is still there, but commented, until we figure out what's going on.
------------------------------------------------------------------------
r9681 | melanie | 2009-05-26 10:38:32 +0900 (Tue, 26 May 2009) | 2 lines

Revert a change I made to get a better URL because it failes under mono

------------------------------------------------------------------------
r9680 | melanie | 2009-05-26 10:27:22 +0900 (Tue, 26 May 2009) | 3 lines

Couple of tweaks to the URL module: handle script reset gracefully and
stop crashing http server threads.

------------------------------------------------------------------------
r9679 | diva | 2009-05-26 10:05:40 +0900 (Tue, 26 May 2009) | 1 line

Addresses mantis #3718.
------------------------------------------------------------------------
r9678 | afrisby | 2009-05-26 09:53:49 +0900 (Tue, 26 May 2009) | 1 line

* Fiddles with some login network code to attempt to fix login bug.
------------------------------------------------------------------------
r9677 | diva | 2009-05-26 08:33:56 +0900 (Tue, 26 May 2009) | 1 line

Fixed a typo.
------------------------------------------------------------------------
r9676 | melanie | 2009-05-26 06:15:14 +0900 (Tue, 26 May 2009) | 2 lines

Correct a minor typo

------------------------------------------------------------------------
r9675 | diva | 2009-05-26 05:30:24 +0900 (Tue, 26 May 2009) | 1 line

Beginning of refactoring RESTComms/LocalComms in the new style of services and connectors. This commit has the beginning of the In connector, not the Out. Nothing of this is finished yet, and it doesn't run. But it should compile ok.
------------------------------------------------------------------------
r9674 | justincc | 2009-05-26 04:54:47 +0900 (Tue, 26 May 2009) | 6 lines

* reseparate inventory item creator id and creator uuid
* unfortunately, while the client requires uuids and we want to be able to have arbitrary string ids, these cannot be kept in sync
* I think the problems last time were due to a serialization change
* So the major inteface version has been bumped to take care of any lingering issues here.
* This means that region servers beyond this revision can only connect to similarly uptodate grid services, and vice versa

------------------------------------------------------------------------
r9673 | diva | 2009-05-26 04:20:27 +0900 (Tue, 26 May 2009) | 1 line

One more utility. Not used yet.
------------------------------------------------------------------------
r9672 | justincc | 2009-05-26 01:29:01 +0900 (Tue, 26 May 2009) | 2 lines

* Display normal log information in the console's default foreground colour, for those of us with white backgrounds

------------------------------------------------------------------------
r9671 | drscofield | 2009-05-25 21:27:17 +0900 (Mon, 25 May 2009) | 1 line

oops: wrong "path" in addin.xml
------------------------------------------------------------------------
r9670 | lbsa71 | 2009-05-25 20:43:56 +0900 (Mon, 25 May 2009) | 1 line

* Upped version number to 0.6.5
------------------------------------------------------------------------
r9669 | drscofield | 2009-05-25 20:32:31 +0900 (Mon, 25 May 2009) | 3 lines

Revert "From: Chris Yeoh <cyeoh@au1.ibm.com>"

This reverts r9666. for some reason the mysql update does not work.

[[Category:Release Notes]]

0.7 Release

2012-03-04T07:36:10Z

MakoBot: /* Troubleshooting */

= Release Notes =

== Major changes from 0.6.x ==

Release 0.7 features the completed major refactoring and rearchitecting work that happened during the second half of 2009 and the first quarter of 2010. This work targeted mainly the resource services and servers previously known as UGAIM. These servers have been replaced by one single server shell called [[ROBUST]] which can now run any combination of services in it.

The standard opensim release includes configuration files for two deployment architectures:

* The standalone deployment consists in having both the simulator and the services in one single process, OpenSim.exe, configured by OpenSim.ini (and included .inis under bin/config-include).
* The grid deployment has 1 ROBUST server process (Robust.exe) running all services, configured by Robust.ini (or Robust.HG.ini); and one or more simulators (OpenSim.exe), each configured by OpenSim.ini (and included .ini files under bin/config-include).

Users and distributors of OpenSimulator can deviate from these pre-existing configurations in many ways. Specifically, large grids will benefit from splitting the single ROBUST server into several ROBUST servers, each running a collection of services. Instructions for how to do that are found elsewhere. (Think of the ROBUST server as an Apache server, to which you can load service modules)

The services themselves have been reconceptualized; we now have the following set of main services:

* Assets -- the asset store
* Authentication -- passwords and auth tokens
* Authorization -- access control
* Avatar -- the visual representation of users, formerly known as "avatar appearance"
* FreeSwitch -- voice
* Friends -- social net
* Gatekeeper -- hypergrid foreign users control
* Grid -- maps map locations to IPs and regions
* Grid User -- grid-local information about users
* Inventory -- the inventory store
* Login -- the login service
* Presence -- tracks where in the grid user agents are
* User Accounts -- administrative info about users
* User Agents -- hypergrid local users protection

The simulators access these services through abstract interfaces, therefore being isolated from implementation details. The services are seamlessly instantiated as plugins in any process, namely ROBUST server shells and the simulators processes themselves, which means that we have complete reuse of service code between standalone and grid configurations. The plugin specification is done in configuration files (.ini). Moreover, access to remote services is also seamlessly achieved through the instantiation of stubs (aka service connectors) as plugins; again, the specification of which stubs the simulators use is done externally in configuration files (.ini).

This layering allows for alternative third-party implementations of the entire resource service infrastructure without having to affect one line of code in the simulator, and simply using different ini files. Starting in this release, there is an alternative infrastructure to Robust: [http://code.google.com/p/openmetaverse/ SimianGrid], a project separate from OpenSimulator. The standard OpenSimulator release includes simulator's connectors and configuration files for the SimianGrid, but that infrastructure is not distributed with OpenSim, only Robust is.

== Database changes ==

[[File:DB-0.7.jpg|400px|right|(click to enlarge)]]

[[File:DB-0.7-old-tables.jpg|400px|right|(click to enlarge)]]

The database schema has changed considerably from previous releases. The top picture on the right shows the entire set of tables for a clean installation of the 0.7 release with MySql. The bottom picture shows the new tables as well as the tables that existed in previous versions of OpenSimulator and that are now obsolete, stroked in red. OpenSimulator does not drop the old tables automatically, for obvious reasons. Once you are sure your data migration was successful, you can then drop the obsolete tables manually.

In the picture on top, the tables are grouped into 2 catalogs, the service-db and the simulator-db, corresponding to the data managed by the resource services (the ConnectionString under the [DatabaseService] section) and the data managed by the simulators (the connection_string under [Startup] section), respectively.

As before, you have a lot of freedom to define how the data is organized, so, for example you might have one single catalog with all the tables (like the organization shown in the picture on the bottom). In any case, after a clean installation of release 0.7, there should be all these tables in your DB.

For SQLite, the tables are split among several .db files under the bin directory. Here are the SQLite .db files that a clean install of 0.7 should produce:

$ ls -l *.db
----------+ 1 crista None 6555648 Jun 14 08:15 Asset.db
----------+ 1 crista None 564224 Jun 14 08:15 OpenSim.db
----------+ 1 crista None 5120 Jun 14 08:15 auth.db
----------+ 1 crista None 4096 Jun 14 08:14 avatars.db
----------+ 1 crista None 4096 Jun 14 08:14 friends.db
----------+ 1 crista None 4096 Jun 14 08:14 griduser.db
----------+ 1 crista None 26624 Jun 14 08:15 inventory.db
----------+ 1 crista None 0 Jun 14 08:14 inventoryStore.db
----------+ 1 crista None 4096 Jun 14 08:15 userprofiles.db

With SQLite, the simulator data is in OpenSim.db; the service data is in all the other files. inventoryStore.db has to do with migrations of inventory from older OpenSimulator releases; on a fresh install, this file is created but is has no data, you can safely delete it afterward.

== Hypergrid changes ==

The Hypergrid underwent considerable changes to make it more secure. 0.7 features HG1.5, an interoperability design that is as secure as it can be while continuing to assume the use of the regular Linden viewer. Here are the highlights with respect to security.

'''HG Teleports: The Gateway'''

HG teleports are now done through the Gateway service, as opposed to being done directly between the departing and the receiving simulators. The flow is like this: user U is in sim A of grid G1, and wants to HG TP to sim B of grid G2; sim A posts the user agent to the Gateway service of G2; after verifying a few things, and making sure this is a genuine agent for user U, the Gateway service in G2 logs in the user's presence in the local grid as a valid grid user, and posts the agent to sim B; sim B in G2 then contacts Sim A in G1 telling it it can delete the agent; at that point sim2 logs off user U from G1.

The posting of foreign agents directly to simulators of a grid, without passing through the Gateway, will fail.

In 0.7, the Gateway is still not performing authorization (i.e. access control for foreign users based on grid-specific policies), but that step is now possible, and will be introduced in a future release.

'''User Agents Verification'''

Prior to 0.7, it was possible to impersonate users by launching agents at simulators pretending to be those users. This vulnerability was independent of the Hypergrid being active or not, it affected all publicly available simulators. With 0.7 and beyond, and for grids where all simulators are under the same authority, this vulnerability has been eliminated.

HG1.5 includes pieces of protocol that guarantee that the user agent being launched at the Gatekeeper of a grid is indeed a genuine agent from the claimed user.

'''Inventory Access'''

The important thing to know about the family of viewers deriving from the Linden viewer is that they all access the user's inventory from the simulator that the user is currently on. In other words, they expect the simulators to proxy inventory, instead of accessing inventory directly from the user's inventory service. This poses serious security and privacy issues that can only be minimized but not eliminated. HG1.5 minimizes the risks as much as they can be minimized while allowing users to access their inventory everywhere. This comes at the cost of a slight UI mismatch at points.

First, in HG1.0, the visiting simulator had the power to delete items from the user's inventory and even delete the entire user inventory. That vulnerability has been eliminated. Foreign simulators cannot delete anything from the user's inventory: "purge" actions from a foreign simulator are ignored by the user's home inventory service. This means that if the user performs a genuine "purge" while in a foreign sim, the viewer will show that the items have been purged, but upon the next login those items will be in the Trash bin again, because they weren't really deleted.

Second, upon arrival at a foreign simulator that simulator is not given the user's root inventory folder. Instead, it is given another folder called Suitcase that will act as root folder while the user is visiting. As such, the simulator cannot recursively download the user's inventory; it can only 'see' the items and folder under the Suitcase folder. (No need to create a Suitcase folder, it will be created if it doesn't exist)

Besides the Suitcase folder, the only items that the simulator will know about upon user's arrival are those pertaining to the user's current appearance. 'Knowing about' means that a rogue simulator can copy them; but it can never delete them, as explained above.

Because inventory access is dictated by the viewer (i.e. by the user's actions), privacy of inventory depends on what actions the user does while visiting foreign grids. If the user does not access his/her inventory, the visiting simulator will know very little about it -- only the things stated above. On the other extreme, searching for an inventory item or opening up the texture picker makes the viewer query the entire user inventory, sending the to simulator all folder identifiers one by one; this means that the visiting simulator will 'see' the entire inventory; rogue simulators may then copy the items (again, they cannot delete them).

While using the Linden family of viewers, HG users should be aware of these issues. Trust decisions, ultimately, fall on them. If users trust the visiting grid, they can access their inventory without worrying that it will be stolen; if, however, the users don't know much about the simulator that they are visiting, they can still visit but should abstain from performing inventory actions.

== Groups Changes ==

The groups module can use a PHP XmlRpc server from:

* Flotsam project at http://code.google.com/p/flotsam/
* SimianGrid project at http://code.google.com/p/openmetaverse

The same GroupsServerURI configuration variable is used for either. 0.6.x setups using the old XmlRpcServiceURL configuration variable should be changed to use GroupsServerURI as illustrated in Opensim.ini.example.

== Profile Changes ==

The profile feature has been discontinued from the core distribution. 3rd-party addons provide different flavors of support for this feature.

== Bug Fixes, New Features and Assorted Changes ==

* Impovements to sculptmap and level of detail handling.
* Standalone database configuration simplified.
* Parcel and estate bans
* Neighboring regions being brought up and down results in correct accessibility in the connected clients.
* Friends online/offline notifications are now working across the board.
* Object attach/drop/attach correctly working.
* Inventory folder 'wear' working correctly.
* Inventory accept/decline notifications working correctly.
* Eliminated deadlock affecting scripts startup. This deadlock showed more often in certain mono versions. The same code was responsible for a CPU spike at region startup, which is now under control.
* Megaregion prims now in place after unclean shutdown. They used to be missing.
* Several permissions vulnerabilities fixed.
* Allow use of old angle rules PSYS_SRC_INNERANGLE and PSYS_SRC_OUTERANGLE in llParticleSystem().
* Bug fix in llRot2Euler()
* llVecNorm() now returns a zero-length vector when one is supplied as input.
* Fixed problem where "Adult" regions were reported as being of type "Unknown"
* Fixed Copy on Ray, Drag Copy and other little things.
* Make drag copy and copy-on-ray handle friends list perms properly.
* Added checks to XInventory DB layer to truncate names and descriptions, so they fit their sizes in the DB.
* Guarded prioritizer agains null values as those produced by a bullet dying before it can be updated
* Security fix: Allow only textures to be fetched using HTTP texture cap
* Fixed faulty profile cut parameter checking in llSetPrimitiveParams()
* Fixed attachments coming back upon being detached in neighbouring regions and crossing.
* Added CHANGED_TELEPORT event trigger upon inter-sim teleports.
* Prevented region crossings from screwing up complex attachments by preserving link numbers.
* Added ability to load IARs directly from URIs
* Added prim prioritization according to several schemes (configurable)
* Fixed spamming the assets table with map tiles.
* Corrected an invalid construction of Primitive.TextureEntry
* Added LightShare scripting
* Added SimianGrid connectors
* "Share with group" implemented for object inventory items. This only works if you're using a groups module with OpenSimulator.
* Added HTTP texture retrieval.
* Fixes to allow Linden Lab's viewer 2 to work, though some new features of this viewer (e.g. shared media/media on a prim) are not yet implemented.
* Added --skip-assets option to load oar command. This allows an oar to be loaded without loading its assets, which can be quicker if the assets are already known to be in the database.
* Various core performance improvements.
* Various core stability improvements.

* Master Avatar no longer in use. Upon creation of a new region, the user is prompted for the region owner and estate information. In standalone configurations, the region owner account is created if it doesn't exist; in grid configurations, the region owner account must already have been created.

= Upgrading from older releases =

Upgrading the database from older releases is done automatically when OpenSimulator 0.7 is first run; no special provisions are required. However, we very strongly recommend that you backup your database first, in case something goes wrong during the migration process.

Configuration files, on the other hand, have changed in 0.7 compared with 0.6 versions. Simply copying old configuration files can result in strange errors. We recommend that you start afresh with the OpenSim.ini.example and example files in bin/config-include and manually move accross any changes that you've made to the default configuration.

== Standalone Deployments ==

For standalones, there is no noticeable difference in the mode of operation. The main configuration file is OpenSim.ini, as before; make sure it exists and that is readable. If you are upgrading from 0.6.[7-8-9], you should already know about config-include/StandaloneCommon.ini. If you are upgrading from older releases, please be aware that this additional configuration file is needed. Make sure it exists and that it is readable. There are .example files for both of these.

There were several changes and additions to the configuration files. As such, it is better that you start with the given .example files and customize from them, as opposed to upgrading your existing ini files.

== Grid Deployments ==

The deployment model for grids has changed considerably, as explained before, so you need to acquire the know-how for operating in this post-0.7 model. The most important change is this: '''none of the UGAIM servers exist any longer'''; they have been replaced by one single server shell, Robust.exe, configured by one single configuration file, Robust.ini (or Robust.HG.ini). There are .example files provided. Copy one of them, and make the appropriate customizations. Robust does not depend on OpenSim.ini, only on Robust.ini.

Robust.exe -inifile=Robust.HG.ini
or
Robust.exe -inifile=Robust.ini

On the simulators' side, the operation is the same as before. The main configuration file is OpenSim.ini, as before; make sure it exists and that is readable. If you are upgrading from 0.6.[7-8-9], you should already know about config-include/GridCommon.ini. If you are upgrading from older releases, please be aware that this additional configuration file is needed. Make sure it exists and that it is readable. There are .example files for both of these.

It is better that you start with the given .example files and customize from them, as opposed to upgrading your existing ini files.

= Troubleshooting =

When migrations fail, the migration number is incremented anyway. If one of your migrations fail, notice which number it was, and to which table it pertained to. Then, login to the DB and set the version number of the corresponding store to the number just before the failed migration.

For example, if there is a failure in migration 8 for the assets table, issue this command in the DB:
> UPDATE Migrations SET version=7 WHERE name='AssetStore';
Then run Robust/OpenSim again.

The very last resort is to perform the migration manually, i.e. login to the DB server and issue the offending statement directly there.

See also [http://opensimulator.org/mantis/view.php?id=4875 this bug report] for useful tips related to account migration problems.

[[Category:Release Notes]]

設定

2012-03-04T07:08:51Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Configuration}}
<br />
== OpenSimulator シミュレータ設定ファイル ==
地域シミュレータの設定は OpenSim.ini と呼ばれるファイルで行われます。このファイルは SIM がスタンドアロンモードで動作していてもグリッドモードで動作していても同じように使用されます。このファイルは config-include/ ディレクトリの中にある追加の設定情報を参照します。各種設定についての情報は OpenSim.ini ファイル自体にあります（または OpenSim.ini.example が参考となります）。

OpenSim.ini という名前は、コマンドライン引数で変更される場合があります。

INI ファイルを 2 つのファイルに分けて配布することができます。 OpenSimulator を複数起動して、一部の設定以外は全く同じ設定にしたいときに便利です。マスターファイルが最初に呼ばれ、 INI ファイルが次に呼ばれます。 INI ファイルに記述された設定はマスターファイルに記述された設定を上書きします。マスターファイルには INI ファイルと同じフォーマットで同じキーワードで書かれていますので、INI ファイルについての説明がマスターファイルについてもあてはまります。


=== 各設定ファイルの日本語訳 ===
* [[日本語訳(OpenSim.ini.example)|bin/OpenSim.ini.example]]
* [[日本語訳(Robust.ini.example)|bin/Robust.ini.example]]
* [[日本語訳(StandaloneCommon.ini.example)|bin/config-include/StandaloneCommon.ini.example]]
* [[日本語訳(GridCommon.ini.example)|bin/config-include/GridCommon.ini.example]]
* [[日本語訳(FlotsamAssetCache.ini.example)|bin/config-include/FlotsamAssetCache.ini.example]]
* [[日本語訳(CenmoeAssetCache.ini.example)|bin/config-include/CenmoeAssetCache.ini.example]]


== データベース ==
OpenSimulator は以下のデータベースエンジンをサポートします。設定の詳細は、 OpenSim.ini.example ファイルや、その他 bin/config-include にある各種サンプルファイルにあります。各データベースの設定の詳細は [[Database Settings]] を参照してください。

* '''SQLite''' （標準） - OpenSimulator にバンドルされている、軽いデータベースで、特に設定をすることなく使用できます。手っ取り早く立ち上げるためのオプションであり、商用利用には適していません。MySQL に比べて超遅いです。ここに書かれている機能の中には（例えばアタッチメントの不揮発化など）、完全に実装されていないものがあります。
* '''MySQL 5.1''' （完全にサポートされています）- これは推奨のデータベースで、本格的に使用したり、小さなスタンドアロンアプリケーションを作成したりする場合に適しています。
::*'''OpenSimulator 0.7.1:''' そのままの状態で MySQL 5.5 をサポートします。
::*'''64 ビット版 Windows:'''  現在、MySQL 5.5 を Windows x64 システムで動作させる場合に、未解決のバグ [http://opensimulator.org/mantis/bug_view_advanced_page.php?bug_id=5294 bug_id=5294] が発生することがわかっています。
::*'''OpenSimulator 0.7.0.2:'''  MySQL 5.1.55 と 0penSim 0.7.0.2 の組み合わせで問題が発生すると、ユーザが報告しています。詳細は [http://opensim-users.2152040.n2.nabble.com/OpenSim-1-7-0-2-and-MySQL-Versions-td6155064.html this thread] を参照してください。この問題は MySql.Data.dll のアップデートされたバージョンを使用するか、MySQL の古いバージョン、例えば [http://downloads.mysql.com/archives.php?p=mysql-5.1&v=5.1.52 MySQL 5.1.52] をインストールして、OpenSimulator 0.7.0.2 と共存させるかすれば解決します。

* '''MSSQL''' (一部サポートされています) - 最近の OpenSimulator の機能の中には実装されていないものがあります。

== スタンドアロン vs グリッド ==
最初のうちは、グリッドに接続したりグリッドを作ったりするまでは、 OpenSimulator をスタンドアロンモードで動かすことをお薦めします。OpenSimulator はバイナリ・ディストリビューションで何も設定しないとスタンドアロンモードで動作します。

OpenSimulator 設定は地域（地域シミュレータによって動作する）とバックエンドデータサービス（ユーザ、アセット、インベントリの管理など）で構成されています。

'''スタンドアロンモード'''で動作するシステムでは、 OpenSim.exe を起動すると、地域シミュレータと全てのデータサービスが同一プロセスで動作します。このモードでは、地域を好きなだけ起動させることができますが、マシンは１つに制限されます。

[[Image:Opensim-standalone.png|frame|center|OpneSim がスタンドアロンモードで動作しています。シミュレータとサービスが両方とも同じプロセス (OpenSim.exe) で動作します。]]

'''グリッドモード'''では、データサービスは地域サーバプロセスから分離されています。その代わり、それぞれ Robust.exe と呼ばれる実行可能プログラムで動作します。Robust シェルは全てのサービスを動作させたり、任意の数の Robust インスタンスに分割して動作させたりすることができます。これにより、必要であれば、全く別のマシンで動作させることもできます。このモードでは、 OpenSim.exe は単なる地域サーバとして動作して、１つ以上の地域と分離したデータサービスとの間の通信を受け持ちます。現在のところ、 OpenSim.exe の地域シミュレータを別々のマシンで複数立ち上げることができます。

[[Image:Opensim-grid-simple.png|frame|center|OpenSimulator がグリッドモードで動作しています。この例の場合だと、全てのサービスが Robust.exe プロセスで動作します。OpenSim.exe の複数のコピー (たいてい、別のマシンで動作しています) がみんなで、同じ一連の共通サービスを利用します。]]

グリッドモードで動作させるのは、スタンドアロンモードで動作させるより難しいです。 UUID 、 XY座標、サーバハンドシェークパスワード、不動産や不動産オーナー、その他諸々の設定についての知識が必要です。設定は、注意深く、忍耐強く行わなければなりません。あなたがものすごく忍耐強く器用な人でなければ、グリッドモードで動作させようとしないことを強くお薦めします。

= OpenSimulator をスタンドアロンモードで動作させる =
OpenSimulator のバイナリディストリビューションをスタンドアロンの設定で動作させるのは比較的単純です。デフォルトでそのように設定されているからです。逆に、もしソースディストリビューションをGit リポジトリから取得してビルドするのなら、以下の手順が必要となります。

# bin/OpenSim.ini.example ファイルを bin/OpenSim.ini にコピーします。これは、3D シミュレータ自体を設定するものです。
# bin/config-include/StandaloneCommon.ini.example ファイルを bin/config-include/StandaloneCommon.ini にコピーします。これは、スタンドアロン設定で使用される、プロセスの内部にあるサービスを設定するものです。
# OpenSim.ini のファイルの最後の方にある [Architecture] セクションで、 Standalone.ini の行のコメントを外します。行のコメントアウト状態を解除するには、行の先頭にあるセミコロン (;) を外して、次のような感じにします。

Include-Architecture = "config-include/Standalone.ini"

OpenSim.exe を起動すると、 OpenSimulator が起動したことになります。しかしその前に、関連するモジュールを全部インストールしておく必要があります。詳細は、[[動作環境]] を参照してください。その後、コマンドプロンプト (Windows の場合、スタートメニュー > ファイル名を指定して実行... > cmd) を開き、OpenSim/bin ディレクトリに移動します。

'''32 ビット版 Windows''' のコマンドプロンプトでは、
<pre>
OpenSim.exe
</pre>
'''64 ビット版 Windows''' では、まだ ODE が 64 ビットモードでコンパイルされていないため、デフォルトの ODE 物理エンジンを使う場合は次のようにして実行します。
<pre>
OpenSim.32BitLaunch.exe
</pre>
'''Linux''' では、次のようにして実行します。
<pre>
mono OpenSim.exe
</pre>
ODE 物理エンジンを使う場合は、32 ビットモードでも 64 ビットモードでもこの手順で起動します。

== OpenSimulator を最初に起動する ==

OpenSimulator を最初に起動すると、いくつかの質問がコンソールに表示され、あなたに代わって１個の地域を設定してくれます。入力した設定内容は bin/Regions/Regions.ini に記載され、後日変更が必要になったときに編集できるようになっています。

多くの質問にはデフォルトの答えがあります。ここで、質問の意味を説明します。

* '''New region name'''
::地域の名前です。空白にしないでください！
* '''Region UUID'''
::地域のユニークな ID です。よっぽどのことがない限り、角括弧に囲まれて表示されている、ランダムに生成されたデフォルト値をそのまま採用すればよいでしょう。既にある地域データに対して設定を行おうとしている場合のみ、やってはいけません。しかし、このケースではおそらく Regions.ini ファイルを直接編集したほうがいいと思うでしょう。
* '''Region Location'''
::これはグリッドの中における地域の位置です。スタンドアロンモードではデフォルト値 (1000,1000) のままにするほうが安全です。後で Regions.ini に別の地域を追加するとき、違うグリッド座標 (1000,1001など) にする必要が出てくるでしょう。 OpenSimulator の地域は 65536 × 65536 のグリッドの中のどこにでも設置することができますが、[[ハイパーグリッド]] 対応地域では地域の位置に関して特別な考慮が必要です。詳しくは[[ハイパーグリッドのインストールと運用#4096 の地域制限]]を参照してください。
* '''Internal IP address'''
::これは常に 0.0.0.0 でなければなりません（0.0.0.0 は「全てのインターフェースの接続を監視する」という意味で、要はワイルドカードです）。UDP 接続を 1 つのネットワークインターフェースだけに限定したい場合は、IP アドレスを明示的に指定しましょう。このアドレスは内部でのみ使用されます - '''External host name''' だけが、ビューアに送信されます（ので、大きな影響をもつものとなっています）。
* '''Internal port'''
::これはクライアント接続の受け口となる IP ポートです。この名前は少し誤解を招きがちです。これは内向きだけでなく、外向きの通信にも（例えば Second Life ビューアなどで）使用されるからです。好きなポートを指定して構いませんが、 9000 にしておくのが安全です。サーバ上の地域には、それぞれ別々のポートが設定されていなければなりません。
* '''Allow alternate ports'''
::これは現在試行中です。デフォルトの False のままにしてください。
* '''External host name'''
::これをデフォルトの 'SYSTEMIP' のままにすると、マシンの LAN ネットワークアドレス（例えば 192.168.1.2) となります。 LAN の中からのみ接続する場合は、この設定で大丈夫です。インターネット上のクライアントから接続させる場合は、これはルータの外部 IP アドレスにしなければなりません。 Fully Qualified Domain Names (FQDNs) も使用されますが、ビューアに送信される前に IP アドレスに変換されます。

OpenSimulator 0.6.9 以前では以下も質問されます。

* '''Master Avatar UUID'''
::これはレガシーな OpenSimulator 機能で、 00000000-0000-0000-0000-000000000000 のままで結構です。後々、地形編集で問題が発生したら、Regions.ini でこれを自分のアバターの UUID に変更するとよいでしょう。
* '''Master Avatar first name'''
::マスターアバターを指定するもう一つのやり方です。 UUID でなくアバター名で指定します。ここでエンターキーを押すと、このフィールドと last name フィールドが空となります。デフォルトの空白のままで結構です - これは後からいつでも Regions.ini ファイルで変更できます。
* '''Master Avatar last name'''
::マスターアバターのラストネームです。
* '''Master Avatar sandbox password'''
::マスターアバターのパスワードです。

OpenSimulator 0.7 以降では、OpenSimulator はセットアップの過程で、各地域を不動産(Estate)に関連づけるための質問をしてきます。不動産を作成する必要がある場合は、不動産管理者(Estate Manager)を作成するためにさらに質問をしてきます。スタンドアロンモードの場合、不動産管理者はセットアップの過程で作成されます。

マスターアバター（0.6.9 の場合）や不動産管理者（0.7 以降）を設定するのに使ったアカウント情報を忘れないようにしてください。初期状態ではこのユーザだけが地域のインワールド設定を行うことができるようになります。これは、最初にログインしてみる際に使うユーザアカウントにもなります。

[[地域の設定]] に、質問によって生成された Regions.ini ファイルについての追加情報があります。

不動産管理者以外のユーザを作成したいときは、サーバコンソールに次のように入力します。
<pre>
create user
</pre>
ユーザ作成に必要な（ファーストネーム、ラストネーム、パスワードなどの）質問をしてきます。

== OpenSimulator に接続する ==

自分のユーザ名で新しい SIM に接続するには、次のコマンドライン引数で Second Life ビューアを起動します。

'''OpenSimulator を同じマシンにあるクライアント:'''
<pre>
-loginuri http://127.0.0.1:9000/
</pre>

'''OpenSimulator と同じ LAN ネットワークにあるクライアント:'''
<pre>
-loginuri http://lan_ip:9000/
</pre>

'''他のマシンや、インターネット上にあるクライアント:'''
<pre>
-loginuri http://external_ip:9000/
</pre>

それから先の手順で設定したユーザ名とパスワードを入力すると、新しいユーザでログインできるはずです。

「外部の」設定を使ってビューアとサーバを同じマシン (LAN) で動作させる場合は、[http://osgrid.org/forums/viewtopic.php?f=5&t=400&start=0&st=0&sk=t&sd=a ループバック] 問題に気をつけてください。
（<u>'''地域のハンドシェークで永遠に待たされることになります'''</u>。） [[Troubleshooting/ja|トラブルシューティングのヒント]] も参照してください。接続に関して問題がある場合は、[[Network Settings|必ずネットワーク設定のページを読んでください]]。地域ハンドシェークにまつわるトラブルを理解するのに重要な資料です。

= OpenSimulator をグリッドモードで動作させる =
{|
| style="background:LavenderBlush; color:black" |
[[Image:Exclamation.png|left]]
注: 0.7 は全てのサービスを ROBUST サーバシェルに完全に移行した最初の OpenSimulator リリースです。0.6.9 から使っていた OpenSim.Grid.UserServer.exe や MessageServer.exe はもう必要ありません。詳細は、[[0.7 Release|0.7 Release Notes]] を確認してください。OpenSimulator 0.6.9 以前のグリッドサービスのセットアップ方法については、 [[OpenSim 0.6.9 グリッドモード設定]] を参照してください。
|}

OpenSimulator をグリッドモードで動作させるのは、スタンドアロンで動作させるのよりも難しいとされています。全てが同一プロセスで動作するのではなく、バックエンドのデータサービス (アセット、インベントリなど) は、たいてい異なるマシン上にある、１つまたは複数に分かれたプロセスで動作します。この仕組みにより、複数の OpneSim.exe シミュレータ・インスタンスが同一のアセットやインベントリ・データを使用することができるようになります。

== ステップ 1: ROBUST サービスインスタンスを設定する ==

1. bin ディレクトリで、Robust.ini.example を Robust.ini にコピーします。このサンプルファイルは、全てのサービスが同一の ROBUST インスタンスで動作するように設定されています。

2. Robust.ini の [DatabaseService] セクションを編集して、MySQL データベースを使用するようにします。MySQL だけがグリッドサービスの実行でサポートされています。

3. Robust.exe を起動します。

mono Robust.exe (Linux, BSD, Mac OS X)

または

Robust.exe (Windows)

コンソールにエラーが (赤で) 表示されていなかったら、次の手順に進みましょう。

4. 全ての地域は不動産 (Estate) に所属していなければなりません。また、全ての不動産にはオーナーがいて、そのユーザアカウントが OpenSimulator のユーザアカウント・サービスで有効になっているような状態でなければなりません。ROBUST コマンドコンソールで次のようにしてユーザを作成します。

create user

ユーザの名前、パスワード、メールアドレス(任意)を聞いてきます。この名前は覚えておきましょう。シミュレータを最初に起動するときに必要になります。

== ステップ 2: OpenSim.exe を設定して ROBUST サービスを利用するようにする ==

グリッドモードでも、スタンドアロンモードと同様、3D シミュレータ自体を制御する OpenSim.ini を編集する必要があります。

しかし、グリッドに接続するシミュレータは、config-include/StandaloneCommon.ini を編集するのではなく、config-include/GridCommon.ini ファイルを参照・編集して、ローカルのプロセス内部のサービスにではなく、ROBUST がホストするリモートのデータサービスのほうに接続する必要があります。

これらの実施手順は、以下のようになります。

1. bin/OpenSim.ini.example を OpenSim.ini にコピーします。

2. [Architecture] セクションを OpenSim.ini で探します。以下の行だけが有効になっているような状態にしてください。

Include-Architecture = "config-include/Grid.ini" (OpenSimulator 0.7.1 以降)

または

Include-Grid = "config-include/Grid.ini" (OpenSimulator 0.7.0.2 以前)

他はコメントアウト状態のままにしてください。

3. bin/config-include に移動し、GridCommon.ini.example を GridCommon.ini にコピーします。

4. GridCommon.ini をテキストエディタで開きます。URL がいっぱい書いてあります。それぞれの URL は、 <nowiki>http://myassetserver.com:8003, http://myinventoryserver.com:8003 </nowiki>のような、ダミーの初期値が記載されています。それぞれを編集して、ROBUST インスタンスのアドレスを示すようにする必要があります。例えば、ROBUST をローカル IP アドレス 192.168.1.2 で動作させようとしているのなら、AssetServerURI を次のようにする必要があります。

AssetServerURI = "http://192.168.1.2:8003"

5. OpenSim.exe を実行します。OpenSim.exe を最初に起動すると、スタンドアロンモードで最初に起動したときと同じように、地域の設定に関する質問をしてきます。どのように答えるかについては、スタンドアロンのセクションを参照してください。また、Regions.ini のさらに詳しい情報は、[[地域の設定]]を参照してください。

全てが順調に設定されれば、OpenSim.exe を起動したときにエラーが表示されないはずです。また、地域がグリッドサービスに登録された旨のログメッセージが、ROBUST コンソールに表示されるはずです。例えば、

21:43:45 - [GRID SERVICE]: Region t1 (176cc95e-f693-4b02-8e08-af86e2372faa) registered successfully at 256000-256000
21:43:47 - [GRID SERVICE]: region t1 has 0 neighbours

6. クライアントでログインします。クライアントの起動オプションはこのようにします。

-loginuri http://192.168.1.2:8002

loginuri はログインサービスのアドレスにする必要があります。スタンドアロンモードでは、地域シミュレータと同じアドレスで、ポートはデフォルトで 9000 でした。しかしグリッドモードでは、ROBUST がホストしているログインサービスのアドレスになります。この場合、192.168.1.2 が ROBUST インスタンスのアドレスになります。ポート 8002 は従来のグリッドログインサービスのために残してあるもので、Robust.ini.example のデフォルト値になっています。

7. ログインに成功すると、ログが ROBUST コンソールと(こちらはログインという行為自体に対するものです)、地域シミュレータのコンソールに (こちらはログイン処理がシミュレータにアバターを迎え入れるように指示を出したタイミングと、ビューアに地域シミュレータのアドレスを伝えたタイミングと、ビューアがシミュレータと直接やりとりするようになったタイミングで) 表示されます。

== 自分の SIM を他人のグリッドに接続する ==
地域サーバ（例えば <tt>OpenSim.exe</tt>）を設定してグリッドに接続する際は、上の[[#ステップ 2: OpenSim.exe を設定して ROBUST サービスを利用するようにする]]に従ってください。

既に必要なサービスがグリッドに提供されているはずです。ステップ２では、提供されたサービス接続 URL を使用する必要があります。

bin/Regions.ini ファイル (などの地域設定ファイル) に、グリッド管理者から提供された、地域のグリッド座標を設定する必要があります。詳細は、[[地域の設定]] を参照してください。

= 追記 =

== トラブルシューティング ==
[[トラブルシューティング]] を参照してください。

== OpenSimulator 0.6.7 以降を 64 ビット版 Windows でを動作させる ==
[[Image:Exclamation.png|left]]
OpenSimulator 0.6.7 から、OpenSimulator のデフォルトの物理エンジンが ODE エンジンに変更されました。これは ODE が現在 OpenSimulator に同梱されている物理エンジンプラグインの中で今のところ最も先進的なものだからです。残念なことに、 64 ビット版 Windows ではライブラリの互換性がないという欠点があります。

このため、64 ビット版 Windows のユーザは、地域シミュレータを起動する際は
<pre>
OpenSim.exe
</pre>
ではなく、
<pre>
OpenSim.32BitLaunch.exe
</pre>
を実行する必要があります。

代替の方法として、基礎物理エンジンや OpenSimulator に同梱されている他の物理エンジンを使うこともできますが、ODE プラグインに比べると断然機能性の面で劣ります。

== Mono に関する注意 ==
Mono を使用している場合、Mono の環境変数 MONO_THREADS_PER_CPU をデフォルトの 5 から SIM で動作する値まで増加させなければなりません。正確な数字は様々な要因によって左右されます: マシンの CPU の数、マシンの他の用途、SIM にある地域の数、隣接する SIM の数、スクリプトの数、アバターの同時滞在予定数などです。参考までに、OSGrid の Wright Plaza という、１つの SIM で１つの地域を動作させていて、約 20 名のアバターで定期的にミーティングを開いている SIM では、値は 125 にしています。

値が小さすぎると、SIM の挙動がいろいろな点でおかしくなってきます。よくある症状は、新しいアバターがログインするときにフリーズすることです。他の症状はこれに比べればはるかに軽いです。

例: $ export MONO_THREADS_PER_CPU=125

== OpenDynamicsEngine を *nix で使用する際のスタック領域拡張 ==
OpenDynamicsEngine を *nix で使用していて問題が発生している場合は、次のコマンドでスタック領域をデフォルトよりも大きく設定してみてください。
<tt>ulimit -s 262144</tt>
もしくは、 opensim-ode.sh で OpenSimulator を起動してください。

== ファイアウォール ==
OS・ディストリビューションによっては、デフォルトでファイアウォールが稼働している場合があります。OpenSimulator にリモートのクライアントからアクセスできない場合は、設定を確認する必要があります。詳細は、[[ファイアウォール設定]] を参照してください。

== レガシー設定に関する情報 ==
正確かどうかはわかりませんが、レガシー設定に関する情報について書かれているページがいくつかあります。

[[OpenSim 0.6.6 legacy configuration information]]

== 拡張オプションの設定 ==

=== OpenSimulator をさらに設定する ===
OpenSim.ini.example ([[日本語訳(OpenSim.ini.example)|ファイルの日本語訳]]) やその他の設定ファイルをよく見ると、膨大な数の設定可能なパラメタがあるはずです。詳しくは、 [[シミュレータ・パラメタの設定]] を参照してください。(訳注：各設定ファイルの日本語訳へのリンクは、このページの一番上の[[#パッケージ内容の日本語訳]] にあります。)

=== OpenSim.exe コマンドラインオプション ===
OpenSim.exe にはコマンドラインオプションがあり、これを使って他のディレクトリから設定ファイルを読みこむといったことができます。詳細は [[OpenSim.exe Command Line Options|command line arguments]] を参照してください。

=== スクリプトエンジン ===
OpenSimulator は複数のスクリプトエンジンをサポートします。詳細は [[ScriptEngines]] を参照してください。何を言っているのかわからないかもしれませんが、デフォルトのスクリプトエンジンはちゃんと動くので安心してください。事実上、最近のバージョンの OpenSimulator は XEngine という１つのスクリプトエンジンしか同梱していません。

=== 権限設定 ===
OpenSimulator には複雑な権限の集合があります。詳細は [[Permissions(Server)]] を参照してください。デフォルトでは、権限は地域シミュレータで有効となっていません。

=== ログ出力 ===
デフォルトでは、OpenSimulator は bin ディレクトリの中の OpenSim.log と呼ばれるファイルに情報をログ出力します。必要であれば、設定方法の詳細が [[Logging]] にあります。

=== 地域モジュールの設定 ===
* [[IRCBridgeModule]]
* [[Freeswitch Module]]
* [[Offline Messaging]]

=== Web サーバや Web ページの設定 ===
OpenSimulator は Web サーバを同梱しており、様々なページを公開することができます。外部ファイルを表示するページもあれば、内部で生成されるページもあります。
* [[External Files]]
* [[Internally Generated]]

=== 複数のスタンドアロン地域を同じサーバで動かすときの設定 ===
OpenSim.ini の 'http_listener_port' を、9000 以外の値に変更し、Regions.ini の InternalPort を 9000 以外の値に変更してください。

= 参考情報 =

* [http://dist.opensimulator.org/wiki/opensim-standalone.odg OpenOffice draw file for OpenSimulator standalone diagram]
* [http://dist.opensimulator.org/wiki/opensim-grid-simple.odg OpenOffice draw file for OpenSimulator grid diagram]

{{DEFAULTSORT:せってい}}

[[Category:Japanese Translations]]

日本語訳(GridCommon.ini.example)

2012-03-04T07:08:39Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

このページには、config-include/GridCommon.ini.example の翻訳を載せています。
OpenSimulator 0.7.1 時点のものです。

<pre>

[DatabaseService]
   ;
   ; ### DB を選択してください。
   ;

   ; SQLite
   Include-Storage = "config-include/storage/SQLiteStandalone.ini";

   ; MySql
   ; ストレージに MySQL 使いたい場合は、以下のコメントを外してください。
   ; DB の設定情報に合わせて、接続文字列を変更してください。
   ;StorageProvider = "OpenSim.Data.MySQL.dll"
   ;ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;"
   ; MySQL を使っていて、エステートに異なるデータベースを使用したい
   ; 場合は、以下のコメントを外してください。
   ;EstateConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;"

[AssetService]

   DefaultAssetLoader = "OpenSim.Framework.AssetLoader.Filesystem.dll"
   AssetLoaderArgs = "assets/AssetSets.xml"

   ;
   ; ここをグリッドのアセット・サーバの URL に変更してください。
   ;
   AssetServerURI = "http://myassetserver.com:8003"

[InventoryService]
   ;
   ; ここをグリッドのインベントリ・サーバの URL に変更してください。
   ;
   InventoryServerURI = "http://myinventoryserver.com:8003"

[GridService]
   ;
   ; ここをグリッドのグリッド・サーバの URL に変更してください。
   ;
   GridServerURI = "http://mygridserver.com:8003"
   ;AllowHypergridMapSearch = true

   ;; リンクされた地域の MapTile イメージの保管ディレクトリ
   ; MapTileDirectory = "./maptiles"

; === ハイパーグリッド専用 ===
;; ここを Gatekeeper サービスのアドレスに変更してください。
;; (普通は特定の ROBUST サーバのポート 8002 に、他のサービスと
;; 同じように存在していますが、必ずしもそうとは限りません)
Gatekeeper="http://mygridserver.com:8002"

[AvatarService]
   ;
   ; ここをグリッドのグリッド・サーバの URL に変更してください。
   ;
   AvatarServerURI = "http://mygridserver.com:8003"

[PresenceService]
   ;
   ; ここをグリッドのプレゼンス・サーバの URL に変更してください。
   ;
   PresenceServerURI = "http://mygridserver.com:8003"

[UserAccountService]
   ;
   ; ここをグリッドのユーザアカウント・サーバの URL に変更してください。
   ;
   UserAccountServerURI = "http://mygridserver.com:8003"

[GridUserService]
   ;
   ; ここをグリッドのユーザアカウント・サーバの URL に変更してください。
   ;
   GridUserServerURI = "http://mygridserver.com:8003"

[AuthenticationService]
   ;
   ; ここをグリッドの認証サーバの URL に変更してください。
   ;
   AuthenticationServerURI = "http://mygridserver.com:8003"

[FriendsService]
   ;
   ; ここをグリッドのフレンド・サーバの URL に変更してください。
   ;
   FriendsServerURI = "http://mygridserver.com:8003"

[HGInventoryAccessModule]
   ;
   ; === ハイパーグリッド専用 ===
   ; ここをプロフィール・サーバの URL に変更してください。
   ; 他のグリッドからアクセスできる URL を指定する必要があります。
   ;
   ProfileServerURI = "http://mygridserver.com:8002/user"
;; アセットを外部から来たビジターにコピーされないようにしたい場合は、
;; 次の行のコメントを外してください。ライセンス管理されているコンテンツ
;; が SIM にある場合は、これをやっておいたほうがよいでしょう。
; OutboundPermission = False

[Modules]
   ;; キャッシュモジュールを 0 個か 1 個選択してください。
   ;; 関連した設定ファイルがあれば、それも選択してください。
   ;; 設定の .example ファイルをコピーして .ini ファイルとし、
   ;; その中にある設定を変更してください。

   AssetCaching = "FlotsamAssetCache"
   Include-FlotsamCache = "config-include/FlotsamCache.ini"

   ;AssetCaching = "CenomeMemoryAssetCache"
   ;Include-CenomeCache = "config-include/CenomeCache.ini"

   ;AssetCaching = "GlynnTuckerAssetCache"

   ;; 必要に応じて、LLProxyLoginModule のポート番号を変更する
   ;; ことができます。
   ;Setup_LLProxyLoginModule = "9090/"

   ;; 認証は外部の PHP で行われるため、デフォルトでは有効になっていません。
   ;AuthorizationServices = "RemoteAuthorizationServicesConnector"

</pre>
{{DEFAULTSORT:にほんごやくGridCommon}}

[[Category:Japanese Translations]]

日本語訳(FlotsamAssetCache.ini.example)

2012-03-04T07:08:29Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

このページには、config-include/FlotsamAssetCache.ini.example の翻訳を載せています。
OpenSimulator 0.7.1 時点のものです。

<pre>
[AssetCache]
;;
;; FlotsamAssetCache の設定
;;

; キャッシュ格納ディレクトリは複数のインスタンス間で共有されます。
CacheDirectory = ./assetcache
; 他の例:
;CacheDirectory = /directory/writable/by/OpenSim/instance

; ログレベル
; 0 - (Error) エラーのみ
; 1 - (Info) ヒット率統計 + レベル 0
; 2 - (Debug) キャッシュ処理 (読み書き) + レベル 1
;
LogLevel = 0

; ヒット率の表示頻度 (AssetRequests の X 回発行ごと)
; 0 にすると表示しません。
HitRateDisplay = 100

; ディスクキャッシュだけにしたい場合は、false にしてください。
MemoryCacheEnabled = false

; メモリにキャッシュされるアセットの保持期間 {時間} 。.5 = 30 分
; 最適化: VPS やメモリの制約が厳しいシステムでは、タイムアウトを
; .016 (1 分) に設定して導入すると、メモリにさほど影響を与えずに
; パフォーマンスを向上させることができます。
MemoryCacheTimeout = 2

; ディスクにキャッシュされるアセットの保持期間 {時間} 。.5 = 30 分
; 0 を指定すると、ディスクに永遠にキャッシュが残ります。
FileCacheTimeout = 0

; ディスク内の期限切れファイルのチェック間隔 {時間}
; 0 を指定すると、期限切れチェックを行いません。
FileCleanupTimer = .166 ; だいたい 10 分ごと

; WAIT_ON_INPROGRESS_REQUESTS が指定されている場合は、
; ディスクへの書き込みが完了するまでの間、リクエストスレッドを
; ブロックし続ける時間 (ミリ秒) となります。
; WaitOnInprogressTimeout = 3000

; キャッシュディレクトリに作成する階層の数
; (現在指定可能な値は 1 から 3)
;CacheDirectoryTiers = 1

; 1 つのパス階層に含まれる文字数。1 を指定すると 16 個の、
; 2 は 256 個の、3 は 4096 個の、4 は 65K 個のディレクトリが
; 各階層に作成されます。
;CacheDirectoryTierLength = 3

; 警告レベルとするキャッシュディレクトリサイズ
;CacheWarnAt = 30000

; 全ての地域に含まれる全てのアセットにディープスキャンをかけ、
; 存在するものや参照されているものを検索します。既にキャッシュに
; 存在するアセットをマーキングし、まだキャッシュされていない
; アセットをリクエストします (これらのアセットはキャッシュ
; されることになります) 。
;
; DeepScanBeforePurge = false

</pre>
{{DEFAULTSORT:にほんごやくFlotsamAssetCache}}

[[Category:Japanese Translations]]

日本語訳(CenmoeAssetCache.ini.example)

2012-03-04T07:08:19Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

このページには、config-include/CenmoeAssetCache.ini.example の翻訳を載せています。
OpenSimulator 0.7.1 時点のものです。

<pre>
[AssetCache]
   ;;
   ;; CenmoeAssetCache の設定
   ;;

   ; 以下の例では 256 MB (デフォルト: 134217728)
   MaxSize = 268435456

   ; キャッシュに格納できる最大アセット数 (デフォルト: 4096)
   MaxCount = 16384

   ; 保持期間 - 以下の例では 1 時間 (デフォルト: 30 分)
   ExpirationTime = 60
</pre>
{{DEFAULTSORT:にほんごやくCenmoeAssetCache}}

[[Category:Japanese Translations]]

日本語訳(BUILDING.txt)

2012-03-04T07:08:10Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|BUILDING.txt}}

以下は、OpenSimulator を解凍したディレクトリにある BUILDING.txt を翻訳したものです。(OpenSimulator 0.7.1 現在)

<pre>
=== OpenSimulator のビルド ===

=== Windows でビルド ===

手順:
* runprebuild.bat を実行します。
* OpenSim.sln を Visual Studio .NET でロードして、ソリューションをビルドします。
* bin フォルダに移動します。("chdir bin")
* OpenSim.ini.example を OpenSim.ini にコピーして、 bin/config-include 配下にある
他のファイルで必要なファイルも同様にコピーします。
* OpenSim.exe を実行します。

=== Linux でビルド ===

要件:
* Mono 2.4.2 以降
* Nant 0.85 以降
* Linux ディストリビューションによっては、他にパッケージをインストールしなければならないこと
もあります。
詳細は http://opensimulator.org/wiki/Dependencies を参照してください。

配布物を展開した状態から:
* ./runprebuild.sh
* nant
* cd bin
* OpenSim.ini.example を OpenSim.ini にコピーして、 bin/config-include 配下にある
他のファイルで必要なファイルも同様にコピーします。
* mono OpenSim.exe

=== 参考情報 ===

以下の情報が役に立ちます:
* http://opensimulator.org/wiki/Build_Instructions

</pre>
{{DEFAULTSORT:にほんごやくBUILDING}}

[[Category:Japanese Translations]]

地域の設定

2012-03-04T07:08:00Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Languages|Configuring_Regions}}
= OpenSimulator 0.7 以降 =
デフォルトでは、地域は bin/Regions ディレクトリにある Regions.ini ファイルで設定されます。
OpenSimulator を白紙の状態からインストールすると、一通りの質問をして、最初の地域を設定してくれます。

以下に、Regions.ini ファイルのサンプルを掲載します。

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2

これは、地域を動作させるために設定しなければならない設定項目のリストです。
Regions.ini ファイルがない状態で OpenSimulator を最初に起動すると、最初の地域を
設定するために、それぞれの設定項目に対応した質問がなされます。詳しくは、
[[設定#OpenSimulator を最初に起動する]] を参照してください。

{| cellspacing="0" cellpadding="5" border="1" align="center" class="sortable" width="90%"
|-
! 項目名
! 説明
|-
|[Big Fat Region]
|地域の名前。
|-
|RegionUUID
|地域の一意ＩＤ。
|-
|Location
|グリッドの中での地域の (x, y) 位置。
|-
|InternalAddress
|サーバに複数の NIC があり、OpenSimulator がリッスンする IP アドレスがどれになっても構わないのであれば、0.0.0.0 を指定します（通常の設定）。そうでなければ、IP アドレスを指定しましょう。
|-
|InternalPort
|クライアントの接続を受け付けるポート番号。
|-
|AllowAlternatePorts
|未使用。常に False にしてください。
|-
|ExternalHostName
|ルータの外部 IP アドレスまたは FQDN。
|}

他の地域を追加したい場合は、次のようにするとよいでしょう。

* Regions.ini にセクションをもう１個追加します。
* bin/Regions に別の .ini ファイルを作成します。
* 古い形式の OpenSim.xml ファイルを作成します（現在の OpenSimulator でもまだ動作します）。
* もしくは、地域コマンドを地域コンソールで発行します (0.6.7 では少しバグがあるようですので、推奨しません)。

Region.ini に２個目の地域を追加する例です。

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
 
[Greek Wedding]
RegionUUID = 5c445740-6460-43d3-ba4c-444444445555
Location = 1000,1001
InternalAddress = 0.0.0.0
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2

見ての通り、２番目の地域は Greek Wedding という名前で、違う UUID になっています。違う位置 (1000,1001) で違う InternalPort (9001) になっています。その他はまったく一緒です。

新しい UUID を作成するには、手作業でひねりだすか（例えば、[0-9][A-F] の範囲で文字を１個変える）、[http://www.famkruithof.net/uuid/uuidgen uuidgen webpage] にあるジェネレータを使用するかします。Unix では、 <tt>uuidgen</tt> コマンドを使用してもよいでしょう。

以上の基本項目の他に、地域のプロパティを変更できる追加の設定項目があります。

{| cellspacing="0" cellpadding="5" border="1" align="center" class="sortable" width="90%"
|-
! 項目名
! 説明
|-
|MaxAgents
|同時に地域に存在できるエージェントの最大数。デフォルトは 100 です。2011/4/21現在、git master にのみ存在します。
|-
|MaxPrims
|地域へ関連づけることのできるプリムの最大数。しかし、現在 OpenSimulator ではこの制限を強制的に適用しているわけではありません。Linden Lab プロトコルの制約により、表示される最大数は 45000 となっています。
|-
|PhysicalPrimMax
|物理プリムの最大寸法。１つの数値で、XYZ 座標に適用されます。既存プリムの大きさを変更する際にこれが影響します。デフォルトは 10 です。この設定は OpenSim.ini の [Startup] セクションに書くこともできます。地域の設定が存在すれば、それは OpenSim.ini の設定を上書きします。
|-
|NonphysicalPrimMax
|非物理プリムの最大寸法。１つの数値で、XYZ 座標に適用されます。既存プリムの大きさを変更する際にこれが影響します。デフォルトは 10 です。この設定は OpenSim.ini の [Startup] セクションに書くこともできます。地域の設定が存在すれば、それは OpenSim.ini の設定を上書きします。
|-
|ClampPrimSize
|true の場合、NonphysicalPrimMax 以上の大きさでプリムを作ろうとすると、NonphysicalPrimMax の大きさにまで縮められます。デフォルトは false です。この設定は OpenSim.ini の [Startup] セクションに書くこともできます。地域の設定が存在すれば、それは OpenSim.ini の設定を上書きします。
|-
|RegionType
|標準の Second Life ビューアで、地域/不動産 (Region/Estate) ダイアログの約款 (Covenant) に出てくる地域の種類 (Type) 。何に使うのかはよくわかりません。
|}

= OpenSimulator 0.6.7 から OpenSimulator 0.6.9 まで =
デフォルトでは、地域は bin/Regions ディレクトリ内の Regions.ini に設定値が格納されます。OpenSimulator のインストールをはじめて行うと、一通りの質問をして、最初の地域を設定してくれます。

Regions.ini の例です。

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
MasterAvatarFirstName = Justin
MasterAvatarLastName = Clark-Casey
MasterAvatarSandboxPassword = yeahokay

この表は、Regions.ini の項目とセットアップ時の質問の関係を示しています。それぞれの質問に関する詳細は、[[設定#OpenSimulator を最初に起動する]]を参照してください。

{| cellspacing="0" cellpadding="5" border="1" align="center" class="sortable" width="90%"
|-
! 項目
! セットアップ時の質問
! 説明
|-
|[Big Fat Region]
|New region name
|地域の名前。
|-
|RegionUUID
|Region UUID
|地域の一意ＩＤ。
|-
|Location
|Region Location
|グリッドの中での地域の位置。
|-
|InternalAddress
|Internal IP address
|0.0.0.0 または固定 IP アドレス。
|-
|InternalPort
|Internal port
|クライアントの接続を受け付けるポート番号。
|-
|AllowAlternatePorts
|Allow alternate ports
|未使用。常に False 。
|-
|ExternalHostName
|External host name
|ルータの外部 IP アドレスまたは FQDN 。
|-
|MasterAvatarFirstName
|Master Avatar first name
|(0.6.9 以前) マスターアバターのファーストネーム。
|-
|MasterAvatarLastName
|Master Avatar last name
|(0.6.9 以前) マスターアバターのラストネーム。
|-
|MasterAvatarSandboxPassword
|Master Avatar sandbox password
|(0.6.9 以前) マスターアバターのパスワード。
|-
|}

他の地域を追加したい場合は、

* Regions.ini にセクションをもう１個追加します。
* bin/Regions に .ini ファイルを別途作成します。
* 古い形式の OpenSim.xml ファイルを作成します（OpenSimulator 0.6.7 でもまだ動作します）。
* もしくは、地域コマンドを地域コンソールで発行します（0.6.7 では少しバグがあるようですので、推奨しません）。

Region.ini に２個目の地域を追加する例です。

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
MasterAvatarFirstName = Justin
MasterAvatarLastName = Clark-Casey
MasterAvatarSandboxPassword = yeahokay
 
[Greek Wedding]
RegionUUID = 5c445740-6460-43d3-ba4c-444444445555
Location = 1000,1001
InternalAddress = 0.0.0.0
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
MasterAvatarFirstName = Justin
MasterAvatarLastName = Clark-Casey
MasterAvatarSandboxPassword = yeahokay

見ての通り、２番目の地域は Greek Wedding という名前で、違う UUID になっています。違う位置 (1000,1001) で違う InternalPort (9001) になっています。その他はまったく一緒です。

新しい UUID を作成するには、手作業でひねりだすか（例えば、[0-9][A-F] の範囲で文字を１個変える）、[http://www.famkruithof.net/uuid/uuidgen uuidgen webpage] にあるジェネレータを使用するかします。Unix では、 <tt>uuidgen</tt> コマンドを使用することもできます。

= OpenSimulator 0.6.6 以前 =
強力なジェネレータがここにあります: [[RegionGenerator]]

同じマシンで複数の地域を稼働させるには、'default.xml' ファイルのコピーを <tt>bin/Regions/</tt> ディレクトリに複数作成するだけでよいです。OpenSimulator コマンドプロンプトで <tt>create region</tt> と入力したり、<tt>share/regions</tt> にある <tt>make.php</tt> を使ったり、手作業でファイルを作成したりもできます。

手作業でファイルを作成したい場合は、

:default.xml ファイルのコピーを <tt>bin/Regions</tt> ディレクトリに作成し、なんでもいいので名前をつけます（私は自分のファイルに region.x.y.xml とつけます。region が地域の名前で、x と y がグリッド座標です。）
:それぞれの xml ファイルを開き、UUID （ジェネレータが [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage] にあります。または Unix では、uuidgen コマンドを使います）、地域の名前、XY 座標、内部 IP ポート番号を編集します。

'''重要！''' 地域の作成方法にかかわらず、地域の UUID 、名前、グリッド座標はグリッドの中で一意でなければなりません。ポート番号はマシンの中で一意でなければなりません。内部 IP ''アドレス'' や外部ホスト名は全ての地域で同じでなければなりません。

ちなみに、地域を連結させたいときは、<tt>sim_location_x</tt> や <tt>sim_location_y</tt> は隣りあった番号にしなければなりません。そうすれば地域の間を行ったり来たりできます。 '''重要: これらのグリッド座標はメートルではありません。SIM の位置です。''' (1000, 1000) は (1001,1000) 、(1000, 1001) などと隣りあわせになります。1256, 2000, 2048 を指定すると 1000 とは隣りあわせとならず、かなり遠く離れたところになり、お互いの SIM から見えることはありません。

２個以上の xml ファイルが bin/Regions フォルダにあれば、<tt>OpenSim.exe</tt> を１個起動させれば全ての SIM が起動するようになります！エラーが発生したら、 xml ファイルの記述が間違っている可能性が高いです。

{{DEFAULTSORT:ちいきのせってい}}

[[Category:Japanese Translations]]

動作環境

2012-03-04T07:07:50Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Dependencies}}

OpenSimulator バイナリを動かすためには、OpenSimulator コードだけでなく、他のパッケージをいくつかインストールする必要があります。
依存関係（動作環境）に関するより詳細な情報は、このページにだけでなく（ここの情報は将来拡充されるはずです）、[[ビルド手順]] にも掲載されていますが、そのページにはビルドにだけ関連する依存関係も載っています。[[トラブルシューティング]] にもヒントが載っています。

依存関係を解決してもさらに、ファイアウォールの外側にあるビューアから内側の OpenSimulator にアクセスできるようにするために、システムにデフォルトでインストールされているファイアウォールの設定も直さなければならないかもしれません。

= Windows =

OpenSimulator は現在 Windows 環境でさせる場合は、'''.NET Framework 3.5''' が必須となっています。'''Windows 7''' や '''Windows Server 2008 R2''' で OpenSimulator を動作させる場合は、既に入っていますので OpenSimulator 0.7.1 はそのまま動かせます。'''Windows Vista''', '''Windows Server 2008''', '''Windows Server 2003''', '''Windows XP''' で動作させる場合は、3.5 (以降、ただし、.NET Framework 4.0 はまだ OpenSimulator で正式にはサポートされていません) にアップデートする必要があります。[http://msdn.microsoft.com/ja-jp/netframework/cc378097 Microsoft .NET Framework 3.5 ダウンロード@.NET Framework デベロッパーセンター] からダウンロードできます。ちなみに、古いバージョンの Windows (NT や 2000 など) はサポートされていません。

Windows XP で動作させる場合は、必ず Service Pack 2 (SP2) 以上に更新してください。

以下のアプリケーションをダブルクリックするか、コマンドプロンプトで実行してください。
*32 ビット版 Windows: '''OpenSim.exe'''
*64 ビット版 Windows: '''OpenSim.32BitLaunch.exe'''
インストール時の状態によっては、管理者としてプログラムを実行しなければならないかもしれません(右クリック ->「管理者として実行」)。実行を許可するかどうかを問い合わせるダイアログが表示されますので、「続行」を選択します。

= Linux =

OpenSimulator は Mono 2.4.3 以降が必須です。'''注意:''' OpenSimulator は Mono 2.8.x, 2.10.0, 2.10.1 で、パフォーマンスとスケーラビリティに関する致命的な問題を抱えていることが明らかになっています。Mono 2.10.2 現在では、スケーラビリティに関する問題は修正されたようです。このため、2.6.x か 2.10.2 以降を使用すべきでしょう。2.4.3 でもいいですが、今となっては超古いです。

== Ubuntu ==

sudo apt-get install mono-complete

{{anchor|CentOS}}{{anchor|RedHat}}{{anchor|RHEL}}{{anchor|Fedora}}
== RHEL, Fedora, CentOS その他 RedHat 系のディストリビューション ==

まず、"yum info mono-core" を実行して、自分のディストリビューションのコアリポジトリに入っている Mono パッケージのバージョンを調べてみましょう。もし '''2.4.3''' 以降なら、[[#コアリポジトリからインストールする]] に進みましょう。そうでないなら、[[#Mono のリポジトリからインストールする]] にスキップしましょう。ディストリビューションによっては、yum リポジトリから現在取得可能なバージョンは要求されるバージョンより低いことがあります(例：CentOS は '''1.2.4''')。Ubuntu とは違い、RedHat 系のディストリビューションは常に保守的でなければならないため、リポジトリがなかなか更新されなくても不思議ではありません。この問題を解決するには、Mono のために別のリポジトリを追加します。

=== コアリポジトリからインストールする ===

以下のように入力してください。
<pre>
sudo yum install mono-core mono-data-sqlite mono-extras libgdiplus
</pre>
関連モジュールも一緒にインストールされます。これが済めば、mono で OpenSim.exe を普通に起動することができます。

=== Mono のリポジトリからインストールする ===

この手順は、CentOS 5.5, 5.6 と OpenSimulator 0.7.1 の組み合わせで検証しました。

yum の config ファイルフォルダに移動して、mono 用に新しいファイルを作成します。
<pre>
cd /etc/yum.repos.d
sudo vi mono.repo
</pre>

それから、mono.repo に次のように記述します。
<pre>
[mono]
name = novell-mono
baseurl=http://ftp.novell.com/pub/mono/download-stable/RHEL_5/
enabled=1
gpgcheck=0
</pre>

これで、このリポジトリから mono の新しめのバージョンを yum でインストールすることができるようになりました。ちなみに、全ての mono パッケージが (IA64 ではなくて) i386 になっているか確認してからインストールしてください。32 ビットマシンでは、この点を気にする必要はありません。またこの場合、".i386" が後ろになくても正しくインストールできます。
<pre>
sudo yum install mono-addon-core.i386 mono-addon-data.i386 mono-addon-data-sqlite.i386 \
mono-addon-extras.i386 mono-addon-web.i386 mono-addon-winforms.i386 mono-addon-libgdiplus0.i386
</pre>

mono は /opt/novell/mono にインストールされます。なので、/usr/bin にシンボリックリンクを貼っておくといいでしょう。
<pre>
sudo ln -s /opt/novell/mono/bin/mono /usr/bin/mono
</pre>

これで、OpenSim.exe をエラー無しで起動することができるようになるはずです。

== Debian ==

Debian 4 (Etch) の debian.org でのサポートは終了しました。5 (Lenny) 以降にアップデートしてから OpenSimulator を起動しましょう。詳細は、[http://www.debian.org/releases/lenny/i386/release-notes/ch-upgrading.html Upgrades from previous release@debian.org] を参照してください。

Debian 5 (Lenny) 以降では、次のように入力します。
<pre>
sudo aptitude install mono-gmcs libmono-microsoft8.0-cil \
libmono-system-runtime2.0-cil libmono-i18n2.0-cil
</pre>

aptitude でなく、apt-get を使用しても構いません。どちらのコマンドも、関連パッケージも一緒にインストールします。

Debian 5(Lenny), Debian 6(Squeeze), Debian 7(Wheezy) で検証しました。

== openSuSE ==

次のように入力します。
<pre>
sudo zypper install mono-core mono-data-sqlite mono-extras libgdiplus
</pre>
関連モジュールも一緒にインストールされます。これで、mono で OpenSim.exe を普通に起動できるようになります。

= Mac OS X =

Mono の '''Runtime''' パッケージを [http://www.go-mono.com/mono-downloads/download.html Mono ダウンロードサイト] から取得して、インストールするだけです。

OS X 10.4 を使用している場合は、X11 を 0S X インストール CD からインストールしなければなりません。OS X 10.5 以降では必要ありません。

= ロケールや地域に関する設定 =
OpenSimulator は英語のロケール・地域設定にて正しく動作します。英語以外の設定では、スクリプトの動作不良からクラッシュに至るまで、さまざまな問題が発生する可能性があります。

== Linux ==
Linux では、OpenSim.exe は、標準の "C" ロケールで起動するのが簡単です。[[トラブルシューティング#スクリプトエンジンの問題]] に説明があります:
<pre>
env LANG=C mono OpenSim.exe
</pre>

ロケールを変更する一般的なやり方についての詳細情報は、[[トラブルシューティング#ロケールの問題]] に掲載されています。

== Windows ==
Windows 標準のロケールが英語圏以外の場合、残念ながら、Linux のような簡単な対処方法はありません。OpenSimulator 用にユーザアカウントを新しく作って、言語設定を "English (US)" にして、
通常のユーザアカウントから、OpenSim.exe を runas コマンドで（もしくは、Shift キーを押しながらエクスプローラのアイコンを右クリックし、「別のユーザーとして実行」を選択）、先に作った OpenSimulator 用アカウントを選択します。

= 参考情報 =

OSGrid テクニカルサポートフォーラム。たくさんのインストールチュートリアルが載っています:  [http://osgrid.org/forums/viewforum.php?f=14 osgrid.org/forums/viewforum.php]

MONO プロジェクト:  [http://www.mono-project.com/Main_Page www.mono-project.com/Main_Page]
{{DEFAULTSORT:どうさかんきょう}}

[[Category:Japanese Translations]]

利用者向け説明書

2012-03-04T07:07:40Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|User Documentation}}

{{ambox
| type = content
| text = リンク先は日本語で記載されていない限り英語です。
}}


== パッケージ内容の日本語訳 ==
* [[日本語訳(README.txt)|README.txt]]
* [[日本語訳(BUILDING.txt)|BUILDING.txt]]
* [[日本語訳(OpenSim.ini.example)|bin/OpenSim.ini.example]]
* [[日本語訳(Robust.ini.example)|bin/Robust.ini.example]]
* [[日本語訳(StandaloneCommon.ini.example)|bin/config-include/StandaloneCommon.ini.example]]
* [[日本語訳(GridCommon.ini.example)|bin/config-include/GridCommon.ini.example]]
* [[日本語訳(FlotsamAssetCache.ini.example)|bin/config-include/FlotsamAssetCache.ini.example]]
* [[日本語訳(CenmoeAssetCache.ini.example)|bin/config-include/CenmoeAssetCache.ini.example]]


== 初期設定 ==
* [[ダウンロード]] - ダウンロードの方法
* [[動作環境]] - 言語（ロケール）設定、OpenSimulator に関連してインストールする必要のあるパッケージ
* [[ファイアウォール設定]] - ファイアウォールの内側にある OpenSimulator にビューアでアクセスできるようにする方法
* [[ビルド手順]] - ソースから OpenSimulator をビルド／コンパイルする方法
* [[設定]] - OpenSimulator サーバを稼働させるための設定方法
* [[地域の設定]] - Regions.ini で地域を設定する方法の詳細
* [[シミュレータ・パラメタの設定]] - シミュレータ・パラメタの構造と、初期セットアップが完了した後に設定を変更する方法の詳細
* [[Database Settings]] - データベースの接続に必要な設定の詳細
* [[Upgrading]] - データを残したまま OpenSimulator のバージョンを上げる方法
* [[トラブルシューティング]] - OpenSimulator インストールでつまずいたときの対処方法
* [[Tips]] - 虎の巻
* [[OpenSim Graphics]] - OpenSimulator ウェブサイトで使用されているグラフィック、ログインページ、作成物
* [[FAQ/ja]] - よくある質問

== 利用者向けガイド ==
* [[Connecting]] - 対応ビューアを使って OpenSimulator に接続する方法

== 管理者向けガイド ==
* [[サーバコマンド]] - OpenSimulator の運用コマンド
* [[Useful Queries]] - OpenSimulator データベースを操作する便利なクエリ
* [[Logging]] - OpenSimulator のログ機構
* [[Automating Tasks]] - 管理者が楽する方法（タスクの自動化）
* [[Network Settings]] - NAT、ポート、サービスなどなど
* [[RemoteAdmin]] - XMLRPC 管理インターフェースを使ったコマンドのリモート発行
* [[RestConsole/ja|REST コンソール]] - リモートコンソールの使用
* [[Performance]] - OpenSimulator のパフォーマンスチューニング
* [[Console-less OpenSim]] - OpenSimulator をコンソールを使わずに運用する方法
* [[Backups]] - OpenSimulator のデータをバックアップする方法

== 基本機能 ==
* [[Feature Matrix]] - OpenSimulator で現在実装されている機能の早見表
* [[LSL Status]] - LSL 関数の実装状況
* [[OpenSim Archives]] - OpenSimulator での地域データの保存／ロード
* [[Inventory Archives|OpenSimulator Inventory Archives]] - OpenSimulator でのユーザインベントリアイテム／フォルダの保存／ロード
* [[Custom Libraries]] - OpenSimulator サーバにカスタムコンテンツを追加する方法
* [[IRCBridgeModule]] - IRC とシミュレータを連携する OpenSimulator の基本モジュール
* [[ハイパーグリッド]] - 試験段階のハイパーグリッド・アーキテクチャを設定する方法
* [[GridInfo/ja]] - スマートクライアントにグリッド情報を提供する方法
* [[PhysicsEngines]] — OpenSimulator の物理エンジンのオプション
* [[Scripting Documentation]] - OpenSimulator のスクリプト大全とサンプルスクリプト一覧
* [[:Category:Tech Reference|Technical Reference]] - 技術用語集

== Optional Features ==
* [[Feature Proposals/AutoBackup|AutoBackup]] - 地域の OAR への定期バックアップを、ファイル名を変えながら自動的に行うモジュール
* [[Freeswitch Module]] - OpenSimulator でボイスチャットに FreeSWITCH を使う方法

== 試験段階の機能 ==
*[[メガ・リージョンの設定]]

== RealXtend ==
* [[ModRex]] - RealXtend サーバモジュールのセットアップ方法
* [[RealXtend Viewer Linux]] - RealXtend ビューアを Wine(Linux) 環境で使用する方法
* [[Naali Viewer Linux]] - Naali ビューアを Kubuntu 環境でコンパイルする方法

== チュートリアル ==
=== プラットフォーム依存 ===
* [[Linux Gridserver, the ubuntu way]] OpenSimulator を Ubuntu(Linux) 環境にとりあえずインストールする方法
* [[Wiiコントローラ]] - Wii リモコン／ヌンチャクを OpenSimulator ビューアで使用する方法 (Linux)
* [[Cacti]] - サーバの状態表示の生成に Cacti ツールと SNMP を使う方法 (Linux)
* [http://sunredbeach.com/dokuwiki/doku.php?id=opensim:minimal-server Installing an openSUSE 11.1 Minimal server setup for an OpenSimulator server] - openSUSE 11.1 サーバにとりあえずセットアップする方法

* [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - チュートリアル、ヒント集。Windows ユーザ向けですが、Linux ユーザでも使えます！

=== プラットフォーム共通 ===
* [[OSGrid Region Registration]] - OS-Grid に地域をリンクさせる方法
* [[Getting Started with Region Modules]] - OpenSimulator アプリケーション開発の初歩
* [[Building a bot]] - クライアント側で libomv を使ったボット設計の初歩
* [[pCampBot]] - 物理属性をもつ OpenSimulator ボット
* [[Using L3DT]] - カスタム地形を作成する方法
* [[Detailed cross-region terrain making]] - 地域をまたがった大きなカスタム地形を作成する手順
* [http://update.multiverse.net/wiki/index.php/About_Terrain 良い地形を作成する方法（4 つのプログラムつき）] (英語)
* [http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=8&lid=22 OpenSimulator サーバシステムを Linux 環境で構築する方法についての日本語マニュアル] （東京情報大学ネットワークシステム研究室）

== Gforge プロジェクト ==
* [[OpenSimSearch]] - Search for your OpenSimulator
* [[ServerStats]] - RRD/Proc serverstats using the OpenSimulator module for Berlios Serverstats (Linux)

<cleanpage title=hide cats=hide />
{{DEFAULTSORT:りようしゃむけ}}

[[Category:Japanese Translations]]

メガ・リージョンの設定

2012-03-04T07:07:30Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Setting Up Mega-Regions}}
{{ambox
| type = content
| text = 開発チームから挙がっている顕著な問題点がまだまだ残っています。既にある地域をメガ・リージョンに統合したい場合は、OARS ファイルを作成し、現時点で地域にあるコンテンツのフル・バックアップを取ってください。OAR ファイルから復元すると、リストアされた地域は南西の端だけにしか配置できません。これを執筆している現在、原因究明中です。最終更新日 2010 年 10 月 26 日}}

= レイアウト配置図 =

これは典型的な設定を図示したものです。これが全部ではないですが、地域のレイアウトを作成する際のよい見本になるでしょう。

'''注意事項''': ほとんどのビューアは、4096 のテレポートバグ、つまり、4096 を超える先の地域にはテレポートできないというバグを抱えています。OSGrid の中心点は 10000 10000 にあります。ビューアによっては、MeerKat や Imprudence など、最近になって修正されているものもあります。他のビューアも同様に修正してくる見込みです。このバグはハイパーグリッドでない地域だけでなく、ハイパーグリッドの地域にもあてはまります。

[[Image:MegaReg Layout.png|center|512x512px|Mega region Layout Example]]

= 手順 =

=== ステップ 0: 地域をバックアップしよう ===

OpenSimulator インスタンスにコンテンツがない場合は、この手順をスキップして [[#ステップ 1: "OpenSim.ini" ファイルを編集しよう]] に進みましょう。

地域にコンテンツがある場合は、統合するのは危険な行為となります。コンテンツを無くすことになるかもしれません。念のために、以下のことをやっておきましょう。

# データベースのバックアップを取りましょう。手順は [[Backups]] を参照してください。
# メガ・リージョンに統合する各地域の OAR ファイルを作成しましょう。手順は [[OpenSim Archives]] を参照してください。

=== ステップ 1: "OpenSim.ini" ファイルを編集しよう ===

OpenSim.ini を編集します。<nowiki>[Startup]</nowiki> セクションで、
<source lang="ini">
; CombineContiguousRegions = false
</source>
を
<source lang="ini">
CombineContiguousRegions = true
</source>
に変更してください。

=== ステップ 2: "Regions.ini" ファイルを編集しよう ===

"bin/Regions" にある Region.ini ファイルを編集します。

以下の [[#Regions.ini ファイルのサンプル]] にあるサンプルは、3x3 の 9 SIM からなるメガ・リージョンのものです。適宜埋めていきましょう。必ず Regions.ini の中で地域が'''南西から北東へ'''並ぶように書いていってください。

=== ステップ 3 : OpenSimulator を起動しよう ===

OpenSimulator を起動します。地域にコンテンツがない場合は、ここで完了です！ある場合は、

# エラーメッセージが大量に出ます。無視してください。
# コンソールの動きが止まるまで待ちます。それから、'''fix-phantoms''' と入力します。
# プロセスが完了するまで待ちます。バックアップスレッドが全てのバックアップを取得するのに数分かかることがあります。
# コンソールの動きが止まったら、'''backup''' と入力します。(念のため、データベースにデータを不揮発化します)
# OpenSimulator を再起動して、全てのオブジェクトが元通りの場所にあるか確認します。

参考情報: [http://www.metaverseink.com/blog/?p=28 Importing OARs into megaregions (Diva のブログ記事)]

= Regions.ini ファイルのサンプル =

<source lang="ini">
; 9SIM 3x3 メガ・リージョンの例
; 各地域に一意の UUID を振ってください。
; 各地域に一意の InternalPort を割り当ててください。
;
;************************************************
[RegionName_SW]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5000,5000
InternalAddress = 0.0.0.0
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;************************************************
[RegionName_W]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5000,5001
InternalAddress = 0.0.0.0
InternalPort = 9002
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;************************************************
[RegionName_NW]
RegionUUID = 84b41485-6884-412d-b4a2-2f6941559924
Location = 5000,5002
InternalAddress = 0.0.0.0
InternalPort = 9003
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
[RegionName_S]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5001,5000
InternalAddress = 0.0.0.0
InternalPort = 9004
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
[RegionName_Centre]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5001,5001
InternalAddress = 0.0.0.0
InternalPort = 9005
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;************************************************
[RegionName_N]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5001,5002
InternalAddress = 0.0.0.0
InternalPort = 9006
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
;
[RegionName_SE]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5002,5000
InternalAddress = 0.0.0.0
InternalPort = 9007
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
[RegionName_E]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5002,5001
InternalAddress = 0.0.0.0
InternalPort = 9008
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
[RegionName_NE]
RegionUUID = 00000000-0000-0000-0000-000000000000
Location = 5002,5002
InternalAddress = 0.0.0.0
InternalPort = 9009
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
</source>
{{DEFAULTSORT:めがりーじょん}}

[[Category:Japanese Translations]]

メインページ

2012-03-04T07:07:20Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{MainPageQuicklinks/ja|Main Page}}

{{Information}}

=== OpenSimulator とは何ですか？ ===
{{FrontPageSidebar}}

OpenSimulator は 3D のアプリケーションサーバです。これを使って仮想環境（仮想世界）を作成し、様々なクライアントや、複数のプロトコルからそれにアクセスすることができるようになります。 OpenSimulator で、適材適所のテクノロジーを使って独自の環境を構築することができます。 - 私たちは[[Getting Started with Region Modules|ロードモジュール]]を通じて建造物のあらゆる設定をカスタマイズできるように、ソフトウェアを設計しました。OpenSimulator は [[BSD License|BSD ライセンス]]の下でリリースされており、オープンソースでありながら、商用利用可能となっています。

難しい設定などは一切なしで、OpenSimulator を使って Second Life™ に似た仮想環境をシミュレートすることができます（クライアントも互換性があります）。他の環境、プロトコル、機能はアドオンモジュールを導入すると利用できます。利用可能なモジュールの一覧は、[http://forge.opensimulator.org/gf/ Forge サイト] にあります。

OpenSimulator はまだ'''アルファ版ソフトウェア'''とされていますが、たくさんの人々が[http://planet.opensim.us これを使ってわくわくするようなことをしています]。

=== 機能 ===
OpenSimulator は比較的新しいソフトウェアですが、既にたくさんの便利な機能が備わっています。
* １つのアプリケーションインスタンスの中に、複数の「世界」を作成できます。
* 複数のクライアントやプロトコルを使うことができます - 同じ世界に同じ時間に複数のプロトコルでアクセスできます。
* 自分のアバターを、カスタムメイドの服、スキン、装着オブジェクトで、めいいっぱいカスタマイズできます。
* ODE などの複数のエンジンの中から選択して、物理シミュレーションをリアルタイムで行うことができます。
* インワールドの建造ツールを使って、環境の中にコンテンツをリアルタイムで作成できます。"What you see is what you get"（見たものが、手に入るもの）です。
* LSL/OSSL, C#, VB.NET など数多くの言語で、インワールドアプリケーションを作成できます。

=== OpenSimulator を使う ===
OpenSimulator を使いはじめるのに一番手っ取り早い方法は、[http://osgrid.org OSGrid] にアカウントを作って、[http://opensim-viewer.sourceforge.net/ Hippo Viewer] か [http://secondlife.com/support/downloads.php Linden Lab の Second Life Viewer] （やその他のクライアント）をダウンロードして OSGrid に接続することです。このプロセスは 10 分もかからないうちに終わり、OpenSimulator がどのようなものか感じ取ることができるでしょう。

インターネット上に数多くある [[グリッドリスト|公共グリッド]] に簡単に接続することもできます。

また、スタンドアロンの OpenSimulator を Windows, Linux, Mac デスクトップ端末に[[ダウンロード]]して動かし、コンテンツを作成したり、見たりすることもできます。

=== 自分の OpenSimulator を動かす ===

自分の OpenSimulator サーバを動かして、独自の 3D 環境を運用してみたいと思ったら、以下のリンクのリンク先を見てみるとよいでしょう:

*[[ダウンロード|OpenSimulator の入手]] - [[日本語訳(README.txt)]]
*[[ビルド手順|OpenSimulator のビルド]] - [[日本語訳(BUILDING.txt)]]
*[[設定|OpenSimulator の設定と起動]]
*[[メガ・リージョンの設定]]
*[[サーバコマンド]]
*[[FAQ/ja|OpenSimulator の運用に関するよくある質問]]
*[[:Category:Tech Reference|技術用語集]]

=== OpenSimulator コミュニティに参加する ===
OpenSimulator は[http://en.wikipedia.org/wiki/Open_source オープンソース]プロジェクトで、コミュニティメンバーが時間と心血を注ぐことで成り立っています。色々な方法でコミュニティに参加・貢献できます:
* [http://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] に参加する - [irc://irc.freenode.net/opensim #opensim]（ユーザ）, [irc://irc.freenode.net/opensim-dev #opensim-dev]（開発者）, [irc://irc.freenode.net/opensim-scripts #opensim-scripts]
* メーリングリストに参加する - [https://lists.berlios.de/mailman/listinfo/opensim-users opensim-users]（ユーザ）, [https://lists.berlios.de/mailman/listinfo/opensim-dev opensim-dev]（開発者）.
* [[WikiStructure|この Wiki に寄稿し]]、OpenSimulator ドキュメントをより良いものにする。
* [[bugs|バグ]]を報告したり、[[Submitting code to OpenSim|パッチ]]を提供したり、[http://opensimulator.org/mantis/ Mantis バグトラッカー] にコンテンツを提供したりする。
* [http://forge.opensimulator.org Forge] や Web の[[Related Software|どこか]]で OpenSimulator に関連するプロジェクトを立ち上げる。 Forge にはたくさんのプロジェクトが登録されていますし、それは OpenSimulator コミュニティーをさらに発展させる素晴らしいやり方です。
* OpenSimulator の公開コンテンツの作成に参加する。詳細は [[Artist Home]] にあります。
* OpenSimulator についてブログを書く。そのブログを [irc://irc.freenode.net/opensim #opensim] でお知らせしてくれれば、[http://planet.opensim.us Planet OpenSim] に追加します。
* 毎週開催される OpenSimulator の[[Office Hours|オフィスアワー]]のどれかに参加する。現在、開発、Wiki 執筆、テストに関するオフィスアワーを毎週開催しています。

{{Layout_box2|1=
=== カテゴリ別のページ: ===
<b>
[[:Category:Japanese Translations|日本語に翻訳されているページ]], [[:Category:Getting_Started | さあはじめよう]] , [[:Category:Support | サポート]] , [[:Category:Tech Reference|技術用語集]] , [[:Category:Help|ヘルプ]] , [[:Category:Configuration|設定ページ]] , [[:Category:Users|ユーザページ]] , [[:Category:Development |開発ページ]] , [[:Category:Scripts|スクリプト]] , [[:Special:Recentchanges|最近の Wiki の変更]]</b><br />
}}

<cleanpage title=hide cats=hide />
{{DEFAULTSORT:めいんぺーじ}}

ファイアウォール設定

2012-03-04T07:07:10Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Firewall Settings}}

このページでは、各ＯＳ・ディストリビューションのファイアウォール設定について説明します。

= Widows =

== Windows Firewall ==

Server 2008, Vista, Windows 7 では、「セキュリティが強化されたWindowsファイアウォール」の設定を変更して、他のマシンのビューアからアクセスできるようにする必要があります。以下に手順を示します。

#[スタート]をクリックし、[コントロールパネル]をクリックします。コントロールパネルでは、[システムとセキュリティ]をクリックして[管理ツール]をクリックします。管理ツールでは、[セキュリティが強化されたWindowsファイアウォール]をダブルクリックします。また、スタートメニューの「ファイル名を指定して実行」のテキストボックスに WF.msc と入力して直接アクセスすることもできます。
#左の枠にある[受信の規則]を選択して、[操作]の枠の[受信の規則]の下にある[新規の規則]をクリックします。新規の受信の規則ウィザードが起動します。
#最初の'''規則の種類'''画面では、'''ポート'''を選択します。[次へ]をクリックして進みます。
#'''プロトコルおよびポート'''画面では、'''TCP''' を選択し、'''特定のローカルポート'''を選択して、'''9000''' と入力します(スタンドアロンの場合。グリッドモードの場合 '''8002''' になります)。[次へ]をクリックして進みます。
#'''操作'''画面では、'''接続を許可する'''を選択します。[次へ]をクリックして進みます。
#'''プロファイル'''画面では、何もいじらずに[次へ]をクリックして進みます。
#'''名前'''画面では、規則の名前と説明を入力します。[完了]をクリックしてルールを作成します。
#2 から 7 の手順を繰り返して '''UDP''' の規則も作成します。

== マカフィー・インターネットセキュリティ ==

マカフィー・インターネットセキュリティは特別に指定されない限り、アプリケーションがポートを監視することを許可していません。２つの対策があります。1) ファイアウォール・プロテクションを全部無効にしてしまう、または、2) <tt>OpenSim.exe</tt> がポートを開けるようにする、のいずれかです。

ファイアウォールを無効にする - McAfee SecurityCenter を開きます。「インターネットとネットワーク」を選択します。左下に「設定」という小さなリンクが表示されています。これをクリックします。ウィンドウの右側に、「ファイアウォールによる保護が有効です」と表示された項目があります。ここで「オフ」を選択します。

<tt>OpenSim.exe</tt> がポートを開けるようにする - McAfee SecurityCenter を開きます。「インターネットとネットワーク」を選択します。左下に「設定」という小さなリンクが表示されています。これをクリックします。ウィンドウの右側に、「ファイアウォールによる保護が有効です」と表示された項目があります。「詳細設定...」ボタンをクリックします。新しいウィンドウが出てきます。

新しいウィンドウの左側で、「プログラム許可機能」を選択します。ウィンドウの右側の真ん中あたりに、「許可されたプログラムを追加」ボタンがあります。開いたダイアログで OpenSimulator の実行ファイルを探して選択します。

最後に「OK」ボタンを押して McAfee SecurityCenter ウィンドウを閉じます。

= Linux =

== Ipconfig ==

root ユーザで 'iptables -L' を実行し、結果に何か規則らしきものが表示されたら、この手のファイアウォールがシステムで稼働しているということになります。リモートアクセスができるように変更するには、次のようにします。
<pre>
iptables -A INPUT -p tcp --dport 9000 -j ACCEPT
iptables -A INPUT -p udp --dport 9000 -j ACCEPT
</pre>
もしくは、ファイアウォールが chain を使用している場合(CentOS など)、次のようにします。
<pre>
iptables -I RH-Firewall-1-INPUT -p tcp --dport 9000 -j ACCEPT
iptables -I RH-Firewall-1-INPUT -p udp --dport 9000 -j ACCEPT
</pre>
それから、以下のコマンドを実行して変更を反映します。
<pre>
iptables-save
iptables-save > /etc/sysconfig/iptables
service iptables restart
</pre>

== SuSE Firewall2 ==

openSuSE の新規インストールを行うと、デフォルトでこの手のファイアウォールが稼働します。外部のビューアが OpenSimulator にアクセスできるようにするには、設定ファイルを編集します。
<pre>
sudo vi /etc/sysconfig/SuSEfirewall2
</pre>

このファイルの中に、"FW_SERVICES_EXT_TCP" と "FW_SERVICES_EXT_UDP" という行があります。次のように変更します。
<pre>
FW_SERVICES_EXT_UDP="9000" # スタンドアロンの場合 / グリッドモードの場合 "8002"
...
FW_SERVICES_EXT_TCP="9000" # 同上
</pre>
保存します。

最後に、設定再読み込みコマンドを実行します。
<pre>
sudo /sbin/SuSEfirewall2
</pre>
{{DEFAULTSORT:ふぁいあうぉーる}}

[[Category:Japanese Translations]]

ビルド手順

2012-03-04T07:07:00Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Build Instructions}}

このページでは OpenSimulator ソースコードを様々なプラットフォームでビルドする方法について説明しています。単に OpenSimulator を起動させたいだけなら、バイナリディストリビューションを [[ダウンロード]] して [[設定|起動]] しましょう。ほとんどの場合、バイナリディストリビューションで充分なはずです。

== OpenSimulator のダウンロード ==

OpenSimulator のソースリリースを入手する方法は、[[ダウンロード]] ページに記載されています。Git Master にある不安定なソースにどうしても興味のある方は、[[Using Git]] で取得方法を確認してください。ソースを取得したら、以下の手順でビルドしてください。

== 一般的な注意事項 ==

このページに長々と記載されてはいますが、ビルドは本来極めてシンプルなものです。配布物の中にある BUILDING.txt([[日本語訳(BUILDING.txt)|日本語訳]]) ファイルに、単純化した手順が記載されていますので見てください。このページではビルドの前にしないといけないことを説明しています。

=== 設定ファイルについて ===

バイナリディストリビューションと違い、OpenSimulator のソースディストリビューションにはデフォルトの設定ファイル、例えば、'''OpenSim.ini''' や '''StandaloneCommon.ini''' が入っていません。このため、自分で作成する必要があります。[[設定]] ページをよく確認して、''"APPLICATION EXCEPTION DETECTED: System.UnhandledExceptionEventArgs Exception: System.Exception: Configuration file is missing the [SimulationDataStore] section"''(= OpenSim.ini ファイルがない) や ''"Error loading plugin from OpenSim.Services.FriendsService.dll, exception System.Exception: No StorageProvider configured"''(= *Common.ini ファイルがない) で悩むようなことがないようにしましょう。

=== Linux での近道 ===

Linux で一番簡単に動作させることのできるプラットフォームは 32 ビット版 Ubuntu です。Linux を使っている開発者が一番使っているのがこれです。手っ取り早く動かす方法をお探しなら、[[#Ubuntu|こちら]] へどうぞ。

'''(Ubuntu を含む) 多くのディストリビューションでは、"mono-runtime" パッケージだけがインストールされた状態になっていますが、LSL スクリプトコマンドなど、OpenSimulator の一部の機能を動作させるためには、"mono-complete" をインストールする必要があります。'''

== MS Windows ==

OpenSimulator の動作には [http://msdn.microsoft.com/ja-jp/netframework/cc378097 .Net Framework version 3.5] または [http://www.go-mono.com/mono-downloads/download.html Mono 2.4.3 以降] が必要です。

=== サポートされているコンパイラ ===
* Visual Studio 2010
* Visual Studio 2008
:どのエディションでも動作するはずです。無料の [http://www.microsoft.com/japan/msdn/vstudio/express/ Microsoft Visual C# Express Edition] も使えます。OpenSimulator は C++ でなく、C# で書かれていますのでご注意ください。
:Visual Studio 2005 以前はもうサポートされていません([http://www.mail-archive.com/opensim-dev@lists.berlios.de/msg02674.html opensim-dev で提案されたときのメール], [http://www.mail-archive.com/opensim-dev@lists.berlios.de/msg02673.html opensim-dev で承認されたときのメール])。
*[http://www.go-mono.com/mono-downloads/download.html Mono for Windows]

=== IDE でのコンパイル ===
# "runprebuild.bat" (2008 の場合) か "runprebuild2010.bat" (2010 の場合) を実行してください。
# 生成された "OpenSim.sln" を Visual Studio で開きます。
# [ビルド] (または [デバッグ]) -> [ソリューションのビルド] を選択します。

=== コマンドプロンプトでのコンパイル ===
# "runprebuild.bat" を実行します。
# 生成された "compile.bat" を実行するか "nant" を実行します。MSBuild(前者)かnant(後者)を使ってビルドが行われます。

=== 補足 ===

* 64 ビット版 Windows(Vista, Windows 7 ...) でも OpenSimulator を起動できますが、Visual Studio でデバッグする場合は、OpenSim.32BitLaunch をソリューションに追加して、スタートアッププロジェクトに設定しなければなりません。詳細は [http://blog.tedd.no/2008/12/05/opensim-in-visual-studio-on-win64/ OpenSimulator in Visual Studio on Win64@Tedds blog] を確認してください。

*Cygwin シェルを使っている場合、"<tt>chmod 755 *.dll *.exe</tt>" を <tt>bin</tt> ディレクトリで実行して DLL のパーミッションに関する問題を解決しなければならないことがあるかもしれません。

== Mac OS X ==

=== Mac OS X 10.5 以降, Intel ===

以下をダウンロードして、インストールするだけです。
* Mono SDK from [http://www.go-mono.com/mono-downloads/download.html Mono Download Page]
* MonoDevelop package from [http://monodevelop.com/Download MonoDevelop Download Page]
XCode や MacPort は今では不要となっています(MacPort で mono の開発ライブラリと nant をインストールしても別に構いませんが)。

nano で OpenSimulator をビルドする場合、"Unable to locate 'mono' module using pkg-config. Download the Mono
development packages" というエラーが表示される場合があります。XCode や MacPort が悪さしているのではないかと疑っています(これらを両方とも削除したらうまくいったので)。まあ原因はどうだっていいのですが、'''/usr/bin/nant''' スクリプトファイルに以下の行を入れて、この問題に対処しましょう。
<pre>
#!/bin/sh
export PKG_CONFIG_PATH=/Library/Frameworks/Mono.framework/Libraries/pkgconfig # これを追加
exec /Library/Frameworks/Mono.framework/Versions/2.10.2/bin/mono \
/Library/Frameworks/Mono.framework/Versions/2.10.2/share/NAnt/bin/NAnt.exe "$@"
</pre>

"runprebuild.sh" を実行した後、OpenSimulator を MonoDevelop でコンパイルすることができます。ソリューションファイル (*.sln) を MonoDevelop で開き、メニューから Build -> Build All を選択してください。

=== Mac OS X 10.4/10.5 on PowerPC ===
{{ambox
| type = content
| text = 未翻訳です。Intel とほぼ同じような手順でビルドできるはずです。mono のダウンロードページに PowerPC 用のパッケージが用意されているので、そちらのほうを使います。原文は [[Build Instructions#Mac OS X 10.4/10.5 on PowerPC|こちら]] です。
}}


== Ubuntu ==

(7.10, 8.04, 9.10 など) 古いディストリビューションを使っている Ubuntu ユーザは、 mono を 2.4.3 以降にアップグレードする必要があります。Mono をアップグレードする必要がある場合は、[[Update Mono on Ubuntu]] を参照してください。

Ubuntu Karmic (9.10) には mono 2.4.2.3 が入っています。

Ubuntu Lucid (10.04) には mono 2.4.4 が入っています。

Ubuntu Maverick (10.10) には mono 2.6.7 が入っています。

Ubuntu Natty (11.04) には mono 2.6.7 が入っています。

=== Ubuntu 10.04 以降 ===

このバージョンでは、mono-complete をインストールするだけで大丈夫です。動作に必要な関連パッケージは一緒にインストールされます。まとめると、ビルドの手順はこうなります。
sudo apt-get install mono-complete
opensim を[[ダウンロード]]
cd opensim
./runprebuild.sh
xbuild

mono 2.6 系の時点では、xbuild で OpenSimulator を完全にビルドすることができます。xbuild は Ubuntu の '''mono-complete''' に含まれていますので、xbuild より nant を使いたいという特段の理由がなければ、他のパッケージをインストールする必要はありません。この２つは、同じ C# コンパイラをそれぞれ別のビルドスクリプト形式で呼び出す別々のビルドシステムです。

'''オプション (開発者向け):''' レグレッションテストスイートを実行するには、このように nunit-console をインストールします。

sudo apt-get install nunit-console
nant test

{{anchor|CentOS}}{{anchor|RedHat}}{{anchor|RHEL}}{{anchor|Fedora}}
== RHEL, Fedora, CentOS その他 RedHat 系 ==

OpenSimulator のバイナリディストリビューションを動かせるような状態で OpenSimulator をソースからビルドするには、mono の開発ライブラリと nant をインストールする必要があります。以下の両方の項を参照してください。

=== Mono ライブラリの取得 ===

[[動作環境#RedHat|OpenSim.exe バイナリディストリビューションを動作させたときに]]、Mono を自分のディトリビューションのコアリポジトリからインストールした場合は、以下のように入力すれば大丈夫です。
<pre>
sudo yum install mono-devel
</pre>

そうでない場合は、次のように入力します([[動作環境#Mono のリポジトリからインストールする|Mono 用の yum リポジトリの設定が済んでいる前提です]])。
<pre>
sudo yum install mono-addon-devel
</pre>

どちらのコマンドも、関連パッケージを一緒にインストールします。

=== NAnt のインストール ===

"yum info nant" を実行して、nant のバージョンを確認しましょう。見つかったら、次のように入力すれば大丈夫です。
<pre>
sudo yum install nant
</pre>
これで、nant を普通に実行できます。

yum リポジトリに nant がなかった場合、もしくは、OpenSimulator を動作させるのにはあまりも古すぎると感じた場合は、NAnt を [http://nant.sourceforge.net/ NAnt プロジェクトサイト] から取得してください。そこにある User Manual に詳細な手順が載っています。0.90 時点では、スタートアップスクリプトを以下のように作成します(NAnt を /usr/local/nant に展開したという前提です)。
<pre>
sudo vi /usr/bin/nant
</pre>
ファイルの中には、このように書きます。
<pre>
#!/bin/sh
exec mono /usr/local/nant/bin/NAnt.exe "$@"
</pre>
それから、実行権限をつけます。
<pre>
sudo chmod +x /usr/bin/nant
</pre>

これで、runprebuild.sh を実行して OpenSimulator を nant でビルドすることができるようになります。

== openSUSE ==

次のように入力します。
<pre>
sudo zypper install nant
</pre>
それから、runprebuild.sh と nant を実行します。関連パッケージも一緒にインストールされます。

== FreeBSD ==

FreeBSD 6.2 では、次のようにします。

su
cd /usr/ports/devel/subversion/ && make install clean (you may also need to rebuild apr-svn if this step fails)
cd /usr/ports/lang/mono/ && make install clean
cd /usr/ports/devel/nant/ && make install clean
cd /usr/ports/databases/sqlite3/ && make install clean
cd /usr/ports/x11-toolkits/libgdiplus/ && make install clean
cd /opensim/installation/directory/
[[Download]] opensim
cd opensim
./runprebuild.sh
nant

注) "System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so" 問題の対応方法は、[[トラブルシューティング#System.DllNotFoundException: ..2Flibopenjpeg-libsl-2.1.2.0.so|トラブルシューティングの手順]] の通りですが、 "make" ではなく "gmake" を使ってください。

ODE 物理エンジンでは、次の手順を実行します:
cd /usr/ports/graphics/libGL/ && make install clean
cd /usr/ports/graphics/libGLU/ && make install clean
cd /opensim/installation/directory/
svn co http://opensimulator.org/svn/opensim-libs/trunk opensim-libs
cd opensim-libs/unmanaged/OpenDynamicsEngine2/
sh autogen.sh
./configure --enable-shared --enable-release --disable-demos
make
mv ./ode/src/.libs/libode.so /opensim/installation/directory/opensim/bin/

== Debian ==

Debian 4 (Etch) の debian.org でのサポートは終了しました。5 (Lenny) 以降にアップデートしてから OpenSimulator を起動しましょう。詳細は、[http://www.debian.org/releases/lenny/i386/release-notes/ch-upgrading.html Upgrades from previous release@debian.org] を参照してください。

Debian 5 (Lenny) 以降では、次のように入力します。
<pre>
sudo aptitude install nant
</pre>
それから、runprebuild.sh と nant を実行します。aptitude でなく、apt-get を使用しても構いません。どちらのコマンドも、関連パッケージも一緒にインストールします。

Debian 5(Lenny, 以前の安定版), Debian 6(Squeeze, 安定版), Debian 7(Wheezy, テスト版) で検証しました。

{{DEFAULTSORT:びるど}}

[[Category:Japanese Translations]]

ハイパーグリッドのインストールと運用

2012-03-04T07:06:51Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Installing and Running Hypergrid}}

== ハイパーグリッドモードでの OpenSimulator のインストールと運用 ==
ハイパーグリッドのセットアップは OpenSimulator をスタンドアロンモードで動かしているかグリッドモードで動かしているかによって違います。バージョン 0.7 でもかなり変わっています。0.6.x の古いバージョンの OpenSimulator シミュレータを使っている場合は、このページの下のほうにある [[#OpenSimulator 0.6.x での設定]]を参照してください。

== 設定 ==
OpenSimulator シミュレータをハイパーグリッドからアクセスできるようにするには、外部から参照できる IP アドレスかドメイン名を使う必要があります。また、OpenSimulator シミュレータや地域が使う全てのポート (TCP と UDP) にポートフォワーディングを設定しないといけないかもしれません。通常は、グリッドモードでインストールすると 8002, スタンドアロンでは 9000 となります。地域は通常 9000 以降のポートを使います。詳細は、[[Network Settings]] を参照してください。

=== スタンドアロン ===
ハイパーグリッドの設定は OpenSim.ini の [Architecture] セクションで行われます。Include-HGStandalone の行のコメントだけを解除するようにしてください。
<source lang="ini">[Architecture]
;Include-Standalone = "config-include/Standalone.ini"
Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
;Include-Grid = "config-include/Grid.ini"
;Include-HGGrid = "config-include/GridHypergrid.ini"
;Include-SimianGrid = "config-include/SimianGrid.ini"</source>

StandaloneCommon.ini では、[LoginService] と [GatekeeperService] セクションのネットワークアドレスを外部ネットワークアドレスに変更してください。
<source lang="ini">[LoginService]
; ... (このセクションの他の設定) ...
HomeURI = "http://example.com:9000"
GatekeeperURI = "http://example.com:9000"
InventoryServerURI = "http://example.com:9000"
AssetServerURI = "http://example.com:9000"

[GatekeeperService]
; ... (このセクションの他の設定) ...
ExternalName = "http://example.com:9000"</source>

これらのアドレスに違うポートを使いたいときは、OpenSim.ini の [Network] セクションにある HTTP リスナーポートの設定も修正してください。
<source lang="ini">[Network]
; ... (このセクションの他の設定) ...
http_listener_port = 9000
</source>

最後に、今までに変更した設定に応じて地域設定を修正してください。[[#グリッド・スタンドアロン共通の地域設定]] を参照してください。

=== グリッドモード ===
グリッドモードでハイパーグリッドを使えるようにするには、Robust サーバと地域サーバ（シミュレータ）の設定を修正する必要があります。

==== Robust サーバ ====
Robust サーバは Robust.ini の代わりに Robust.HG.ini ファイルを使って起動します。このファイルがインストールパッケージに含まれていない場合は、Robust.HG.ini.example をコピーして作成してください。動作環境に合わせて適切な変更を行ってください（例：データベースの接続文字列の修正）。ハイパーグリッドには、次の設定項目が関連します。

<source lang="ini">[LoginService]
; ... (このセクションの他の設定) ...
HomeURI = "http://example.com:8002"
GatekeeperURI = "http://example.com:8002"
InventoryServerURI = "http://example.com:8002"
AssetServerURI = "http://example.com:8002"

[GatekeeperService]
; ... (このセクションの他の設定) ...
ExternalName = "http://example.com:8002"
</source>

これらのアドレスに違うポートを使いたいときは、[Startup] セクションの ''''ServiceConnectors'''' パラメタにあるポート番号を修正する必要があります。また、[Network] セクションにあるポート番号も修正しなければならないでしょう。

これらの修正が終わったら、Robust サーバを起動できます。Windows/.NET では、次のようにします。
Robust -inifile=Robust.HG.ini
Mono (例：Linux や OSX) では、次のようにします。
mono Robust.exe -inifile=Robust.HG.ini

==== シミュレータ ====
Robust サーバに接続する地域サーバ（シミュレータ）は OpenSim.ini ファイルから設定を読み込みます。ハイパーグリッドを有効にするには、[Architecture] セクションの Include-HGGrid の行のコメントを外してください。
<source lang="ini">[Architecture]
;Include-Standalone = "config-include/Standalone.ini"
;Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
;Include-Grid = "config-include/Grid.ini"
Include-HGGrid = "config-include/GridHypergrid.ini"
;Include-SimianGrid = "config-include/SimianGrid.ini"
</source>

=== グリッド・スタンドアロン共通の地域設定 ===
最後に、全ての地域が同じ外部ネットワークアドレスを使う必要があります。これは GatekeeperService に設定します。例えば、次のようにします。
<source lang="ini">[Region One]
; ... (このセクションの他の設定) ...
ExternalHostName = "example.com"
</source>

地域が使うポートに到達できるように、ネットワークを保護するファイアウォールは TCP と UDP のリクエストを通さなければなりません。

== OpenSimulator 0.6.x での設定 ==

=== インストール ===

OpenSimulator をチェックアウトし、プレビルド・ビルドを通常通り行うか、バイナリパッケージを [[メインページ]] からダウンロードします。OpenSimulator を他のマシンと一緒にグリッドモードで運用している場合、OpenSim.ini を修正してハイパーグリッドを有効にするだけでいいです。

スタンドアロンで運用していてネットワーク接続ができるようにしたい場合、またはループバックアドレス (127.0.0.1) でグリッドを運用している場合、[Network] セクションの全てのサーバアドレスを変更しなければなりません。以下を参照してください。

=== Network セクションの例 ===

==== スタンドアロンのネットワーク設定の標準的な例 ====

<source lang="ini">[Network]
http_listener_port = 9000

grid_server_url = "http://example.com:9000"

grid_send_key = null
grid_recv_key = null

user_server_url = "http://example.com:9000"

user_send_key = null
user_recv_key = null

asset_server_url = "http://example.com:9000"

inventory_server_url = "http://example.com:9000"
messaging_server_url = "http://example.com:9000"</source>

==== グリッドサーバのネットワーク設定の標準的な例 ====

<source lang="ini">[Network]
http_listener_port = 9000

grid_server_url = "http://example.com:8001"
grid_send_key = null
grid_recv_key = null

user_server_url = "http://example.com:8002"
user_send_key = null
user_recv_key = null

asset_server_url = "http://example.com:8003"
inventory_server_url = "http://example.com:8003"
messaging_server_url = "http://example.com:8006"</source>

==== OSGrid に接続しているサーバのネットワーク設定 ====

<source lang="ini">[Network]
http_listener_port = 9000
grid_server_url = "http://osgrid.org:8001" ;デフォルト 8003
grid_send_key = "1234"
grid_recv_key = "1234"

user_server_url = "http://osgrid.org:8002"
user_send_key = "1234"
user_recv_key = "1234"

asset_server_url = "http://assets.osgrid.org:8003"
inventory_server_url = "http://osgrid.org:8004" ;デフォルト 8003
messaging_server_url = "http://osgrid.org:8006"</source>

==== ハイパーグリッドを有効にするには、OpenSim.ini の修正が必要です ====

- OpenSim.ini の上のほうにある以下の行を変更します。
<pre>hypergrid = false → true</pre>
- ### それから、WORLD MAP セクションを追加修正して次のようにします。

<source lang="ini">; ##
; ## WORLD MAP
; ##

WorldMapModule = "WorldMap"
MapImageModule = "MapImageModule"
WorldMapModule = "HGWorldMapModule" ;この行は OpenSim.ini.example にはありません</source>

''※ HGWorldMapModule は、他のグリッドにテレポートした後、元いたグリッドから残っている地図のタイルを除去します。''

- それから、下の方の [Archictecture] セクションを修正します。

対応する Include-HG* = の行のコメントを外し、コメントが外れている行が１個だけになるようにします。（下の例は、スタンドアロンでハイパーグリッド対応する場合）

<source lang="ini">[Architecture]
;Include-Standalone = "config-include/Standalone.ini" ; デフォルトではコメントアウトされていません
Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
;Include-Grid = "config-include/Grid.ini"
;Include-HGGrid = "config-include/GridHypergrid.ini"</source>
これで OpenSimulator シミュレータは内向き・外向きともにハイパーグリッドが使えるようになります。

== 4096 の地域制限 ==
ビューアの制約により、4096 個以上の地域をまたがったテレポートはうまくいきません。ほとんどのビューアがテレポートを実行しますが、テレポート先の地域が表示されないため、いつまで経っても見ることができません。具体的な例を出すと、(1000, 1000) の地域にいる場合、(5095, 5095) よりも離れた地域にテレポートすることができません。遠くの地域にテレポートするには、自分の地域をテレポート先の近くに置くか、テレポート元・先両方の地域からテレポートできるような中継地域を使う必要があります。

[[Public Hypergrid Nodes]] で有名なグリッドやスタンドアロンを参照し、これらがどこにあるかを調べてみましょう。

== 重要事項 ==
必ず「ホーム」を設定しておいてください。ホームの地域がない場合、ハイパーリンクのテレポートは動作しないことがあります。ホームを設定するには、ローカルの地域のどれかに行き、ビューアで「ホームをここに設定」を選択します。

地域、スタンドアロン、ハイパーグリッド間などのテレポートをスクリプトで行うには、osTeleportAgent 関数を使います。例は右のリンク先にあります：[[OsTeleportAgent]]

== 地域同士をリンクする (オプション) ==

=== 方法その１ ===

コンソールで、次のように入力します。
<pre>link-region <Xloc> <Yloc> osl2.nac.uci.edu:9006</pre>
Xloc と Yloc は遠すぎず、近すぎず、自分の空間に適した値にしてください。<br />
osl2.nac.uci.edu と 9006 には、リンクしたい地域のあるシミュレータのドメイン名／IP アドレスと http_listener_port が入ります。１つのインスタンス上で動作する地域を指定してリンクすることもできます。下の例のように、地域の名前を最後に付け加えます。
<pre>link-region 997 997 osl2.nac.uci.edu:9006:UCI Welcome</pre>

=== 方法その２ ===

XML ファイルからのリンクの読み込みもサポートするようになりました。

コンソールコマンドを使います: link-region <URI> [<excludeList>]

URI にはローカルにある XML ファイルか HTTP サーバにある XML 文書のパスが入ります。

XML ファイルの書式：

<source lang="xml"><Nini>
<Section Name="Region1">
<Key Name="xloc" Value="1002"/>
<Key Name="yloc" Value="1006" />
<Key Name="externalPort" Value="9006" />
<Key Name="externalHostName" Value="osl2.nac.uci.edu" />
<Key Name="localName" Value="OSGrid-Gateway" />
<Key Name="real-xloc" Value="10222"/> //元のグリッドにおける実際のロケーション（任意）
<Key Name="real-yloc" Value="10265" /> //元のグリッドにおける実際のロケーション（任意）
</Section>
<Section Name="Region2">
...
</Section>
...
</Nini></source>

[注意] セクションの名前 (Section Name) は何でもよいですが、一意でなければならず、名前の中に空白があってはいけません。

==== ExcludeList:(除外リスト) ====

除外リスト(Exclude List)は１つの文字列引数で、次のような書式となります。
excludeList:<SectionName>[;<SectionName>]

XML ファイルから読み込む際、リストに記載されたセクションは全て無視され、ハイパーグリッドへのリンクは生成されなくなります。

この仕組みにより、Web サーバにリンクリストを作って、誰でも自分の地域を追加できるようになります。その際は、必ず自分自身のセクション名を自分の地域の除外リストに追加しなければなりません。

例えば、OpenSimulator の２回目の誕生日に向けて、誰かがオンラインで編集可能なリストを作ったとします。このような感じでしょうか。
<source lang="xml"><Nini>
<Section Name="OSGrid-Party">
<Key Name="xloc" Value="1002"/>
<Key Name="yloc" Value="1006" />
<Key Name="externalPort" Value="9006" />
<Key Name="externalHostName" Value="osl2.nac.uci.edu" />
<Key Name="localName" Value="OSGrid-Gateway" />
</Section>
<Section Name="UCIGrid-Party">
...
</Section>
</Nini></source>
こうすると、自分の地域を "MW-Party" というセクション名で登録できます。その後、ハイパーグリッドへの参加を希望する当該地域を起動するときに、次のコマンドを使います。
<pre>"link-region <XML ファイルの URI> excludeList:MW-Party"</pre>
これで、自分の地域は自分自身へのハイパーリンクを作成しようとしなくなります。

=== 方法その３ (動的リンク) ===

r8193 から、ハイパーグリッド対応地域にいると、下に書いた方法のどれかで（もっとありそうですが）、SIM に動的にリンクを貼ってテレポートすることができるようになります。下のほうにあるリストで調べるなどして、目的地のアドレスさえわかれば大丈夫です。

1) チャット画面から secondlife://ucigrid04.nacs.uci.edu:9007/ などと入力して、チャット履歴を表示してリンクをクリックします。

2) 世界地図を開いて検索窓に ucigrid04.nacs.uci.edu:9007 のように入力します。

3) 内蔵ブラウザを使って '''secondlife://ucigrid04.nacs.uci.edu:9007'''/ のようなリンクがあるページ（http://www.ics.uci.edu/~lopes/hypergrid/test.html など）にアクセスします。

ここでも、右のような感じで、１つのインスタンス上で動作する地域を指定してリンクすることができます。 '''secondlife://ucigrid04.nacs.uci.edu:9007:Gateway 7000/'''

=== 4096 の地域制限をチェックする ===
[[#4096 の地域制限|4096 の地域制限]]により、0.7.0.1 からは、作成しようとしているリンクが１つ以上の自分の地域からアクセスできるか OpenSimulator シミュレータで検証されるようになりました。リンクしようとしている地域から 4096 以内の距離に、自分のグリッドやスタンドアロンの地域が１つもないと、リンクは却下されます。StandaloneCommon.ini（スタンドアロンの場合）や Robust.HG.ini（グリッドの場合）で、このチェックを行わないようにすることができます。
<source lang="ini">[GridService]
Check4096 = false</source>

=== 地域の永久リンク ===
グリッドモードでは、方法その１とその２は Robust コンソールでも地域コンソールでも動作します。地域コンソールでは、リンクされた地域はデータベースに格納されず、地域がシャットダウンされると設定が消えます。Robust コンソールでリンクされた地域は unlink-region コマンドで明示的に解除されない限り再起動しても残ります。

== リンクされている地域を一覧で表示する ==

リンクされている全ての地域の一覧を表示するには、コンソールで次のコマンドを実行してください（0.7.1 r/13457 以降で利用可能。0.7-post-fixes でも可）。
<pre>show hyperlinks</pre>

== 地域のリンクを解除する ==

コンソールで次のように入力してください。
<pre>unlink-region osl2.nac.uci.edu:9006</pre>
または
<pre>unlink-region <local region name></pre>

データベースに MySQL を使っている場合、地域の名前は 32 文字までしか入りません。リンクされている地域の名前がそれよりも長い場合は、丸められます。名前が 32 文字に丸められると、リンク解除コマンドは１つの地域しか検索しません。

== 参考情報 ==

実装された OSSL 関数: [[OSSL Implemented]]

利用可能な OSSL 関数: [[OSSL Enabling Functions]]

ハイパーグリッドのセキュリティ: [[Hypergrid Security]]

ハイパーグリッドでの外部ユーザの BAN: [[Banning Foreign Users in Hypergrid]]

ハイパーグリッドの公共ノード一覧: [[Public Hypergrid Nodes]]

ハイパーグリッドのインベントリアクセス: [[Hypergrid Inventory Access|Hypergrid Inventory Access (proposal)]]

{{DEFAULTSORT:はいぱーぐりっどのいんすとーる}}

[[Category:Japanese Translations]]

ハイパーグリッド

2012-03-04T07:06:41Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks/ja|Hypergrid}}
<br />

== OpenSimulator のハイパーグリッド(HyperGrid) ==

こちらもご覧ください [[Grider]]; [[Virtual World Model]]; [[HyperGrid Team]]

=== ハイパーグリッドとは何ですか？ ===


ハイパーグリッドは OpenSimulator の拡張機能で、これを使うことでインターネット上の他の OpenSimulator へリンクし、エージェント (Agent) をシームレスにこれらの OpenSimulator へ移動させることができるようになります。この機能はスタンドアロンモードでもグリッドモードでも使用できます。ハイパーグリッドは仮想空間がウェブへ登場するために大きく貢献しています。

ハイパーグリッドの基本的な概念は、地域／グリッドの管理者が他人が運営するハイパーグリッド地域のハイパーリンクを自分のマップ上に作成する、というものです。ハイパーリンクが作成されると、ユーザは自分の地域と同じようにリンク先の地域とも交流できます。具体的にいうと、ユーザはその地域へテレポートすることができます。ユーザがハイパーリンク先の地域に到着すると、元々いた空間からログアウトせずにそのまま他の仮想空間に触れることになります。また、自分のインベントリには今まで通りアクセスできます。

ハイパーグリッドは GForge プロジェクトとして始まりましたが、今では OpenSimulator の標準パッケージに組み込まれています。OpenSimulator をハイパーグリッドモードで運用したい場合は、[[Installing and Running Hypergrid|Installing and Running]] を参照してください。

=== 仮想空間のハイパーリンク ===
[[Image:hghyperlink.jpg|250px|thumb|A Virtual World Hyperlink]]

ウェブのハイパーリンクはみなさんおなじみです。しかし、仮想空間のハイパーリンクとは何でしょうか？

ハイパーグリッド・モデルでは、仮想空間の 2D マップをウェブページと同じように考えます。仮想空間のハイパーリンク自体は、マップ上の１つの地域を指します。

OpenSimulator をベースとした仮想空間の基本モデルでは、既にハイパーグリッドの概念をいくらか取り入れています。マップを使って別の地域にテレポートすると、自分のエージェントが他の OpenSimulator サーバに移動する可能性があります。この移動は「エージェント転送 (Agent Transfer)」という立派な名前で、既に稚拙ながらウェブに存在しているものです。ハイパーリンクが参照されたときに発生します。ただし、基本モデルでは、ハイパーリンクには２つの厳しい制約が課せられています。
# 地域のマップ全体をグリッドサービス(Grid Service)として知られるセントラルサービス(Central Service)で管理すること。このサービスで、空間の全体像を全ての地域に提供すること。
# 転送可能なエージェントは、ユーザサービス(User Service)と呼ばれる他のセントラルサービスが知っているユーザのものであること。入ってくるユーザの情報がユーザサービスのデータベースに存在しなければ、エージェントの転送を行わない。

ハイパーグリッドは、単にこれらの２つの制約を取り払ったものです。

最初に、マップのコントロール機能をグリッドサーバからそれぞれの OpenSimulator インスタンスに移すことで、それぞれの OpenSimulator のローカルマップに「隣の地域 (Neightbers)」を追加できるようになっています（ただし、グリッド管理者が希望すれば、ハイパーリンクはグリッドサーバから提供するようにもできます）。こうすると、仮想空間はもっと面白く変化に富んだものになります。ある OpenSimulator で見ることのできるマップは、ハイパーリンクでテレポートすると、全く違うものになってしまいます。OpenSimulator の管理者として、マップに表示したい他の OpenSimulator を自由に設定することができます。

次に、知らないユーザ、例えば、他の仮想空間で登録したユーザなどのエージェントを転送できるようになっています。ハイパーグリッドでは、１つの中央集権的なユーザサービスを前提としたものではなく、世界中に無数に散らばったサービスで動作するようになっています。ハイパーグリッドに対応した OpenSimulator 間でエージェントが転送されると、ユーザに関する多くの詳細情報が渡ります。この情報の中には、転送を行うユーザが必要とする、サーバの一覧が含まれています。

=== 利用シナリオ ===

ここに利用シナリオを一部紹介します。これらのシナリオの間に明確な区別はなく、だいぶ重なっています。これは排他的なリストではありません。この説明がハイパーグリッドを使ってみる際のヒントになればと思います。うまいシナリオがありましたら、どうぞこのリストに追加していってください。

{| class="wikitable"
|-
|
[[Image:topoA.jpg|400px|left]]
|
'''Personal Worlds (個人空間)'''

最初のシナリオは、スタンドアロンの OpenSimulator でのものです。通常、スタンドアロンはインターネットからは完全に切り離されています。しかし、ハイパーグリッドモードで動作させると、スタンドアロンはネットワークに接続することができます。こうすると、仮想空間を自分のマシンで動かしながら、好きなところにリンクすることができます。例えば、友達のハイパーグリッド対応 OpenSimulator にリンクしたり、OSGrid のような公共グリッドのハイパーグリッド・ゲートウェイにリンクしたりすることができます。

このシナリオのいいところは、自分のアセットは全て自分のマシンに格納され、他のサーバーに格納されないことです。どこにでもあるようなバックエンド・ツールをつかってバックアップをとることができます。そんなによくないところは、自分のアセットが全部自分のマシンにあることです！ハードディスクがやられると吹っ飛びます（このため、常日頃からこまめにバックアップをとるようにしましょう）。

|-
|
[[Image:topoB.jpg|400px|left]]
|
'''Communities (コミュニティ)'''

２番目のシナリオは、広義のコミュニティに関するものです。人々が集まって、グループで小さなコミュニティ・グリッド（例: 集団活動を行う共通の仮想空間）を運営するといったものです。しかし同時に、コミュニティのメンバーが自分のスタンドアロンの仮想空間をメンテナンスすることになります。スタンドアロン OpenSimulator はコミュニティ・グリッドにリンクし、コミュニティ・グリッドは各メンバーの仮想空間に逆リンクを貼り、他の興味のある場所へリンクします。

メンバーの個人情報は各自のスタンドアロン OpenSimulator 上にあり、各自のアセットもそこに格納されるでしょう。ただし、コミュニティ地域で表示されるアセットは、グリッドのアセットサーバに格納されます。

|-
|
[[Image:topoC.jpg|400px|left]]
|
'''Grid Public Regions (グリッド公共地域)'''

箱庭（Walled-Garden、閉鎖グリッド）は広く普及し、役に立つさまざまな機能を提供しています。箱庭グリッドの管理者が運営に興味を示しそうな、ハイパーグリッドのハイブリッド・モード(Hybrid Mode)があります。ハイブリッド・モードでは、グリッド上のほとんどの OpenSimulator インスタンスは箱庭モードとして今まで通り動作するため、外部からの訪問は受け付けません - 物理的にアクセス不可能です。しかし、グリッド上の一部の OpenSimulator はハイパーグリッド・モードで動作することができるため、外部からの訪問を受け付けることができます。このやり方では、当該グリッドのローカルユーザと登録されていないユーザが出会うゲートウェイ(Gateway)が存在します。事前にアカウント登録することなく誰でもゲートウェイ地域を訪れることができることから、グリッドに新しいユーザを呼び込む良い戦略ともなります。

ハイブリッドモードはウェブで起きることとよく似ています。例えば、Facebook の公開ページは誰でもアクセスできますが、Facebook のユーザだけが内部のページにアクセスできます。

|-
|
[[Image:topoD.jpg|400px|left]]
|
'''Level Games（レベルゲーム）'''

OpenSimulator の通常のバージョンでは、グリッドの全ての地域が必ず世界地図に掲載されます。ハイパーグリッドではその制約がなくなります。このため、プレイヤーの居場所によって、仮想空間の様子が異なるバーチャルゲームを簡単に制作できるようになります。
|-
|}

== ハイパーグリッドの実装 ==

=== ハイパーリンクとエージェント転送 ===

OpenSimulator から他へリンクを作成すると、情報のリクエスト先であるリンク先の OpenSimulator にメッセージが送信されます。取得する情報には、OpenSimulator をホストしているネットワークの情報、ローカルグリッドでの最初の地域の座標がリージョン・ハンドル形式で含まれます。例えば、ノード x.com:9000 をリンクして、それを自分のローカルマップの 900, 900 に置こうとしているとします。向こうの OpenSimulator では１つ以上の地域が稼働していて、それらの座標は向こうのローカルマップでは 900, 900 ではなく、最初の地域が 1100, 1100 にあるとします。こちらからすると、向こうの座標がどうなっていようと関係なく、知る必要もありません -- これに気づけば、2D マップで提供された「空間」の中心はどうでもいいということがわかります。自分は 900, 900 に置きたいのですから。向こうのシミュレータの「実際の」位置というのは、自分の空間から他の OpenSimulator へテレポートするときに、LindenLab ビューアが使用するだけです。この異なる座標間のマッピングが OpenSimulator のハイパーリンクの要となります。ハイパーグリッドの実装において、簡単だけど重要なことです。このマッピングは TeleportFinish イベントで発生します。ビューアにローカル座標を送信する代わりに、ハイパーグリッド・テレポート・ラッパーはリモート座標を送信します。

エージェントがハイパーリンクを使ってテレポートすると、次のようなことが起こります。まず、 InformRegionOfChildAgent の前に、"expect_hg_user" メソッドで、ローカルの OpenSimulator が当該ユーザが外部からやってくる旨をリモートの OpenSimulator に通知します。このメッセージは、ユーザサーバ、インベントリサーバ、アセットサーバなど、このユーザが使用する全てのサーバに行き渡ります。リモートの OpenSimulator はローカルのユーザ・プロフィール・キャッシュにそのユーザのエントリを作成しますが、ユーザ・データベースには作成しません。外部ユーザの情報は永続させません。これが終わったら、通常のテレポートと全く同じようにテレポート処理されます。唯一の違いは、リージョン・ハンドルが、リモート地域のローカルグリッドでのハイパーリンク座標を指すか、ローカルグリッドでの実際の座標を指すかが切り替わるぐらいです。

要約すると、ハイパーグリッドは新しい概念を２つ導入しました。ハイパーリンクという概念と、「ローカルユーザ(Local User)」「[[Banning Foreign Users in Hypergrid|外部ユーザ(Foreign User)]]」という概念です。

=== インベントリへのアクセス ===

外部からのインベントリへのアクセスは従来のシーン・インベントリ会話処理 (Scene-Inventory Interactions) にコードを追加して、ユーザのアセットサーバからインベントリ・アセットを出し入れするようにラップすることで実現しています。インベントリにアクセスすると、ハイパーグリッド・ラッパーはユーザが外部ユーザかを判定し、そうであれば、ラッパーはユーザのアセットサーバから必要なアセットを取得して、ローカルのアセットキャッシュやサーバに格納します。その後、ラッパーは従来のインベントリアクセス関数に制御を引き継ぎます。インベントリに何か追加されると、ハイパーグリッド・ラッパーはイベントを起こして通知し、アセットをユーザのアセットサーバに入れます。やりとりされたアイテムの識別情報はキャッシュで管理されるため、アイテムの転送が繰り返し発生することはありません。

ハイパーグリッドに対応した OpenSimulator は結果として複数のアセットサーバとやりとりすることとなります。このやりとりは、複数の GridAssetClient インスタンスを作成することでわかりやすく実装されています。

=== ハイパーグリッドのクラス ===

現在、ハイパーグリッドは OpenSimulator 名前空間の外で実装されています。このため、従来の挙動と新しい挙動の間に明確な区別がついています。HyperGrid という独自の名前空間で実装されています。この中には、OpenSimulator のソフトウェア構成にならって、４つのサブの名前空間があります。これから、具体的に説明します。

* '''OpenSim.Framework''':
** ForeignUserProfileData が UserProfileData を拡張し、ユーザの「ホーム」の情報を追加しています。具体的には、ホームのアドレス、ポート、リモートのポートです。ユーザのホームはユーザのユーザサービスにおけるホームではありません。ユーザが自分でホームと決めた OpenSimulator になります。ホームへ戻る (Ctrl-Shift-H) を実現するために必要な処理です。
** HGNetworkServersInfo は NetworkServersInfo の考え方を受け継ぎますが、継承や包含の関係ではありません。今のところ、これはユーティリティクラスです。主要な２つの機能で、サーバのドメイン名から IP アドレスを解決し、整形したものを bool IsLocalUser(...) に回答しています。

* '''OpenSim.Region.Framework.Scenes.Hypergrid''':
** HGSceneCommunicationService は SceneCommunicationService を拡張し、RequestTeleportToLocation をオーバーライドしています。基底メソッドに対して２つの非常に小さな、しかし重要な変更を行っています。(a) TeleportFinish イベントで、テレポート先地域がハイパーリンクの場合に、リージョン・ハンドルを切り替えています。(b) ハイパーリンクのテレポートに備え、終了時に必ずコネクションをクローズしています。
** HGScene は Scene を拡張し、TeleportClientHome(...) をオーバーライドしています。基底メソッドに対する唯一の変更は、ユーザサービスはまだ完全に外部ユーザのためにラップされていないため、暫定的にユーザサーバとの関係を切ったことです。ユーザサービスが適切にラップされれば、このクラスは不要となります。
** HGScene.Inventory は HGScene の内部クラスです。このような実装は OpenSimulator フレームワークでよく見かけます。この HGScene の内部クラスでは、一部のインベントリ・シーン会話処理メソッドをオーバーライドし、ユーザのアセットサーバからの出し入れができるようになっています。出し入れが完了したら、このメソッドは基底メソッドに制御を引き継ぎます。
** HGAssetMapper: このクラスはハイパーグリッド専用で、ユーザがいる外部の地域とユーザのアセットサーバの間でアセットの出し入れの管理をします。

* '''OpenSim.Region.Communications.HyperGrid''' は OpenSim.Region.Communications.* の寄せ集めです。ここにほとんどのハイパーグリッドの拡張機能が入っています。ハイパーグリッドのコミュニケーション処理で１つ余分な処理をしているのがその理由の１つです。その処理で、スタンドアロンをネットワーク接続可能にしています。
** HGCommunicationsStandalone は CommuniationsLocal を拡張しています。基底クラスと同じように、複数のネットワークを収容するハブとなっており、これはスタンドアロンモードで利用できます。主な違いは、これらのサービスは OpenSimulator にあるサービスの拡張であることです。
** HGCommunicationsGridMode は直接 CommunicationsManager を継承しています。これはグリッドモードで使用できるネットワークサービスのハブです。OpenSimulator の拡張となっています。
** HGGridServices (基底クラス), HGGridServicesStandalone, HGGridServicesGridMode (サブクラス) は OpenSimulator のインターフェースである IGridServices と IInterRegionCommunications を実装しています。サブクラスの２つはそれぞれ LocalBackEndServices と OGS1GridServices のラッパーとなっています。３つのクラスを通して、共通のパターンで実装されています。これから会話をする地域がハイパーリンクかを判定し、そうでなければ処理を LocalBackEndServices/OGS1GridServices に引き継ぎます。ハイパーリンクであれば、HGGridServices に処理を押し上げます。HGGridServices では、代わりに、ハイパーリンク地域の管理を行い、地域間連携プロトコルの２つの追加項目を指定します。
*** region_uuid: 地域をリンクする際に必要
*** expect_hg_user: expect_user インターフェースに似ていますが、転送するユーザに関するより詳細な情報が含まれます。具体的には、ユーザの全てのサーバです（インベントリ、アセット、ユーザ、ホームなど）。
** HGInventoryService は LocalInventoryService を拡張し、ISecureInventoryService を実装ています。このクラスはまさに野良処理の寄せ集めのようなクラスで、スタンドアロンユーザ向けのローカルのサービスアクセスと、外に出て行ったときのためのリモートのインベントリアクセスが混ざっています。今のところは、OGS1InventoryService と OGS1SecureInventoryService を巻き込んで見苦しくなるのを避けるために、コピペを乱発しています。HGInventoryService はいつでも ISecureInventoryService です。全てのメソッドは同じパターンになっています。ユーザがローカルのスタンドアロンユーザであるかを判定し、もしそうなら、（LocalInventoryService の）基底メソッドに処理を引き継ぎます。そうでないなら、セキュアなリモートアクセスを実施します。
** HGUserServices は OSG1UserServices をラップしていますが、まだ動作しません。

* '''OpenSim.Region.CoreModules.HyperGrid''' は３つの地域モジュールの集合です。
** HGWorldMapModule は WorldMapModule を拡張しています。基底クラスのものをほとんど再利用しています。唯一の小さな変更は RequestMapBlocks で、オフラインのマップ閉塞信号をクライアントに送信しようとします。
** HGStandaloneInventoryService と HGStandaloneAssetService は名前通りの処理を行います。これらはスタンドアロンのインベントリとアセットにアクセスする地域モジュールで、スタンドアロンユーザが出かけるときに動作します。考え方としては、これらのモジュールと REST のインベントリ／アセットプラグインには多くの共通点があります。残念ながら、プラグインは使えませんでした。プラグインは従来のインベントリ／アセットサーバで使用されていたインターフェースと完全に異なっていたからです。ハイパーグリッドへのアクセスは一貫したインターフェースでなければなりません。

== インストールと実行 ==

[[ハイパーグリッドのインストールと運用]] を参照してください。

== ハイパーグリッドとセキュリティ ==

[[Hypergrid Security]] を参照してください。

== 外部ユーザの BAN ==

[[Banning Foreign Users in Hypergrid]] を参照してください。

== ハイパーグリッドの公開ノード ==

[[Public Hypergrid Nodes]] を参照してください。

== ハイパーグリッドのリスト ==
[[Hypergrid Lists]] を参照してください。

== 開発者ミーティング ==

[[Hypergrid Meetings]]

{{DEFAULTSORT:はいぱーぐりっど}}

[[Category:Japanese Translations]]

トラブルシューティング

2012-03-04T07:06:31Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Troubleshooting}}
<br />
このページには、システム固有の有用な設定や、遭遇する可能性のある問題を解決するためのアドバイスを掲載しています。
__TOC__
{{clear}}

== 一般的なヒント ==

OpenSimulator の起動が完了して、地域コンソールでコマンドが入力できる状態となっていれば、"config get" や "config save" コマンドを使って、現在の設定を調べることができます。[[サーバコマンド]] (または、コンソールで help と入力) に詳しい説明があります。これは、トラブルの原因を究明する際に、誤った設定を修正するのに役に立ちます。

また、.NET のランタイムとデータベースのバージョンが適切か確認してください。データベースのバージョンについては、[[設定#データベース]] を参照してください。また、.NET 3.5 以降を使用しなければなりません。.NET 2.0 には System.Core がありません。Windows の .NET を使っているのであれば、3.5 か 4 の更新モジュールをダウンロードしてきましょう。Mono を使っているのであれば、Mono のバージョンを上げる必要があります。

== システム固有の設定 ==
=== CentOS 5 (64 ビット) ===

CentOS 5.2 64bit で Mono 2.2 をソースからコンパイルして使っている場合 (他のケースでもそうなるかは分かりませんが)、以下のステップを実行する必要があります。
sudo yum install libgdiplus
sudo yum install libexif
sudo ln -s /usr/lib64/libgdiplus.so.0 /usr/lib64/libgdiplus.so
ldconfig

これで私の場合は OpenSimulator をエラーなしで起動することができ、他のグリッドに接続することもできるようになりました。

=== Gentoo ===
Mono の依存パッケージや Mono 自体で、"~x86" にマスクされたパッケージを使うことがあります (プラットフォームが x86 の場合。使用しているプラットフォームに応じて読み替えてください。例: 64 ビットの場合、"~amd64")。次のようにして USE フラグを確認してみましょう。

ACCEPT_KEYWORDS="~x86" emerge -vp subversion nant mono libgdiplus

それから、次のようにしてインストールしましょう。

ACCEPT_KEYWORDS="~x86" emerge subversion nant mono libgdiplus

注: ACCEPT_KEYWORDS="~x86" は Gentoo の /etc/make.conf ファイルでも設定できますが、testing/unstable の全てのパッケージが表示されることになってしまいます。emerge コマンドの先頭でこれを使えば、この変数はこの emerge プロセスにだけ適用されます。

=== Mac OS X ===

2.0 Framework がサポートされていない旨のエラーが発生したら、<tt>pkg-config</tt> パスを修正するとよいでしょう。例えばこれを <tt>~/.bash_profile</tt> に書くことができます。
export PKG_CONFIG_PATH="/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig/:${PKG_CONFIG_PATH}"

== エラーとその対処方法 ==

=== 仕様不備かバグによる問題の回避策 ===

==== UID 重複によるプリム消失 ====

通常、この問題は save-xml/load-xml ファイルが、-newUID スイッチを使ってオブジェクトの UUID を新しく採番することなく、同じ SIM にロードされた場合に発生します。詳細な情報は [[サーバコマンド]] を参照してください (<nowiki>load-xml <filename> -newUID</nowiki>) 。それでもうまくいかなければ、オブジェクトを Shift コピーして空中に持っていき、空中にあるほう(実はこれがコピー) を削除するとうまくいくかもしれません。これで全てのプリムの UID が新しく割り振られます。このオブジェクトはそのままにして、元の load-xml ファイルを他の地域にロードしましょう。

=== ODE Physics で例外が発生して落ちる (System.EntryPointNotFoundException: dSpaceLockQuery) ===

次のエラーは、たいてい "libode" のバージョンが合っていないために発生します。

{|
|-
| style="background: none repeat scroll 0% 0% LavenderBlush; color: black;" |
[SCENE] [02-01 22:20:40] System.EntryPointNotFoundException: dSpaceLockQuery

:at (wrapper managed-to-native) Ode.NET.d:SpaceLockQuery (intptr)
:at OpenSim.Region.Physics.OdePlugin.OdeScene.waitForSpaceUnlock (IntPtr space) [0x00000]
:at OpenSim.Region.Physics.OdePlugin.OdeCharacter.AvatarGeomAndBodyCreation (Single npositionX, Single npositionY, Single npositionZ, Single tensor) [0x00000]
:at OpenSim.Region.Physics.OdePlugin.OdeCharacter..ctor (System.String avName, OpenSim.Region.Physics.OdePlugin.OdeScene parent_scene, OpenSim.Region.Physics.Manager.PhysicsVector pos) [0x00000]
:at OpenSim.Region.Physics.OdePlugin.OdeScene.AddAvatar (System.String avName, OpenSim.Region.Physics.Manager.PhysicsVector position) [0x00000]
:at OpenSim.Region.Environment.Scenes.ScenePresence.AddToPhysicalScene () [0x00000]
:at OpenSim.Region.Environment.Scenes.ScenePresence.MakeRootAgent (LLVector3 pos, Boolean isFlying) [0x00000]
:at OpenSim.Region.Environment.Scenes.Scene.AgentCrossing (UInt64 regionHandle, LLUUID agentID, LLVector3 position, Boolean isFlying) [0x00000]

|}

まず、ファイルシステムを検索して、他の ODE Physics エンジンがないか探してみましょう。

find / -name "libode.so"

それから、最新のバージョンかどうか確認しましょう。

=== 6-8 時間経ってから、MySQL のコネクションでエラーが発生する ===

MySQL にはタイムアウトがあり、28,800 秒 (8 時間) アクティブでないとコネクションを切断します。たぶんこれが原因で、ユーザサーバが長時間アイドル状態にあるとログインできなくなるのだと思います。この問題が発生したら、タイムアウトを大きな値、例えば 604800 (1 週間) や 31536000 (1 年) に増やしましょう。MySQL コンソールで、次のように入力しましょう。

set global wait_timeout=604800;

=== System.DllNotFoundException: gdiplus.dll ===

最初に、<tt>libgdiplus.so</tt> がダイナミック・リンカが参照できる場所にあるか調べましょう。

/sbin/ldconfig -p | grep libgdiplus

見つからなかったら、libgdiplus.so のあるディレクトリが <tt>LD_LIBRARY_PATH</tt> 環境変数や、 /etc/ld.so.conf.d/ の *.conf ファイル (例: gdiplus.conf) にあるか確認しましょう。それから <tt>ldconfig</tt> でキャッシュを更新しましょう。そうすると、ライブラリを見つけられるようになっているはずです。

それでもまだエラーが出る場合、libgdiplus は他のダイナミック・ライブラリにも依存しているため、それらがロードできなければ、libgdiplus もロードできません。これを確かめるには、OpenSimulator をデバッグ情報を表示させる設定にして起動します。

MONO_LOG_LEVEL=debug mono OpenSim.exe

Mac OS X では、/opt/local/lib/libgdiplus.dylib があるか確認しましょう。存在していたら、root ユーザで /opt/local/etc/mono/config ファイルを編集して、次の行を追加しましょう。

<dllmap dll="gdiplus.dll" target="/opt/local/lib/libgdiplus.dylib" os="!windows"/>

=== OpenSimulator の MySQL データベースを WIndows から Linux に移行する ===

==== MySql.Data.MySqlClient.MySqlException: Table 'opensim.UserAccounts' doesn't exist ====

'''環境:''' Opensim Server 0.7.0.2, Linux Ubuntu 8.0.4 環境。Mono 2.8, MySQL 5.0 がインストールされた状態。

MySQL 5.0 で稼働している OpenSimulator 0.7 データベースを Window から Linux に移行した場合、OpenSimulator サーバにユーザがログインすると、OpenSimulator サーバコンソールに次のような例外が表示されることがあります。

{|
|-
| style="background: none repeat scroll 0% 0% LavenderBlush; color: black;" |
03:11:10 - [LLOGIN SERVICE]: Exception processing login for (user_name): MySql.Data.MySqlClient.MySqlException: Table 'opensim.UserAccounts' doesn't exist
at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000] in <filename unknown>:0 at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000] in <filename unknown>:0

|}

クライアントでは、次のようなエラーが表示されます。

Login Failed
Error generating Login Response

この例外は MySQL がテーブル名を格納する仕組みが原因となって発生します。Windows の MySQL サーバでは、テーブル名は大文字小文字を区別しませんが、'''Linux の MySQL のテーブルはデフォルトで大文字小文字を区別します'''。このため、OpenSimulator が大文字で始まる名前でデータベースを検索すると、見つかりません。

一つの解決策は、OpenSimulator が必要とするテーブルのテーブル名を (ALTER TABLE で) 変えてしまうことです。しかし、最もきれいなやり方は、MySQL の設定を変え、"'''/etc/mysql/my.cnf'''" ファイルの '''[mysqld]''' セクションで "'''lower_case_sensitive = 1'''" とすることです。

# sudo nano /etc/mysql/my.cnf

..........................
[mysqld]
..........................
lower_case_sensitive=1
..........................

これで、MySQL は自動的にテーブル名を小文字に変換して解釈するようになります。MySQL サーバと OpenSimulator を再起動すると、テーブルは問題なくロードされるようになります。

注: '''migration''' テーブルをクリアして OpenSimulator にデータベースを強制的に再移行させようとしないでください。'''データベースが損傷する原因となります'''。

=== 不完全なデータ移行にまつわるエラー ===

OpenSimulator のデータ格納方法が変更となり、アップグレード時になんらかの原因でデータベースの移行に失敗すると、この問題が発生することがあります。

OpenSimulator コンソールにこのようなエラーメッセージが表示されます。

[LLOGIN SERVICE]: Exception processing login for [username]: MySql.Data.MySqlClient.MySqlException: Table 'opensim.UserAccounts' doesn't exist
at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000]
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000] at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000]
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000]

この場合、'users' テーブルの内容が 'UserAccounts' に移行されていないにも関わらず、OpenSimulator は 'UserAccounts' がある前提で動作しようとしていました。また、ビューアにもエラーが表示されます。

Login Failed
Error generating Login Response

移行の失敗の原因となったファイルシステム (私の Linux 場合は、'/var/lib/mysql/...' がぐちゃぐちゃになってました) の権限を変更して、'migration' テーブルを削除し、サーバを再起動させると、私の場合は解決しました移行時に [non-critical] 警告が発生したので、たぶんもっと適切な方法があったのではと思いますが、私は完全にバックアップをとっていたので、安直な方法でやってしまいました) 。地形データ参照と現在のシェイプ／衣類／アタッチメントデータはなくなってしまいましたが(これは簡単にインワールドで復元できます)、それ以外は私的には大丈夫でした。

== Mono や libgdiplus0 をインストールすると、依存関係にある libexif.so.9 が見つからないエラーが発生する ==

これは Centos5 で現象が確認されましたが、他のオペレーションシステムでも発生することがあります。ftp://rpmfind.net/linux/conectiva/snapshot/i386/RPMS.extra/libexif9-0.5.12-47547cl.i386.rpm をダウンロードしてインストールすれば、解決します。これで、(他に問題がなければ) Mono がインストールできるようになります。

=== mscorlib.dll アセンブリが見つからない、またはロードできない ===

NAnt と一緒にインストールされる mscor ライブラリで見つからないものがあると考えられます。NAnt をインストールすれば簡単に解決します。必要なライブラリの 1.0 や 2.0 のバージョンのものが一緒に入っています。

apt-get install nant

=== External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe ===

mono-gmcs を再インストールすると、簡単に直ります。

apt-get install mono-gmcs

=== The type or namespace name JScript does not exist in the namespace Microsoft ===

JScript と連呼しているのに注目してください。これがヒントになるかな？

apt-get install mono-mjs libmono-microsoft8.0-cil

Fedora や OpenSUSE では、必要なパッケージは "mono-jscript" になります。

=== The type or namespace name Tcp does not exist in the namespace System.Runtime.Remoting.Channels ===

これはインストール一発で簡単に直る問題です。

apt-get install libmono-system-runtime2.0-cil

=== Missing: libopenjpeg-libsl-2.1.2.0-x86_64.so ===

おそらく、64 ビットのマシンなのでしょう。以下の手順に沿って作業しましょう。

* [[Installing and running on x86-64]]

=== error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file ===

Debian ベースのシステムで、このページの一番上のように導入したが、apt バージョンの Mono ではなく、Web サイトからダウンロードしたインストーラを使っている場合、この問題が発生することがあります。

http://www.mono-project.com/Downloads で .bin をダウンロードして、手順に沿って実行し、完了した後で、"mono --version" を実行すると、このメッセージが表示されます。libglib2.0-0 をインストールする必要があるということです。

apt-get install libglib2.0-0

=== The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file. ===

apt バージョンの NAnt を再インストールすると直るようです。

apt-get install nant

この現象は <tt>pkg-config</tt> が <tt>mono.pc</tt> ファイルにもアクセスできないために発生することもあります。このファイルがあるディレクトリを <tt>PKG_CONFIG_PATH</tt> 環境変数に追加すると直ります。

== ネットワークや設定の問題 ==

この Wiki ページを参照してください。
* [[Network Settings]]
* [[ファイアウォール設定]]
* [[設定]]

=== ログインはできるが、リモートクライアントから地域にログインできない ===

OpenSimulator/bin/Regions フォルダを開いてください。
# Regions.ini ファイルの InternalAddress に '''0.0.0.0''' を指定してみてください。
# '''ExternalHostName=127.0.0.1''' を、アクセス可能な DNS ネームに変更する必要があります。例えば、"opensim.example-host.com" や "71.6.131.152" (外部からアクセス可能な IP アドレス) のように書きます。

If you still have the same problem, it might be a firewall issue. Check if your firewall is active and configure it. See [[Firewall Settings]] for detailed instructions.

== OpenSimulator のビルド ==
=== ビルドファイルもソリューションファイルも見つかりません ===
* Windows では、
runprebuild.bat
* Linux/Mac/FreeBSD では、
runprebuild.sh
を実行してください。

=== Visual Studio 2005 で .sln ファイルが開けません ===
* Visual Studio 2005 C# を起動してみてください。恐らく、Visual Studio 2005 C++ を起動しようとしているんじゃないでしょうか。これは C# プロジェクトです。

== OpenSimulator の実行 ==
=== Cygwin シェルで OpenSim.exe を実行すると、一部の DLL でアクセス拒否が発生します ===
* '<tt>cd bin</tt>' の後に '<tt>chmod a+x *</tt>' を実行して、全ての DLL ファイルを実行可能な状態にしてください。

=== SIM が起動できません ===
* [[設定]] を見てください。

== なんかおかしくなった！ ==
=== svn r3254 以降でアップデートした後にグリッドを起動すると、'owner_uuid' がなんたらかんたらというエラーが出ます ===
r3254 以降の最近のリビジョンに更新すると、owner_uuid をwe are now using the unused owner_uuid. グリッドによっては、リージョンテーブルを初期化する .sql スクリプトからこの項目が誤って消されてしまったタイミングで MySQL テーブルが作られてしまっています。MySQL にログインして、この SQL クエリを実行し、足りない owner_uuid を追加すると、この問題は解決するはずです。
alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';
regions と owner_uuid の周りの記号は、「グレイヴ・アクセント(バッククオート)」です。default や comment の値の周りはシングルクオートです。日本語キーボードでは、Shift + @ でバッククオートが、Shift + 7 でシングルクオートが出てきます。これは MySQL で覚えておきたいことです。

=== svn r3786 以降でアップデートした後にグリッドを起動すると、'State' がなんたらかんたらというエラーが出ます ===
r3786 以降では、SQLite の 'primshapes' テーブルに、新たに 'State' フィールドが追加されました。このフィールドは tree や grass を不揮発化するのに使用されます。起動すると何もない地域ができあがります。OpenSimulator は 'State' フィールドを見つけられないので、何をすればいいのかわからないからです。一番よい解決策は、SQLiteBrowser などの SQLite テーブルのエディタ ([http://sqlitebrowser.sourceforge.net/ http://sqlitebrowser.sourceforge.net/] でダウンロードしてください) を使って、足りないフィールドを作成することです。
alter table primshapes add column State integer default 0
SQLiteBrowser を起動して、File > Open Database と辿り、OpenSim.db ファイルをブラウズして開きます。そして、"Execute SQL" タブを開き、上のコマンドを "SQL String" テキストボックスにコピー＆ペーストします。それから、"Execute Query" ボタンをクリックします。

=== Region Handshake (地域のハンドシェイク) でタイムアウトになります ===
* Regions フォルダにある設定ファイルに正しい IP アドレスが記載されていますか？
* OpenSimulator が動作しているサーバにはインターフェースが複数存在しませんか？OpenSimulator は外向きの UDP パケットを特定の IP アドレスに割り当てず、デフォルトでアクセスする IP アドレスが、地域が UDP で応答する際の IP アドレスになります。他の IP アドレスで地域を設定してしまうと、接続時にタイムアウトになります。

=== OpenSimulator に接続できません ===
* [[Connecting]] か [[ファイアウォール設定]] を参照してください。

=== 接続できますが、移動することができません ===
クライアントから接続できるのに、アバターがくるくる回って移動しない場合は、SIM が正しく設定されていません。最初のログイン処理は完了しましたが、クライアントと SIM の間でパケット通信が成立していない状態です。おそらく、SIM のネットワーク設定が正しくないと思われます。
* [[設定]] を参照してください。

=== しょっちゅうアバターが固まります ===
ちょうど今はプリムのデータベース同期でボトルネックがあります。このため、短時間 (５〜１０秒) アバターがハングすることがありますが、いったんデータベースと同期がとれれば大丈夫です。これは既知の問題で、データの格納処理の一部にある古い構造が原因となっています。

=== Command error: System.IO.FileNotFoundException: Could not load file or assembly 'System.Core, Version=3.5.0.0, culture=neutral,PublicKeyToken=b77a5c561934e089' or one of its dependencies. ===

System.Core がないということは、.NET ランタイムの古いバージョンを使っているということです。

.NET 3.5 以降を使用しなければなりません。.NET 2.0 には System.Core がありません。Windows の .NET を使っているのであれば、3.5 か 4 の更新モジュールをダウンロードしてきましょう。Mono を使っているのであれば、Mono のバージョンを上げる必要があります。

=== 世界地図を見れません ===
* OpenSimulator を Linux サーバで動作させているときにこの問題が発生することがあります。グリッドモード、スタンドアロンモードに関わらず発生します。
* 症状：SL ビューアで世界地図を開くと、SIM が世界地図に表示されなかったり、サーバコンソールに OpenJPEG 関連のエラーが表示されたり、現在のセッションがフリーズしたり、などなど。。
* 原因：SVN の source trunk に正しい <tt>libopenjpeg-libsl</tt> ライブラリが含まれていません。
* 原因その２："defaultstripe.png" が OpenSimulator フォルダにないか、壊れています。
* 解決策：libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>) の最新のソースを取得し、<tt>openjpeg-libsl</tt> サブディレクトリで '<tt>make</tt>' し、生成された <tt>libopenjpeg-libsl-2.1.2.0.so</tt> を OpenSimulator の <tt>bin</tt> サブディレクトリにコピーして、既にあるものを上書きします。
* 再コンパイルして、OpenSimulator を再起動してください。

== コンソールに出力される例外 ==
以下にコンソールに出力される可能性のある例外を列挙します。意味と、問題であるか否かを説明しています。

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===

{|
| style="background:LavenderBlush; color:black" |
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
: at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
: at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
:at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
:at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]
|}

Linux で動作させており、ネイティブのライブラリ libopenjpeg-libsl-2.1.2.0.so がシステムと合っていません。以下の原因が考えられます。
* 古いプロセッサで動作させている (libopenjpeg が最適化オプションつきでコンパイルされている)
* 64 ビットモードで動作させようとしている (ネイティブライブラリはどれも 64 ビット向けにビルドされていません)

ソースから libopenjpeg を再ビルドしするか、互換環境で動作させてみましょう。
次のようにします。
svn co svn://openmv.org/libsl/libopenmetaverse/trunk libsl
cd libsl/openjpeg-libsl/
make

それから、 libopenjpeg-libsl-2.1.2.0.so を OpenSimulator の bin フォルダにコピーします。

=== System.NullReferenceException at OpenSim.Region.Communications.Local.LocalLoginService.PrepareLoginToRegion ===
{|
| style="background:LavenderBlush; color:black" |
[LOGIN END]: XMLRPC Login failed, System.NullReferenceException: Object reference not set to an instance of an object
:at OpenSim.Region.Communications.Local.LocalLoginService.PrepareLoginToRegion (OpenSim.Framework.RegionInfo regionInfo, OpenSim.Framework.UserProfileData user, OpenSim.Framework.Communications.LoginResponse response) [0x00000] in /home/sim/svn/opensim/OpenSim/Region/Communications/Local/LocalLoginService.cs:293
:at OpenSim.Region.Communications.Local.LocalLoginService.CustomiseResponse (OpenSim.Framework.Communications.LoginResponse response, OpenSim.Framework.UserProfileData theUser, System.String startLocationRequest) [0x00520] in /home/sim/svn/opensim/OpenSim/Region/Communications/Local/LocalLoginService.cs:253
:at OpenSim.Framework.Communications.LoginService.XmlRpcLoginMethod (Nwc.XmlRpc.XmlRpcRequest request) [0x00369] in /home/sim/svn/opensim/OpenSim/Framework/Communications/LoginService.cs:252
|}

実在しないドメイン名を地域の External Host Name に指定してしまうなどしたため、OpenSimulator の初回起動に失敗しています。このため、初期化は一部だけしか行われていません。この問題を解決するには、bin フォルダを削除して、svn update を行い、再ビルドしてデータベースをパージ (完全消去) する必要があります。

=== Exception: System.NotImplementedException: The requested feature is not implemented. ===

次のようなメッセージで始まる例外が発生したら、

{|
| style="background:LavenderBlush; color:black" |
|Exception: System.NotImplementedException: The requested feature is not implemented.
| at (wrapper managed-to-native) System.Threading.Interlocked:Add (int&,int)
| at System.Threading.ReaderWriterLockSlim.TryEnterReadLock (Int32 millisecondsTimeout) [0x000e3] in
|}

Mono に誤って '''--optimize=-all''' というオプションを渡してしまったと考えられます。Mono はコンパイルで System.Threading.Interlocked クラスのメソッドの「最適化された」バージョンを作ってしまうのが問題となっています。これらの最適化はコンパイルしている環境にある素のアセンブラを使って行われます (ビルド時に自動的に検出されます) 。'''--optimize=-all''' を渡すと、ランタイムはこれらの関数が最適化されていることを検出し、無効にします。このため、次にクラスがこれらの関数の呼び出しを行うと、ランタイムはメソッドのネイティブな実装がないとみなします！これは、全ての System.Threading 同期プリミティブに影響します。OpenSimulator はスレッドや排他制御に大きく依存していますので、この処理機構がないと何もできません。おそらく、Mono の将来のバージョンには '''--optimize=-all''' を渡すことができるようになり、例外を発生させるのではなく、最適化されていない実装 (例：pthreads) を出してくるようになるのでしょう。

Mono で (ネイティブコードでエラーが発生しているなど) ローレベルで発生している問題をデバッグしようとするとき、'''--optimize=-all''' を渡すのは適切なやり方とは言えません。代わりに、環境変数 MONO_LOG_LEVEL=debug を設定し、'''--debug''' スイッチを Mono に渡してプログラムを起動させましょう。他のプロセスと同じようにして、gdb でも Mono を動かすことができます。

== グリッドモード ==

=== SIM を起動しましたが、どのグリッドにも接続されていません ===

OpneSim を最初に起動するときに、設定が必要です。

* [[設定]] を参照してください。

=== OpenSim.Grid.UserServer.exe を起動しましたが、エラーが発生します ===
* [[設定]] を参照してください。

=== 私のグリッドはユーザが１人だけのときはうまくいくのですが、同時に２人のユーザがログインすると２人とも固まります ===
* 環境変数に MONO_THREADS_PER_CPU="100" を export してあるか確認しましょう。

=== 20 分以内に私の地域は CPU100% になって、地域がハングします ===
* Mono が 1.9.1 以前の場合は、2.2 にアップグレードしましょう。

== ハイパーグリッド ==
=== ハイパーグリッドを有効にして OpenSimulator を起動すると、インベントリがロードされません！ ===
*グリッドモードで動作させようとしている場合、まず OpenSim.ini を調べて、グリッドサーバの DNS ネームやアドレスが自分からもインターネットからもアクセスできるか確認しましょう。
*UGAIM サーバの XML 設定ファイルを調べて、全部の項目にインターネットからアクセスできる IP アドレスが記載されているか確認しましょう。
**心当たりがあり、UGAIM サーバのアドレスを変更しなければならない場合は、UGAIM の変更後の IP アドレスを参照するようにするために、データベースに間に合わせの SQL クエリを発行してグリッドのユーザアカウントを更新する必要があります。

SQL サーバにログインし、データベースをグリッドに合わせて変更しましょう。XML 設定ファイルで UGAIM サービスのアドレスを変更した後、次のコマンドで、ユーザのホームインベントリやアセットの URI が更新されます。

<pre>
update users set userInventoryURI="http://new.UGAIM.address:8004" where userInventoryURI = "http://old.UGAIM.address:8004";
</pre>

<pre>
update users set userAssetURI="http://new.UGAIM.address:8003" where userAssetURI = "http://old.UGAIM.address:8003";
</pre>

== 物理エンジンの問題 ==
=== OpenDynamicsEngine を *nix で使用する際に発生する問題 ===
OpenDynamicsEngine を *nix で使用していて問題が発生している場合は、次のコマンドでスタック領域をデフォルトよりも大きく設定してみてください。 ulimit -s 262144 もしくは、 opensim-ode.sh で OpenSimulator を起動してください。

== スクリプトエンジンの問題 ==
=== スクリプトをコンパイルすると "Primitive: Error compiling script: unknown char: . error" と表示されます ===
スクリプトを ( [[DotNetEngine|.NET]] や [[XEngine|X]] で) コンパイルしようとすると、このようなエラーが表示される場合があります。
{|
| style="background:LavenderBlush; color:black" |
Primitive: Error compiling script:
unknown char: .
|}

コンソールでは、次のように表示されます。
{|
| style="background:LavenderBlush; color:black" |
11:06:37 - [ScriptEngine.DotNetEngine]: Unloading script<br />
11:06:37 - Exception in MaintenanceLoopThread. Thread will recover after 5 sec throttle. Exception: System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
:at System.Collections.Generic.Dictionary`2[OpenSim.Region.ScriptEngine.Interfaces.IEventReceiver, OpenSim.Region.ScriptEngine.Shared.Api.Plugins.Dataserver].get_Item (IEventReceiver key) [0x00000]
:at OpenSim.Region.ScriptEngine.Shared.Api.AsyncCommandManager.RemoveScript (IEventReceiver engine, UInt32 localID, UUID itemID) [0x00000]
:at OpenSim.Region.ScriptEngine.DotNetEngine.ScriptManager._StopScript (UInt32 localID, UUID itemID) [0x00000]
:at OpenSim.Region.ScriptEngine.DotNetEngine.ScriptManager.DoScriptLoadUnload () [0x00000]
:at OpenSim.Region.ScriptEngine.DotNetEngine.MaintenanceThread.MaintenanceLoop () [0x00000]
11:06:37 - [ScriptEngine.DotNetEngine]: Loading script<br />
11:06:37 - [ScriptEngine.DotNetEngine]: ScriptManager StartScript: localID: 720001, itemID: 88c9d28c-6004-4609-a707-717190de044a<br />
11:06:37 - [Compiler]: Compiled new assembly for fad15951-f9aa-493f-be68-2aaf5ff8a3c9<br />
11:06:37 - [SCRIPT]: Compiled assetID fad15951-f9aa-493f-be68-2aaf5ff8a3c9: ScriptEngines/a83150da-1ab1-11dd-89fb-0014853ee9da/CommonCompiler_compiled_fad15951-f9aa-493f-be68-2aaf5ff8a3c9.dll<br />
11:06:37 - [ScriptEngine.DotNetEngine]: AppDomain Loading: OpenSim.Region.ScriptEngine.Shared, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
|}

これは '''Linux''' で、デフォルトロケール ( "C" ) でない場合に発生します。
* [http://opensimulator.org/mantis/view.php?id=2088 Mantis #2088] and [http://opensimulator.org/mantis/view.php?id=2015 Mantis #2015] に、これを回避して OpenSimulator を起動する方法が掲載されています。
<pre>
env LANG=C mono --debug OpenSim.exe
</pre>
* ロケール設定を変更するという手もあります。私が使っている '.bash_profile' はこのような感じになっています。
<pre>
export LC_ALL=C
export LANG=C
</pre>
この方法で Linux でのロケール設定を行うのはあまり良くないというのは私も承知していますが、この方法で'''スクラッチから Linux をインストールした'''環境でうまくいきました。

'''追伸''': Melanie が数週間前にソースコードの一部を修正して、この手の問題が回避されるようになったようです。

=== スクリプトをコンパイルすると "Primitive: Error compiling script: ApplicationName='gmcs', ..." と表示されます ===
スクリプトを ( [[DotNetEngine|.NET]] や [[XEngine|X]] で) コンパイルしようとすると、このようなエラーが表示される場合があります。

{| width="100%"
| style="background:LavenderBlush; color:black" |
Primitive: Error compiling script:<br />
ApplicationName='gmcs', CommandLine='/target:library /debug+ /optimize- /out:
:"ScriptEngines/430c29d0-c5c6-11dd-ad8b-0800200c9a66/CommonCompiler_compiled_fbe5e682-afae-4f1a-805b-0125031101f7.dll"
:/r:"/usr/lib/opensim/bin/OpenSim.Region.ScriptEngine.Shared.dll"
:/r:"/usr/lib/opensim/bin/OpenSim.Region.ScriptEngine.Shared.Api.Runtime.dll" --
:"/tmp/11b81aac/594d02ce.0.cs" ', CurrentDirectory=''
|}

右クリックメニューで、"Touch" などの他の機能が使えなくなります。

インストールした Mono が壊れている可能性があります (つまり、Mono として認識されているが、Ubuntu 8.10 Intrepid マシンに gmcs がインストールされていない）。

mono-gmcs (sudo apt-get install mono-gmcs) が正しくインストールされているか確認してください。

=== スクリプトをコンパイルすると、"gmcs: Cannot find the specified file" と表示されます ===
システムに "mono-gmcs" をインストールしてください。詳細は [[動作環境]] を参照してください。

== ロケールの問題 ==
一部の OpenSimulator ユーザがグリッドモードで OpenSimulator リージョンサーバのクラッシュに見舞われることがあります。

この問題の解決策を探るため、さまざまなテストを作成しました。

最初にこの問題に見舞われたのは、OpenSimulator SVN.6660 の時です。接続しているユーザがいないのに、OpenSimulator リージョンサーバが不定期にクラッシュしていました (１時間後だったり、５時間後だったり、...) 。

最初に思いついた案は、SVN の最新の版にアップグレードすることですが、うまくいかず、同じ問題が発生しました。このため、他のサーバ (同じOS, 同じパラメタ, 同じ Mono バージョン, ...) で正常に動作している、以前の SVN リリース (SVN.6575) で実験してみました。うまくいかず、同じ問題が発生しました。

それから、ロケールをいろいろいじってみました。サーバを起動させるのに使っている '''screen''' UNIX コマンドライン・ユーティリティをリコンパイルしてみましたが、だめでした。

このため、サーバのメモリの使われ方を調べてみました。すると、最新の SVN リリースでは、OpenSimulator サーバがマルチリージョン／グリッドモードで動作するのに必要なメモリ容量が増加していることに気づきました。なので、MySQL サーバをより少ないメモリで動作するようにチューニングしました。幾分ましになりましたが、それでも OpenSimulator リージョンサーバは不定期にクラッシュし続けました (しかし以前よりは長くもちました) 。

このため、'''screen''' コマンドライン引数をいろいろいじってみました。... 全てのテストで、'''--debug''' 引数がサーバにインパクトを与えているという結果となりました。

最初のころは、以下のようなコマンドで OpenSimulator を起動していました。
<pre>
/screen -S Region-service -d -m --debug mono OpenSim.exe
</pre>

'''--debug''' 引数がなければ、全てがより安定して動作しているように見えました。

ロケールについて言えば、mantis や、opensim-dev や opensim-users のスレッドを読むと分かるように、"en_US" や "C" のロケールに対応していないシステムでの動作には問題があります。

サーバを再セットアップして、全部 "en_US.UTF8" で動作するようにしました。

Ubuntu 8.0.4 server では、
<pre>
# cat /etc/default/locale
LANG="en_US.UTF-8"

# cat /var/lib/locales/supported.d/local
fr_FR.UTF-8 UTF-8
en_US.UTF-8 UTF-8

# cat /etc/environment
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games"
LANG="en_US"
LANGUAGE="en_US"
</pre>
そして、おそらく以下の手順も必要でしょう。
<pre>
# sudo dpkg-reconfigure locales
</pre>

'''screen''' コマンドの引数は最終的にこうなります。
<pre>
screen -S Region-service -d -m -U mono OpenSim.exe
</pre>

これで、OpenSimulator SVN.6575 がクラッシュせずに 48 時間動作し続けるようになりました。そして SVN.6735 も。

この情報が役に立つと幸いです。

以下参考情報：
[[Troubleshooting#Locales Issues|スクリプト類のサンプルが、原文に掲載されています。]]
{{DEFAULTSORT:とらぶるしゅーてぃんぐ}}

[[Category:Japanese Translations]]

ダウンロード

2012-03-04T07:06:20Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Download}}{{ReleaseInfo}}
= はじめに =
<font color="#ff0000">'''注意 1:'''</font> もしこれを http://www.opensimulator.org のサイト以外で読んでいる場合、実は OpenSimulator.org ソフトウェアをダウンロードしていない可能性があります。先に進む前に、ブラウザに表示されている URL を確認してください。

<font color="#ff0000">'''注意 2:'''</font> OpenSimulator でやりたいことによって、設定するのに技術的知識が必要になることもあります。 OpenSimulator をダウンロードしたら、この Wiki や他にいくつかある導入マニュアルをよく読んでください。OpenSimulator の学習曲線は急勾配ですのでご注意ください。

<font color="#ff0000">'''注意 3:'''</font> Linux ディストリビューションの多くが (Ubuntuも含みます) "mono-runtime" パッケージだけがインストールされた状態で出荷されています。しかし、OpenSimurator の一部の機能、例えば LSL スクリプトコマンドを使用できるようにするには "mono-complete" パッケージもインストールする必要があります。また、Mono 2.4.2 以上を使用しなければなりません (Ubuntu 10.04 には Mono 2.4.4 が入っていますので、大丈夫です）。

OpenSimulator はまだアルファ段階ですので、意図した通りに動作するという保証や、動作が不安定にならないという保証は全くありません。

= バイナリパッケージ =

== 現在のリリース版 ==
最新の OpenSimulator リリースは .zip 形式か .tar.gz 形式で提供されます。

tar.gz には mono のデバッグ用ファイルが含まれています。.zip には Windows の .NET のデバッグ用ファイルが含まれています。それ以外は中身は全く同じで、Mono でも .NET でも動作するようになっています（ただし、.NET のほうは、例外で行番号が出力されません）。

解凍すると、「何の設定もなしに」 OpenSimulator をスタンドアロンモードで動作させることができます - コードをコンパイルしたり、改めてインストールしたりする必要はありません。

現在のリリースは '''{{#var:currentversion}}'''（リリース日：{{#time: Y 年 n 月 j 日| {{#var:releasedate}}}} ）で、以下からダウンロードできます:

*{{#var:url_bingz}} または
*{{#var:url_binzip}}

解凍したら [[{{#var:currentversion}} Release]] にある注意事項を読んでください。
手順の詳細は、アーカイブを解凍すると、 README.txt([[README.txt/ja|日本語訳]]) にあります。

= インストーラ =

OpenSimulator プロジェクトは現在最新のリリースについてインストーラーを提供していません - バイナリパッケージをダウンロードして解凍するほうが楽でしょう - これはインストールと同じことになります。Debian/Ubuntu のパッケージはあるにはありますが、メンテナンスされていません。

* '''0.6.6 （や他のリリース／版）非公式な Debian や Ubuntu Linux の .deb パッケージ
[[UnofficialDebPackages]]

= 他のディストリビューション =

他のプロジェクトで OpenSimulator のパッケージを改造して、独自のモジュールや設定を含めたりしても構いません。既知のディストリビューションは

* Diva ディストリビューション。'''Hypergrid のスタンドアロンとして事前設定済み'''のバイナリディストリビューションです。簡単に設定や最新化を行うことができます。 Windows と Linux/Unix です。 diva-rNNNN.zip というファイルをダウンロードし、解凍して、 README.txt を読み、先に進んでください。
http://github.com/diva/d2/downloads

* OSGrid ディストリビューション。これはあらかじめ OpenSimulator インスタンスが http://osgrid.org に接続するように設定してあるものです。
http://www.osgrid.org/elgg/pg/utilities/software

= ソースコード =

最新のソースリリースは常に http://dist.opensimulator.org で公開されています。

*{{#var:url_srcgz}} または
*{{#var:url_srczip}}

tar.gz には mono のデバッグ用ファイルが含まれています。.zip には Windows の .NET のデバッグ用ファイルが含まれています。それ以外は中身は全く同じで、Mono でも .NET でも動作するようになっています（ただし、.NET のほうは、例外で行番号が出力されません）。

= 以前のリリース =
OpenSimulator の以前のリリースは http://dist.opensimulator.org にあります。古いリリースはソースコードパッケージのみ置いてあります。

以前のリリースノートは[[Release Notes]]にあります。

= 開発者やテスター =
開発者やテスターで、人柱となって開発中のコードをダウンロードしたい場合は、[[Developer Documentation#Source Code Repository Access|ここに行ってください]]。

= 関連するソフトウェア =
* [[Related Software|関連するソフトウェアの章です]]。
* OpenSimulator モジュールや他のプロジェクトは [http://forge.opensimulator.org/gf/ OpenSimulator Forge] にもあります。

''カテゴリ別のページ:''[[:Category:Users|利用者ページ]],[[:Category:Development|開発者ページ]],[[:Category:Scripts|スクリプト]]<br />

{{DEFAULTSORT:だうんろーど}}

[[Category:Japanese Translations]]

シミュレータ・パラメタの設定

2012-03-04T07:06:10Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Configuring Simulator Parameters}}

= 構成 =

OpenSimulator の設定は、Windows の INI ファイルのような感じで、非常に複雑な構造となっています。いろいろな用途、あらゆるアーキテクチャに対応できるようにするために、このような構造になっています。

設定ファイルに、他の設定ファイルをインクルードすることができます。例えば、標準的なスタンドアロン設定は以下の INI ファイルから読み込まれます(ログやコンソールには、この順番で表示されます)。

OpenSimDefaults.ini (OpenSimulator 0.7.1 以降)
OpenSim.ini
config-include/Standalone.ini
config-include/StandaloneCommon.ini
config-include/CenomeCache.ini (デフォルトの状態では存在しない)
config-include/storage/SQLiteStandalone.ini

OpenSimDefaults.ini (OpenSimulator 0.7.1 以降) や OpenSim.ini は、起動時に毎回チェックされます。しかし、他の INI ファイルは上記の INI ファイルに書いてあるインクルード指示を受けてロードされます。

例えば、OpenSim.ini の一番下にある [Architecture] セクションには、設定可能なアーキテクチャのインクルード文が列挙されています。例えば、デフォルトの OpenSimulator 0.7.1 スタンドアロン設定では、次のようになっています。

[Architecture]
Include-Architecture = "config-include/Standalone.ini"
; Include-Architecture = "config-include/StandaloneHypergrid.ini"
; Include-Architecture = "config-include/Grid.ini"
; Include-Architecture = "config-include/GridHypergrid.ini"
; Include-Architecture = "config-include/SimianGrid.ini"
; Include-Architecture = "config-include/HyperSimianGrid.ini"

１つ以上のセミコロン (;) で始まっている行は、コメントアウトされたものとみなされ、有効な設定とはなりません。この例では、OpenSimulator は OpenSim.ini を読み込んだとき、その後で config-include/Standalone.ini を読みにいき、そこから config-include/StandaloneCommon.ini などを順次インクルードしていきます。

設定ファイルが見つからない場合、無視され、見つからない旨がログに記録されます。

bin/ フォルダの中にある OpenSim.ini や OpenSimDefaults.ini はシミュレータ・パラメタ (チャット距離、物理属性など) を扱います。config-include の中のパラメタはデータサービス (地域データベース、アセット・サービス、インベントリ・サービスなど) のロケーションやパラメタを調整するものです。

= シミュレータの設定変更 =

設定ファイルにはいくつかのセクションがあり、それぞれのセクションは角括弧 ([]) で囲まれた名前で始まります。例えば、OpenSim.ini.example では次のようになっています(説明文は省略)。

[Startup]
; save_crashes = false
; crash_dir = "crashes"
...

[SMTP]
; enabled = false
...

[Chat]
; whisper_distance = 10

設定パラメタは各セクションの後に記述されています。それぞれ、<parameter> = <value> の形式となっています (例：whisper_distance = 10)。

OpenSim.ini.example で、パラメタが先頭にセミコロン (;) がついた状態でコメントアウトされていると、OpenSimDefaults.ini の値が代わりに使われるか(OpenSimulator 0.7.1 以降)、OpenSimulator 自体に存在するデフォルト値が使われます。

パラメタを変更するには、コメントを外して値を変更します。例えば、自分の SIM でささやきの範囲を 50 メートルにしたい場合、OpenSim.ini を次のように変更します。

[Chat]
whisper_distance = 50

SIM が次に起動されたタイミングで、OpenSimDefualts.ini があればその値をオーバーライド(=上書き)して、ささやきの範囲は 50m となります。

OpenSimulator 0.7.1 以降では、OpenSimDefaultsini ではなく、OpenSim.ini のパラメタを変更することを推奨しています。これは、以前のリリースから、たくさんのパラメタが新規に追加されたり名前が変更されたりしたためです。変更が必要な一般的なパラメタは、既に OpenSim.ini.example に記載されています。OpenSimDefaults.ini には、これらのパラメタや、よりマニアックなパラメタのデフォルト値が記載されています。OpenSim.ini.example になく、OpenSimDefults.ini にあるパラメタをオーバーライドしたい場合は、当該セクションを OpenSim.ini にコピーして、コピーした先の値を変更することをお勧めします。

= 集約・オーバーライド =

以上のようにして、複数の設定ファイルに同一のセクションが存在する場合、設定は集約されます。後に読み込まれる設定が、先に読み込まれた設定と同じ名前の場合、後に読み込まれる設定が先に読み込まれた設定をオーバーライドします。

= パラメタに関する情報の取得 =

シミュレータのコンソールでは、"config show" コマンドで、実際に使用されているパラメタの情報を取得することができます。意図したパラメタがシミュレータにロードされたかを確認したいときに便利です。
{{DEFAULTSORT:しみゅれーた}}

[[Category:Japanese Translations]]

サーバコマンド

2012-03-04T07:06:00Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks/ja|Server Commands}}

= サーバコマンドについて =

地域サーバや ROBUST サービスのコンソールでサーバコマンドを発行すると、いろいろなことができます。

'''免責事項''': コマンドによっては期待通りに動作しないものもありますし、全く動かないものもあるかもしれません。また、万に一つ全ての設定・コンテンツを失ってしまうこともあるかもしれません。この早見表はすぐに古くなります - コマンドを探す一番いい方法は、地域コンソールで "help" と入力することです。

特に注記のない限り、この一覧は OpenSimulator 0.7.1 では正しいものになっているはずです。

= コマンド =

== 地域コンソールのコマンド ==

=== 一般 ===

*alert <message> - 全てのユーザにインワールドで警告メッセージを送信します。
*alert-user <first> <last> <message> - 指定したユーザにインワールドで警告メッセージを送信します。
*backup - シミュレータのバックアップ処理 (オブジェクトのデータベースへの即時不揮発化) を開始します。シミュレータは一定時間経過後とシャットダウン時に自動的にこれを実行しています。
*bypass permissions <true / false> - インワールドのパーミッション・チェックをスキップします。
*change region <region name> - 以降に発行されるコマンドは、指定された地域にのみ適用されます。region name に "root" が指定された場合は、全ての地域が選択されたことになります。
*clear-assets - アセットキャッシュを強制的にクリアします。おそらくその後 SIM は不安定になります。注意して使ってください。
*command-script [name of scriptfile] - サーバコマンドを含むコマンドスクリプトを実行します。
*config get [<section>] [<key>] - 現在の設定を表示します。キー (key) 、セクション (section) で絞り込んだり、全ての設定を表示させたりできます。
*config save <path> - 現在の設定をファイルに保存します。
*config set <section> <key> - 指定した設定項目に値を設定します。ぶっちゃけ、OpenSimulator もモジュール類も設定値を動的に再取得しないため、これは無意味です。
*config show [<section>] [<key>] - 'config get' の代替コマンドです。
*create region [name] [filename] - 地域を新規作成します。
*debug packet <level> - パケット・デバッグ機構を稼働させます。level で設定したレベルに応じて、OpenSimulator がビューアに入出力パケットのサマリを表示します。
*debug permissions - パーミッション・デバッグ機構を稼働させます。
*debug scene - シーン・デバッグ機構を稼働させます。
*delete-region <name> - 地域をハードディスクから消去します。
*edit scale [primitivename] [xvalue] [yvalue] [zvalue] - 指定したプリムのサイズを変更します。
*emergency-monitoring - 緊急デバッグ・モニタリング・モードのオンオフを切り替えます。
*export-map [<path>] - 世界地図の画像を保存します (デフォルトの名前は exportmap.jpg です) 。
*force permissions - パーミッションの強制適用のオンオフを切り替えます。
*force update - 地域にある全てのプリムの再送信を開始します。
*help [<command>] - コマンド全般の一覧や、指定したコマンドやコマンド群に関する詳細なヘルプを取得します。
*kick user <first> <last> [message] - シミュレータからユーザを追い出します。
*kill uuid <UUID> - UUID 指定でオブジェクトを削除します (プリム数限界状態をコンソールでなんとかするのに役立ちます) 。
*link-mapping - リモートのハイパーグリッドをローカルのグリッド座標にリンクさせます。
*link-region - ハイパーグリッド地域にリンクします。link-mapping と何が違うのかよくわかりません。
*load iar <first> <last> <inventory path> <password> [<archive path>]: - ユーザのインベントリ・アーカイブをロードします。
*load oar [filename] - OpenSimulator アーカイブをロードします。現在の地域を完全に上書きします。デフォルトのファイル名は '''region.oar''' です。詳細は [[OpenSim Archives]] を参照してください。
*load xml [-newIDs [<x> <y> <z>]] - 地域データを XML フォーマットからロードします。(0.7.* では非推奨で、すぐに廃止する予定です。代わりに "load xml2" を使ってください)
:XML は export save や *export save-all で作成されたものです。
*load xml2 [filename] - オプションの引数は 2008 年 7 月 1 日から XML2 フォーマットのサポート対象外となりました。*modules list - モジュール一覧を表示します。
*modules load <name> - モジュールをロードします。
*modules unload <name> - モジュールのロードを解除します。
* monitor report - 現在の地域やシミュレータのさまざまな統計を表示します。
* quit - シャットダウンと同義です。
* region restart abort [<message>] - 地域の再起動の予定をキャンセルします。オプションでメッセージを指定することもできます。
* region restart bluebox <message> <delta seconds>+ - 地域の再起動をスケジューリングします。引数の数字が１つだけ指定されていれば、指定した秒数後に地域が再起動されます。再起動予定時刻は、地域にいるユーザに、画面上の青いダイアログで通知されます。数字が複数指定された場合は、それぞれの時間が経過するたびに、通知が表示されます。
* region restart notice <message> <delta seconds>+ - 地域の再起動をスケジューリングします。通知方法が画面下のすぐに引っ込む青いダイアログであること以外、上に同じです。
* reload estate - 不動産データを再読み込みします。
* remove-region - シミュレータから地域を削除します。
* restart - このインスタンスの全ての SIM を再起動します。
* save iar <first> <last> <inventory path> <password> [<archive path>] - ユーザのインベントリをアーカイブに保存します。 [[Inventory Archives]] を参照してください。
* save oar [filename] - 現在の地域を OpenSimulator アーカイブに保存します。デフォルトのファイル名は '''region.oar''' です。詳細は [[OpenSim Archives]] を参照してください。
* save prims xml2 [<prim name> <file name>]: - 指定されたプリムを XML2 に保存します。
* save xml [filename] - プリムを XML に保存します。
* save xml2 [filename] - プリムを XML に保存します (フォーマット 2 - 一部のノードが再構成されて、読出・保存が簡単になっています)。
* set log level [level] - コンソールのログレベルだけを変更します。例えば、off や debug などを指定します。詳細は、 [[Logging]] を参照してください。
* set region flags <Region name> <flags> - 地域のデータベースフラグを設定します。
* set terrain heights <corner> <min> <max> [<x>] [<y>] - 指定したコーナー番号 <corner> の地形テクスチャの高さを <min> から <max> の範囲にします。<x> や <y> が指定されていると、指定した座標にある地域にだけ設定します。<x> や <y> に -1 を指定すると、ワイルドカードとなります。コーナー番号は、SW = 0, NW = 1, SE = 2, NE = 3 です。
* set terrain texture <number> <uuid> [<x>] [<y>] - <number> の地形テクスチャに <uuid> を設定します。<x> や <y> が指定されていると、指定した座標にある地域にだけ設定します。<x> や <y> に -1 を指定すると、ワイルドカードとなります。
* show capabilities - 登録された全てのケイパビリティ URL を表示します。
:注意: OpenSimulator 0.7.1 では、help コマンドの結果には "show capabilities" と表示されますが、実際には "show caps" だけが有効なコマンドとなります([http://opensimulator.org/mantis/view.php?id=5467 #5467])。
* show circuits - エージェントのサーキット情報を表示します。
* show connections - 接続情報を表示します。
* show http-handlers - 登録された全ての HTTP ハンドラを表示します。
* show hyperlinks - ハイパーグリッド地域の一覧を表示します。
* show info - サーバ情報を表示します (バージョンや起動ディレクトリ)
* show modules - モジュール情報を表示します。
* show neighbours - ローカルで隣り合わせとなっている地域を表示します。
* show pending-objects - キューで待機しているオブジェクトの数を、全てのビューアについて表示します。
* show pqueues [full] - それぞれのクライアントについて、キュー内でのデータの優先順位を表示します。'full' オプションを指定しない場合は、Root Agent だけが表示されます。'full' オプションを指定する場合は、Child Agent も表示されます。
* show queues - キューに入っているエージェント接続の内容を表示します。
* show ratings - レーティング区分を表示します。
* show regions - 地域の情報を表示します。(地域名称(Region Name)、Ｘ・Y座標(Region XLoc/Region YLoc)、ポート(Region Port)、不動産名称(Estate Name))
* show stats - サーバに関する役に立つ統計情報を表示します。詳細は、下のほうにある [[#フレーム統計 (Frame Statistics) の値|フレーム統計 (Frame Statistics) の値]] を参照してください。
* show threads - システムに登録されている不揮発化されたスレッドを一覧表示します。スレッドプール内のスレッドは表示されません。
* show throttles [full] - 各クライアント接続のスロットル情報を表示します。またサーバが許可する１接続あたりの最大数を表示します。'full' オプションを指定しない場合は、Root Agent だけが表示されます。'full' オプションを指定する場合は、Child Agent も表示されます。
* show uptime - サーバの起動時間と稼働時間を表示します。
* show users [full]- 現在地域に接続しているユーザの情報を表示します。'full' オプションを指定しない場合は、実際に地域にいるユーザのみ表示されます。'full' オプションを指定する場合は、隣り合わせの地域にいるユーザの Child Agent も表示されます。
* show version - サーバのバージョンを表示します。
* shutdown - 全てのクライアントの接続を解除し、シャットダウンします。
* unlink-region <local name> - ハイパーグリッド地域のリンクを解除します。

=== アピアランス・モジュール (Appearance Module) のコマンド ===
* appearance show - アバターの容姿に関する情報を表示します。現在はただ単に、作成されたテクスチャが正しければ "OK"、おかしくなってしまっているなら "corrupt" が表示されるだけになっています。まだ開発中です。現時点では、開発中のコードにだけ存在します。

=== 土地モジュール (Land Module) のコマンド ===

* land show - 現在の地域にある全ての区画を表示します。

=== 地形モジュール (Terrain Module) のコマンド ===

※ SIM の再起動をしないと変更が正しく反映されないものがあります。
* terrain load - 指定したファイルから地形を読み込みます。
* terrain load-tile - 大きなファイルの特定のセクションから地形を読み込みます。
* terrain save - 現在の起伏マップを指定したファイルに保存します。
* terrain fill - 現在の起伏マップを指定した値で埋めます。
* terrain elevate - 現在の起伏マップに指定した値を加算してかさ上げします。
* terrain lower - 現在の起伏マップから指定した値を引いて低くします。
* terrain multiply - 起伏マップに指定した値を掛けます。
* terrain bake - 現在の地形データを退避マップ (Revert Map) に保存します。
* terrain revert - 退避マップの地形データを起伏マップに読み込みます。
* terrain newbrushes - 標準の地形ブラシから、実験段階のブラシに持ち替えます。警告: これはデバッグ用の設定なので、いつなくなるかはわかりません。
* terrain stats - デバッグ用に地域の起伏情報を表示します。
* terrain effect - 指定したプラグイン・エフェクトをかけます。

=== 植物モジュール (Tree Module) のコマンド ===

'''tree active''' - 植物モジュールの稼働状態を切り替えます。

'''tree freeze''' - 指定した雑木林の活動を一時停止／停止解除します。

'''tree load''' - XML ファイルから雑木林の設定情報を読み込みます。

'''tree plant '''- 雑木林の植え込みを開始します。

'''tree rate''' - 木の更新頻度を再設定します。 (ミリ秒)

'''tree reload''' - 見える範囲の木の設定情報を再ロードします。

'''tree remove''' - 木の設定情報を削除して、見える範囲の木を全て除去します。

'''tree statistics''' - 木の統計情報を表示します。

=== Windlight/[[LightShare]] モジュールのコマンド ===

'''windlight load''' - データベースから Windlight プロファイルをロードして、クライアントに配布します。

'''windlight enable''' - Windlight プラグインをオンにします。

'''windlight disable''' - Windlight プラグインをオフにします。

== アセット・サービス (Asset Service) のコマンド ==
*delete asset - データベースからアセットを削除します。実装はされていないようです。
*dump asset <ID> - ファイルシステムにアセットをダンプします。(開発中コードのみ)
*show digest <ID> - アセットの情報を簡単に表示します。

== ユーザ・サービス (User Service) のコマンド ==
* create user [first] [last] [passw] [RegionX] [RegionY] - 新しいユーザを作成し、パスワードを設定します。
:または: create user - 全てのデータを対話式に入力してユーザを作成します。
:
:'''スタンドアロンモードでユーザを作成する場合の注意点:''' ユーザのデフォルトの座標 1000,1000 をスタート地域のX・Y座標に指定してください。そうしないと、 "[LOGIN]: Not found region" というエラーメッセージが表示されます。
* logoff-user <firstname> <lastname> <message> - 指定したユーザをグリッドからログオフさせます。
* reset user password - ユーザのパスワードをリセットします。
* login-level <value> - ログインできるユーザのレベルの最低ラインを指定します。
* login-reset - ログインレベルをリセットします。
* login-text <ログインの間に表示される文字列>

== 地形モジュール (Terrain Module) コマンドの詳細 ==

==== terrain load ====
指定したファイルから地形データを読み込みます。

引数
* filename (String)
ロード元となるファイルを指定します。ファイルの拡張子で、どのローダーが使用するか判断します。サポートされている拡張子: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

==== terrain load-tile ====
大きなファイルの特定のセクションから地形データを読み込みます。

引数
* filename (String)
ロード元となるファイルを指定します。ファイルの拡張子で、どのローダーが使用するか判断します。サポートされている拡張子: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)
* file width (Integer)
横方向のタイル分割数を指定します。
* file height (Integer)
縦方向のタイル分割数を指定します。
* minimum X tile (Integer)
ファイルの最初のセクションの読み込み先となる地域の X 座標を指定します。
* minimum Y tile (Integer)
ファイルの最初のセクションの読み込み先となる地域の Y 座標を指定します。

==== terrain save ====
現在の起伏マップを指定したファイルに保存します。

引数
* filename (String)
起伏マップの保存先となるファイルの名称を指定します。ファイルの拡張子で、保存するフォーマットを判断します。サポートされている拡張子: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

==== terrain fill ====
現在の起伏マップを指定した値で埋めます。

引数
* value (Double)
地域に設定する標高を数字で指定します。

==== terrain elevate ====
現在の起伏マップを指定した分かさ上げします。

引数
* amount (Double)

==== terrain lower ====
現在の起伏マップを指定した分低くします。

引数
* amount (Double)
地形から引く標高をメートルで指定します。

==== terrain multiply ====
起伏マップに指定した値を掛けます。

引数
* value (Double)
起伏マップに掛ける数を指定します。

==== terrain bake ====
現在の地形データを退避マップ (Revert Map) に保存します。

==== terrain revert ====
退避マップの地形データを起伏マップに読み込みます。

==== terrain newbrushes ====
標準の地形ブラシから、実験段階のブラシに持ち替えます。警告: これはデバッグ用の設定なので、いつなくなるかはわかりません。

引数
* Enabled? (Boolean)
true / false - 新しいブラシにする

==== terrain stats ====
デバッグ用に地域の起伏情報を表示します。

==== terrain effect ====
指定したプラグイン・エフェクトをかけます。

引数
* name (String)
実行するプラグイン・エフェクトを指定します。'list' を指定するとプラグイン一覧を表示します。

== ハイパーグリッド系コマンドの詳細 ==

link-region <Xloc> <Yloc> <host> <port> <location-name>

* Xloc と Yloc にはワールドに応じて妥当な値を指定してください。具体的には、既にある地域に近いが、隣接していない場所を指定してください。
* osl2.nac.uci.edu と 9006 をリンク先の地域のホスト名・IPアドレスとポート番号に置き換えてください。

例) link-region 8998 8998 osl2.nac.uci.edu 9006 OSGrid Gateway

'''重要'''

ビューアのバグにより、どの方向でも 4096 セルを超えない範囲の地域にしかテレポートできません。このため、具体的には OSGrid に接続する際、OSGrid の中心となる、マップの (10,000; 10,000) 地点にアクセスできる範囲に地域を設置しなければなりません。8,000 番台か 12,000 番台のどれかに地域を設置してください。

link-mapping

== フレーム統計 (Frame Statistics) の値 ==

フレーム統計 (Frame Statistics) は、コンソールで "show stats" コマンドを発行すると表示されますが、ちょっと意味わからないかもしれません。以下に、それぞれの値の意味を一覧で掲載します。

*Dilatn - 時間延伸係数(Time Dilation)
*SimFPS - SIM の FPS
*PhyFPS - 物理的作用の FPS
*AgntUp - エージェントの更新回数
*RootAg - Root Agent の数
*ChldAg - Child Agent の数
*Prims - プリム数の合計
*AtvPrm - アクティブなプリムの数
*AtvScr - アクティブなスクリプトの数
*ScrLPS - １秒間に実行されたスクリプトの行数
*PktsIn - １秒間に受信したパケット数
*PktOut - １秒間に送信したパケット数
*PendDl - 保留中のダウンロードの数
*PendUl - 保留中のアップロードの数
*UnackB - 送達未確認のバイト数
*TotlFt - フレーム時間の合計
*NetFt - 通信にかかったフレーム時間
*PhysFt - 物理計算にかかったフレーム時間
*OthrFt - 他の処理にかかったフレーム時間
*AgntFt - エージェントの処理にかかったフレーム時間
*ImgsFt - 画像処理にかかったフレーム時間
{{DEFAULTSORT:さーばこまんど}}

[[Category:Japanese Translations]]

サポート

2012-03-04T07:05:50Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks/ja|Support}}
== サポートと貢献のプロセス ==
=== 助けを求める前に ===
* [[ニュース|最新ニュース]]ページで、最近のアップデートを確認しましょう。
* [[FAQ/ja|FAQ]] と [[トラブルシューティング]] で探しましょう。
* [[利用者向け説明書]] をくまなく検索してから助けを求めるようにしましょう。
* [[Definitions]] を読みましょう。
* [[:Category:Tech Reference|Technical Reference]] を確認しましょう。
* 設定ファイルを見て、明らかな欠陥がないか確認しましょう。
* 手順通りに進めていっているか確認しましょう。
* [http://opensimulator.org/mantis 既知のバグ]を確認しましょう。

=== サポートを受ける ===

これらを全部実施しても、まだ問題がある場合の手順はこちらです。この順に実施します:

#irc.freenode.net の #opensim と #opensim-dev で質問します。この順番であたってください :) 礼儀正しく、開発者や手伝ってくれる他の人はボランティアでそこにいて、あなたを手伝う義務がないということを念頭に置いてください。
#*質問するように依頼するのではなく、単刀直入に質問してください。
#*質問を質問の形式で書いてください。
#*具体的に。
#*問題を説明してください。
#*問題の再現方法を説明してください。
#*設定ファイルやエラーメッセージをコピペする必要がある場合は、 [http://pastebin.ca/ pastebin] に貼り付けて、そのリンクを IRC チャネルに送信してください。
#IRC でその時点でだれも助けることができない場合、利用者と開発者がコミュニケーションをとるためにあるメーリングリストにあたってみましょう。
#*[https://lists.berlios.de/mailman/listinfo/opensim-users opensim-users] - OpenSimulator のユーザサポート・フォーラム
#*[https://lists.berlios.de/mailman/listinfo/opensim-dev opensim-dev] - OpenSimulator の開発者フォーラム
#問題が OpenSimulator のバグに起因しているという結論に達したら、バグレポートを提出しましょう（やり方は後述）。これを実施する際には、バグレポートに必要な全てのデータがそろっているか確認しましょう。開発者が注目する良いバグレポートを提出するには、あなたのほうで相当努力しなければなりません。もしその努力をしたくないのであれば、わざわざバグレポートを提出しないでください。

オープンソースの開発者と触れ合うことに慣れていなければ、[http://www.catb.org/~esr/faqs/smart-questions.html これ]を読むことをおすすめします。絶対に面白いですよ！

=== 手伝ってもらった後 ===
* 問題がバグで、だれも助けてくれないとき、 [[Bugs|バグレポート]]を提出してください。やり方は以下を参照してください。
* 誰かが手伝ってくれたら、問題と解決方法が Wiki に載っていなければ Wiki に文書化しましょう。

=== オフィスアワーに参加する ===
プロジェクトに貢献したければ、あなたが（プロジェクトについて学んだあとに）やったほうがいいのは、インワールドの [[Office hours|OpenSimulator ディスカッションアワー]]に参加することです。

== バグを報告する ==

[[Bugs|バグを報告する]] を読んでください。

== 既知の問題 ==
[[BuildingIssues]]

== 将来要望 ==

あなたは Opensim をまだ行ったこともない面白い方向に発展させるアイデアをもっているかもしれません。もしそうなら、以下の手順を踏んでください:

* アイデアを電子メールや、できれば、Web のどこかに書きます。そして opensim-dev メーリングリスト上で議論を始め、あなたのアイデアについて開発者がどう考えているかを知り、実装についてのアドバイスを受けます。開発者が興味をもってないなと感じたら、GForge プロジェクトやあなたのプロジェクトでいつでも実装することができます。あなたのアイデアがコアな貢献となる可能性があると感じたら、次に読み進めてください。

* Opensim のあなたが持っているコピーでアイデアを実装し、利用者や開発者が特に努力しなくても試せるようにします。人々が試すのにかける努力が少なければ少ないほど、人々が試し、受け入れる可能性が高くなります。

* あなたがプログラマーでない場合、プログラマーの誰か（コアでも、コアでなくても）を説得してあなたの代わりに実装してもらうことしかできないでしょう。 Opensim の開発者はあなたの代わりに作業してくれませんし、'''彼らが''' 興味のあるものを実装するので手一杯です。アイデアが、裏付けるコードがないただのアイデアなら、それは無視されます。

* 実装が完了したら、パッチで提供して開発者にレビューしてもらいます。

== パッチを提供する ==

[[Submitting code to OpenSim]] を参照してください。

<cleanpage title=hide cats=hide />
{{DEFAULTSORT:さぽーと}}

[[Category:Japanese Translations]]

グリッドリスト

2012-03-04T07:05:40Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks/ja|Grid_List}}

= グリッドリストとは？ =

== グリッドリストについて ==
現時点で、更新などを行う時間以外は２４時間年中無休で運用しようとしている SIM がたくさんあります。気をつけてください - インベントリやランドスケープなどが復旧されるという保証はどこにもありません。このため、これはせいぜいベータグリッド程度のものだと考えてください。 Opensim リンクでログインするためには、 [http://lab.newworldgrid.com/index.php/OpenSim_Launcher OpenSimulator ランチャー]をインストールするか、ブラウザに[[Browser Protocol Handler|プロトコルハンドラ]]を追加する必要があります。そうでなければ、 Second Life ビューアに[[Connecting|ショートカット]]を作成して適切なパラメタを追加するとよいでしょう。

== 公開グリッド ==

<big>重要事項:</big>OpenSimulator プロジェクトは誰でも使うことのできるアプリケーションプラットフォームです。このページに掲載されているグリッド、グリッドの内容やグリッドで行われている活動について責任を負うものではありません。
グリッドリストポリシー: あなたのソフトウェアが OpenSimulator.org SVN ソフトウェアコードをベースにしている場合にだけ、リストにご自分のグリッドを掲載してください。他のグリッドは全て削除されます。また、ご自分のグリッドの Web サイトにこのプロジェクトの Web サイトのリンクを貼って、相互リンクになるようにしてください。<br /><br /> グリッドを持っていて、グリッド連合に加入したい場合は、このページを参照してください: [[Grid Associations]] <br /><br /> 公開グリッドは所有者の Web サイトにアカウントを作成し、それを使ってグリッドにログインするする必要があります。<br /><br />これらのグリッドは出現した順に並んでいます。リストの上のほうに追加されているのを発見次第、誰かに削除されます。リストの最後尾に追加してください。例外はありません。<br /><br />メインリストのグリッドリストの内容にはグリッド名と列ヘッダに定義されている番号だけでなければなりません。[[Grid List/Template|この]]テンプレートを使って、サブページに入る情報が比較できる書式となるようにしてください。よろしくお願いします。<br /><br /> [http://spreadsheets.google.com/pub?key=rHNVZVIc1-GdXzqx2Ac4NDQ&gid=4 ユーザの多い順]、[http://spreadsheets.google.com/pub?key=rHNVZVIc1-GdXzqx2Ac4NDQ&gid=6 ３０日以内にログインしたユーザの多い順]([http://spreadsheets.google.com/pub?key=rHNVZVIc1-GdXzqx2Ac4NDQ&oid=6&output=image チャート])に並んでいます。

<br /><br />

{| border="1" cellpadding="5" cellspacing="0" align="center"
!名前
!Web サイト
!ログイン URI
!地域 #
!ユーザ #
|-
|TUIS Open Grid
|http://www.opensim.tuis.ac.jp/
|http://opensim.tuis.ac.jp:8002/
|20
|50
|-
|OPEN NEBURA
|http://www.opennebula.net/
|http://60.32.217.116:8002/
|9
| 
|-
|NS GRID
|http://www.nasco-sys.co.jp/opensim01.html
|http://opensim.nasco-sys.co.jp:8002/
|8
| 
|}

海外の公開グリッドは、[[Grid List#Public grids|こちら]]を参照してください。

== オフィスアワー ==

毎週火曜日に、OSGrid は公式オフィスアワーを開催しています。そこで、開発者が集まって、その週のソフトウェア開発作業について打ち合わせを行います。ここは OpenSimulator で何が起きようとしているかを知る良い場所です。

オフィスアワーの日程は、[[Grid List#Office Hour|こちら]]を参照してください。

== グリッドテストアワー ==

グリッドによっては、プロジェクトに貴重なテスト情報を提供して、それぞれが特別な「テスト」時間を設けて、プラットフォームの性能をテストしているところがあります。これらは毎週同じ時間に実施されています。あなたが抱える疑問に答えられる人と出会うことができる良いきっかけともなります。

テストアワーの日程は、[[Grid List#Grid Test Hours|こちら]]を参照してください。

== スタンドアロン SIM ==

スタンドアロン SIM は "Testa User" .. "Testz User" 、パスワード "test" で「匿名」ログインすることができます。

スタンドアロン SIM の一覧は、[[Grid List#Standalone sims|こちら]]を参照してください。

= 参考情報 =

* [http://spreadsheets.google.com/pub?key=rHNVZVIc1-GdXzqx2Ac4NDQ&gid=4 グリッドリスト（ユーザの多い順）]
* [http://spreadsheets.google.com/pub?key=rHNVZVIc1-GdXzqx2Ac4NDQ&gid=6 グリッドリスト（３０日以内にログインしたユーザの多い順）]
* [[Grid Associations|グリッド連合]]
* [[Public Hypergrid Nodes|HyperGrid ノード]]

{{DEFAULTSORT:ぐりっどりすと}}

[[Category:Japanese Translations]]

Opensim-ru

2012-03-04T07:05:31Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{MainPageQuicklinks|Main Page}}



{{Information}}

=== Что такое OpenSimulator? ===
{{FrontPageSidebar}}

OpenSimulator это сервер трёхмерного окружения. Он может быть использован для создания виртуальной среды(или вселенной) к которой можно присоединиться используя различные программы-клиенты, на нескольких протоколах. OpenSimulator позволяет создавать свою среду используя технологии, которые вы считаете наилучшими для своих целей - разработанные [[Используйте модули регионов|модули раширения]] позволяют создать полностью индивидуальную конфгуацию сервера. OpenSimulator выпущен под [[Лицензия BSD|лицензией BSD]], делающей его одинаково удобным для внедрения в приложениях с открытым кодом и коммерческих продуктах.



=== Особенности ===
Хотя OpenSimulator относительно молодое програмное обеспечение, у него всёже есть множество полезных функций:
* поддерживается создание нескольких "миров" на одном сервере;
* поддерживаются несколько клиентв и протоколов - доступ к одному и тому же "миру" одновременно через несколько протоколов;
* широкие возможности для настройкки вашего аватара, включая одежду, скины и одеваемы предметы;
* моделирование физики в реальном времени, используя несколько различных движков, включая ODE;
* возможность создавать контент в реальном времени прямо в среде, используя встроенные инструменты;
* возможность создания внутри среды приложений, используя ряд различных языков программирования, в том числе - LSL/OSSL, C#, JScript и VB.NET.

=== Использование OpenSimulator ===
Самый быстрый способ начать использовать OpenSimulator, это создать учётную запись на [http://osgrid.org OSGrid], а затем [http://osgrid.org OSGrid] скачать [http://opensim-viewer.sourceforge.net/ Hippo Viewer] или [http://secondlife.com/support/downloads.php Linden Lab's Second Life viewer] (в числе прочих клиентов) для подключения к OSGrid. 

=== Запуск своего собственного сервера OpenSimulator ===

Если вы заинтересованы в создании своего собственного сервера OpenSimulator, для разещения собственной трёхмерной среды, то вам необходимо ознакомиться с информацией в следующих статьях:

*[[Скачивание|Скачать OpenSimulator]]
*[[Инструкции по компиляции|Компиляция OpenSimulator]]
*[[Настройка|Настройка OpenSimulator]]
*[[Настройка мега-регионов]]
*[[Запуск|Запуск OpenSimulator]] '''(Windows / Linux скрипты для управления и обслуживания)'''
*[[Консольные команды]]
*[[ЧАВо|Часто задаваемые вопросы по запуску OpenSimulator]]
*[[Технические руководства]]
*[http://ru.wikibooks.org/wiki/Diva_distro Инструкция по установке Diva distro]



{{Layout_box2|1=
=== Pages by Category: ===
<b>
[[:Category:Getting_Started | Getting Started]] , [[:Category:Support | Support]] , [[:Category:Tech Reference|Technical Reference Pages]] , [[:Category:Help|Help]] , [[:Category:Configuration|Configuration Pages]] , [[:Category:Users|User's Pages]] , [[:Category:Development | Development Pages]] , [[:Category:Scripts|Scripts]] , [[:Special:Recentchanges| Recent Wiki Changes]]</b><br />
}}



[[Category:Russian Translations]]

XSimStatus

2012-03-04T07:05:09Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

This old facility provides a way to retrieve some very basic region data and some more detailed information about the simulator as a whole. It is always active.

Each region will register a URL handler with a random UUID. There will also be a handler that will return data for the simulator as a whole. These UUIDs will be different on each restart of the simulator but are stored in the regionSecret field of the regions table. However, this is not useful for standalone simulators since they do not persist this table.

So a two region simulator will have three handlers, one for each simulator and one for the simulator as a whole.

Sending a GET request to a handler will return data in JSON format.

You can see these handlers using the region console command

show http-handlers

In the last section you should see something like

* StreamHandlers (7):
POST:/friends
GET:/map
GET:/get_grid_info
GET:/F27ED466A0D311F8A7B1F309F942437F3302D455
GET:/493F5C64F8AF200E63C9A33EA92BD393D9232A61
GET:/simstatus
GET:/1B71AB5959171C2308F429E8F397F0390ADEF94D

Here, F27ED466A0D311F8A7B1F309F942437F3302D455, 493F5C64F8AF200E63C9A33EA92BD393D9232A61 and 1B71AB5959171C2308F429E8F397F0390ADEF94D are XSimStatus handlers. Unfortunately, it's not possible to tell which are which except by pointing your browser at them. Let's suppose you are running a standalone on 192.168.1.2 with an HTTP listener port of 9000. In this case, going to

<pre>http://192.168.1.2:9000/F27ED466A0D311F8A7B1F309F942437F3302D455</pre>

yields

<pre>
{
"OSStatsURI":"http://192.168.1.2:9000/1B71AB5959171C2308F429E8F397F0390ADEF94D/",
"TimeZoneName":"GMT",
"TimeZoneOffs":1.0,
"UxTime":1318276065,
"Memory":31.0,
"Version":"OpenSimulator 0.7.3 Dev "
}
</pre>

This is data for a particular region. In the OSStatsURI field it does give the statistics handler for the simulator as a whole. Sending a get request to http://192.168.1.2:9000/1B71AB5959171C2308F429E8F397F0390ADEF94D/ returns

<pre>
{
"AssetsInCache":"0",
"TimeAfterCacheMiss":"0",
"BlockedMissingTextureRequests":"0",
"AssetServiceRequestFailures":"0",
"abnormalClientThreadTerminations":"0",
"InventoryServiceRetrievalFailures":"0",
"Dilatn":"1",
"SimFPS":"56.67",
"PhyFPS":"46.93",
"AgntUp":"0",
"RootAg":"0",
"ChldAg":"0",
"Prims":"1",
"AtvPrm":"0",
"AtvScr":"1",
"ScrLPS":"0",
"PktsIn":"0",
"PktOut":"0",
"PendDl":"0",
"PendUl":"0",
"UnackB":"0",
"TotlFt":"0.67",
"NetFt":"0",
"PhysFt":"0.33",
"OthrFt":"0",
"AgntFt":"0.33",
"ImgsFt":"0",
"Memory":"21",
"Uptime":"00:20:49.0991070",
"Version":"OpenSimulator 0.7.3 Dev 013bf27"
}
</pre>

Unfortunately, the simulator stats here are only for one region. In a multi-region simulator which one this is is not defined and will change depending on exactly when the URL is called. Also, the top 6 statistics (AssetsInCache to InventoryServiceRetrievalFailures) are not currently in use.

WxService

2012-03-04T07:04:59Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

== An example module for Robust ==
WxService is a user-space module consisting of a set of connector, service and handler for Robust. It provides a starting point and example for writing modules to run in the Robust server shell. The example framework demonstrates...
* the steps needed to configure and load the application under the Robust server
* servicing requests that interact with existing core OpenSimulator services
* adding commands to the Robust console
* adding a custom database with migrations
* building an application under Robust

The purpose of WxService is to show how one can leverage the Robust shell to provide points of interaction with OpenSimulator core for external applications. This gives anyone an opportunity to build applications that can interact with OpenSimulator without manipulating the databases directly (bad, bad, bad). It also allows applications that have traditionally used in external apache/php services to be more tightly integrated into the OpenSimulator framework. It should make distribution of modules to users simpler by using the OpenSimulator database facilities to migrate data on installations or upgrades. And, the applications can be made better by providing management commands in the console.

== '''Example code''' ==
The code is laid out in directories similar to the core services and connectors in OpenSimulator core and is heavily commented. It should be pretty easy to follow and adapt to your own projects. See: http://bluewallvirtual.com/WxService_Reloaded for code and discussion forum. For help, post in the forum there (no account required) or find me (BlueWall) on IRC - Freenode #opensim

WikiStructure/de

2012-03-04T07:04:51Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks|WikiStructure}}
= An dieser Wiki mitwirken =

Erst mal herzlichen Dank, dass Sie uns bei dieser Wiki unterstützen möchten. Bevor Sie jedoch beginnen, ist es sehr wichtig, dass Sie ein grundlegendes Verständnis davon haben, wie man eine Wiki editiert und wie sie funktioniert

Hier folgen einige grundlegende Wiki-spezifische Tags und Konzepte:
# In einer Wiki brauchen Sie kein HTML. Verwenden Sie stattdessen die [http://www.mediawiki.org/wiki/Help:Formatting Wiki-Markup Äquivalente]. Benutzen Sie AUSSCHLIEßLICH die Wiki-Markup, wenn Sie Seiten editieren.
# Möchten Sie eine andere Seite verlinken? Nehmen Sie den Namen der Seite (nicht die URL!) und setzen Sie diesen in doppelte eckige Klammern. Etwa so: '''<nowiki>[[Beispiel]]</nowiki>'''. Nachdem Sie die Seite abgespeichert haben, wird es dann so aussehen [[Beispiel]]. Dies wird ein interner Link genannt.
# Wenn Sie eine neue Seite erstellen, stellen Sie sicher, dass Sie diese einer Kategorie zuordnen. Um dies zu tun, besuchen Sie [[:category:categories]], und finden Sie dort die Kategorie, welche am besten zu Ihrem Artikel passt. Fügen Sie dann den Text '''<nowiki>[[Category:NameDerKategorie]]</nowiki>''' Ihrer Seite hinzu.
# Um bereits existierende HTML-Tabellen in die Wiki-Markup zu konvertieren, können Sie das Online-Werkzeug auf http://www.uni-bonn.de/~manfear/html2wiki-tables.php benutzen. Es funktioniert wirklich gut.
# Leeren Sie '''NIEMALS''' eine Seite. Die Informationen können immer noch nützlich für manche Menschen sein, egal wie veraltet sie sein mögen. Nutzen Sie stattdessen ein [[WikiStructure#Tags|Tag]], um anzuzeigen, dass es keine aktuellen Infos sind. Falls Sie glauben, dass eine Seite besser gelöscht als archiviert werden sollte, ziehen Sie zuerst in Betracht, diese zu verwandten Seiten umzulenken. Wenn Sie einen veralteten Artikel (nennen wir ihn „A“) finden, dessen Inhalt im Großen und Ganzen der gleiche ist, wie ein anderer gepflegter Artikel (nennen wir ihn „B“), setzen Sie '''<nowiki>#Redirect [[B]]</nowiki>''' in eine leere Seite A. Falls Sie trotz all Ihrer Bemühungen keine verwandte Seite finden können, so setzen Sie '''<nowiki>{{delete|Ihr Grund, warum Sie die Seite löschen möchten}}</nowiki>''' ganz oben auf die Seite und speichern Sie diese ab. Ein Sysop (auch Wiki-Admin genannt) wird sich dann Ihren Wunsch auf Löschung anschauen, und die Seite löschen, wenn er diesen akzeptiert. Die einzige Ausnahme von dieser Regel sind Seiten, die nur Spam enthalten. Werfen Sie sie in unseren Mülleimer, indem Sie '''<nowiki>#Redirect [[Trash Bin]]</nowiki>''' setzen. Danach wird Sie auf [[Trash Bin]] umgeleitet, ohne auch nur den griffigen Titel der Spam Seite anzuzeigen.

Weitere Informationen dazu, wie man Wiki-Seiten editiert, finden Sie unter http://www.mediawiki.org/wiki/Help:Editing

== Wobei brauchen wir Ihre Hilfe? ==

Es gibt mittlerweile viele Seiten in der Opensim-Wiki und einige sind nicht wirklich in Schuss.

Schauen Sie sich um und wenn Sie einen Artikel finden, den Sie ergänzen können, dann zögern Sie nicht, dies auch zu tun. Ein Ort, an dem Sie nachsehen können, ist die [[:Category:Stubs|

The stubs Kategorie]], Hier finden Sie Seiten, die Ergänzungen brauchen.

Ein anderer Weg uns zu unterstützen ist, sich durch die Seiten zu lesen und diese zu taggen. Schauen Sie hierzu weiter unten nach den Tags und Templates, die Sie auf die Seiten dieser Wiki anwenden können.

== Wie finden Sie Dinge, die zu tun sind? ==
Schauen Sie auf den folgenden Seiten nach, um Aufgaben zu finden, an denen Sie arbeiten können:

*[[Special:UncategorizedCategories|Unkategorisierte Kategorien]] - Diese Kategorien müssen einer Kategorie zugeordnet werden.
*[[Special:UncategorizedImages|Unkategorisierte Bilder]] - Diese Bilder müssen einer Kategorie zugeordnet werden.
*[[Special:UncategorizedPages|Unkategorisierte Seiten]] - Diese Seiten müssen einer Kategorie zugeordnet werden.
*[[Special:UnusedCategories|Ungenutzte Kategorien]] - Ungenutzte Kategorien. Bearbeiten Sie die Seiten, um sie diesen Kategorien hinzuzufügen, oder markieren Sie sie zur Löschung.
*[[Special:ShortPages|Kurze Seiten]] - Kurze Seiten müssten vielleicht erweitert werden.
*[[Special:LongPages|Lange Seiten]] - Lange Seiten sollten vielleicht in separate Unterseiten aufgeteilt werden.
*[[Special:DoubleRedirects|Doppelte Weiterleitungen]] - Doppelte Weiterleitungen belasten den Server unnötig. Entfernen Sie die mittleren Weiterleitungen und ändern Sie die Erste, sodass Sie auf die Letzte in der Kette zeigt.
*[[Special:DeadendPages|Sackgassen-Seiten]] - Sackgassen-Seiten haben keinerlei Links zu anderen Seiten. Um eine Wiki funktionieren zu lassen, wie Sie es sollte, fügen Sie Links zu anderen Seiten hinzu.
*[[Special:BrokenRedirects|Kaputte Weiterleitungen]] - Kaputte Weiterleitungen zeigen auf nichtexistente Seiten. Diese sollten gelöscht, oder so geändert werden, dass aus Ihnen nützliche Artikel werden.
*[[Special:LonelyPages|Verwaiste Seiten]] - Diese Seiten sind Seiten, die nicht verlinkt sind, oder auf die falsch verlinkt wurde (wie zum Beispiel unter Verwendungen eines externen anstatt eines internen Links).
*[[Special:WantedPages|Erwünschte Seiten]] - Diese Seiten existieren noch nicht, werden aber gebraucht. Bitte erstellen Sie diese, wenn Sie das können (und füllen Sie sie bitte mit Inhalten. Keine Platzhalter!).

=== Was müsste noch getan werden? ===
*Aktualisieren Sie Navigationslinks - Mark Malewski
*Überprüfen Sie die Wiki auf verwaiste Seiten und kaputte Links - Mark Malewski
*Überreden Sie Entwickler und versuchen Sie aktuelle Inhalte für die WIKI-Seiten zu bekommen - Mark Malewski
*Erstellen einer Mind Map für die Wiki - SeanDague

Schauen Sie auch unter [[WikiTodo]] nach

= Tags =
Die folgenden Templates sollten benutzt werden, um Seiten zu taggen, die nicht dem Standard entsprechen. Das wird uns dabei helfen, sich um eine Liste der Dinge zu kümmern, die gebraucht werden, um die Wiki zu verbessern. Sorgen Sie sich nicht zu sehr darum, eine Seite falsch zu taggen. Diese Seiten zu taggen, läßt sie unter verschiedenen Kategorien auftauchen und Wiki Admins, oder sogar Benutzer, werden diese Tags wieder löschen, wenn sie nicht passen sollten.

=== Wie es gemacht wird ===
Um eine Seite zu taggen, fügen Sie das passende Template in den Artikelkorpus, genau vor den Text, den Sie taggen möchten, ein. Wenn Sie den Artikel speichern, wird das Template automatisch in eines der Kästchen, die Sie weiter unten sehen, übersetzt.

'''Beispiel :''' Sie stoßen auf einen Artikel über ein Add-on eines Dritten, oder einer Software, welche noch nicht getagged wurde. Sie editieren die Seite und treffen auf einen Artikelkorpus, der wie folgt aussieht:
<nowiki>
= Irgendweine Software eines Drittanbieters =

Die Software ''soundso'' wurde entworfen, um [[diesunddas]] einfacher verwalten zu können, und […]</nowiki>
Um das Template hierauf anzuwenden, fügen Sie den Text '''<nowiki>{{thirdparty}}</nowiki>''' dem Artikelkorpus hinzu.
Der Artikelkorpus wird dann wie folgt aussehen:
<nowiki>
{{thirdparty}}
= Irgendweine Software eines Drittanbieters =

Die Software ''soundso'' wurde entworfen, um [[diesunddas]] einfacher verwalten zu können, und […]</nowiki>
Die meisten Templates werden den Artikel einer Kategorie hinzufügen, was ihn leichter auffindbar macht.

== Seiten die berichtigt werden müssen ==

{{obsolete}}
'''Zweck''': Diese Seite hatte zu einem bestimmten Zeitpunkt wertvolle Informationen, sie ist allerdings zu veraltet, um noch von Wert zu sein. Wir müssen die Informationen in einer anderen Seite unterbringen, oder machen Sie sich die Mühe, diese Seite zu aktualisieren.

'''Tag:''' <nowiki>{{obsolete}}</nowiki>

{{archive}}
'''Zweck:''' Die Informationen dieser Seite sind veraltet. Dennoch können sie für manche Menschen von Wert sein (Beispiele sind Chatlogs, Versionshistorie, oder OpenSimulator 0.6x spezifische Informationen), oder sie müssen aus anderen Gründen aufbewahrt werden. Sie sollten als archivierte Informationen gekennzeichnet werden, um Verwirrungen vorzubeugen.

'''Tag:''' <nowiki>{{archive}}</nowiki>

{{needsexample}}
'''Zweck:''' Obwohl der Inhalt auf dieser Seite gut sein mag, ist es schwer ihn ohne Beispiele zu verstehen. Wir hätten gerne Beispiele auf dieser Seite, damit sie Anwenderfreundlicher wird.

'''Tag:''' <nowiki>{{needsexample}}</nowiki>

{{content}}
'''Zweck:''' Diese Seite enthält ein wenig Informationen, ist aber sehr unvollständig. Sie kann möglicherweise an ihrem Platz bleiben, benötigt aber etwas mehr Pflege.

'''Tag:''' <nowiki>{{content}}</nowiki>

== Seiten die gelöscht werden sollten (sparsam verwenden!) ==

{{delete|Dies ist ein Beispiel für ein Lösch-Tag.}}
'''Zweck:''' Diese Seite gehört nicht in dieses Wiki. Sie enthält Spam, ist eine leere Seite, ist eine selbstgefällige Seite, oder wird aus anderen Gründen als Schund angesehen.

''Nennen Sie immer den Grund für Ihre Löschanfrage.'' Ohne Grund wird diese Seite nicht gelöscht werden.

'''Tag:''' <nowiki>{{delete|Grund}}</nowiki>

'''Beispiel:''' <nowiki>{{delete|Dies ist ein Beispiel für ein Lösch-Tag.}}</nowiki>

== Informelle Tags für Seiten ==

{{proposal}}
'''Zweck:''' wird benutzt, um Vorschläge für die '''Zukunft''' wiederzugeben, damit die Leute nicht auf die Idee kommen, dass OpenSimulator zur Zeit auf diese Weise funktioniert.

'''Tag:''' <nowiki>{{proposal}}</nowiki>

{{deprecate|Nov. 21 1997|NewArticle}}
'''Zweck:''' Wird auf Seiten mit missbilligten Funktionen verwendet. Eine neue Seite mit der Ersatzfunktion soll erstellt werden. Es wird vorgeschlagen den Inhalt der Seite mit der missbilligten Funktion zu kopieren und die Änderungen am Inhalt der neuen Seite durchzuführen.

'''Tag:''' <nowiki>{{deprecate|<MM DD YYYY>|<neuer Name>}}</nowiki>

'''Beispiel:''' <nowiki>{{deprecate|Nov. 21 1997|Neuer Artikel}}</nowiki>

{{thirdparty}}
'''Zweck:''' Wird auf Seiten verwendet, die von Drittanbieter Add-ons, Modulen und so weiter handeln. Um sie klar, einheitlich und ohne Aufwand als Drittanbieter-Software zu kennzeichen.

'''Tag:''' <nowiki>{{thirdparty}}</nowiki>

[[Category:Support]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Development]]
[[Category:German Translations]]

WikiStructure

2012-03-04T07:04:41Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks}}
= Contributing to the Wiki =

Thank you for wanting to help with the wiki, but before you start, it is very important that you have a basic understanding of how to edit a wiki, and how it works

Here are a few basic wiki-specific tags and concepts:
# In a wiki, you don't need HTML. Instead, use the [http://www.mediawiki.org/wiki/Help:Formatting Wiki markup equivalents]. Use ONLY Wiki markup when editing pages.
# Want to link to another page? Take the name of the page (not the URL!) and put them in double square brackets, like so: '''<nowiki>[[Example]]</nowiki>'''. After saving the page, it will look like [[Example]]. This is called an internal link.
# If you create a new page, make sure to add it to a category. To do so, first go to [[:category:categories]], from there, find the category that'd be best suited for your article. Then add the text '''<nowiki>[[Category:NameOfCategory]]</nowiki>''' to your page.
# To convert existing HTML tables to Wiki markup, you can use the online tool at http://www.uni-bonn.de/~manfear/html2wiki-tables.php which does a pretty good job.
# '''NEVER EVER''' empty a page. The information, no matter how outdated it may be, may still be useful to some people, so use a [[WikiStructure#Tags|tag]] to indicate that it's non-current info. If you believe that a page should be deleted instead of being archived, first consider make a redirect to relative pages. If you find an outdated article(we'll call it "A") which contents is almost the same as another maintained article(call it "B"), put '''<nowiki>#Redirect [[B]]</nowiki>''' in empty page A. If you can't find related page despite of your every effort, put '''<nowiki>{{delete|Your reason for wanting the page deleted}}</nowiki>''' to the top of the page, and save it. A sysop (a.k.a. Wiki admin) will then review your proposal to delete, and if accepted, will delete the page. The only exception to this rule, are pages that only contain spam. Throw it into our trash bin by putting '''<nowiki>#Redirect [[Trash Bin]]</nowiki>'''. After that, it will redirect to [[Trash Bin]] page without even showing the big catchy title of the spam page.

For more info on how to edit Wiki pages, see http://www.mediawiki.org/wiki/Help:Editing

== What do we need help with? ==

There are a lot of pages in the opensim wiki today, many of which aren't really up to snuff.

Have a look around, and if you find an article that you think you can add to, then feel free to do so. One place to look could be [[:Category:Stubs|The stubs category]], where you can find pages that are in need of expansion.

Another way to help, is to go through and tag pages. See below for tags and templates that you could apply to the pages in the wiki.

== How to find stuff to do ==
See the following pages for things that need work:

*[[Special:UncategorizedCategories|Uncategorized Categories]] - These categories need to be put into a category.
*[[Special:UncategorizedImages|Uncategorized Images]] - These images need to be put into a category.
*[[Special:UncategorizedPages|Uncategorized Pages]] - These pages need to be put into a category.
*[[Special:UnusedCategories|Unused Categories]] - Unused categories. Edit pages to add them to these categories, or mark for deletion.

*[[Special:ShortPages|Short Pages]] - Short pages may need to be expanded.
*[[Special:LongPages|Long Pages]] - Long pages may need to be split into separate sub-pages.

*[[Special:DoubleRedirects|Double Redirects]] - Double redirects put an unnecessary load on the server. Remove the middle redirect(s) and change the first one to point to the last page in the chain.
*[[Special:DeadendPages|Dead-end Pages]] - Dead-end pages don't have any links to other pages. To keep the wiki work like a wiki should, add links to other pages.
*[[Special:BrokenRedirects|Broken Redirects]] - Broken redirects point to nonexistent pages. These should be deleted, or modified so they become useful articles.

*[[Special:LonelyPages|Orphaned pages]] - These pages are pages that are not being linked to, or have been incorrectly linked to (like by using an external link instead of an internal one).
*[[Special:WantedPages|Wanted Pages]] - These pages don't exist yet, but are needed. Please create them if you can (and make sure to add content to them. No placeholders!).

=== What else is there to be done? ===
*Update Navigation links - Mark Malewski
*Check the WIKI for orphan pages and bad links - Mark Malewski
*Twist the developer's arms, and try to get updated content for WIKI pages - Mark Malewski
*Mind Map for the Wiki - SeanDague

See also [[WikiTodo]]

= Tags =
The following templates should be used to tag pages that are not up to par. This will help us keep a list of things needed to improve the wiki. Don't worry too much about marking a page incorrectly, tagging these pages makes them show up under various Categories and wiki admins, or even users, will clear tags if they aren't appropriate.

=== How to use ===
To tag a page, put the appropriate template in the article's body, just before the text that you want to tag. When saving the article, the template will automatically be translated into one of the boxes that you see below.

'''Example : '''
You come across an article about a third-party addon, or software that was not yet tagged. You edit the page, and find that the article body looks like this:
<nowiki>
= Some Third Party Software =

The software ''foo'' was designed to make [[bar]] easier to manage, and [...]</nowiki>
To apply the template, add the text '''<nowiki>{{thirdparty}}</nowiki>''' to the article's body.
The article body will then look like this:
<nowiki>
{{thirdparty}}
= Some Third Party Software =

The software ''foo'' was designed to make [[bar]] easier to manage, and [...]</nowiki>
Most templates will automatically add the article to a category, to make them easier to find.

== Pages That Need Fixing ==

{{obsolete}}
'''Purpose''': This page had good information at one point, but it is too out of date to really have value now. We need to capture the information in another page, or do major work to bring the page up to date.

'''Tag:''' <nowiki>{{obsolete}}</nowiki>

{{archive}}
'''Purpose:''' The information on this page is out of date. However, it may still hold value to some people (examples are chat logs, version history, or OpenSimulator 0.6x specific info) or needs to be preserved for other reasons. It should be marked as archived information to prevent confusion.

'''Tag:''' <nowiki>{{archive}}</nowiki>

{{needsexample}}
'''Purpose:''' While the content of the page is good, it's too hard to understand without examples. We'd like to get examples into this page to make it more user friendly.

'''Tag:''' <nowiki>{{needsexample}}</nowiki>

{{content}}
'''Purpose:''' This page has a little bit of information, but it's very incomplete. It probably can stay in the same place but needs more helping hands.

'''Tag:''' <nowiki>{{content}}</nowiki>

== Pages that need deleting (use sparsely!) ==

{{delete|This is an example of the delete tag.}}
'''Purpose:''' This page does not belong on the wiki. It contains spam, is an empty page, a vanity page, or is considered rubbish otherwise.

''Always specify the reason for the delete request.'' Without one, the page will not be deleted.

'''Tag:''' <nowiki>{{delete|Reason}}</nowiki>

'''Example:''' <nowiki>{{delete|This is an example of the delete tag.}}</nowiki>

== Informational Tags for Pages ==

{{proposal}}
'''Purpose:''' This is used on pages that represent '''future''' proposals, so that people don't get the idea that this is the way that opensim currently works.

'''Tag:''' <nowiki>{{proposal}}</nowiki>

{{deprecate|Nov. 21 1997|NewArticle}}
'''Purpose:''' To be used on the pages of deprecated functions. New page is to be created with replacement function. Suggest copying over the content of the page of the deprecated function, and make modifications in the content of the new page.

'''Tag:''' <nowiki>{{deprecate|<MM DD YYYY>|<newname>}}</nowiki>

'''Example:''' <nowiki>{{deprecate|Nov. 21 1997|NewArticle}}</nowiki>

{{thirdparty}}
'''Purpose:''' To be used on pages dealing with 3rd party add-ons, modules, and so forth, so as to clearly, uniformly, and effortlessly mark them as 3rd party software.

'''Tag:''' <nowiki>{{thirdparty}}</nowiki>

[[Category:Support]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Development]]

Wifi

2012-03-04T07:04:31Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{quicklinks}}
{{thirdparty}}
'''Wifi - A Simple Account Management Front-end'''

"Wifi" stands for "Web Interface For... I", and is an '''add-on''' module which is not a standard part of OpenSimulator. It is provided by Diva Canto and can be added to OpenSimulator 0.7 onwards.

== '''PLEASE NOTE''' ==
'''Packaged binary versions of Wifi are available from http://github.com/diva/d2/downloads in two packages: as part of the standalone Diva distribution (D2) of OpenSimulator, and another package for use with a ROBUST server grid implementation of OpenSimulator. The latter package (Wifi for Robust) is NOT intended to work with standalone implementations of OpenSim.'''

----

== Introduction ==
'''


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.

Its 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 management of user inventory 
* A welcome page which can be used as login page for the user's viewer.

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

# It doesn’t require an additional web server; it’s all done with built-in OpenSimulator features.
# Using OpenSimulator features bring many technical benefits. These benefits aren't visible immediately, but it will show its value in the future. Unlike other Web apps that access the database directly, Wifi works by communicating with OpenSimulator directly. This means that any future changes to the OpenSimulator database structure, will not affect Wifi.
# Technically speaking, Wifi is a set of components that can be used by both standalone sims, as well as [[ROBUST]] (Grid) servers.

== Adding Wifi to your OpenSimulator Setup ==

'''Additions to Standard OpenSimulator Distribution (from 0.7 onwards)'''

=== Binary Approach ===

Obtain the latest Wifi module distribution zip from
http://github.com/diva/d2/downloads
and place the files as instructed in the equivalent locations in your OpenSimulator directory.

bin directory
* add bin/Diva.Wifi.dll
* add bin/Diva.Wifi.ScriptEngine.dll
* add bin/Diva.OpenSimServices.dll
* for standalones, also add bin/Diva.Modules.dll (this doesn't exist in the module zip! Get it from the diva-rxxxxx.zip file instead.)

Copy WifiPages directory and its contents to OpenSimulator top level directory.

doc directory
* add in doc/WIFI.txt

Copy over the WIFI related readme, release notes and licence text files.

For grids, edit Robust(.HG).ini in section [Startup] to add 8002/Diva.Wifi.dll:WifiServerConnector to <code>ServiceConnectors</code>.

For standalones, edit StandaloneCommon.ini in section [Modules] to add <code>WifiModule = true</code>.

Add a new section [WifiService] from example at http://github.com/diva/diva-distribution/blob/master/addon-modules/Wifi/Wifi.ini.example to Robust(.HG).ini (for grids) or StandaloneCommon.ini (for standalones).

=== Source Code Approach ===

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

== Setting Configuration Parameters for a Grid ==

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

'''Additions to Robust.ini or Robust.HG.ini for Grids'''

<source lang="ini">[Startup]
ServiceConnectors = "8002/Diva.Wifi.dll:WifiServerConnector"
</source>

Note that it will be usual to specify the port number to be accessible outside your firewall (normally port 8002) rather than the default Network Port for internal inter-component OpenSimulator traffic (normally port 8003) which can be set to only be accessible within a firewall.

<source lang="ini">[WifiService]
GridName = "grid name"
LoginURL = "http://<hostname>:8002"
WebAddress = "http://<hostname>:8002"

;; The Wifi Administrator account
AdminFirst = "Wifi"
AdminLast = "Admin"
AdminEmail = "you@example.com"

;; Do you want to be able to control grid registrations?
AccountConfirmationRequired = false

;; Default avatars for new account registration
;; Syntax: AvatarAccount_<AvatarType> = "<FirstName> <LastName>"
;; Appearance and attachments are copied from avatar <FirstName> <LastName>.
AvatarAccount_Female = "Female Avatar"
AvatarAccount_Male = "Male Avatar"
AvatarAccount_Neutral = "Neutral Avatar"

;; Preselection for default avatar in new account registration
AvatarPreselection = "Neutral"

;; 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"
</source>

== Setting Configuration Parameters for a Standalone ==

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

'''Additions to config-include/StandaloneCommon.ini for Standalones'''

<source lang="ini">[Modules]
WifiModule = true

[WifiService]
GridName = "grid name"
LoginURL = "http://<hostname>:9000"
WebAddress = "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

;; Default avatars for new account registration
;; Syntax: AvatarAccount_<AvatarType> = "<FirstName> <LastName>"
;; Appearance and attachments are copied from avatar <FirstName> <LastName>.
AvatarAccount_Female = "Female Avatar"
AvatarAccount_Male = "Male Avatar"
AvatarAccount_Neutral = "Neutral Avatar"

;; Preselection for default avatar in new account registration
AvatarPreselection = "Neutral"

;; 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"
</source>

== Configurable Default Avatars ==
[[Image:Openvue-avatars-male-female-neutral-2010-08-27.jpg|300px|right|Example Avatars]]
When users sign up, they can choose between default avatars. It's up to you to decide what these default avatars look like. Here is how you can configure them... Once your OpenSimulator is up and running, create accounts (using Wifi) with the names given in your configuration. With the above examples, these would be:
* Male Avatar
* Female Avatar
* Neutral Avatar

Then login to the world under each of those accounts, and set their appearances however you like. You can add prim attachments.

== Problems with HTTP ports ==

The port used for the Wifi HTTP service is configurable. Usually this will be 8002 for a grid and 9000 for a standalone unless you use custom ports.

For a standalone you can do this by adding the "port" line for the port to use for Wifi and other services to the [Network] section of OpenSim.ini

<source lang="ini">[Network]
port = 9000
</source>

Or for a grid specify a specific port (usually 8002) for the WifiServiceConnector in the ServiceConnectors list in the [Startup] section of Robust(.HG).ini

<source lang="ini">[Startup]
ServiceConnectors="............,8002/Diva.Wifi.dll:WifiServerConnector"
</source>

In either case, define the equivalent WebAddress in the [WifiService] section of your StandaloneCommon.ini or Robust(.HG).ini (or addon-modules/Wifi/config/Wifi.ini if used in future).

<source lang="ini">[WifiService]
WebAddress = "http://hostname:8002"
</source>

If you do not use the usual OpenSimulator service ports, please note that 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.

== Wifi URLs When Operational ==

* Sample grid: <nowiki>http://yourgridhostname:8002/wifi</nowiki>
* Sample standalone: <nowiki>http://yourstandalonehostname:9000/wifi</nowiki>
* Local standalone: <nowiki>http://localhost:9000/wifi</nowiki>

'''Examples'''

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

== Wifi Administrator Functions ==

=== Manage Users ===
[[Image:Openvue-Wifi-Example.jpg|300px|right|Example Wifi Entry Page]]
If authorisation is set to be on, you will receive an e-mail to the nominated admin account e-mail address if a user requests a new account and avatar creation. You can activate or delete new user creation requests. Users are notified of the activation via an e-mail to their nominated address.

You can also search for users and change their details. Give a space as a search term to select all avatars. Available are fields for "Level", "Flags" and "Title".
* Level = 0 is a normal user
* Level = 50 (default) is used to indicate a privileged user (e.g. who can set up new hypergrid linked regions)
* Level = 100 is a Wifi admin account user

You can manually reset a user's password by typiing into the password box and the nhitting the "Reset" button. Note that the user is '''NOT''' infromed of this password reset, so you must manually contact the user to communicate such a password change.

Note that the Wifi admin username/avatar is set in the Wifi configuration, and can be changed there. BUT.. '''once an admin always an admin'''. Well almost. If you change from one admin to another, the previous avatar still has administrator rights. You can remove Wifi administrator rights from an avatar by changing the "Level" of the user from 100 to the normal avatar level of 0 using the Manage Users facility in Wifi.

You can set an intermediate level for a '''privileged''' user which can be used to allow certain types of Wifi menu that a normal user will not see, but that are less than full admin user rights. A configurable parameter sets the '''Level''' above which this functions for a user (default 50).

=== Manage Regions ===

A facility to add '''LINK REGIONS''' is available in Wifi versions for OpenSimulator 0.7.1 onwards.

Administrators and other '''privileged''' users can also view the current set of '''LINKED REGIONS'''

=== Remote Console ===

A feature in Wifi versions for 0.7.1 onwards and available to administrators via the '''CONSOLE''' link if suitably enabled.

The WifiConsole uses OpenSim's REST console and thus the Robust server and any simulators must be started with parameter "-console rest". Furthermore, the configuration options "ConsoleUser" and "ConsolePass" must be set in section [Network] and the values of these options must match across all instances. Finally, for all region simulators (i.e. except for the Robust server), option "ConsoleAllowedOrigin" must be set to the same value as option "WebAddress" in section [WifiService] of the Robust configuration.

Please note that as at February 2011 the console in Wifi is not much more than a proof on concept in its current state. It has been tested on web browsers based on Mozilla (i.e. the Gecko Engine) only. Browsers using the WebKit engine do work somewhat, too, and IE has its own issues. The console also does not yet work with any interactive input, as necessary for creating a new region with "create region", for example.

Right now, there is no way to use this feature in a secure way because the values for "ConsoleUser" and "ConsolePass" are transmitted as clear text over the network. Please keep this in mind when using the console in Wifi.

== Diva Distribution ==

[[Image:Diva-Tagus-Wifi-Example-v2.jpg|300px|right|Example Wifi Entry Page]]

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/

Webinterface

2012-03-04T07:04:20Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__ {{Quicklinks}} {{thirdparty}}

== Addon Modules ==

* [[Wifi]] - A Simple Account Management Front-end

== PHP ==

* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?XoopenSim%20(E) XoopenSim] - Web Interface for [http://xoopscube.org/ Xoops Cube]. v1.50 supports MySQL Data Base of 0.6.7,0.6.8,0.6.9 and 0.7, 0.7.1Dev, and it includes flotsam group function, osprofile, ossearch, mute list and login screen function.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Modlos%20%28E%29 Modlos] - Web Interface for [http://moodle.org/ Moodle]. This software is sister application of XoopenSim. Modlos has same functions with XoopenSim and supports cooperation with [http://www.sloodle.org Sloodle].
* [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimulator Web Interface] This is a PHP Web Interface for OpenSimulator (Open Simulator Project), it allows grid citizens to create User Accounts to access the grid. Grid Owners can also manage all users for the grid, with a very powerful CMS system included. (Beta Release for 0.7.x is in Branches)
* [http://d4os.org D4os] - A set of [http://drupal.org Drupal] modules to control a grid.
* [http://openmetaverse.googlecode.com/ SimianGridFrontend] - The PHP-based web interface that accompanies SimianGrid. SimianGridFrontend is based on the CodeIgniter PHP MVC framework.
* [http://lab.newworldgrid.com/Wiki/index.php/Rest_Ajax_Manager/ Nwg Rest Ajax Manager] - A remote console using php & ajax to user with RestConsole system.
* [http://lab.newworldgrid.com/Wiki/index.php/Ajax_Map/ Nwg Ajax Map] - A dynamic map of the grid using ajax with a reservation system.
* [http://code.google.com/p/openmetaverse/wiki/SimianGrid SimianGrid] - A scalable, extensible, light-weight, open source persistence layer for MMOs and virtual worlds, written in PHP. Also provides the frontend mentioned above and WebDAV access to inventory.
* [http://sourceforge.net/apps/trac/unga/wiki/WikiStart unga] - Both an UGAIM (User, Grid, Assets, Inventory, Messaging) server system and a backend for configuring that servers. Also, its modular architecture allows to create (or plug) specialized modules created in standard PHP.
* [http://www.foto50.com/ jOpenSim] - Joomla! component for interacting with an OpenSimulator server and 2 modules (grid status and friends online). The component is developed and designed with opensimulator starting from V 0.7.0.1 running in grid mode with MySQL as storage engine, but also can work with standalone mode.

=== Optional modules ===

* [http://code.google.com/p/flotsam/wiki/XmlRpcGroups XmlRpcGroups] - A set of xmlrpc methods to manage groups in opensim. See [[Groups|this page]] for how to configure it.
* [http://forge.opensimulator.org/gf/project/ossearch ossearch] - A set of xmlrpc methods to manage search, events and classifieds. See [[OpenSimSearch|this page]] for how to configure it.
* [http://forge.opensimulator.org/gf/project/osprofile osprofile] - A set of xmlrpc methods to manage persistent profile.
* [http://forge.opensimulator.org/gf/project/webassets/ webassets] - A script to render assets pictures to display on a website.

== Python ==

* [https://github.com/phrearch/hwios HWIOS] - Websocket CMS with experimental OpenSimulator support. HWIOS includes OpenSimulator user management, region management with interactive scalable maps, distributed service management(start/stop/kill service + remote websocket consoles), IAR/OAR sharing through teknon webdav shares, websocket chat, a realtime distributed wiki(hyki) and a simple collaborative drawing application. HWIOS is currently compatible with OpenSimulator 0.7.1 and webkit browsers(Chrome/Chromium 8+, Safari and FF4 to some degree). For more information, check out the [http://hwios.blogspot.com HWIOS Blog]
* [https://github.com/phrearch/teknon Teknon] - A Twisted TCP daemon, capable of communicating over a persistent connection between local services and HWIOS websockets through subprocess pipes. HWIOS uses teknon for distributed service management and remote consoles.

[[Category:Development]]

Warp3DImageModule

2012-03-04T07:04:09Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

[[Image:Warp3DImageModule-Example-OpenVue.jpg|256px|thumb|Example Warp3DImageModule map cell - OpenVue]]
[[Image:Warp3DImageModule-Example-OpenVCE.jpg|256px|thumb|Example Warp3DImageModule map cell - OpenVCE]]
[[Image:Comparemap3dmodule.png|256px|thumb|Comparative Map - Arya on FrancoGrid]]

Improved rendering of the OpenSim.ini map tiles is possible by using "Warp3DImageModule" (rather than the default "MapImageModule") for the MapImageModule for any region server. The Warp3dRender engine is included in the standard OpenSimulator build (from version 0.7.1).

Include in OpenSim.ini [Startup] section:
MapImageModule = Warp3DImageModule
TextureOnMapTile = true
DrawPrimOnMapTile = true

Then use requests of this form for each of your regions...

http://regionserver:port/index.php?method=regionImageUUID

Get the region UUID for each region you want to get the map tile
for... then use the Opensim.exe running host name and port you are
using for that (usually the port for the first region in that
instance). Note its NOT the Robust port if you are using a grid, its
the region server port. Then add the UUID directly (with all hyphens
removed) on the end of the URL root.

* An example served live from the Openvue Grid is http://virtual.aiai.ed.ac.uk:9000/index.php?method=regionImage9c8b6f8f81784a6992dc9feba4646e6b

* A combination to show a grid map is at http://virtual.aiai.ed.ac.uk:8002/resources/map.html

The map cells are served at a resolution of 256x256.

Virtual World Model

2012-03-04T07:04:00Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

What follows are working definitions for the model of virtual worlds supported by OpenSimulator. They are intended to clarify terminology, and to sharpen the requirements with respect to security of users' data and world assets. Please use the [[Talk:Virtual_World_Model|Discussion]] tab to comment on these definitions -- they are live and subject to improvements.

'''Simulator Trust Domain''': One or more simulators that completely trust each other, operated by one single
authority. Trust means that these simulators can safely exchange messages and share data with each other.
Specifically, trusting simulators can engage in exchanges that enable useful features, such as server-side
teleports, that are unsafe when done between non-trusting simulators. Trust domains can be extended to include
simulators in other trust domains, but in these extensions trust is neither commutative nor transitive.
[[Talk:Virtual_World_Model|discuss here]]

'''Resource Services''': A set of zero or more services serving resources for simulators. Resources include:
assets, user accounts, and assorted services like map, lookup, social networking, forums, etc.

'''Grid''': One or more simulators that share resources via resource services. At the very minimum, the
simulators in a grid share assets, but many more services are possible (see above). A Grid includes one or
more simulator trust domains. Normally one would expect one grid to be one single trust domain, but that
doesn't necessarily need to happen. Given that a Grid may include more than one simulator
trust domain, there can be untrusted connections within the same grid. In deploying security schemes, this
needs to be taken into account. (OSGrid and trust domains...[[Talk:Virtual_World_Model|discuss here]]).

'''Hypergrid''': The interconnection of grids. Hypergrid simulator connections are necessarily untrusted, so
security schemes need to take that into account. Besides safe simulator connectivity between grids, the
Hypergrid addresses the interoperability of resource services -- that is, the ability for: user accounts in
one user service being recognized in other grids; assets in one asset service being transferred to other
grids; social networking services being bridged, etc. The Hypergrid architecture enables, but does not impose,
the emergence of independent Hypergrid-wide resource services such as User Services, Asset Storage, Social
Networking, Search, etc. that serve several grids and are not coupled with any one grid in particular.

'''Walled-Garden Grid''': A grid that only handles resources directly managed by its own resource services. It
does not recognize or allow users and assets from other grids, and it does not allow the export of its own
users and assets. It may, however, import/export assets in bulk via backend storage systems (e.g. OARs).

Additional notes:

* Tentatively, I'm unifying the concept of Grid with the concept of Virtual World.

* A "Standalone", which should be read as "Standalone Grid" (term credit to Michael Cortez), is a grid-in-a-box. It's one process that single-handily performs simulation and resource management. Just like any other grid, a Standalone grid may be hypergrided or may operate as a walled garden.

* Simulator trust domains have ultimate freedom to implement any feature they want among themselves, including transferring user agents (user permitting), sharing private data, etc.

* Grids may exist without any services but asset services. [Note: could there be a grid without assets?!]

* Hypergrided Grids may treat all users equally or may treat their own users in special ways.

* Grids may provide visitors with additional resources that are only available while the users visit that grid, and become unavailable once the visitor goes elsewhere (aka grid-specific inventory).

More notes (Melanie's email, edited by Diva):

Users should be in control of their own inventory and its associated assets, independent of a single grid. This means:

* users can select where their data is stored. This may be an ISP, a web hoster, a grid or their own PC (bandwidth permitting). No simulator has authority over that storage.

* Regions hold COPIES of the assets needed to render whatever is currently in world. Normally, this will be "by value", e.g. the sim will have a full and valid copy of the data and be able to supply everything needed to render its content independent of any outside servers.

* Grids are one or more trust domains, they are groups of regions sharing asset and user services. They access the same servers for their data and anything within one region can be moved to any other region without the need to copy assets. Regions within a trust domain are able to destroy storage needed by other regions to render data, but cannot access user inventories unless authorized, and with very limited scope. Typically, but not mandatory, all sims in one gridwill be owned and operated by a single individual/organization.

* User services authenticate users for access to a trust domain. They may require username/password, X.509 certificates, oAuth, openID or any other form of authentication, or none. They may decree that, if you don't authenticate, your access may be limited to observation only, or in any other way they, as the trust domain controller, see fit.

* Sim asset services are the storage at the heart of a grid, sims in a grid share these asset services. That is distinct from user asset services, which are out of scope for regions.

* Optionally, user asset services may pass an object to a region "by reference". This assumes a basic level of trust with the region, which is advised to not keep a copy, but request the current data from the user asset service each time it is needed. This required continuous authorization for that item, which will be limited to specific sims, Therefore, such items can't leave the sim, they cannot be given or sold, but only be taken by the owner. This is useful for allowing the update of scripts in-place, e.g. for applications like sloodle, which may want to update all inworld terminals all at once. It it a marked departure from the Linden way of doing things.

Vehicles

2012-03-04T07:03:50Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{obsolete}}
== Summary ==
August 2009: Kitto Flora is revising the OdePlugin files in an attempt to provide SL-compatible VEHICLE functionality to OpenSimulator. A couple of test regions have been provided by Bri Hasp, these are Sea-3 and Sea-4 in OSgrid. You may visit there and test vehicles but please clean up after. The regions will frequently be restarted to test revisions. The revised Open Simulator files are being made available as a git branch, check here to see what may or may not work.

== News ==
==== Oct 24 2009 (apx) PROJECT HALTED. ====
At about this date opensim trunk was merged into the vehicles branch bringing in the packet prioritization modifications. It had already been pointed out that those modifications caused problems with the display of motion of physical objects. The result of this merge is that a physical object that is simply rotating is no longer updated on the viewer screen. Debug messages show that ODE is indeed rotating the object, and sending update requests but it appears that the packet system is not transmitting updates to the viewer. This makes it impossible to see the results of the work in progress - adding functions such as llRotLookAt(). Work is therefore suspended until this packet problem is fixed. See http://opensimulator.org/mantis/view.php?id=4336
==== Oct 22 2009 ====
* Vehicle branch is merged into opensim. Any version r11303 or later will have the VEHICLE capabilities (and problems) listed below available.
==== Oct 6 2009 ====
* Sea-3/Sea4 are down because osgrid is being upgraded/fixed to deal with other ongoing problems, and the vehicle branch is no longer compatible. I am waiting for trunk to stabilize before proceeding.
Meanwhile I am investigating the details of SL physics parameters.
==== Sept 28 2009 ====
* Cause of poor update rate of rotating physical prims found and fixed.
==== Sept 24 2009 ====
* OpenSimulator Vehicle version running at Sea-3 and Sea-4 in OSgrid have been adjusted to improve the Vertical Attractor.
* The Tako sailboat works somewhat, but the listen() event on channel 0 fails after 30 seconds or so, resulting in some loss of control.
* Camera controls are still a problem, it appears that camera position depends on which prim is clicked to 'sit'. (Camera fails to reference to root prim of a link-set???).
* timer() event will keep working if llSetTimer(float) is called at every timer() event.
* Racecar updated to 'ODB VEH racecar10', deals with changed Vertical Attractor; timer() used in place of llSensor(), resulting in much lower simulator CPU load. Available in sea-3.

== Terminology ==
Here some terms are defined so that when we communicate we are talking about the same things.

==== Vehicle ====

Any object or link-set that moves. It is usually rideable. It may be Physical or not.

==== VEHICLE ====
Any object or link-set that uses LSL VEHICLE functions to achieve mobility. It is set to other than 'VEHICLE_TYPE_NONE'.

==== Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, TRUE). It will fall due to gravity (unless buoyancy is changed) and collide with other prims, avatars and the ground (unless set phantom).

==== Non-Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, FALSE), or has never has llSetStatus(STATUS_PHYSICS,...) applied. Such objects 'stick in midair' and can interpenetrate other objects.

==== Kinematic ====
Motion system used by Non-Physical objects, applied by such functions as llSetPos() and llSetRot().

==== Dynamic ====
Motion system used by Physical objects, applied by such functions as llSetForce() and llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <...>).

== About This Project ==
The objectives of this project are:
# To provide VEHICLE associated LSL functions within OpenSimulator that are compatible with Second Life functionality. This means trying to get them really close, but as we are trying to emulate complex HAVOK functions using what is available in ODE they may be only close to the SL functions.
# To clean up the OdePlugin files. Over many revisions and add-ons they have become somewhat non-optimal. In particular the 'Move' operation that makes objects move around needs to be very clean and smooth so that the update rate remains high.
# Maintain the existing non-VEHICLE dynamic functions and fix errors where found.

== Vehicle LSL Functions in revised OpenSimulator ==
There are three categories of LSL functions that are used by Vehicles: Kinematic, Dynamic and VEHICLE. These are listed below with information on their current status within the revised OpenSimulator. (Not the general release at this time.)
Kinematic vehicle motion can be used by non-physical objects. VEHICLE motion and the associated functions '''ONLY''' apply to objects that are set to a VEHICLE_TYPE of AIRPLANE, BALLOON, BOAT, CAR or SLED. Dynamic functions '''ONLY''' apply (at this time) to VEHICLE_TYPE_NONE, which is the default condition of an object. (In SL it appears that one can use Dynamic functions on a VEHICLE, but to keep things simple at the start of this project such a combination is ignored.)

== Known Problems ==
# timer() event ceases about 10 seconds after Vehicle moves. Does not restart until many seconds after Vehicle stops. '''Work-around:''' Use llSensor() for a non-existent object at short range and no_sensor() event to re-trigger it. This produces about 1000 events per second. Divide down to produce more reasonable rates.
# llSetBuoyancy() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non-VEHICLE vehicles.
# llSetHoverHeight() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non VEHICLE vehicles.
# llSetVehicleFlags() and llRemoveVehicleFlags() are not hooked to physics methods, and may cause simulator crash. LSL engine problem. '''Work-around:''' None, but the VEHICLE_TYPE presets are setting necessary flags.
# Prim parameters like Material are not being saved. '''Work-around:''' Set by script on rez or whenever used.
# Script state is not maintained between Take and Rez. '''Work-around:''' on_rez() Reset script and set *everything* again.
# Border Crossing is bad. Vehicle will be killed and Av unseated and left drifting through target region. '''Work-around:''' Quickly double-click on Map to tele-port to old region. Drag vehicle back and reset it.

== VEHICLE Scripting Notes ==
# (Not really scripting , but very important) DO NOT attempt to drive a VEHICLE across the Region boundary. If you do your Av will be orbited. You may be able to recover by Map double-click TP to a nearby Region. The VEHICLE object is usually killed, and sitting at edge of the destination region.
# In revised OpenSimulator the function llSetVehicleType(VEHICLE_TYPE_xxx), where xxx is AIRPLANE, BALLOON, BOAT, CAR or SLED, pre-sets all the applicable VEHICLE parameters to reasonable numbers. If you wish to change any of these pre-set parameters do so after asserting llSetVehicleType(VEHICLE_TYPE_xxx).
# At present it appears that some conditions within an instantiated scripted object are not maintained after a Region restart, and possibly between take and rez. Therefore you should assert llSetVehicleType(VEHICLE_TYPE_xxx) when the driver sits and llSetVehicleType(VEHICLE_TYPE_NONE)when the driver stands, and probably on_rez.
# The advice above also applies to camera controls. Assert llSetCameraxxx() on sit and llClearCameraParams() on stand. (At present there seems to be bugs in the Camera Control system, the camera will go underground!)
# The advice above is also true of Material Type. Land vehicles need the 'wheels' to be PRIM_MATERIAL_GLASS. The script(s) must llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]) in every prim that touches the ground, when the rider sits, for reliable operation. Use a link mesage from the root to daughter prim scripts.
# Use llSetStatus(STATUS_PHYSICS, TRUE) to enable the VEHICLE, usually when the driver sits. Use llSetStatus(STATUS_PHYSICS, FALSE) to disable the VEHICLE, usually when the driver stands.
# It appears that the timer() event freezes while a Vehicle is in motion, so do not rely in Timer() to update things like steering or velocity. See Known Problems for a work-around.

== VEHICLE Scripting Examples ==
Below are some initial (and very similar) Vehicle scripting examples, implementing a sort of go kart, and the second a motorboat. The motorboat script is a derivative work based on the go kart script.

*** Note that these scripts are works in progress and may or may not impact the performance of your region negatively.

Car or Go kart script:

<source lang=LSL>
// Very simple vehicle script, mod for OpenSimulator & ODE & VEHICLE code
// By Kitto Flora September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 12; //Power used to go forward (1 to 30)
float reverse_power = -6; //Power ued to go reverse (-1 to -30)
float turning_ratio = 2.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer turncount;
string Wheeldir = "WC";
string NewWheeldir = "WC";
string Wheelrot = "S";
string NewWheelrot = "S";
integer scount;
integer Speed;
integer Run;

string sit_message = "Ride"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//car
llSetVehicleType(VEHICLE_TYPE_CAR);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.50);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.50);

}
Init()
{
Sound(0);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llGround(<0,0,0>) + 0.52;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]);
llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
llLoopSound("RUNNING",1);
}
else if(n == 1)
{
llLoopSound("IDLE",1);
}
else
{
llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
NewWheeldir = "WR";
turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
NewWheeldir = "WL";
turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
if(turncount > 0)
{
turncount--;
}
if(turncount == 1)
{
NewWheeldir = "WC";
}
if(Wheeldir != NewWheeldir){
Wheeldir = NewWheeldir;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
}
if(Wheelrot != NewWheelrot){
Wheelrot = NewWheelrot;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
}
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Sound(1);
Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

Motorboat script:

<source lang=LSL>

// Very simple vehicle script, mod for OpenSimulator & ODE & VEHICLE code
// By Kitto Flora September 2009

// modified by Hiro Protagonist for basic aquatic motorcraft
// September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 8; //Power used to go forward (1 to 30)
float reverse_power = -3; //Power ued to go reverse (-1 to -30)
float turning_ratio = 1.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer scount;
integer Speed;
integer Run;

string sit_message = "Man the Helm"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//boat
llSetVehicleType(VEHICLE_TYPE_BOAT);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.250);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.250);

}
Init()
{
Sound(0);
llSetBuoyancy(1);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llWater(<0,0,0>) + 0.22;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_WOOD]);
// llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
// llLoopSound("RUNNING",1);
}
else if(n == 1)
{
// llLoopSound("IDLE",1);
}
else
{
// llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
// llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
// NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
// NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
// NewWheeldir = "WR";
// turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
// NewWheeldir = "WL";
// turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
// if(turncount > 0)
// {
// turncount--;
// }
// if(turncount == 1)
// {
// NewWheeldir = "WC";
// }
// if(Wheeldir != NewWheeldir){
// Wheeldir = NewWheeldir;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
// }
// if(Wheelrot != NewWheelrot){
// Wheelrot = NewWheelrot;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
// }
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
// llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
// Sound(1);
// Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

== Vehicle LSL Functions and Status ==
NOTE! This list applies to the revised OpenSimulator, not the released
OpenSimulator.

Key: Y = Yes; N = No; F = Framework present but commented out; N/A = Has not been checked (much) yet

=== KINEMATIC ===
Object must not be PHYSICAL

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Set by LSL?!!Used by OpenSimulator C#!!Works?!!Comments
|-
|llSetPos()||Y||Y||Y||Also works on physical objects!
|-
|llSetRot()||Y||Y||Y||Y
|-
|llSetLocalRot()||Y||Y||Y
|-
|llSetScale()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|}

=== DYNAMIC ===
Object must be PHYSICAL and VEHICLE_TYPE_NONE(default) at present, but this must probably change.

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Parameter!!Set by LSL?!!Used by OpenSimulator C#!!Comments
|-
|llApplyImpulse()||N/A||N/A||N/A||N/A
|-
|llApplyRotationalImpulse()||N/A||N/A||N/A||N/A
|-
|llGroundRepel()||N/A||N/A||N/A||N/A
|-
|llMoveToTarget()||N/A||N/A||N/A||N/A
|-
|llPushObject()||N/A||N/A||N/A||N/A
|-
|llSetBuoyancy()||N/A||N/A||N/A||(do not confuse with VEHICLE_BUOYANCY)
|-
|llSetForce()||N/A||N/A||N/A||N/A
|-
|llSetForceAndTorque()||N/A||N/A||N/A||N/A
|-
|llSetHoverHeight()||N/A||N/A||N/A||(do not confuse with VEHICLE_HOVER_HEIGHT)
|-
|llSetTorque()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||Use of this crashes script||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|}

=== VEHICLE ===
Object must be PHYSICAL and VEHICLE_TYPE_<other than NONE>
{|class="wikitable sortable"
!Functions!!Set by LSL?!!Used!!Works!!Exceptions
|-
|llSetVehicleType()||Y||Y||Y
|-
|llSetVehicleFlags()||N||N||N||Some flags are set by llSetVehicleType()
|-
|llRemoveVehicleFlags()||N||N||N||
|-
|llSetVehicleFloatParam()||Y||Y||Y||
|-
|llSetVehicleVectorParam()||Y||Y||Y||
|-
|llSetVehicleRotationParam()||Y||Y||Y||
|}

{|class="wikitable sortable"
!Parameters!!Set by LSL?!!Used!!Works!!Exceptions
|-
|VEHICLE_LINEAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_OFFSET||F||N|| ||
|-
|VEHICLE_ANGULAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
||VEHICLE_BANKING_EFFICIENCY||F||N|| ||
|-
|VEHICLE_BANKING_MIX||F||N|| ||
|-
|VEHICLE_BANKING_TIMESCALE||F||N|| ||
|-
|VEHICLE_BUOYANCY||Y||Y||Y||(do not confuse with llSetBuoyancy())
|-
|VEHICLE_HOVER_HEIGHT||Y||Y||Y||(do not confuse with llSetHoverHeight())
|-
|VEHICLE_HOVER_EFFICIENCY||Y||N|| ||
|-
|VEHICLE_HOVER_TIMESCALE||Y||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_REFERENCE_FRAME||F||N|| ||
|-
|VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY||Y||Y||Y||
|-
|VEHICLE_VERTICAL_ATTRACTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_TYPE_NONE||Y||Y||Y||
|-
|VEHICLE_TYPE_BALLOON||Y||Y||Y||
|-
|VEHICLE_TYPE_BOAT||Y||Y||Y||
|-
|VEHICLE_TYPE_CAR||Y||Y||Y||
|-
|VEHICLE_TYPE_SLED||Y||Y||Y||
|-
|VEHICLE_FLAG_NO_DEFLECTION_UP||Y||N|| ||
|-
|VEHICLE_FLAG_LIMIT_ROLL_ONLY||Y||N|| ||
|-
|VEHICLE_FLAG_HOVER_WATER_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_TERRAIN_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_GLOBAL_HEIGHT||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_UP_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_LIMIT_MOTOR_UP||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_STEER||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_BANK||Y||N|| ||
|-
|VEHICLE_FLAG_CAMERA_DECOUPLED||Y||N|| ||
|}
== VEHICLE TYPE Presets ==
VEHICLE_TYPE_SLED:
linearFrictionTimescale <30, 1, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1000
linearMotorDecayTimescale 120
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1000
angularMotorDecayTimescale 120
VhoverHeight 0
VhoverEfficiency 1
VhoverTimescale 10
VehicleBuoyancy 0
linearDeflectionEfficiency 1
linearDeflectionTimescale 1
angularDeflectionEfficiency 1
angularDeflectionTimescale 1000
bankingEfficiency 0
bankingMix 1
bankingTimescale 10
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_CAR:
linearFrictionTimescale <100, 2, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1
angularMotorDecayTimescale 0.8
VhoverHeight 0
VhoverEfficiency 0
VhoverTimescale 1000
VehicleBuoyancy 0
// m_linearDeflectionEfficiency 1
// m_linearDeflectionTimescale 2
// m_angularDeflectionEfficiency 0
angularDeflectionTimescale 10
verticalAttractionEfficiency 1
verticalAttractionTimescale 10
bankingEfficiency -0.2
bankingMix 1
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_BOAT:
linearFrictionTimescale <10, 3, 2>
angularFrictionTimescale <10,10,10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 2
VehicleBuoyancy 1
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 0.5
angularDeflectionTimescale 5
verticalAttractionEfficiency 0.5
verticalAttractionTimescale 5
bankingEfficiency -0.3
bankingMix 0.8
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_TERRAIN_ONLY
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_AIRPLANE:
linearFrictionTimescale <200, 10, 5>
angularFrictionTimescale <20, 20, 20>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 2
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 1000
VehicleBuoyancy 0
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 1
angularDeflectionTimescale 2
verticalAttractionEfficiency 0.9
verticalAttractionTimescale 2
bankingEfficiency 1
bankingMix 0.7f
bankingTimescale 2
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY

VEHICLE_TYPE_BALLOON:
linearFrictionTimescale <5, 5, 5>
angularFrictionTimescale <10, 10, 10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 6
angularMotorDecayTimescale 10
VhoverHeight 5
VhoverEfficiency 0.8
VhoverTimescale 10
VehicleBuoyancy 1
linearDeflectionEfficiency 0
linearDeflectionTimescale 5
angularDeflectionEfficiency 0
angularDeflectionTimescale 5
verticalAttractionEfficiency 1
verticalAttractionTimescale 1000
bankingEfficiency 0
bankingMix 0.7
bankingTimescale 5
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT

VMware Appliance

2012-03-04T07:03:40Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

Disclaimer:
This appliance is unofficial and is in no way connected with the OpenSimulator Development team,
no one will be held responsible for any damages that may occur through the use of this appliance.

If there are currently no seeders, please try again in a few hours.
== First Edition ==
Built against Ubuntu Server 7.10.
Contains and runs the 0.5 OpenSimulator release by default, also contains SVN version with easy update script.
Sim is standalone and uses SQLite as a database and ODE for physics.

On first run the sim will need to be configured, simply log in and the Console should appear.

[http://thepiratebay.org/tor/4057585 Torrent] - Readme can be found here, aswell as inside the torrent.

== FreeBSD Edition ==
Coming soon..

== Future Editions ==
=== To Do ===
* More user friendly, reliable.
* Fix init script to function as originally intended. (Add proper shutting down)
* Add first boot configuration for OpenSim, a nice menu interface would be nice, maybe let the user edit config by hand after for tweaking.
** Give option of running attached to a grid.
** Give option of using MySQL.
* Add SVN update script as a cronjob, need to check that an in place update wont go awry, and also a fallback in case the current SVN fails.
* Some way to update the appliance when major changes are made.
* Trim size down a bit, remove uneeded stuff, eg. XOrg was installed as a dependency for Mono when it is clearly not needed.
* FreeBSD Edition ( [[DevalnorWorkNotes|Devalnor Work Notes]])
* Run Mono in Jail mode for more security

=== Ideas / Requests ===
* Feel free to add stuff here

Using Git

2012-03-04T07:03:30Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

This is an introduction to using git for OpenSimulator. If you just want to know git cloning path, jump to [[#Cloning the Repositry (for Non Core Developers)]].

= Installing Git =

== Linux ==

=== CLI ===
:Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:
::* Debian, Ubuntu: <pre>apt-get install git-core</pre>
::* Centos: see the instructions at http://www.how-to-linux.com/2009/01/install-git-161-on-centos-52/

=== GUIs ===
:[http://www.kernel.org/pub/software/scm/git/docs/git-gui.html git-gui]
::* Debian, Ubuntu:
$ sudo apt-get install git-gui
$ git gui

:[http://cola.tuxfamily.org/ git-cola]
::* Debian, Ubuntu:
$ apt-get install git-cola
$ git-cola

== Windows ==

On Windows you need to install 2 packages:
* [http://code.google.com/p/msysgit/ msysgit] - the basic git port for windows. Install this first.
* [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.

When '''installing msysgit''' be sure to choose
'''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.

[[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]

== Mac OS X ==

If you have [http://www.macports.org/ MacPorts] installed, then open a Terminal window and run:

sudo port install git-core

Or you can even obtain GitX GUI tool from [http://gitx.frim.nl/ GitX Website] and put it into application folder.

= Configuring Git =

Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.

On Linux / Mac OS X this is done via:

git config user.email YOUR@EMAIL.ADDR
git config user.name "Your Name"

On Windows this is done with the config menu.

[[Image:Config1.png]] [[Image:Config2.png]]

To setup your Context Menu to make your options easier, select the Context Menu options as shown above and choose what you want to have displayed immediately.

<br />

[[Image:Config3.png]]

= Git Repositories for OpenSimulator =

The urls for the repositories are as follows:

{| border="1" cellpadding="5"
! Repository !! Developer URL !! Anon URL
|-
|| opensim (main repository) || ssh://opensimulator.org/var/git/opensim || git://opensimulator.org/git/opensim
|}

== Cloning the Repositry (for Core Developers) ==

If you are a core developer, use the developer url above. If you aren't a core developer, use the anon url above. The initial clone will take a few minutes, as it is pulling the entire change history. Don't be concerned about space, all the change history stored in git takes up less space than a single checked out copy of opensim. Welcome to the wonderful world of content addressable storage.

Unlike with svn, you can define multiple sources to pull from. So if you initially start with an anon tree (which is read only), you can still later define the core tree (or some other remote target on github) and push to that.

=== Linux / Mac OS X ===
Run the following on the command line:

git clone ssh://opensimulator.org/var/git/opensim

This will create an opensim-test directory locally

=== Windows ===

Right click on the Desktop (or wherever) and 'Git Clone...'

When prompted for a url provide ssh://opensimulator.org/var/git/opensim. You username and password will be the ones used for opensimulator.org.

== Cloning the Repositry (for Non Core Developers) ==

git clone git://opensimulator.org/git/opensim

This is the equivalent of anonymous svn access.

== Resolving git hash & revision numbers ==

These generate the bin/.version file which is used to identify the Git-Hash Revision.  The GIT Hash is used to track the builds for troubleshooting and for filling Mantis Reports.  Without proper Version Identification developers / contributors cannot locate & address problems within the source code, resulting in un-usable Mantis reports.  Please Version your Builds to help everyone make a better OpenSimulator.

[[Show git version numbers - Windows|Windows batchfile]]

[[Show git version numbers - Linux|Linux bash script]]

NOTE:  Older installation of GIT such as 1.6.0.4 do not support the extra functions.  To make use of the above scripts it is recomended you update your GIT installation to the most current revisions.  They are available from [http://git-scm.com/ git-scm.com/]

= Conceptual Changes from Subversion =

Distributed source code control is a substantially different mental model than centralized source code control. If it freaks you out a bit, don't worry, everyone has that same reaction initially. This [http://betterexplained.com/articles/intro-to-distributed-version-control-illustrated/ blog post] is the best explanation that I've seen of the concepts involved.

For heavy users of subversion you should read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.

* Terminology
** master is the name of the primary upstream branch (in subversion terms, this is trunk)
** origin is the name and location of the tree you cloned from
* All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in
* Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.
* Committing
** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.
** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)
** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.

The biggest real change is the Subversion dictates a very specific workflow. Git does not. Git allows for many different workflows, and lets each developer use the one that is best suited to his/her self.

= Using Git like Subversion/trunk development =

This is a set of quick instructions to use git like we do subversion development today. It is targetted for core developers (so assumes you are using the ssh access), though most of it will work for non developers by just changing a url.

This is done by giving the unix commands. These options should all be available in the context menu on tortoise git as well.

== Getting the source code ==

'''git clone ssh://opensimulator.org/git/opensim-test'''

This is the equivalent of '''svn co'''

'''Note:''' all other operations assume that you are in the git directory.

== Updating your checkout ==

'''git pull'''

This is the equivalent of '''svn update'''

== Inspecting what has changed in your working tree ==

'''git status'''

This is the equivalent of '''svn status'''

== Committing a change ==

either:

'''git add file1 file2 ...'''

'''git commit'''

or

'''git commit -a'''

by default git does not add all files during a commit.

== Pushing the committed change ==

The first time you do this you'll need to specify which branch to push.

'''git push origin master'''

After the first time a simple '''git push''' will be enough, as it defaults to origin, and now git knows that master should by synced to origin.

'''Important:''' commits in git are local. They are not included in the main tree '''until you push''' them. This means you can create commits when you are not on the network and sync afterwards.

== Setting the checkout dir to a specific revision ==

'''git reset --hard #HASHVALUE'''

This will effectively rewind the tree to the specific revision, and modify the checkout dir accordingly. This is equiv to '''svn up -R#version'''.

git reset can also be useful if you screwed up commits and want to get rid of them

== Resetting the tree to master (i.e. trunk) ==

'''git pull'''

per previous

== Creating a Patch ==

'''git format-patch #HASHVALUE'''

This will create a patch suitable for attaching or emailing from a single commit. You can also specify a range of commits.

This is closest to '''svn diff > patchfile.txt''' for uncommitted changes in subversion.

== Applying a Git Patch ==

If someone has formatted a git patch you can apply it directly (including all file adds, file mode changes, and their change log entry) with:

preferred method (preserves creator info): '''git am --signoff patchfile.patch'''

this also works (try above method first) : git apply patchfile.patch

== Reverting a Change ==

'''git revert #HASHVALUE'''

This directly reverts the change, with a commit message stating that fact. There is no svn direct equiv, though this is often accomplished through: svn diff -R revisions > revert.patch && patch -p0 < revert.patch && svn ci -m "reverting revisions"

== Resetting part of the tree to master ==

'''git checkout -- file1 file2 ...'''

Checkout is an operation that populates the working directory from the git repository. Doing a git checkout (master is the implied branch) -- file1 file2 repulls those files from the git repo, clobbering them in your local directory. This is like '''svn revert'''.

== Diffing Changes ==

Against your most recently committed changes

'''git diff'''

From your most recent changes to a past change

'''git diff #HASHVALUE'''

Between any 2 changes

'''git diff #HASHVALUE1 #HASHVALUE1'''

== Branches ==

=== Creating a Branch ===

To create a new branch based on the current one, do:

'''git branch <branchname>'''

=== Changing Branches ===

To change between branches do:

'''git checkout <branchname>'''

=== Tracking a Branch ===

If you want to work on a specific branch, you can track it, by creating a local version of it on which you can pull and push. If you have already pulled (or fetched) from origin, you should have all remote branches names:

'''git branch -a'''

Will show all branches, local and remote. Choose a remote branch to track then do:

'''git branch --track <localbranchname> remotes/origin/<remotebranchname>'''

A new local branch will be created, which will push and pull to the specific remote branch.

** alternate method that also works

'''git checkout -b <wanted_branch> origin/<wanted_branch>'''

== Resources & References ==

Git - SVN Crash Course at [http://git-scm.com/course/svn.html git-scm.com/course/svn.html]

Git for the lazy tutorial at [http://www.spheredev.org/wiki/Git_for_the_lazy www.spheredev.org/wiki/Git_for_the_lazy]

Git Video Tutorials at  [http://gitcasts.com/ http://gitcasts.com/]   (Several Excellent Video Tutorials)

The Git Community Book at [http://book.git-scm.com/ http://book.git-scm.com/]

The git-svn(1) Manual Page [http://www.kernel.org/pub/software/scm/git/docs/v1.6.3.3/git-svn.html] (git-svn = Bidirectional operation between a single Subversion branch and git)

The Git-Svn Cheat Sheet [http://cheat.errtheblog.com/s/gitsvn/]

Userlevel

2012-03-04T07:03:19Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

On the table [[useraccounts]] in the database ''opensim'' there are 2 fields:
* ''UserLevel'' integer used to attribute the God powers for each individual user
* ''UserTitle'' string used for Administrator; you can set here the particularities of each user (possibly SL only; might not be in use in core OpenSim?)

== UserLevel values as applied to OpenSimulator ==
The only UserLevel used is 200 (to indicate god). Also presumably level 0 for non-god, basic user level.

A [[IRegionModule|region module]] could get these values via the UserAccount class from the UserAccountService. They can be set either by directly writing to the database, via the "set user level" command on the [[ROBUST]] console (there is no command for setting user title) or via the StoreAccount call on the robust service if it has been explicitly allowed (security risk in open grids).

== God Mode Values ==
The Viewer source code shows that there are several levels of "God Mode" (each level has all the previous levels' powers):

'''GOD_NOT'''

Value: 0 ''(Presumably the default "God Mode" status given to every logged-in user)''

'''GOD_LIKE'''

Value: 1
* rename objects without modify permission

'''GOD_CUSTOMER_SERVICE'''

Value: 100
* Toggle character geometry
* Take copy
* Owner To Me
* Set To Linden Content
* Claim Public Land

'''GOD_LIAISON'''

Value: 150
* Enable land auction

'''GOD_FULL'''

Value: 200 ''(Difference from GOD_LIAISON not apparent)''

'''GOD_MAINTENANCE'''

Value: 250 ''(Difference from GOD_FULL not apparent)''

''Note: text in "God Mode Values" section was borrowed from [http://wiki.secondlife.com/wiki/God_mode SLwiki], shared under a [https://creativecommons.org/licenses/by-sa/3.0/ CC BY-SA 3.0] license''

User DocumentationPT

2012-03-04T07:03:09Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

==OpenSimulator - Português - Documentos para Usuários==

{{QuicklinksPT}}

{{Aviso_Traducao}}

__NOTOC__

== Initial Setup ==
* [[Download]] - Download instructions
* [[OpenSim Build Instructions|Build Instructions]] - How to build and compile OpenSimulator from Source
* [[OpenSim Configuration|Configuration]] - How to get your OpenSimulator server up and running
* [[Connecting]] - How to connect a compatible viewer to OpenSimulator
* [[Troubleshooting]] - How to trouble shoot your OpenSimulator installation.
* [[Tips]] - Useful tips from users like you
* [[FAQ]] - Frequently Asked Questions

== Administrator Guide ==
* [[Server Commands]] - Commands to control OpenSimulator
* [[Custom Libraries]] - Describes how to add custom content to your OpenSimulator server
* [[Automating Tasks]] - How to make administrating a walk in the park
* [[Network Settings]] - NAT, Ports, Services and more...
* [[Performance]] - How to tweak OpenSim's performance
* [[Console-less OpenSim]] - How to run OpenSimulator without console

== Scripting ==
* [[Scripting Documentation]] - Everything you need to know about OpenSimulator scripting and a list of sample scripts

== Tutoriais Básicos ==
Você encontra tutoriais básicos em português no [http://www.opensimbr.blogspot.com/ link]

* [[OSGrid Region Registration]] - Describes how to link your region into OS-Grid
* [[Using L3DT]] - How to create custom terrains
* [[Production environment]] - How to setup a production environment with Linux-servers

== Contribution Policy ==
* [[User Wiki Conventions]] - Read this carefully, before adding content to the wiki
<cleanpage title=hide cats=hide />

[[Category:Portuguese Translations]]

User Documentation

2012-03-04T07:03:01Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks}}

== Introduction ==
This is user documentation for OpenSimulator, mainly aimed towards administrators of the system rather than the ultimate end-users who access the environment through a viewer. If you can't find what you want here you might want to try looking in the [[Developer Documentation]].

For a summary of what features have been implemented in OpenSimulator, please see the [[Feature Matrix]].

== Initial Setup ==
* [[Download]] - Download instructions
* [[Dependencies]] - The other packages you need to install that OpenSimulator relies upon
* [[Build Instructions]] - How to build and compile OpenSimulator from source
* [[Configuration]] - How to configure OpenSimulator so you can get the server up and running
* [[Configuring Regions]] - More details on configuring regions in Regions.ini
* [[Configuring Simulator Parameters]] - More details on the structure and configuration simulator parameters after the initial setup.
* [[Database Settings]] - Detailed configurations to connect to your database
* [[Upgrading]] - How to upgrade your OpenSimulator version so that you can use your existing data
* [[Network Settings]] - NAT, Ports, Services and more.
* [[Firewall Settings]] - Incomplete operating system specific instructions on how to open firewall ports for external OpenSimulator access.
* [[Troubleshooting]] - How to trouble shoot your OpenSimulator installation.
* [[Tips]] - Useful tips from users like you
* [[OpenSim Graphics]] - Graphics that can be used on OpenSimulator websites, viewer login pages or products.
* [[FAQ]] - Frequently Asked Questions

== User Guide ==
* [[Connecting]] - How to connect a compatible viewer to OpenSimulator

== Administrator Guide ==
* [[Server Commands]] - Commands to control OpenSimulator
* [[OpenSim.exe Command Line Options]] - Switches when you launch OpenSimulator.
* [[Useful Queries]] - Some useful queries for manipulating the OpenSimulator database.
* [[Logging]] - Logging in OpenSimulator
* [[Monitoring]] - Monitoring OpenSimulator
* [[Automating Tasks]] - How to make administrating a walk in the park
* [[RemoteAdmin]] - Using the XMLRPC administration interface for executing commands remotely
* [[RestConsole]] - Using the remote console.
* [[Performance]] - How to tweak OpenSim's performance
* [[Console-less OpenSim]] - How to run OpenSimulator without console
* [[Backups]] - How to backup your OpenSimulator data.

== Core Features ==
* [[Feature Matrix]] - Matrix of features currently implemented by OpenSimulator.
* [[Scripting Documentation]] - Everything you need to know about OpenSimulator scripting, and the list of sample scripts
* [[OpenSim Archives]] - Loading and saving whole region archives with OpenSimulator
* [[Inventory Archives|OpenSimulator Inventory Archives]] - Loading and saving user inventory items and folders with OpenSimulator
* [[NPC]] - Use of Non Player Characters (NPCs) in OpenSim, also known as bots.
* [[Custom Libraries]] - Describes how to add custom content to your OpenSimulator server
* [[IRCBridgeModule]] - A core OpenSimulator module for integrating IRC with a simulator.
* [[Hypergrid]] - Information about how to configure the experimental hypergrid architecture
* [[GridInfo]] - how to provide information about your grid to smart clients
* [[PhysicsEngines]] — Options for physics engines in OpenSimulator.
* [[:Category:Tech Reference|Technical Reference]] - Technical Reference Guide

== Optional Features ==
* [[Feature Proposals/AutoBackup|AutoBackup]] - Module for automatically backing up a region to an OAR regularly using a different filename.
* [[Freeswitch Module]] - Using FreeSWITCH for voice in OpenSimulator.
* [[Mumble]] - Using Mumble/Whisper for voice in OpenSimulator.
* [[Enabling Groups]] — How to enable creating groups in your regions

== Experimental Features ==

These are even more alpha than the rest of the code and may not currently work properly.

* [[Setting Up Mega-Regions]]

== RealXtend ==
* [[ModRex]] - How to setup the RealXtend server module
* [[RealXtend Viewer Linux]] - This tutorial describes how to use the RealXtend viewer on Linux, using wine

== Tutorials ==

If you've written a tutorial or guide on this wiki or on an external site, then please feel free to add a link here and/or on more specific topic pages.

=== Platform specific ===
* [[Linux Gridserver, the ubuntu way]] the quick and dirty way to install opensim under ubuntu (Linux)
* [[Wiimote]] - How to use a wiimote/nunchuk controller with the OpenSimulator viewer (Linux)
* [[Cacti]] - Generate Serverstats using the Cacti-Tool and SNMP (Linux)
* [http://sunredbeach.com/dokuwiki/doku.php?id=opensim:minimal-server Installing an openSUSE 11.1 Minimal server setup for an OpenSimulator server] - Quick and Dirty setup on an openSUSE 11.1 server
* [[Streaming Media in OpenSim]]

* [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - Full suite of tutorials, tips and tricks, for the Windows user (Windows) Also very useful for Linux users!

=== Cross-platform ===
* [[Getting Started with Region Modules]] - The Hello World of OpenSimulator application development
* [[Using L3DT]] - How to create custom terrains
* [[Detailed cross-region terrain making]] - A workflow for creating large cross-region custom terrains
* [http://update.multiverse.net/wiki/index.php/About_Terrain How to make a good Terrain (includes 4 programs to use)]
* [http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=8&lid=22 Japanese Manual for Construction of OpenSimulator Server System on Linux] by NSL (Sorry, Japanese only)

=== Application ===
* [http://www.scribd.com/doc/57959626/OpenSimulator-School-Quick-Start-Guide David W. Deeds' OpenSimulator School Quick Start Guide] - David W. Deeds' OpenSimulator School Quick Start Guide courtesy of Changchun American International School. Has lots of useful and interesting info, including lesson plans.

== Gforge Projects ==
* [[OpenSimSearch]] - Search for your OpenSimulator
* [[ServerStats]] - RRD/Proc serverstats using the OpenSimulator module for Berlios Serverstats (Linux)
<cleanpage title=hide cats=hide />

[[Category:Users]]
[[Category:Support]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting Started]]
[[Category:Development]]

UserServer

2012-03-04T07:02:50Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
{{proposal}}
{{content}}

= What is a User Server? =

== Introduction ==

Many virtual worlds are being developed independently with a wide variety of different architectures and protocols. However, one common component across these worlds is a user service. A user service is the means of '''<place definition of user service here>'''. The current generation of virtual world user services are implemented as proprietary, behind-the-simulator services that are not directly available to a user.

Blah, blah, blah <<Put some meaningful text here>>

# Regions are tied to a single grid. Wide availability of content is critical to the growth of virtual worlds, and the inability to roam between or share content between grids limits the ability of small providers. Having an asset server closely tied to a grid limits the ability of many small grids to reach critical mass.

''<edit all the text below this mark (this is leftover text from the AssetServer page), and change/adapt it for use for the User Service page>'''

----------------------------------------------------------------------------
**************** MODIFY ALL THE TEXT BELOW THIS AREA ********************
----------------------------------------------------------------------------

# The current vendor-specific nature of asset storage limits the ability of third-party value added services. Offline content creation, asset archiving, specialized caching, and web service integration are all services that could be added with a more open approach.
# With assets "locked up" in proprietary asset servers, the ability to combine and re-purpose content is limited. For instance, specialized asset processing tuned to mobile applications.
# An asset server closely tied to a grid limits the content creator and owner's ability to manage asset lifecycle. An asset owner may wish to have their assets stored, backed up, and tracked from their own servers rather than handing over control to a grid.

== Vision ==

We envision virtual world grids modeled after the current World Wide Web, with millions of independent administrative domains. Content will be spread across millions of small, independent domains as well as aggregated on large domains supporting millions of users. A rich community of value added services and the free and open exchange of content will weave the network together, much as the Web 2.0 movement is tying the web together today. Every organization can choose to host an asset service or connect with any number of third party asset providers. Additionally, the content rights decisions are placed in the hands of the content hosts. With the proper authentication users are free to move assets to wherever they roam.

Data services will become as important as data hosting itself. Just as search engines and content portals have changed how we use the web, services that can plug into a common interface in asset hosting will change how we use virtual worlds. Auditing services can provide an approach to rights management and traffic analytics. Existing caching techniques and services that have been built for today's web content can be leveraged for delivery of rich virtual world content.

== Approach ==

Most implementations, including Second Life® and its open source derivatives, have opaque asset hosting that is a part of the world itself. The opaque asset hosting model has a choke point at the simulator level. Asset downloads make up the bulk of virtual world bandwidth requirements, and in the current Second Life model all assets must be proxied through the simulator.

In the proposed architecture, control of assets is moved from grid owners to content owners to allow cross-world assets with content authorization management. Protocol enhancements could include better support for content rights, asset hosting as an independent service, asset migration between worlds, and scalable performance by allowing centralized servers to be removed from the equation.

Our approach is to start simple by proposing common interfaces and paths for extensibility. By working with the community to refine these interfaces and explore use cases, we can outline specifications and minimum requirements documents. The short-term goals are to consolidate on a common metadata format with core features for version one, and build a reference asset service that plugs into the OpenSimulator UGAIM model.

=== Asset Hosting as An Independent Service ===

The current model of asset hosting approaches trust and permissions from the viewpoint of a grid. Users authenticate with a grid login service, upload assets to grid asset storage, and set permissions that apply to other users of that grid. By moving authorization to the asset storage, an asset service no longer needs to be tied to a specific grid and can serve anyone who is properly authenticated. This opens up the possibility of web service access to assets or asset metadata, or other use cases that do not directly involve logging in to a virtual world.

=== Leveraging Existing Infrastructure ===

With asset serving separated from grid-specific code, the solution looks similar to existing solutions. Proven infrastructure for asset lookups, authentication, serving metadata, and content distribution can be used as building blocks.

=== Scalability ===

The difficult research in scalable content distribution has already been done and implemented across the web in various different implementations. The goal is to reuse that existing knowledge for virtual world assets, adding optional features such as identity-based permission levels or new caching strategies.

== Terminology ==

* Client: From the asset server's point of view, the networked program that is fetching or storing an asset.
* Asset Server: The network service that presents an interface allowing fetching and storing of asset items.
* Asset: A typed blob of data. The actual definition of asset content is left to the asset creator.
* Asset Metadata: Information stored along with the asset blob which includes type-specific information, ownership information, creation information (creation data), license, and anything else useful in identifying and controlling the asset data.
* Asset ID: A 128-bit identifier for content in a virtual world. These identifiers may or may not follow RFC 4122; the specific implementation is out of scope of the asset service. Asset IDs only have context in the grid they were created in.
* Authentication Token: A session cookie that is temporarily stored on the Asset Server and the Client that proves authentication and may grant some level of authorization. These cookies take the same UUID form as Asset IDs.
* Grid: For the purposes of this document, a grid is defined as the set of services where a particular Asset ID has contextual meaning.

== Protocol Overview ==

# The end user retrieves an authorization token to connect to an asset service. This can be returned by directly connecting to an asset service and supplying OpenID credentials, or an out of band method such as logging into a virtual world grid server.
# The end user does a GET operation, supplying the credentials from step 1, and requests the metadata for an asset ID.
# The asset service performs a lookup step which resolves the ID to metadata which includes the location of the content, a list of supported REST operations on the content, and additional information, such as the dimensions of a texture.
# The end user has information on different valid operations on the asset, and in the most common scenario will choose to use the fetch operation to download the asset.

All user-facing services must be available over standard HTTP 1.1, and must adopt at least one common metadata format.

== Asset Metadata Request ==

An end user must discover the asset service through some means. The specific means of discovery is out of scope of this document but could for example be built into a client application, provided during grid login, or published on a webpage. To request asset metadata, an HTTP 1.1 GET is made to the asset service with the asset ID and metadata operation specified. For example, a request might look like:

<pre>GET /89556747-24cb-43ed-920b-47caed15465f/metadata HTTP/1.1
Host: assets.virtualworld.com
Date: Mon, 22 Sep  2008 12:00:00 GMT
Authorization: OpenGrid ce9a6995-a737-4206-bae8-910cae310e94</pre>

If the asset is a protected resource the Authorization header is required. If the resource is publicly accessible, no Authorization header is needed and a normal HTTP GET (such as one generated by a web browser) can be used.

== Authentication ==

Access to the asset service methods is controlled with a authentication token, a UUID. This UUID is a non-guessable, temporary token assigned to an end user at the end of a successful authentication process. This token could be granted by authentication through a virtual world login server (where the login server is responsible for transmitting the authentication token to the asset server), or through a direct login to the asset service itself using OpenID. Temporary tokens must only be given out to authenticated end users, and should be expired similar to HTTP cookies.

If the asset service supports direct logins, it may respond to unauthorized requests with a response that includes information about authenticating with OpenID.

Once an authenticated request for an asset has been made, the asset service determines if the authenticated user has authorization for the requested content. If a request is unauthorized, a 403 Forbidden response must be sent back to the end user, optionally including information about authenticating with OpenID so the user can choose to authenticate with another identity.

== Lookup ==

Once a request has been authorized, a lookup is performed. This could be as simple as a map<UUID,metadata> or a more scalable solution such as a distributed hash table. The lookup resolves the asset metadata and asset location, and together with the authorization can determine the list of supported actions that are returned in metadata.

== Metadata ==

The metadata provides information on supported methods for the resource and information about the resource itself (such as the size and dimensions of a texture, or byte boundaries of quality layers in a JPEG2000 file). One of the goals of this research is to work with the community to develop a common metadata format for requests and responses. The current metadata reference implementation uses JSON for the wire protocol. See [[AssetServer/ClientDocs|Asset Server Client Documentation]] for more information.

The metadata is broken up into three parts. Required fields, methods, and extra fields.

The required fields are basic attributes that all assets share. These are:

* id - UUID of the asset
* name - Name of the asset
* description - Description of the asset
* creation_date - Timestamp when the asset was created
* type - HTTP Content-Type of the asset
* sha1 - The SHA-1 hash of the asset data
* temporary - Boolean, whether the asset is temporary or not

The methods section is a collection of allowed methods for the asset. The only required method is data, however this method may not be present in the list of returned methods if the client has permission to access an assets metadata but not the data. Each method is a string (such as "data") that maps to a URL. The URL may exist on the same server as the metadata, but this is not required.

The extra data section is a free-form version of the required fields section. Any fields can be defined, and is most commonly used to add extended data for specific types of assets.

== Data ==

Once the metadata has been retrieved, if a data method exists the asset data can be fetched with a simple HTTP GET on the asset data URL. This allows the actual data to optionally be stored on a simple web server, a content distribution network, a third party storage provider, etc.

----------------------------------------------------------------------------
**************** MODIFY ALL THE TEXT ABOVE THIS AREA ********************
----------------------------------------------------------------------------

= See Also =

* [[:Category:Getting Started|Getting Started]]
* [[OpenSim:Introduction_and_Definitions|What are UGAIM Services?]]
* [[UserServer|User Server]]
* [[UserServer/ClientDocs|UserServer Client Documentation]]
* [[UserServer/DeveloperDocs|UserServer Developer Documentation]]
* [[GridServer|Grid Server]]
* [[GridServer/ClientDocs|GridServer Client Documentation]]
* [[GridServer/DeveloperDocs|GridServer Developer Documentation]]
* [[AssetServer|Asset Server]]
* [[AssetServer/ClientDocs|AssetServer Client Documentation]]
* [[AssetServer/DeveloperDocs|AssetServer Developer Documentation]]
* [[InventoryServer|Inventory Server]]
* [[InventoryServer/ClientDocs|InventoryServer Client Documentation]]
* [[InventoryServer/DeveloperDocs|InventoryServer Developer Documentation]]
* [[MessagingServer|Messaging Server]]
* [[MessagingServer/ClientDocs|MessagingServer Client Documentation]]
* [[MessagingServer/DeveloperDocs|MessagingServer Developer Documentation]]

* [[:Category:Tech Reference|Technical Reference Pages]]

[[Category:Support]]
[[Category:Tech Reference]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting Started]]
[[Category:Development]]
[[Category:Todo]]
[[Category:Proposal]]

Upgrading

2012-03-04T07:02:40Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

== Migrating between versions of OpenSimulator without changing database backends ==

'''Unfortunately, this upgrading information is considerably out of date. We recommend that you do not attempt to copy over config files from previous versions of OpenSimulator but instead use the new files and make the changes by hand. However, it is possible to use previous version databases with new versions of OpenSimulator - on startup the data will automatically be migrated to the new formats (so it's best to make a database backup first in case this process goes wrong!).'''

Upgrading OpenSimulator so that your data stays intact is not too difficult. If you’re using MySQL or MSSQL as a backend database with standalone OpenSimulator then all you should have to do is copy over your bin/Regions xml files (and maybe your OpenSim.ini if you don’t want to re-enter your settings manually) to the new OpenSimulator version and start it.

If you're using grid mode then you will also need to copy the 5 xml files in the bin directory that govern the configuration of the UGAIM servers.

Note that estate_settings.xml if present is used for default values for estates, but the saved setttings themselves are in the data base "estate_settings" tables (since r5525).

OpenSimulator contains code to automatically migrate all your data to conform to the newest formats. However, we would always suggest backing up your database beforehand in case something goes wrong during the conversion (e.g. you have a power cut).

Using sqlite (the default on disk database) is just a little more complicated. As well as copying bin/Regions and possibly OpenSim.ini, you also need to copy all the db files (AssetStorage.db, inventorystore.db, OpenSim.db and userprofile.db) to your new installation.

This process should always work between the last numbered versions (e.g. going from 0.5.9 to 0.6.0). It may also work for older versions (e.g. 0.5.8 to 0.6.0) though this is not guaranteed.

SEE Discussion at [[Talk:Upgrading]] for examples of How-To Back Up & Restore your system PRIOR to ANY Migration or Upgrade!

'''METHOD 1: If Using SQLite in StandAlone Mode'''

1. Build the latest version from source (or download the binaries)

2. Put this new installation in a new folder

3. Copy the following files from the old \bin to the new \bin
- All *.db files
- The opensim.ini file
- The \bin\regions XML files
- The \bin\config-include INI files
- estate_settings.xml (if it has been amended)

4. Launch the new opensim.exe

'''METHOD 2: If Using MySQL in StandAlone Mode'''

1. Build the latest version from source (or download the binaries)

2. Put this new installation in a new folder

3. Copy the following files from the old \bin to the new \bin
- The opensim.ini file
- The \bin\regions XML files
- The \bin\config-include INI files
- estate_settings.xml (if it has been amended)

4. Launch the new opensim.exe

'''METHOD 3: If Using MySQL in Grid Mode'''

1. Build the latest version from source (or download the binaries)

2. Put this new installation in a new folder

3. Copy the following files from the old \bin to the new \bin
- The opensim.ini file
- The \bin\regions XML files
- The 5 XML config files
- The \bin\config-include INI files
- estate_settings.xml (if it has been amended)

4. Launch services in the following order: UGAIM + R where "R" designates the region server (Opensim)

== Migrating databases ==

Since SQLite is our default database, there often comes a time when people outgrow it and want to move on to another database backend (usually MySQL). There is a script on the forge at [http://forge.opensimulator.org/gf/project/sqlite2mysql/] which should be able to do the conversion. If it's out of date then just give the author/s a nudge (or patch it!)

An alternative method is to change to each region (change-region) before backing up their contents to a separate OpenSimulator Region Archive (OAR) for each region. Then change the database backend and then reload the OARs in each region separately. The disadvantage of this is that it's a little laborious if you have many regions.

You can use the "command-script" feature of OpenSim.exe to semi-automate this. E.g., create a file in your "bin" directory, called something like "dobackup", which contains the necessary commands, for example:

change-region My Island 1
save-oar MI1
change-region My Island 2
save-oar MI2
change-region Another Region
save-oar AR
change-region root

This can be run from OpenSim.exe by typing "command-script" followed by the name you gave the script (eg "dobackup"). Note that this will overwrite the previous backup of the same name.

Note that using a save and reload via the OAR mechanism would not normally migrate your avatar inventories (you would need to rez everything out to the region, convert the data base, and then derez them again to your inventory).

Updatelibrary.py

2012-03-04T07:02:30Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

A python script for maintaining a server inventory library and associated asset set. See [[Custom Libraries]] for more information.

You can download the current version from [http://www.sonic.net/~rknop/php/vw/updatelibrary.py http://www.sonic.net/~rknop/php/vw/updatelibrary.py]

<source lang = "python">
#!/usr/bin/python

# updatelibrary.py Version 1.2 by Rob Knop aka Prospero Frobozz (rknop@pobox.com)

# Written with some reference to genassets.pl by Illuminous Beltran/IBM,
# as found on the OpenSimulator wiki.

# Copyright 2011 Rob Knop (aka Prospero Frobozz). All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are
# met:
#
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.

# 2. Redistributions in binary form must reproduce the above
# copyright notice, this list of conditions and the following
# disclaimer in the documentation and/or other materials provided
# with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY ROB KNOP ``AS IS'' AND ANY
# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ROB KNOP OR
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
# The views and conclusions contained in the software and documentation
# are those of the authors and should not be interpreted as representing
# official policies, either expressed or implied, of Rob Knop.

import os, os.path, sys, stat, shutil, re, uuid
import xml.dom, xml.dom.minidom
import traceback
from optparse import OptionParser

opensim_library_root_uuid = "00000112-000f-0000-0000-000100bba000"

# **********************************************************************

class AssetExistsException(Exception):
def __init__(self, value):
self.value = value
def __str__(self, value):
return repr(value)

class InventoryException(Exception):
def __init__(self, value):
self.value = value
def __str__(self, value):
return repr(value)

class NiniException(Exception):
def __init__(self, value):
self.value = value
def __str__(self, value):
return repr(value)

# **********************************************************************
class NiniSection(object):
def __init__(self, sectionname, keyvalues):
self.sectionname = sectionname
self.keyvalues = keyvalues

def name(self):
return self.sectionname

def keyvalues(self):
return self.keyvalues

def value(self, key):
return self.keyvalues[key]

def setvalue(self, key, value):
self.keyvalues[key] = value

# **********************************************************************

class NiniThing(object):
def __init__(self, keynames, ninitype):
self.keynames = keynames
self.ninitype = ninitype

def readXML(self, filename):
sections = []

if not os.path.exists(filename):
sys.stderr.write("WARNING: {0} file {1} doesn't exist. Returning empty list.\n".
format(self.ninitype, filename))
return sections

xmlblob = xml.dom.minidom.parse(filename)
topelem = xmlblob.documentElement
if topelem.tagName != "Nini":
raise NiniException("Error not a Nini file: {0}".format(filename))

for sec in topelem.childNodes:
if sec.nodeType == xml.dom.Node.ELEMENT_NODE:
if sec.tagName != 'Section':
raise NiniException("Error {0} file: expecting a 'Section', found a {1}".
format(self.ninitype), sec.tagName)

item = NiniSection(sec.getAttribute("Name"), dict())
for keyname in self.keynames:
item.setvalue(keyname, "")

for seckey in sec.childNodes:
if seckey.nodeType == xml.dom.Node.ELEMENT_NODE:
if seckey.tagName != "Key":
raise NiniException("Error reading {0}: expecting a 'Key', found a {1}".
format(self.ninitype, seckey.tagName) )
item.setvalue(seckey.getAttribute("Name"), seckey.getAttribute("Value"))

sections.append(item)

xmlblob.unlink()

return sections

def writeXML(self, filename, sections):
ofh = open(filename, "w")

ofh.write("<Nini>\n")

for item in sections:
ofh.write(" <Section Name=\"{0}\">\n".format(item.name()))
for keyname in self.keynames:
ofh.write(" <Key Name=\"{0}\" Value=\"{1}\" />\n".format(keyname, item.value(keyname)))
ofh.write(" </Section>\n\n")

ofh.write("</Nini>\n")
ofh.close()

# **********************************************************************

class AssetSet(NiniThing):
def __init__(self):
super(AssetSet,self).__init__( [ "assetID",
"name",
"assetType",
"inventoryType",
"fileName"
],
"Asset Set" )
self.assets = []

def __iter__(self):
return self.assets.__iter__()

def addasset(self, uuid, name, asstype, invtype, filename):
ass = NiniSection(filename,
{ 'assetID': uuid,
'name': name,
'assetType': asstype,
'inventoryType': invtype,
'fileName': filename }
)
self.assets.append(ass)
return ass

def findbyfilename(self, filename):
for ass in self.assets:
if ass.value('fileName') == filename:
return ass
return None

def findbyuuid(self, uuid):
for ass in self.assets:
if ass.value('assetID') == uuid:
return ass
return None

def readXML(self, filename):
self.assets = super(AssetSet, self).readXML(filename)

def writeXML(self, filename):
super(AssetSet, self).writeXML(filename, self.assets)

# **********************************************************************

class InvFolders(NiniThing):
def __init__(self):
super(InvFolders, self).__init__( [ "folderID",
"parentFolderID",
"name",
"type"
],
"Inventory Folders" )
self.folders = []

def __iter__(self):
return self.folders.__iter__()

def findbyuuid(self, uuid):
for folder in self.folders:
if folder.value('folderID') == uuid:
return folder
return None

# NOTE -- findbyname only finds the first folder of
# the given name inside the given parent folder.
# It is possible, if perverse, to have more than
# one folder with the same name...

def findbyname(self, name, parentid):
for folder in self.folders:
if ( ( folder.value('parentFolderID') == parentid ) and
( folder.value('name') == name ) ):
return folder
return None

def ensureexists(self, path, name, parentid):
if ( ( parentid != opensim_library_root_uuid ) and
( not self.findbyuuid(parentid) ) ):
raise InventoryException("No such parent folder exists: " + str(parentid))

folder = self.findbyname(name, parentid)
if folder != None:
return folder

# HACK ALERT -- I want this "type 6" to become whatever the right
# type is for no icon
# http://opensimulator.org/wiki/AssetServer/DeveloperDocs doesn't tell me enough

folder = NiniSection(path,
{ 'folderID' : uuid.uuid4(),
'parentFolderID' : parentid,
'name' : name,
'type' : -1
}
)
self.folders.append(folder)

return folder

def readXML(self, filename):
self.folders = super(InvFolders, self).readXML(filename)

def writeXML(self, filename):
super(InvFolders, self).writeXML(filename, self.folders)

# **********************************************************************

class InvItems(NiniThing):
def __init__(self, folders):
super(InvItems, self).__init__( [ "inventoryID",
"assetID",
"folderID",
"name",
"description",
"assetType",
"inventoryType",
"currentPermissions",
"nextPermissions",
"everyonePermissions",
"basePermissions"
],
"Inventory Items" )
self.folders = folders
self.items = []

def findbyinvid(self, uuid):
for item in self.items:
if item.value('inventoryID') == uuid:
return item
return None

# Note -- findbyname only finds the first one of that name
# in that folder. You can have more than one thing of
# the same name in a given folder....

def findbyname(self, name, folderid):
for item in self.items:
if ( ( item.value('name') == name ) and
( item.value('folderID') == folderid) ):
return item
return None

def ensureexists(self, path, name, assetid, assettype, invtype, folderid):
if ( ( folderid != opensim_library_root_uuid) and
( not self.folders.findbyuuid(folderid) ) ):
raise InventoryException("No such folder for item: " + str(folderid))

for item in self.items:
if ( ( item.value('assetID') == assetid ) and
( item.value('folderID') == folderid ) and
( item.value('name') == name ) ):
return item

item = NiniSection(path,
{ 'inventoryID' : uuid.uuid4(),
'assetID' : assetid,
'folderID' : folderid,
'name' : name,
'description' : "",
'assetType' : assettype,
'inventoryType' : invtype,
'currentPermissions' : "2147483647",
'nextPermissions' : "2147483647",
'everyonePermissions' : "2147483647",
'basePermissions' : "2147483647"
}
)
self.items.append(item)

return item

def readXML(self, filename):
self.items = super(InvItems, self).readXML(filename)

def writeXML(self, filename):
super(InvItems, self).writeXML(filename, self.items)

# **********************************************************************

class LibraryGenerator(object):
def __init__(self, libname, shortname):
self.libname = libname
self.shortname = shortname
self.asset_dir = os.path.abspath(os.path.join("assets", "{0}AssetSet".format(shortname)))
self.inv_dir = os.path.abspath(os.path.join("inventory", shortname))
self.asset_xmlfile = "{0}AssetSet.xml".format(shortname)
self.folders_xmlfile = "{0}InvFolders.xml".format(shortname)
self.items_xmlfile = "{0}InvItems.xml".format(shortname)
self.skips = []
self.wipeinv = False

self.matchj2k = re.compile("\.j2k$")
self.matchtxt = re.compile("\.txt$")
self.matchlsl = re.compile("\.lsl$")
self.endsinslash = re.compile("/$")
self.commentline = re.compile("^\s*#")
self.blankline = re.compile("^\s*$")
self.assetlistline = re.compile("^\s*([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\s*(\d+)\s*(\d+)\s*(.*\S)\s*$")

def set_skip_patterns(self, skips):
self.skips = skips

def set_asset_dir(self, asset_dir):
self.asset_dir = asset_dir

def set_inv_dir(self, inv_dir):
self.inv_dir = inv_dir

def set_asset_xmlfile(self, asset_xmlfile):
self.asset_xmlfile = asset_xmlfile

def set_folders_xmlfile(self, folders_xmlfile):
self.folders_xmlfile = folders_xmlfile

def set_items_xmlfile(self, items_xmlfile):
self.items_xmlfile = items_xmlfile

def wipe_inventory(self):
self.wipeinv = True

def run(self):
# Create our storage for things, and read any current
# XML files if they exist

self.assets = AssetSet()
self.assets.readXML(os.path.join(self.asset_dir, self.asset_xmlfile))

self.folders = InvFolders()
if not self.wipeinv:
self.folders.readXML(os.path.join(self.inv_dir, self.folders_xmlfile))

self.items = InvItems(self.folders)
if not self.wipeinv:
self.items.readXML(os.path.join(self.inv_dir, self.items_xmlfile))

# Run the recursive directory processor thingie

origdir = os.getcwd()
os.chdir(self.asset_dir)
self.process_dir(opensim_library_root_uuid, "", "")
os.chdir(origdir)

# Write the XML files, saving copies of the old ones out of paranoia

if os.path.exists(os.path.join(self.asset_dir, self.asset_xmlfile)):
shutil.copy2(os.path.join(self.asset_dir, self.asset_xmlfile),
os.path.join(self.asset_dir, "{0}-old".format(self.asset_xmlfile)))

self.assets.writeXML(os.path.join(self.asset_dir, self.asset_xmlfile))

if os.path.exists(os.path.join(self.inv_dir, self.folders_xmlfile)):
shutil.copy2(os.path.join(self.inv_dir, self.folders_xmlfile),
os.path.join(self.inv_dir, "{0}-old".format(self.folders_xmlfile)))

self.folders.writeXML(os.path.join(self.inv_dir, self.folders_xmlfile))

if os.path.exists(os.path.join(self.inv_dir, self.items_xmlfile)):
shutil.copy2(os.path.join(self.inv_dir, self.items_xmlfile),
os.path.join(self.inv_dir, "{0}-old".format(self.items_xmlfile)))

self.items.writeXML(os.path.join(self.inv_dir, self.items_xmlfile))

def process_dir(self, parent_uuid, my_name, path):
origdir = os.getcwd()
sys.stderr.write("Processing directory: {0} \n".format(os.path.join(self.asset_dir, path)))
if my_name != "":
os.chdir(my_name)
else:
my_name = self.libname

# Create the folder XML blob if necessary

if (path == ""):
curfolder = self.folders.ensureexists(self.libname, my_name, parent_uuid)
else:
curfolder = self.folders.ensureexists(path, my_name, parent_uuid)
my_uuid = curfolder.value("folderID")

# Walk through this directory and process everything in it

for fname in os.listdir("."):
statinfo = os.stat(fname)

doskip = False
for skip in self.skips:
if re.search(skip, fname):
doskip = True
if doskip: continue

if stat.S_ISDIR(statinfo.st_mode):
self.process_dir(my_uuid, fname, os.path.join(path, fname) )
continue

fpath = os.path.join(path, fname)

if fpath == self.asset_xmlfile:
# Ignore the XML file we're working on!
continue

elif fname == "addassets.lis":
# Ignore the file specifing pre-existing assets to add
# to inventory
continue

elif self.matchj2k.search(fname):
asset_type = 0
elif self.matchtxt.search(fname):
asset_type = 7
elif self.matchlsl.search(fname):
asset_type = 10
else:
sys.stderr.write("WARNING: Skipping unrecognized file " +
fname + "\n")
continue

# Strip the extension for aesthetic purposes
# (Right now, that must be .txt, .lsl, or .j2k, so
# we can assume it's 4 characters long.)

name = fname[0:-4]

# Create the asset XML blob if necessary

ass = self.assets.findbyfilename(fpath)
if ass == None:
ass = self.assets.addasset(uuid.uuid4(), name, asset_type,
asset_type, os.path.join(path, fname))

# Create the inventory XML blob if necessary

self.items.ensureexists(os.path.join(path, name), name, ass.value('assetID'),
asset_type, asset_type, my_uuid)

# Add pre-existing assets (to inventory only) from file addassets.lis

if os.path.exists("addassets.lis"):
asslis = open("addassets.lis")
for line in asslis:
line.rstrip("\r\n")
if self.blankline.search(line) or self.commentline.search(line):
continue
match = self.assetlistline.search(line)
if match == None:
sys.stderr.write("WARNING : error parsing line in {0}\n".
format(os.path.join(path, "addassets.lis")))
sys.stderr.write("Offending line: \"{0}\"\n".format(line))
continue
self.items.ensureexists(os.path.join(path, match.group(4)), match.group(4),
match.group(1), match.group(2), match.group(3), my_uuid)
asslis.close()

# We're done; restore the CWD to where we started and return

os.chdir(origdir)

# **********************************************************************

def main():

usage = """
updatelibrary.py -n "Library Name" -s ShortLibName [options]

Goes through your asset set directory. (See below for how to specify
it, and what the default is.) Finds all .j2k images, .txt files, and
.lsl files in that directory and all subdirectories. Generates an
Asset Set XML file for all of those files. Also generates library
Inventory Folder and Inventory Item XML files for all of those assets,
organized in a folder hierarchy that matches the directory hierarchy.

Additional assets that already exist in the grid's asset store may be
specified in each directory in a file named "addassets.lis".

For more documentation, see http://opensimulator.org/wiki/Custom_Libraries

When done, you will need to manually add your asset directory to the
OpenSimulator AssetSets.xml file (in "assets" under the OpenSimulator bin
directory), and your inventory XML files to the Libraries.xml file (in
"inventory" under the OpenSimulator bin directory).

Written 2011 by Rob Knop aka Prospero Frobozz. I've only used this on
Linux; I have no idea how well it will function on Windows. If you're
on Windows, I recommend http://www.ubuntu.com

Run updatelibrary.py --help for option listings
"""

parser = OptionParser(usage = usage)

parser.add_option("-n", "--lib-name", action="store", type="string",
dest="libname", default="New Library",
help="The name of your library as it appears in the viewer")

parser.add_option("-s", "--short-name", action="store", type="string",
dest="shortname", default="NewLibrary",
help="A name without spaces of your library for filename purposes.")

parser.add_option("-w", "--wipe-inventory", action="store_true", default=False,
dest="wipeinv",
help="Wipe & start over the inventory? (Safe! Use this if you've removed things.)")

parser.add_option("-a", "--asset-dir", action="store",
type="string", dest="asset_dir",
default=None,
help="Directory where your .j2k, .txt, and .lsl files are, and which will "+
"serve as the Assset Set in the OpenSimulator library. Defaults to assets/[shortname]AssetSet")

parser.add_option("-i", "--inv-dir", action="store", type="string",
dest="inv_dir", default=None,
help="Directory in which to put the inventory XML files. Defaults to "+
"inventory/[shortname]")

parser.add_option("", "--asset-xmlfile", action="store",
type="string", dest="asset_xmlfile", default=None,
help="Name of Asset XML file. Defaults to [shortname]AssetSet.xml")

parser.add_option("", "--folders-xmlfile", action="store",
type="string", dest="folders_xmlfile", default=None,
help="Name of Inventory Folders XML file. Defaults to [shortname]InvFolders.xml")

parser.add_option("", "--items-xmlfile", action="store",
type="string", dest="items_xmlfile", default=None,
help="Name of Inventory Folders XML file. Defaults to [shortname]InvItems.xml")

parser.add_option("", "--skip", action="append", type="string",
dest="skip_patterns",
default=['^\.hg$', '^\.git$', '^\.svn$'],
help="Regex for filenames to not process")

if len(sys.argv) < 2:
parser.print_usage()
sys.exit(0)

options, args = parser.parse_args()

try:
generator = LibraryGenerator(options.libname, options.shortname)

if options.skip_patterns:
generator.set_skip_patterns(options.skip_patterns)

if options.asset_dir != None:
generator.set_asset_dir(options.asset_dir)

if options.inv_dir != None:
generator.set_inv_dir(options.inv_dir)

if options.asset_xmlfile != None:
generator.set_asset_xmlfile(options.asset_xmlfile)

if options.folders_xmlfile != None:
generator.set_folders_xmlfile(options.folders_xmlfile)

if options.items_xmlfile != None:
generator.set_items_xmlfile(options.items_xmlfile)

if options.wipeinv:
generator.wipe_inventory()

generator.run()

except Exception:
print "FAIL"
traceback.print_exc()
sys.exit(20)

# **********************************************************************

if __name__ == "__main__":
sys.exit(main())
</source>

UnofficialDebPackages

2012-03-04T07:02:20Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

== Unofficial .deb (i386) packages ==

Currently tested with:

* Debian lenny
* Ubuntu Hardy (8.04)
* Ubuntu Intrepid (8.10)
* Ubuntu Jaunty (9.04)

These are packages I (coyled) created and use to run an assortment of regions in OSGrid (though there's nothing OSGrid-specific in these packages). You're welcome to use, but please back up your OpenSim.ini, *.xml, *.db, and other important files before installing, just in case. But I use these packages on a regular basis, and they work fine for me.

Here you'll find repositories of three different flavors:

"releases"
-- official versioned releases (e.g. 0.6.3)

"testing"
-- the SVN revision number which is "recommended" for OSGrid
region admins each week during the OpenSimulator developer office
hours on Wright Plaza

"unstable"
-- an SVN revision number close to HEAD, usually no more than
a couple days old
-- this may contain untested changes and/or breakage

For Debian users, depending on which repository you choose above, add one of:

deb http://pkg.knifejaw.com/debian opensim releases modules
or:
deb http://pkg.knifejaw.com/debian opensim testing modules
or:
deb http://pkg.knifejaw.com/debian opensim unstable modules

to your /etc/apt/sources.list .

For Ubuntu users, depending on which repository you choose above, add one of:

deb http://pkg.knifejaw.com/ubuntu opensim releases modules
or:
deb http://pkg.knifejaw.com/ubuntu opensim testing modules
or:
deb http://pkg.knifejaw.com/ubuntu opensim unstable modules

to your /etc/apt/sources.list .

Then run:

# apt-get update
# apt-get install opensimulator

OpenSimulator will be installed in /usr/lib/opensim , logs will appear in /var/log/opensim , and it'll create an opensim user & group. It doesn't install any start/stop scripts, as people tend to have different preferences on how to do that.

Universal Time in OpenSim

2012-03-04T07:02:00Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

== OpenSimulator Standard Time ==

OpenSimulator is based on [[UTC]] (Coordinated Universal Time) and not SLT (Second Life Time) which is based on PST (Pacific Standard Time). Due to the very nature of OpenSimulator being a metaverse, UTC was a natural choice due to its use throughout the Earth as the standard starting point for all timezones. Going forward it will be much easier to plan events and use standard toolsets in OpenSimulator and any metaverses based on it.

[[Category:Standards]]

UXSimStatus

2012-03-04T07:01:49Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

As of OpenSimulator svn 9529 the xtended stats reporting will return a jsonp
callback to allow popular javascript toolkits to use the returned data to
create ajax monitoring applications in the browser. This is an advantage
because after the page is loaded, the browser will interact directly with
the region, eliminating traffic through the website (polling the region and
servicing the browser). It also allows the creation of mashups to create
mini-monitor apps in other pages.

To enable your stats reporting, set the following in your OpenSim.ini...

; Simulator Stats URI
; Enable JSON simulator data by setting a URI name (case sensitive)
Stats_URI = "jsonSimStats"

...the URI can be anything you want, and is case sensitive. You can query
the URI directly to return a json string to use in php, python, java, etc.
or you may use one of the popular javascript toolkits to have OpenSimulator
generate a callback for jsonp. The json serialization carries the following
data...

{"AssetsInCache":5.0,"TimeAfterCacheMiss":0.0,"BlockedMissingTextureRequests":0.0,"AssetServiceRequestFailures":0.0,
"abnormalClientThreadTerminations":0.0,"InventoryServiceRetrievalFailures":0.0,"Dilatn":0.967380821704865,"SimFPS":55.0,
"PhyFPS":47.1628913879395,"AgntUp":0.0,"RootAg":0.0,"ChldAg":0.0,"Prims":0.0,"AtvPrm":0.0,"AtvScr":0.0,"ScrLPS":0.0,
"PktsIn":0.0,"PktOut":0.0,"PendDl":0.0,"PendUl":0.0,"UnackB":0.0,"TotlFt":0.0,"NetFt":0.0,"PhysFt":0.0,"OthrFt":0.0,
"AgntFt":0.0,"ImgsFt":0.0,"Memory":"8","Uptime":"05:12:19.0365590","Version":"OpenSimulator Server 0.6.4.9533 "}

<source lang="html4strict">
<html>
<head>
<title>JSON Test</title>
<script src="http://ascent.bluewallgroup.com/jquery-1.3.2.js"></script>
<script src="http://ascent.bluewallgroup.com/timer.js"></script>
<script type="text/javascript" src="http://www.google.com/jsapi"></script>
<script type="text/javascript" language="JavaScript">
SimFPS = 0;
PhyFPS = 0;
Memory = 0;
RootAg = 0;
ChldAg = 0;
Uptime = "";
Version = "";
</script>

<script type="text/javascript" language="JavaScript">

$.timer(15000, function(timer) {
$.getJSON("http://ascent.bluewallgroup.com:9300/jsonSimStats/?callback=?",

function(data){

SimFPS = Math.round(data.SimFPS);
PhyFPS = Math.round(data.PhyFPS);
Memory = Math.round(data.Memory);
ChldAg = data.ChldAg;
RootAg = data.RootAg;
Uptime = data.Uptime;
Version = data.Version;
drawChart();
setTags();
timer.reset(15000);
});
});
</script>

<script type="text/javascript" language="JavaScript">

google.load("visualization", "1", {packages:["gauge"]});
google.setOnLoadCallback(drawChart);
function drawChart() {
var cdata = new google.visualization.DataTable();
cdata.addColumn('string', 'Label');
cdata.addColumn('number', 'Value');
cdata.addRows(3);
cdata.setValue(0, 0, 'SimFPS');
cdata.setValue(0, 1, SimFPS);
cdata.setValue(1, 0, 'PhyFPS');
cdata.setValue(1, 1, PhyFPS);
cdata.setValue(2, 0, 'Memory');
cdata.setValue(2, 1, Memory);

var chart = new
google.visualization.Gauge(document.getElementById('chart_div'));
var options = {width: 400, height: 120, redFrom: 90, redTo: 100,
yellowFrom:75, yellowTo: 90, minorTicks: 5};
chart.draw(cdata, options);
}
</script>

<script type="text/javascript" language="JavaScript">
function setTags() {
$("#par-uptime").text("Uptime: " + Uptime);
$("#par-ragent").text("Root Agent: " + RootAg);
$("#par-version").text("Version: " + Version);
$("#par-cagent").text("Child Agent: " + ChldAg);
}
</script>

</head>
<body>
= BlueWall Development Region =
<table>
<tr><td>
<div id="par-version">version</div>
</td><td>
<div id="par-ragent">root agent</div>
</td></tr><tr><td>
<div id="par-uptime">uptime</div>
</td><td>
<div id="par-cagent">child agent</div>
</td></tr>
</table>
<div id="chart_div"></div>
</body>
</html>
</source>

[[SSL in OpenSim]]

== JSON Grid Simstats ==

Python example to gain the region data from a grid service
- should work but this version not tested -
*reference material*

<source lang="python">

import hashlib
import urllib2

''' value shown is an example, get this from your grid database each time - regions.regionSecret '''
regionsecret = 'fe21314b-6267-44f7-aa1e-6047e1c3f94a'

''' My region host '''
hostName = myregion.host.net

''' My region port '''
hostPort = 9000

''' create an *UPPERCASE* SHA1 hash from the regionSecret '''
resourceName = str(hashlib.sha1(regionsecret).hexdigest()).upper()

regionuri = hostName + ":" + hostPort + "/" + resourceName + "/"

''' data includes TimeZoneName , TimeZoneOffs, UxTime, Memory, Version and OSStatsURI '''
regiondata = simplejson.load(urllib2.urlopen(regionuri))

''' OSStatsURI is the uri to query the OpenSimulator instance. return same data as the user set uri '''
simuri = regiondata['OSStatsURI']

simdata = simplejson.load(urllib2.urlopen(simuri))

</source>

Troubleshooting

2012-03-04T07:01:42Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks}}
<br />
This page gives any system-specific configuration settings that may be useful, and advice for problems that might be encountered.
__TOC__
{{clear}}
== General tips ==

If OpenSimulator does startup to a point where you can type commands in the region console, then you can find out what your current configuration is by using the "config get" and "config save" commands as detailed at [[Server Commands]] (and by typing help on the console). This can be useful for eliminating a bad configuration when diagnosing some issues.

Also make sure that you are running the correct versions of the .NET runtime and database. See the [[Configuration#Database]] for notes about database versions, and you must use .NET 3.5 or later. .NET 2.0 doesn't have a System.Core. If you are using Windows .NET, simply download the 3.5 or 4 Update. If you are using Mono, you'll need to update your mono version.

== System-specific configuration ==

=== CentOS 5 (64bit) ===
If you are running Mono 2.2 compiled from source on CentOS 5.2 64bit (not sure if it applies to other scenarios as well), you need to take these steps:
sudo yum install libgdiplus
sudo yum install libexif
sudo ln -s /usr/lib64/libgdiplus.so.0 /usr/lib64/libgdiplus.so
ldconfig

That finally enabled me to run OpenSimulator without errors, and even connect to other grids.

=== Gentoo ===
some Mono dependency & latest Mono itself may use "~x86" masked packages (assuming x86 is your platform, change may be made to reflect your ex:"~amd64" for 64bits). You could check for USE parameter with:

ACCEPT_KEYWORDS="~x86" emerge -vp subversion nant mono libgdiplus

Then install with:

ACCEPT_KEYWORDS="~x86" emerge subversion nant mono libgdiplus

N.B: The ACCEPT_KEYWORDS="~x86" can be set in Gentoo /etc/make.conf file, but that turn up all the emerges in testing/unstable, using it at the begining of emerge command line use it only for current emerge process

=== Mac OS X ===
If you get errors about the 2.0 framework not being supported, you may need to update your <tt>pkg-config</tt> path.
For example, you can set this in <tt>~/.bash_profile</tt>:
export PKG_CONFIG_PATH="/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig/:${PKG_CONFIG_PATH}"

== Errors and fixes ==

=== Build workarounds due to non-functionality or bugs: ===

==== Disappearing prims due to duplicate UID's ====

Generally this problem occurs when a save-xml/load-xml file is loaded into the same sim without using the -newUID switch to generate new UUID's for the objects. See [[Server Commands]] for detailed information. (<nowiki>load-xml <filename> -newUID</nowiki>). But if this does not work, the other way is to shift-copy your build and drag it up into the air.. then delete the one in the air, (which is actually the copy). This will generate new UID's on all your prims.. you can now leave that build, and load your original load-xml file in another region.

----

=== Exception and loss of ode physics (System.EntryPointNotFoundException: dSpaceLockQuery) ===

The following error is usually caused by using the wrong version of ''libode'':

{|
|-
| style="background: none repeat scroll 0% 0% LavenderBlush; color: black;" |
[SCENE] [02-01 22:20:40] System.EntryPointNotFoundException: dSpaceLockQuery

:at (wrapper managed-to-native) Ode.NET.d:SpaceLockQuery (intptr)
:at OpenSim.Region.Physics.OdePlugin.OdeScene.waitForSpaceUnlock (IntPtr space) [0x00000]
:at OpenSim.Region.Physics.OdePlugin.OdeCharacter.AvatarGeomAndBodyCreation (Single npositionX, Single npositionY, Single npositionZ, Single tensor) [0x00000]
:at OpenSim.Region.Physics.OdePlugin.OdeCharacter..ctor (System.String avName, OpenSim.Region.Physics.OdePlugin.OdeScene parent_scene, OpenSim.Region.Physics.Manager.PhysicsVector pos) [0x00000]
:at OpenSim.Region.Physics.OdePlugin.OdeScene.AddAvatar (System.String avName, OpenSim.Region.Physics.Manager.PhysicsVector position) [0x00000]
:at OpenSim.Region.Environment.Scenes.ScenePresence.AddToPhysicalScene () [0x00000]
:at OpenSim.Region.Environment.Scenes.ScenePresence.MakeRootAgent (LLVector3 pos, Boolean isFlying) [0x00000]
:at OpenSim.Region.Environment.Scenes.Scene.AgentCrossing (UInt64 regionHandle, LLUUID agentID, LLVector3 position, Boolean isFlying) [0x00000]

|}

First try searching your filesystem to see if you have other copies of the ode physics engine:

find / -name "libode.so"

Then make sure you have the latest version.

=== MySQL connection errors after about 6-8 hours ===

MySQL has a timeout which drops the connection after 28,800 seconds (8 hours) of inactivity, which will probably result in failure to login after the User server has been sitting idle for an extended period. If you have this problem, increase the timeout to something larger, like 604800 (1 week) or 31536000 (1 year). From the mysql console, type:

set global wait_timeout=604800;

=== System.DllNotFoundException: gdiplus.dll ===

First, check to make sure that <tt>libgdiplus.so</tt> is known to the dynamic linker:

/sbin/ldconfig -p | grep libgdiplus

If nothing is found, make sure that the directory libgdiplus.so exists in is either in your <tt>LD_LIBRARY_PATH</tt> environment variable or listed in a *.conf file (e.g., gdiplus.conf) in /etc/ld.so.conf.d/. Then run <tt>ldconfig</tt> to update the cache. Then it should be able to find the library.

You may still have the above error, however, since libgdiplus also depends on other dynamic libraries, and if they fail to load, libgdiplus will fail. To test for this, run OpenSimulator with debugging information turned on:

MONO_LOG_LEVEL=debug mono OpenSim.exe

On Mac OS X - check the following file exists... /opt/local/lib/libgdiplus.dylib if it does then as root user edit the file /opt/local/etc/mono/config and add the line

<dllmap dll="gdiplus.dll" target="/opt/local/lib/libgdiplus.dylib" os="!windows"/>

=== Migrating Opensim / MySQL database from Windows to Linux ===

==== MySql.Data.MySqlClient.MySqlException: Table 'opensim.UserAccounts' doesn't exist ====

'''Environment:''' Opensim Server 0.7.0.2 behind Linux Ubuntu 8.0.4 with mono 2.8 and MySQL 5.0 installed.

When you migrates a Opensim 0.7 database working with MySQL 5.0 on Windows to Linux, when logging a user in Opensim server, you may receive the following exception in the Opensim server console:

{|
|-
| style="background: none repeat scroll 0% 0% LavenderBlush; color: black;" |
03:11:10 - [LLOGIN SERVICE]: Exception processing login for (user_name): MySql.Data.MySqlClient.MySqlException: Table 'opensim.UserAccounts' doesn't exist
at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000] in <filename unknown>:0 at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000] in <filename unknown>:0
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000] in <filename unknown>:0

|}

On the client, you also receive the following error:

Login Failed
Error generating Login Response

This exception is caused by the way MySQL store the table names. On a Windows MySQL server, the table names are not case sensitive, but '''all tables in MySQL Linux are case sensitive by default''', so when OpenSimulator will find them in the database with names in first capital letters, it can not find it.

One solution would be to change the names of the tables required by opensim (ALTER TABLE's), but the cleanest solution is changing MySQL config, checking the option “'''lower_case_sensitive = 1'''” in the file "'''/etc/mysql/my.cnf'''", section '''[mysqld]'''.

# sudo nano /etc/mysql/my.cnf

..........................
[mysqld]
..........................
lower_case_sensitive=1
..........................

This makes MySQL translate to lowercase the table names automatically. After restarting MySQL server and OpenSim, the tables are loaded without problems.

Warning: don’t try to clear the table '''migration''' to force opensim re-migrate your database, because '''it will provoke a blight on your database'''.

=== Errors from incomplete data migrations ===

This can happen during version upgrades if for some reason a database migration fails when there is a change in the way OpenSimulator stores data.

You may see errors on the OpenSimulator console like:

[LLOGIN SERVICE]: Exception processing login for [username]: MySql.Data.MySqlClient.MySqlException: Table 'opensim.UserAccounts' doesn't exist
at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000]
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000] at MySql.Data.MySqlClient.MySqlStream.OpenPacket () [0x00000]
at MySql.Data.MySqlClient.NativeDriver.ReadResult (System.UInt64& affectedRows, System.Int64& lastInsertId) [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.GetResultSet () [0x00000]
at MySql.Data.MySqlClient.MySqlDataReader.NextResult () [0x00000]

In this case the 'users' table had not been migrated to the 'UserAccounts' table which OpenSimulator was expecting, also resulting in the viewerside error:

Login Failed
Error generating Login Response

I solved by fixing the filesystem permissions that were causing the migration to fail (on my Linux box '/var/lib/mysql/...' had got itself messed up), then dropping the 'migration' table and running the server again (from the [non-critical] migration warnings encountered there was probably a more precise way to do this, but I was fully backed up so I did it quick-and-dirty). Other than loosing terrain data refs. and current shape/clothing/attachment data (easily restored in-sim) all was now good for me.

=== When installing mono or libgdiplus0 you may get dependency missing libexif.so.9 ===

This was noticed on Centos5 but may occur on other systems, download ftp://rpmfind.net/linux/conectiva/snapshot/i386/RPMS.extra/libexif9-0.5.12-47547cl.i386.rpm and install problem solved. You will now be able to install mono (as long as nothing else goes wrong )

=== The assembly mscorlib.dll was not found or could not be loaded ===

This indicates that you are missing one of the mscor libs that comes with nant. This is easily solved by getting NAnt, which comes with both versions 1.0 and 2.0 of the required lib.

apt-get install nant

=== External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe ===

This is quickly fixed by retrieving mono-gmcs.

apt-get install mono-gmcs

=== The type or namespace name JScript does not exist in the namespace Microsoft ===

Note that it says JScript over and over again. Hint perhaps?

apt-get install mono-mjs libmono-microsoft8.0-cil

On Fedora and OpenSUSE, the needed package is "mono-jscript".

=== The type or namespace name Tcp does not exist in the namespace System.Runtime.Remoting.Channels ===

This one is taken care of with a quick install:

apt-get install libmono-system-runtime2.0-cil

=== Missing: libopenjpeg-libsl-2.1.2.0-x86_64.so ===

You are probably on a 64-bit linux machine and may need to follow these instructions:

* [[Installing and running on x86-64]]

=== error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file ===

If you start with a base Debian system as we did at the top of the page, but instead of using the apt version of mono you use the installer from their website, then you may encounter this issue.

After getting the .bin file from http://www.mono-project.com/Downloads, and executing it as per its instructions, upon finishing, you may find that if you try to run `mono --version` you are presented with this message. This one means you need to install libglib2.0-0.

apt-get install libglib2.0-0

=== The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file. ===

This one seems to be fixed by retrieving the apt version of nant.

apt-get install nant

This can also be due to <tt>pkg-config</tt> not being able to locate the <tt>mono.pc</tt> file. Adding the directory containing this file to the environment variable <tt>PKG_CONFIG_PATH</tt> may solve this.

== Networking and config issues ==

See also the wiki page:
* [[Network Settings]]
* [[Firewall Settings]]
* [[Configuration]]

=== You are able to log in, but not connect to a Region from a remote client ===

Look in your OpenSimulator/bin/Regions folder:
# Try '''0.0.0.0''' for the InternalAddress in your Regions.ini file.
# '''ExternalHostName=127.0.0.1''' will be needed to change its name to the asscssable DNS name such as "opensim.example-host.com" or "71.6.131.152" (your public accessable ip)

If you still have the same problem, it might be a firewall issue. Check if your firewall is active and configure it. See [[Firewall Settings]] for detailed instructions.

== Building OpenSimulator ==
=== I can't find any build files or solution files ===
* If you're on Windows, run
runprebuild.bat
* on Linux/Mac/FreeBSD, run
runprebuild.sh

=== VS2005 won't open the .sln file ===
* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

== Running OpenSimulator ==
=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===
* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== How to do a clean rebuild? (e.g. after 'APPLICATION EXCEPTION DETECTED' after rebuild with updated source) ===

When you build from source, then update the source, rebuild and try to run, you get strange runtime exceptions like that:

APPLICATION EXCEPTION DETECTED: System.UnhandledExceptionEventArgs
Exception: System.MissingMethodException

When you build the source, it's 'compiled' into runnable files called 'dlls' or Dynamic Link Libraries.
These have the extension .dll and are added to your local installation, and are not governed by source control.
When we change where these dlls are created, the 'old' ones, from previous builds, will still be there.
This will cause the program to try and load these old dlls, with unexpected results.

Usually, any of these remedies should fix the problem:
* Do a 'nant clean' if you're using Nant then rebuild and run.
* Remove all OpenSim.*.dll (only files that starts with "OpenSim." and ends in ".dll", like "OpenSim.Framework.dll") recursively from your installation directory. This is what "nant clean" does above. Finally, rebuild and run.
* Do a clean checkout, build that from scratch, then copy over all data files (*.db, *.ini) from your old installation, rebuild and run.

If all else fails, join #opensim on freenode, or send an email to the [https://lists.berlios.de/mailman/listinfo/opensim-users opensim-users] mailing list.

=== OpenSim.exe console input is scrambled when run with mono on Windows ===

This is because OpenSimulator uses modified console which emulates cursor control and context help. It is intended to use on _nix console, so if you use it in dos console, it occurs.

Try starting like that. It will use "basic" console without additional features.
<pre>
mono OpenSim.exe -console=basic
</pre>

== Something Has Gone Wrong! ==
=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===
When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:
alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';
The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get errors concerning 'State' when starting up my grid after updating from svn beyond r3786 ===
After r3786, a new 'State' field has been added to the 'primshapes' table on SQLite. This field is used to persist trees and grass.
You may have an empty region at startup, because OpenSimulator does not find this 'State' field and does not know what to do.
The best is to use SQLiteBrowser or another SQLite table editor (download it at [http://sqlitebrowser.sourceforge.net/ http://sqlitebrowser.sourceforge.net/]) to create the missing field:
alter table primshapes add column State integer default 0
Just launch SQLiteBrowser, use File/Open database, then browse to OpenSim.db file and open it. Then, go to the "Execute SQL" tab, copy/paste the command above in the "SQL string" textbox, then hit the "Execute query" button.

=== I get a timeout during region handshake ===
* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSimulator will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSimulator ===
* See [[Connecting]] or [[Firewall Settings]]

=== I can connect but cannot move ===
If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.
* See [[Configuration]]

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===
* This may happen when running OpenSimulator on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSimulator folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSimulator <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSimulator

== Exceptions on the Console ==
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===

{|
| style="background:LavenderBlush; color:black" |
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
: at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
: at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
:at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
:at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]
|}

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://openmv.org/libsl/libopenmetaverse/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSimulator bin-folder.

=== System.NullReferenceException at OpenSim.Region.Communications.Local.LocalLoginService.PrepareLoginToRegion ===
{|
| style="background:LavenderBlush; color:black" |
[LOGIN END]: XMLRPC Login failed, System.NullReferenceException: Object reference not set to an instance of an object
:at OpenSim.Region.Communications.Local.LocalLoginService.PrepareLoginToRegion (OpenSim.Framework.RegionInfo regionInfo, OpenSim.Framework.UserProfileData user, OpenSim.Framework.Communications.LoginResponse response) [0x00000] in /home/sim/svn/opensim/OpenSim/Region/Communications/Local/LocalLoginService.cs:293
:at OpenSim.Region.Communications.Local.LocalLoginService.CustomiseResponse (OpenSim.Framework.Communications.LoginResponse response, OpenSim.Framework.UserProfileData theUser, System.String startLocationRequest) [0x00520] in /home/sim/svn/opensim/OpenSim/Region/Communications/Local/LocalLoginService.cs:253
:at OpenSim.Framework.Communications.LoginService.XmlRpcLoginMethod (Nwc.XmlRpc.XmlRpcRequest request) [0x00369] in /home/sim/svn/opensim/OpenSim/Framework/Communications/LoginService.cs:252
|}

Your first startup of OpenSimulator has failed for example due to giving non existent domain name when prompted for region external host name. This causes only partial initialization. You need to delete bin folder, do svn update, rebuild and purge database to resolve this issue.

=== Exception: System.NotImplementedException: The requested feature is not implemented. ===

If your exception starts as follows:

{|
| style="background:LavenderBlush; color:black" |
|Exception: System.NotImplementedException: The requested feature is not implemented.
at (wrapper managed-to-native) System.Threading.Interlocked:Add (int&,int)
at System.Threading.ReaderWriterLockSlim.TryEnterReadLock (Int32 millisecondsTimeout) [0x000e3] in
|}

You probably unwittingly passed the option '''--optimize=-all''' to mono. The problem is that Mono compiles in an "optimized" version of the System.Threading.Interlocked class's methods; these optimizations are done using raw assembler for your architecture (automatically detected at build time). When you pass '''--optimize=-all''', the runtime detects that these functions are optimized, and disables them. So the next time a class tries to call these functions, the runtime finds that there is no native implementation of the methods! This affects almost all synchronization primitives System.Threading. Since OpenSimulator relies heavily on threading and locking mechanisms, we can't do without this functionality. Perhaps a future Mono version will allow you to pass '''--optimize=-all''', and provide an unoptimized implementation (e.g. pthreads), rather than throwing an exception.

If you're looking to debug a low level problem with mono (such as an error in native code), passing '''--optimize=-all''' is not the way to go about it. Instead, set the environment variable MONO_LOG_LEVEL=debug and run your program with the '''--debug''' switch passed to mono. You can also run mono under gdb, just like any other process.

=== Command error: System.IO.FileNotFoundException: Could not load file or assembly 'System.Core, Version=3.5.0.0, culture=neutral,PublicKeyToken=b77a5c561934e089' or one of its dependencies. ===

A missing System.Core indicates that you are using an old version of the .NET Runtime.

You must use .NET 3.5 or later. .NET 2.0 doesn't have a System.Core. If you are using Windows .NET, simply download the 3.5 or 4 Update. If you are using Mono, you'll need to update your mono version.

== Grid Mode ==

=== I start the sim and it doesn't connect to any grid ===

When OpenSimulator is first started, it needs configuration.

* See [[Configuration]].

=== My grid works fine with one user but when two users login in the same time both get stuck ===
* Make sure you have export MONO_THREADS_PER_CPU="100" in your environment

=== After ~20 minutes my region starts to take 100% cpu and region(s) hang ===
* If you have mono 1.9.1 or lower upgrade to mono 2.2.

== Hypergrid ==
=== After starting OpenSimulator with Hypergrid enabled my inventory wont load! ===
* If you're running in grid mode, first check your OpenSim.ini to make sure that the dns names or addresses for your grid servers are accessible to both you and the public.
* Check the XML config files for your UGAIM servers to make sure that everything is running off of a publicly accessible IP address.
** If this is the case and you have to change your UGAIM addresses you will need to run a few quick and dirty SQL queries on your database in order to update your grid's user accounts so that they now point to the new IP addresses of your UGAIM.

Log into your sql server and change over to the database for your grid. The following will update your user's home inventory and asset URIs after changing the addresses of your UGAIM services in the XML configuration files.

<div align = center>'''!!!!WARNING!!!! - Be smart! Always make a backup of your databases before making any changes to OpenSim! - !!!!WARNING!!!!'''</div>
<pre>
update users set userInventoryURI="http://new.UGAIM.address:8004" where userInventoryURI = "http://old.UGAIM.address:8004";
</pre>

<pre>
update users set userAssetURI="http://new.UGAIM.address:8003" where userAssetURI = "http://old.UGAIM.address:8003";
</pre>
* If you're running in standalone mode... - Anyone familiar with standalone want to fill this in? -
== Physics Issues ==
=== Problems using OpenDynamicsEngine (ODE) on *nix ===
If you have problems using the OpenDynamicsEngine on *nix, try setting your stack reserve level higher than the default with the following command; ulimit -s 262144 Or, run the opensim-ode.sh to start up OpenSimulator.

== ScriptEngine Issues ==
=== Got "Primitive: Error compiling script: unknown char: . error" when compiling script ===
When trying to compile a script ( using [[DotNetEngine]] or [[XEngine]] ) you could have this error :
{|
| style="background:LavenderBlush; color:black" |
Primitive: Error compiling script:
unknown char: .
|}

And on the console :
{|
| style="background:LavenderBlush; color:black" |
11:06:37 - [ScriptEngine.DotNetEngine]: Unloading script<br />
11:06:37 - Exception in MaintenanceLoopThread. Thread will recover after 5 sec throttle. Exception: System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
:at System.Collections.Generic.Dictionary`2[OpenSim.Region.ScriptEngine.Interfaces.IEventReceiver, OpenSim.Region.ScriptEngine.Shared.Api.Plugins.Dataserver].get_Item (IEventReceiver key) [0x00000]
:at OpenSim.Region.ScriptEngine.Shared.Api.AsyncCommandManager.RemoveScript (IEventReceiver engine, UInt32 localID, UUID itemID) [0x00000]
:at OpenSim.Region.ScriptEngine.DotNetEngine.ScriptManager._StopScript (UInt32 localID, UUID itemID) [0x00000]
:at OpenSim.Region.ScriptEngine.DotNetEngine.ScriptManager.DoScriptLoadUnload () [0x00000]
:at OpenSim.Region.ScriptEngine.DotNetEngine.MaintenanceThread.MaintenanceLoop () [0x00000]
11:06:37 - [ScriptEngine.DotNetEngine]: Loading script<br />
11:06:37 - [ScriptEngine.DotNetEngine]: ScriptManager StartScript: localID: 720001, itemID: 88c9d28c-6004-4609-a707-717190de044a<br />
11:06:37 - [Compiler]: Compiled new assembly for fad15951-f9aa-493f-be68-2aaf5ff8a3c9<br />
11:06:37 - [SCRIPT]: Compiled assetID fad15951-f9aa-493f-be68-2aaf5ff8a3c9: ScriptEngines/a83150da-1ab1-11dd-89fb-0014853ee9da/CommonCompiler_compiled_fad15951-f9aa-493f-be68-2aaf5ff8a3c9.dll<br />
11:06:37 - [ScriptEngine.DotNetEngine]: AppDomain Loading: OpenSim.Region.ScriptEngine.Shared, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
|}

This happens on '''linux''' when your locales are not set to default ( "C" ).
* You could refer to [http://opensimulator.org/mantis/view.php?id=2088 Mantis #2088] and [http://opensimulator.org/mantis/view.php?id=2015 Mantis #2015] for a workaround to run opensim.
<pre>
env LANG=C mono --debug OpenSim.exe
</pre>
* You could also change your locale setup. Here is what I use in my '.bash_profile' :
<pre>
export LC_ALL=C
export LANG=C
</pre>
I know it's a ugly way to setup locales on a linux box, but it works fine on my '''Linux From Scratch''' box.

'''Rq''': I saw Melanie has corrected some parts of the source code a few weeks ago to avoid such problems.

=== Get "Primitive: Error compiling script: ApplicationName='gmcs', ..." when compiling script ===
When trying to compile a script ( using DotNetEngine or XEngine ) you have an error something like :

{| width="100%"
| style="background:LavenderBlush; color:black" |
Primitive: Error compiling script:<br />
ApplicationName='gmcs', CommandLine='/target:library /debug+ /optimize- /out:
:"ScriptEngines/430c29d0-c5c6-11dd-ad8b-0800200c9a66/CommonCompiler_compiled_fbe5e682-afae-4f1a-805b-0125031101f7.dll"
:/r:"/usr/lib/opensim/bin/OpenSim.Region.ScriptEngine.Shared.dll"
:/r:"/usr/lib/opensim/bin/OpenSim.Region.ScriptEngine.Shared.Api.Runtime.dll" --
:"/tmp/11b81aac/594d02ce.0.cs" ', CurrentDirectory=''
|}

Other features include "Touch" being disabled on the right click menu wheel.

You might have a broken mono install (i.e. discovered as mono but not gmcs installed on a Ubuntu 8.10 Intrepid machine.)

Check mono-gmcs (sudo apt-get install mono-gmcs) is correctly installed.

=== Get "gmcs: Cannot find the specified file" when compiling script ===
Just install "mono-gmcs" package on your system. See [[Dependencies]] for details.

== Locales Issues ==
Well, some of us, OpenSimulator users, ran into random crash of the OpenSimulator Region server in grid mode ...

I have made many tests to find a solution about that problem.

I first ran into this problem with OpenSIM SVN.6660 ... Even if I have no users connected, my OpenSimulator region server randomly crash ( after 1 hour, or 5 hours, ... ).

My first idea was to upgrade to the latest SVN release, no chance, same problem. So I made a test with a previous SVN release ( SVN.6575 ) which is running fine on another server ( same OS, same parameters, same mono release, ... ) : No chance, same problem.

Then, I tried to play with locales, recompile the '''screen''' unix command line utility I use to run my servers, ... No chance again.

So, I checked the memory usage on my Server, and I discovered that with the last SVN release, the amount of memory needed to run OpenSimulator server in multi-region/grid mode increased :) ... So, I have tuned my MySQL server to use less memory. Was better, but my OpenSimulator region server still randomly crash ( but could stay alive longer than before ).

Then, trying to play with the '''screen''' command line options ... And all my tests shows that the '''--debug''' option impact the stability of the server.

Initially, I used such command line to run OpenSimulator :
<pre>
/screen -S Region-service -d -m --debug mono OpenSim.exe
</pre>

Without the '''--debug''' option, everything seems to be more stable.

About locales, if you read mantis and threads in opensim-dev / opensim-users, you know that there are issues on system that are not "en_US" or "C" local compliant.

I have re-setup my server to be full "en_US.UTF8".

On my Ubuntu 8.0.4 server :
<pre>
# cat /etc/default/locale
LANG="en_US.UTF-8"

# cat /var/lib/locales/supported.d/local
fr_FR.UTF-8 UTF-8
en_US.UTF-8 UTF-8

# cat /etc/environment
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games"
LANG="en_US"
LANGUAGE="en_US"
</pre>
And maybe you should need :
<pre>
# sudo dpkg-reconfigure locales
</pre>

So, the resulting '''screen''' command line options should be :
<pre>
screen -S Region-service -d -m -U mono OpenSim.exe
</pre>

This allow me to run OpenSimulator SVN.6575 without crash during more than 48 hours, and also SVN.6735 ...

Hope those informations could help peoples.

Just for your information :

Here is my '''OpenSimulator Startup script''' :
<pre>
#!/bin/bash

echo "User-Service..."
/usr/local/bin/screen -S User-service -d -m -U mono OpenSim.Grid.UserServer.exe
sleep 5
echo "Grid-Service..."
/usr/local/bin/screen -S Grid-service -d -m -U mono OpenSim.Grid.GridServer.exe
sleep 5
echo "Asset-Service..."
/usr/local/bin/screen -S Asset-service -d -m -U mono OpenSim.Grid.AssetServer.exe
sleep 10
echo "Inventory-Service..."
/usr/local/bin/screen -S Inventory-service -d -m -U mono OpenSim.Grid.InventoryServer.exe
sleep 5
echo "Region-Service..."
/usr/local/bin/screen -S Region-service -d -m -U mono OpenSim.exe
sleep 5
echo " "
echo " "
/usr/local/bin/screen -list
</pre>

Here is also a small script that give you a menu to connect to the '''screen(s)''' sessions :
<pre>
#!/usr/bin/perl

use strict;
use Term::Menu;

my $EXIT = 1;

my $MainTitle = "+-----------------------------------------------------+\n";
$MainTitle .= "| Connexion SCREEN aux Serveurs OPENSIM |\n";
$MainTitle .= "| |\n";
$MainTitle .= "| ( Type CTRL+A+D to exit the Screen Console. ) |\n";
$MainTitle .= "+-----------------------------------------------------+\n";

while ( $EXIT == 1 )
{

system("screen -list | grep service > /tmp/osg.services");
my %LIST = ();
open(IN, "/tmp/osg.services");
while ( my $i = <IN> )
{
chomp($i);

$i =~ s/\./#/g;
$i =~ s/\-service\t/#/g;
$i =~ s/\t//g;
$i =~ s/$//g;
$i =~ s/$//g;

my @STATUS = split(/#/, $i);
$LIST{$STATUS[1]} = $STATUS[2];
}
close(IN);

my %LIST2 = ();
my @indices = ('User', 'Grid', 'Asset', 'Inventory', 'Region');

foreach my $key ( @indices )
{
# print "$key --> $LIST{$key}\n";
if ( $LIST{$key} =~ /Attached/ )
{
$LIST2{$key} = "[X]";
}
else
{
$LIST2{$key} = "[ ]";
}
}

if ( $LIST{'User'} =~ /Attached/ )
{
$LIST2{'USER'} = "X";
}
else
{
$LIST2{'USER'} = "-";
}

system ('clear');
my $prompt = new Term::Menu (
spaces => 3,
aftertext => "\nChoisir une option : ",
beforetext => ${MainTitle},
delim => ". ",
);

my $SEP = " ";

my $answer = $prompt->menu(
osg_user => ["OpenSimulator User Server $SEP$LIST2{'User'}", '1'],
osg_grid => ["OpenSimulator Grid Server $SEP$LIST2{'Grid'}", '2'],
osg_asset => ["OpenSimulator Asset Server $SEP$LIST2{'Asset'}", '3'],
osg_inventory => ["OpenSimulator Inventory Server $SEP$LIST2{'Inventory'}", '4'],
osg_region => ["OpenSimulator Region Server $SEP$LIST2{'Region'}\n", '5'],
osg_shutdown => ["Shutdown Servers (Manual)",'6'],
osg_shutdown2 => ["Shutdown Servers (Hard)\n",'7'],
quit => ["Quitter", 'q'],
);

if ( "${answer}" eq "quit" )
{
$EXIT = 0;
}

if ( "${answer}" eq "osg_user" )
{
system("screen -d -r -S User-service");
$EXIT = 1;
}

if ( "${answer}" eq "osg_grid" )
{
system("screen -d -r -S Grid-service");
$EXIT = 1;
}

if ( "${answer}" eq "osg_asset" )
{
system("screen -d -r -S Asset-service");
$EXIT = 1;
}

if ( "${answer}" eq "osg_inventory" )
{
system("screen -d -r -S Inventory-service");
$EXIT = 1;
}

if ( "${answer}" eq "osg_region" )
{
system("screen -d -r -S Region-service");
$EXIT = 1;
}

if ( "${answer}" eq "osg_shutdown" )
{
system("screen -d -r -S Region-service");
system("screen -d -r -S Inventory-service");
system("screen -d -r -S Asset-service");
system("screen -d -r -S Grid-service");
system("screen -d -r -S User-service");
$EXIT = 1;
}

if ( "${answer}" eq "osg_shutdown2" )
{
# system("/OPENSIM/shutdownGrid.py");
system("screen -S Region-service -r -m -X quit");
system("screen -S Inventory-service -r -m -X quit");
system("screen -S Asset-service -r -m -X quit");
system("screen -S Grid-service -r -m -X quit");
system("screen -S User-service -r -m -X quit");
$EXIT = 0;
}
}
</pre>

Regards,
Ursula Matova.

[[Category:Users]]
[[Category:Users]]

Tips

2012-03-04T07:01:31Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

== Terrain Tidbits ==
=== How can I flatten a region? ===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:

(as of version 0.6.3.8730)
change region YourRegionName
terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25
=== What programs can I use to create terrains for OpenSim? ===

If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions. You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible. Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water. And here are some [[Free Terrains]] that you can use. Enjoy!

Additional Terrain Related Info: [[Artist Home#Terrain]]

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>
For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:
<strike>script terrain load-tile simalpha.r32 512 512 0 0</strike>
script terrain load-tile simalpha.r32 2 2 0 0 ([[User:Oudrun|Oudrun]])
New syntax is using number of tiles instead of imagesize (one tile 256x256 pix). Above example is for a 2x2 region terrainfile.

Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script terrain multiply 0.4
This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSimulator the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change region <nowiki><regionname></nowiki>

Then use the command (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or useful info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=== Importing SL RAW Terrain Files (using Photoshop) ===

1. Open Photoshop and:

(a) Load desired SL RAW terrain file

(b) Select canvas and then flip vertically, NOT
horizontally

(c) save file as a RAW file

If the SL RAW terrain file name is "[region name]_256_256.raw"
then save the new RAW file as "[region name]_flipv_256x256.raw"
or any other name to distinguish it from the SL RAW terrain
file. The expression "flipv" stands for flipped vertically and
256x256 is the size for the 13-channel interlaced 8-bit RAW
file.

2. Move the new RAW file or files to the Opensim bin folder

(a) navigate to

C:\Program Files\Opensim\bin [or whatever the path is]

(b) copy each new RAW terrain file into that directory

3. Run opensim and in the console on the last line type:

(a) change region [enter region name]

(b) terrain load [enter name of new RAW terrain file]

(c) terrain elevate [enter meters to elevate]

Do not type the square brackets and repeat the above commands
for each region.

If the above commands are entered when the region is set to
[root], then each region on the simulator will be affected.
The only useful command in this case would be the terrain
elevate command but only if the terrain is to be elevated
by the same amount in each region.

How much to elevate the terrain depends on the multiplier
used for the SL RAW terrain file (e.g. elevate terrain by
1.474 meters if the multiplier is 0.1016; i.e. value 12
in the green channel of the RAW file).

== General Setup Tricks ==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Placing data away from the code ===
A good set up, separates the code (replaced often in this project) from the data ("unique" and more valuable for the user). Things to do:
* separate your region definitions by using the ''regionload_regionsdir'' value in the OpenSim.ini
e.g. regionload_regionsdir="../OSHirvi/Regions" places the Regions directory besides the "code directory" in a folder called OSHirvi
* make your data persistent in a database (see above), this requires (again) to edit your OpenSim.ini file. You might use unique names to separate multiple setups within the database server you use.
e.g. ''storage_connection_string=''"Data Source=localhost;Database=OSHirvi;User ID=OSHirvi;Password=password;";
* the next step is copying/cutting OpenSim.ini itself away from the code
p.e. place this file in ../OSHirvi/OpenSim.1.ini
* to point from your place ../ to your wanted runtime directory create a link (or some call it shortcut). If you download a newer build just change the link.
e.g. ln -s opensimservercode opensim-0.5.8.5695

Now create a script, and call it startHirvi.sh that:
a) gets it current directory in the code directory, found by the link
b) starts up OpenSim.exe with the required .ini file, by using the ''-inifile'' startup option. You can still add other options.
cd ../opensimservercode
mono OpenSim.exe -inifile ../OSHirvi/OpenSim.1.ini -gridmode=true

Oke, done this you are left with a code directory still filled with runtime data, but this is just persistent temporary stuff that the server automatic rebuilds if it is deleted. Still a pitty there is no way to get it separate.
./addin-db-00
./addins
./OpaenSim.log and many others if you run in grid-mode
./estate_settings.xml and many other configuration settings

=== Deleting a few recently created prims ===
Occaisionally, one ends up with one or more prims that one would like to delete on a region but doesnt know where they are. Here is one possible solution to that problem.

Given the site, http://epochconverter.com, one can enter a human date and get a binary such as an epoch. For instance, 4/21/2008 19:00:34GMT is "1208797234"

Then, from a sqlite3 prompt or a mysql prompt, one can do:
select CreationDate from prims where CreationDate>"1208797234";
delete from prims where CreationDate>"1208797234";

[[Category:Users]]
[[Category:Getting Started]]

Testing

2012-03-04T07:01:21Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

{{Quicklinks}}
{{content}}

= Automated Testing =
For information on the current continuous integration system for OpenSimulator go to [[Automated Testing]].

For information about debugging the test cases go to [[Debugging Unit Tests]].

= Current functionality =

* [[Features Currently Supported]]<br />
* [[Priorities and Test Plans]]<br />
<br />
Check [[LSL Status]] Page for currently implemented scripting features.<br />
Note: not all scripting features are supported yet.<br />
<br />
* Standalone region tested with svn version 9379
* Grid region tested with svn version 9379

== Account ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| login
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| logout
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| relog
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Home - Login Start Location
| bgcolor="lime" | OK
| bgcolor="lime" | OK - Configurable by Region
|-
| Alt Home - if Home unavailable
| bgcolor="yellow" | unknown
| bgcolor="lime" | Alternate Region hardset by GRID
|}

== World ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| day / night cycle
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| windlight
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| clouds
| bgcolor="lime" | Working
| bgcolor="lime" | Working
|-
| wind
| bgcolor="lime" | Working
| bgcolor="lime" | Working
|-
| water and water texture
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| terrain and terrain textures
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
== Accounts and permissions ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| multiple account creation
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| permissions per account
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| account has inventory
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| sim supports multiple logins
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
== Avatar ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| teleport within region
| bgcolor="yellow" | partially working (always facing north after teleport)
| bgcolor="yellow" | partially working (go inside ground when teleport from low to high position,always facing north after teleport)
|-
| teleport between regions
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| built-in animations (walking, flying, sitting)
| bgcolor="yellow" | partially working
| bgcolor="yellow" | partially working
|-
| uploaded animations / gestures
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| uploaded sounds
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| can wear clothes
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| can attach items
| bgcolor="lime" | OK
| bgcolor="yellow" | OK
|-
| profile
| bgcolor="lime" | pics & text
| bgcolor="lime" | pics & text
|-
| DRAG / CTRL DRAG objects
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
== Building ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| create prim
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| change prim type
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| change prim transparency
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| change prim colour
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| change prim texture (including uploaded textures)
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| change prim size, cut, hollow, etc
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| prim light, fullbright and flexi
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| link prims
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| unlink prims
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| permissions
| bgcolor="lime" | Working
| bgcolor="lime" | Working
|-
| objects persist in world across login / logoff and server restart
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| parcel support
| bgcolor="lime" | OK See Parcels Below
| bgcolor="lime" | OK See Parcels Below
|}
== Terraforming ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| select land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| raise land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| lower land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| flatten land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| roughen land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| smooth land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
== Land and parcels ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| subdivide
| bgcolor="lime" | Working
| bgcolor="lime" | Working
|-
| join
| bgcolor="lime" | Working
| bgcolor="lime" | Working
|-
| buy and sell
| bgcolor="orange" | Partial, sell and buy, but no money recieved. (Set helper uri to IP ADDRESS AND PORT:9000
| bgcolor="lime" | Working (when using a 3rd party module)
|-
| Set Land To Group
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Allow Deed To Group
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Owner Makes Contribution With Deed
| bgcolor="red" | not working
| bgcolor="lime" | Working (when using a 3rd party module)
|-
| Buy Pass - (Temporary Paid Access)
| bgcolor="red" | not working
| bgcolor="red" | Not Yet Implemented
|-
| Buy For Group
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
!scope="row" colspan="3"| '''Covenants'''
|-
| Buy For Group
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Estate Owner
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
!scope="row" colspan="3"| '''Land Objects'''
|-
| Sim Usage
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Prims on Parcel
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Return Parcel Primitives
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| AutoReturn of Prims
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Show Owners (Land Menu)
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
!scope="row" colspan="3"| '''Land Options'''|
|-
| Show Owners (Land Menu)
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
!scope="row" colspan="3"| '''Land Media'''
|-
| Replace Texture With Media
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Music Stream URL
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Restrict Spatialized Sounds to Parcel
| bgcolor="red" | Not Yet Implemented
| bgcolor="red" | Not Yet Implemented
|-
!scope="row" colspan="3"| '''Land Access'''
|-
| Show Owners (Land Menu)
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
!scope="row" colspan="3"| '''Land Bans'''
|-
| Limit Access to Group
| bgcolor="lime" | Yes
| bgcolor="lime" | Yes
|-
| Limit Access by Avatar
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| Individual Avatar Ban
| bgcolor="lime" | Working
| bgcolor="lime" | Working - Grid can disable feature gridwide
|}
== UI ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| friends list
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| uploads
| bgcolor="lime" | OK
| bgcolor="lime" | OK, jpg, bmp,tga (alpha)
|-
| edit profile
| bgcolor="lime" | OK, but not complete
| bgcolor="lime" | OK, but not complete
|-
| search
| bgcolor="yellow" | partially working(User, Groups, Parcel, Region)
| bgcolor="yellow" | Working(User, Groups, Land Sales, Events, Classifieds)
|-
| large map
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| minimap
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| money
| bgcolor="lime" | Works if using IP ADDRESS AND PORT:9000
| bgcolor="lime" | Works if using IP ADDRESS AND PORT:9000
|-
| HUD attachments
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
== Friends ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| add
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| remove
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| permissions
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| mapping
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| online visibility
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| can edit my objects
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| send teleport
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
== Groups ==
Groups are implemented, but must be enabled in opensim.ini
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| create
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| join
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| description
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| graphic
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| notices
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| vote
| bgcolor="red" | Not Yet Implemented
| bgcolor="red" | Not Yet Implemented
|-
| invite
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| remove
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| members
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| group list
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| publish
| bgcolor="grey" | unknown
| bgcolor="red" | Not Yet Implemented
|-
| set title
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| change active title
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| enrollment fee
| bgcolor="grey" | unknown
| bgcolor="red" | Not Yet Implemented
|-
| open enrollment
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| set mature flag
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| group land
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
=== Group Roles ===
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| create
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| edit
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| remove
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| add person
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| remove person
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| abilities
| bgcolor="yellow" | Partially Implemented
| bgcolor="yellow" | Partially Implemented
|}
== Chat, IM, Voice ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| local chat
| bgcolor="lime" | OK
| bgcolor="lime" | OK - Plus Configurable Distance (server)
|-
| Shout
| bgcolor="lime" | OK
| bgcolor="lime" | OK - Plus Configurable Distance (server)
|-
| send / receive IM
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| offline IM
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| group IM
| bgcolor="lime" | OK, but groups must be enabled
| bgcolor="lime" | OK, but groups must be enabled
|-
| multiple friend IM
| bgcolor="red" | unknown
| bgcolor="red" | Not Yet Implemented
|-
| participant list
| bgcolor="red" | unknown
| bgcolor="red" | Not Yet Implemented
|-
| voice
| bgcolor="lime" | Must enable and use freeswitch voice
| bgcolor="lime" | Must enable and use freeswitch voice
|-
| IRC bridge
| bgcolor="lime" | OK
| bgcolor="lime" | OK (Configurable on Server)
|}
== Physics / Collision ==
{| border="1" cellpadding="5" cellspacing="0"
! width="150" |  
! width="150" | basicphysics
! width="150" | POS
! width="150" | OpenDynamicsEngine
! width="150" | modified_BulletX
! width="150" | RealPhysX
! width="150" | BulletDotNET
|-
| walk on ground
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="yellow" | partially working (ground is very slippery)
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| fly
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| sit on ground
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="red" | not working
| bgcolor="red" | not working
| bgcolor="lime" | OK
|-
| sit on object
| bgcolor="lime" | OK
| bgcolor="red" | not working
| bgcolor="yellow" | partially working (autopilot has trouble getting to the right spot 'try phantom prim')
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| walk on object
| bgcolor="red" | not working
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| bump into object
| bgcolor="red" | not working
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| Collidable Linksets
| bgcolor="red" | not working
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| Avatar Land on Prim
| bgcolor="red" | not working
| bgcolor="lime" | OK
| bgcolor="lime" | OK
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| prim physics
| bgcolor="red" | not working
| bgcolor="red" | not working
| bgcolor="lime" | OK
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| Physical (active) Linksets
| bgcolor="red" | not working
| bgcolor="red" | not working
| bgcolor="lime" | OK
| bgcolor="red" | not working
| bgcolor="red" | not working
| bgcolor="lime" | OK
|-
| cut/hollow/dimpled prim (non)collisions
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK with Meshmerizer
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | OK
|-
| physical vehicles
| bgcolor="red" | not working
| bgcolor="red" | not working
| bgcolor="lime" | OK, but friction is much too high.
| bgcolor="red" | not working
| bgcolor="red" | not working
| bgcolor="red" | not working
|}
== Scripting ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| create LSL script
| bgcolor="lime" | OK, see supported commands
| bgcolor="lime" | OK, see supported commands
|-
| add script to object
| bgcolor="lime" | OK
| bgcolor="lime" | Drag from inventory into prim
|-
| execute script in object
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|}
Note: not all scripting features are supported yet.
Check [[LSL Status]] for currently implemented features.
== Inventory ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone
! width="200" | Grid
|-
| create new items (folder, notes, body, clothes, prims, scripts)
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| delete prims -> trash
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| delete items -> trash
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| trash folder functions (restore, purge)
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| search inventory
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| "recent items" list
| bgcolor="red" | not working
| bgcolor="yellow" | half, only new uploaded and self created stuff, but acctepted inventory offers not listed (8814)
|-
| inventory persists across logout / login
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| drag items to / from world
| bgcolor="lime" | OK
| bgcolor="lime" | OK
|-
| give inventory items to other avatars
| bgcolor="lime" | OK
| bgcolor="lime" | OK
Inventory should not yet be treated as permanent, whilst development is still occurring.
|}
== Permissions ==
{| border="1" cellpadding="5" cellspacing="0"
! width="200" |  
! width="200" | Standalone - Allowed User
! width="200" | Standalone - Denied User
! width="200" | Grid - Allowed User
! width="200" | Grid - Denied User
|-
| Run Script - Estate Disabled
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | no
| bgcolor="lime" | no
|-
| Run Script - Parcel Disabled
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="lime" | no
|-
| Rez Object - Estate Disabled
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="grey" | N/A
| bgcolor="grey" | N/A
|-
| Rez Object - Parcel Disabled
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Edit Estate Settings
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="lime" | no
|-
| Edit Terrain
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Duplicate (Drag-Duplicate AND Ctrl-D) Object
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Take Object
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Move Object
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Copy Object
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Edit Object
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Delete Object
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|-
| Add/Remove to Object's Inventory
| bgcolor="grey" | unknown
| bgcolor="grey" | unknown
| bgcolor="lime" | yes
| bgcolor="red" | yes
|}

-- note --
new objects had to be rezzed for each change in permissions for a test - new permissions settings did not apply to existing objects

[[Category:Development]]

Teleports

2012-03-04T07:01:10Z

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

__NOTOC__
{{Quicklinks}}
<br />

This page explains the several flavors of teleports in and around opensim. It reflects the code as of the creation of this page. Likely will need updating soon.

== Grid Teleport Procedure ==

[[Image:GridTeleports.jpg|500px]]

== Hypergrid Teleport Procedure ==

[[Image:HypergridTeleports.jpg|500px]]

== Open Grid Protocol Teleport Procedure ==

See [http://wiki.secondlife.com/wiki/OGP_Explained#Teleport OGP Explained "Teleport"]

== Related ==

[[Image:Child-event-queue.png|500px]]

== Teleports in OpenSimulator as of 2009-02-06 ==

[[Image:Teleport.jpg]]

== Teleport Study (2009-03-05) ==

The following four pictures compare the current agent transfer scheme with 3 possible agent transfer schemes. The different schemes have slightly different requirements with respect to authentication.

[[Image:TPCurrent.JPG]]

[[Image:TPScenarioA.JPG]]

[[Image:TPScenarioB.JPG]]

[[Image:TPScenarioC.JPG]]

OpenSimulator - User contributions [en]

MediaWiki talk:Titleblacklist

REST

OSSL Script Library/OpenSim Radio

0.6.6-release

0.7 Release

関連ソフトウェア

設定

日本語訳(GridCommon.ini.example)

日本語訳(FlotsamAssetCache.ini.example)

日本語訳(CenmoeAssetCache.ini.example)

日本語訳(BUILDING.txt)

地域の設定

動作環境

利用者向け説明書

メガ・リージョンの設定

メインページ

ファイアウォール設定

ビルド手順

ハイパーグリッドのインストールと運用

ハイパーグリッド

トラブルシューティング

ダウンロード

シミュレータ・パラメタの設定

サーバコマンド

サポート

グリッドリスト

Opensim-ru

XSimStatus

WxService

WikiStructure/de

WikiStructure

Wifi

Webinterface

Warp3DImageModule

Virtual World Model

Vehicles

VMware Appliance

Using Git

Userlevel

User DocumentationPT

User Documentation

UserServer

Upgrading

Updatelibrary.py

UnofficialDebPackages

Universal Time in OpenSim

UXSimStatus

Troubleshooting

Tips

Testing

Teleports