Second Life Wiki - User contributions [en]

GroupChatTest

2011-06-02T23:08:10Z

JustOneMore Loon: Undo revision 1145275 by JustOneMore Loon (Talk)

= Overview =
We are performing a load test of some Group Chat changes on ADITI Thursday the 2nd of June at 4PM PT. We can use as many willing participants as we can get.

'''Refresh this page at 4PM on Thursday for more details.'''

= Details =
* Who: You!
* What: A load test of Group Chat changes
* Where: ADITI, the preview grid.
** Instructions for accessing ADITI are here: [[Preview Grid#How do I log in to Aditi?]]
* When: '''Thursday, the 2nd of June, 2011 @ 4PM PT'''
* Why: To help make Group Chat better
* How: However you can.

= How To Help =
We will have open join groups for you to become a member in. Testing will be as simple as chatting in these groups while we gather metrics.
* '''Step 1''': Log into ADITI with any Viewer
** Instructions for accessing ADITI are here: [[Preview Grid#How do I log in to Aditi?]]
* '''Step 2''': Teleport to a random region chosen below:
** If your region is full or crowded we encourage you to spread out. We need each region to be as full as possible.
* '''Step 3''': Join the group "Second Life Beta"
** secondlife://Aditi/app/group/19657888-576f-83e9-2580-7c3da7c0e4ca/about
** There are group join objects in each region as well
* '''Step 4''': Start chatting via group chat in the group "Second Life Beta".
* Additional instructions will be sent via god shout.
{| class="wikitable"
|-
! Test Island 1
! Test Island 2
|-
| secondlife://Aditi/secondlife/Oatmeal%201/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%201/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%202/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%202/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%203/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%203/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%204/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%204/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%205/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%205/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%206/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%206/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%207/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%207/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%208/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%208/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%209/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%209/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2010/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2010/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2011/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2011/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2012/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2012/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2013/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2013/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2014/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2014/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2015/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2015/128/128/30
|-
| secondlife://Aditi/secondlife/Oatmeal%2016/128/128/30
| secondlife://Aditi/secondlife/GC%20Test%2016/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2017/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2018/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2019/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2020/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2021/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2022/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2023/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2024/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2025/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2026/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2027/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2028/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2029/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2030/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2031/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2032/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2033/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2034/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2035/128/128/30
|-
|
| secondlife://Aditi/secondlife/GC%20Test%2036/128/128/30
|}

GroupChatTest

2011-06-02T23:04:20Z

JustOneMore Loon: /* How To Help */

= Overview =
We are performing a load test of some Group Chat changes on ADITI Thursday the 2nd of June at 4PM PT. We can use as many willing participants as we can get.

'''Refresh this page at 4PM on Thursday for more details.'''

= Details =
* Who: You!
* What: A load test of Group Chat changes
* Where: ADITI, the preview grid.
** Instructions for accessing ADITI are here: [[Preview Grid#How do I log in to Aditi?]]
* When: '''Thursday, the 2nd of June, 2011 @ 4PM PT'''
* Why: To help make Group Chat better
* How: However you can.

= How To Help =
We will have open join groups for you to become a member in. Testing will be as simple as chatting in these groups while we gather metrics.
* '''Step 1''': Log into ADITI with any Viewer
** Instructions for accessing ADITI are here: [[Preview Grid#How do I log in to Aditi?]]
* '''Step 2''': Teleport to a random region chosen below:
** If your region is full or crowded we encourage you to spread out. We need each region to be as full as possible.
* '''Step 3''': Join the group "Second Life Beta"
** secondlife://Aditi/app/group/19657888-576f-83e9-2580-7c3da7c0e4ca/about
** There are group join objects in each region as well
* '''Step 4''': Start chatting via group chat in the group "Second Life Beta".
* Additional instructions will be sent via god shout.
{| class="wikitable"
|-
! Test Island 1
! Test Island 2
|-
| secondlife://Oatmeal%201/128/128/30
| secondlife://GC%20Test%201/128/128/30
|-
| secondlife://Oatmeal%202/128/128/30
| secondlife://GC%20Test%202/128/128/30
|-
| secondlife://Oatmeal%203/128/128/30
| secondlife://GC%20Test%203/128/128/30
|-
| secondlife://Oatmeal%204/128/128/30
| secondlife://GC%20Test%204/128/128/30
|-
| secondlife://Oatmeal%205/128/128/30
| secondlife://GC%20Test%205/128/128/30
|-
| secondlife://Oatmeal%206/128/128/30
| secondlife://GC%20Test%206/128/128/30
|-
| secondlife://Oatmeal%207/128/128/30
| secondlife://GC%20Test%207/128/128/30
|-
| secondlife://Oatmeal%208/128/128/30
| secondlife://GC%20Test%208/128/128/30
|-
| secondlife://Oatmeal%209/128/128/30
| secondlife://GC%20Test%209/128/128/30
|-
| secondlife://Oatmeal%2010/128/128/30
| secondlife://GC%20Test%2010/128/128/30
|-
| secondlife://Oatmeal%2011/128/128/30
| secondlife://GC%20Test%2011/128/128/30
|-
| secondlife://Oatmeal%2012/128/128/30
| secondlife://GC%20Test%2012/128/128/30
|-
| secondlife://Oatmeal%2013/128/128/30
| secondlife://GC%20Test%2013/128/128/30
|-
| secondlife://Oatmeal%2014/128/128/30
| secondlife://GC%20Test%2014/128/128/30
|-
| secondlife://Oatmeal%2015/128/128/30
| secondlife://GC%20Test%2015/128/128/30
|-
| secondlife://Oatmeal%2016/128/128/30
| secondlife://GC%20Test%2016/128/128/30
|-
|
| secondlife://GC%20Test%2017/128/128/30
|-
|
| secondlife://GC%20Test%2018/128/128/30
|-
|
| secondlife://GC%20Test%2019/128/128/30
|-
|
| secondlife://GC%20Test%2020/128/128/30
|-
|
| secondlife://GC%20Test%2021/128/128/30
|-
|
| secondlife://GC%20Test%2022/128/128/30
|-
|
| secondlife://GC%20Test%2023/128/128/30
|-
|
| secondlife://GC%20Test%2024/128/128/30
|-
|
| secondlife://GC%20Test%2025/128/128/30
|-
|
| secondlife://GC%20Test%2026/128/128/30
|-
|
| secondlife://GC%20Test%2027/128/128/30
|-
|
| secondlife://GC%20Test%2028/128/128/30
|-
|
| secondlife://GC%20Test%2029/128/128/30
|-
|
| secondlife://GC%20Test%2030/128/128/30
|-
|
| secondlife://GC%20Test%2031/128/128/30
|-
|
| secondlife://GC%20Test%2032/128/128/30
|-
|
| secondlife://GC%20Test%2033/128/128/30
|-
|
| secondlife://GC%20Test%2034/128/128/30
|-
|
| secondlife://GC%20Test%2035/128/128/30
|-
|
| secondlife://GC%20Test%2036/128/128/30
|}

GroupChatTest

2011-06-02T22:51:24Z

JustOneMore Loon: /* How To Help */

LSL HTTP server

2009-11-16T17:25:08Z

JustOneMore Loon: /* Other Limitations */

{{LSL Header|ml=*}}
== Introduction ==
This is the counterpart to [[llHTTPRequest]]. While llHTTPRequest enables LSL scripts request data from HTTP-accessible sources, HTTP-in enables outside sources to request data from scripts in Second Life. The key difference is that llHTTPRequest exchanges data when the script in SL wants; HTTP-in allows outside sources to determine when they need to communicate with scripts in SL.

Prior to HTTP-in, similar functionality could be achieved by polling with [[llHTTPRequest]], [[llEmail]] and [[:Category:LSL_XML-RPC|XML-RPC]]. All three are cumbersome and the latter two have serious scalability bottlenecks.

It is important to note that LSL HTTP servers cannot use HTML. See [[#Other_Limitations|Other Limitations]] for details.

== Uses ==
* Easily get data from LSL scripts to outside viewers, scripts or servers.
** Web front end for a visitor counter or other statistics accumulator.
* Easily get data into LSL scripts from outside viewers, scripts or servers.
** A store with a web front end that communicates to an in-world object to exchange L$ and inventory items.
** Inworld game for which an external program handles the primary game logic that needs to manipulate inworld items.

Gory Technical Details follow. Or jump straight to the [[LSL_http_server/examples | Script Examples]].

== Script API ==
* '''[[LlRequestURL|key llRequestURL()]]'''
: Request a new LSL Server public URL.
: An http_request event will be triggered with success or failure and include the returned key
: NOTE: URL's are assigned to the script that called them, an http_request event will not be triggered in a script separate from the one that requested the URL.
<lsl>request_id = llRequestURL();</lsl>
* '''[[LlRequestSecureURL|key llRequestSecureURL()]]'''
: Similar to ''llRequestURL'' except requests an HTTPS / SSL URL.
: An http_request event will be triggered with success or failure and include the returned key
<lsl>request_id = llRequestSecureURL();</lsl>
* '''[[LlReleaseURL|llReleaseURL(string url)]]'''
: Clear the specific URL, used for both secure and non-secure URLs.
<lsl>llReleaseURL("http://sim3015.aditi.lindenlab.com:12046/cap/3ff4f3f2-ea08-76c1-cef6-a22b4a573a7c");</lsl>
* '''[[Http_request|http_request(key id, string method, string body)]]'''
: Event triggered when an URL is hit:
:* id is unique to this request
:* Supported methods are GET/POST/PUT/DELETE
:* body: The body of the request.
: Event also triggered with response to ''llRequestURL'' and ''llRequestSecureURL''
:* id matches the key returned by ''llRequestURL'' or ''llRequestSecureURL''
:* method == [[URL_REQUEST_GRANTED]] for success, [[URL_REQUEST_DENIED]] for failure to get an URL
:* body is the public URL. If unable to get a public URL body will be empty.
* '''[[LlHTTPResponse|llHTTPResponse(key id, integer status, string body)]]'''
: Send ''body'' to the requester with status code ''status''
:* id is the id from http_request that maps to the specific request
:* sending a response to the requestor will clear the request and delete information associated with it
* '''[[LlGetHTTPHeader|string llGetHTTPHeader(key id, string header)]]'''
: Returns the string for the specified header in the specified request. All received headers are converted to lower case and this function is case-sensitive. The returned string is limited to 255 characters.
:* Supported headers are:
::* "x-script-url": The base url, as originally received from [[llRequestURL]] or [[llRequestSecureURL]].
::* "x-path-info": Any trailing path information from the requested url
::* "x-query-string": Any query arguments, the text past a ? in the url
::* "x-remote-ip": IP address of the host that made the request
::* "user-agent": The user-agent header as reported by the requester
:* Supported headers sent by '''[[LlHTTPRequest|llHTTPRequest()]]'''
::* "x-secondlife-shard"
::* "x-secondlife-object-name"
::* "x-secondlife-object-key"
::* "x-secondlife-region"
::* "x-secondlife-local-position"
::* "x-secondlife-local-rotation"
::* "x-secondlife-local-velocity"
::* "x-secondlife-owner-name"
::* "x-secondlife-owner-key"
requested url: ''https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322/foo/bar?arg=gra''
x-script-url: ''https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322''
x-path-info: ''/foo/bar''
x-query-string: ''arg=gra''
: This header information is valid for 30 seconds, or until [[llHTTPResponse]] is called.
* '''[[Changed|changed(integer change)]]'''
:* [[CHANGED_REGION_START]]: New changed() event triggered on region startup.
* '''[[LlGetFreeURLs|integer llGetFreeURLs()]]'''
: Returns the number of URLs available to this script.

== URL Lifetime Limitations ==
* URLs are '''temporary'''!
* URLs will be lost in the following cases, all detectable by the script events listed with them.
** On object derez/rez: [[on_rez]]
** On script save/reset: ''[[default]] [[state_entry]]() (trickier in multi-state scripts)
** On region cross or TP(attachments): [[changed]]() {{LSLGC|Events|event}}, [[CHANGED_REGION]] and [[CHANGED_TELEPORT]]
** On region restart: [[changed]]() event, ''new'' flag [[CHANGED_REGION_START]]
* When urls are 'lost' it means that all public urls for that script are gone, new ones will need to be requested and the new urls will '''''not''''' resemble the old ones.
* Maintaining persistent URLs will require building or using an external service similar to how [http://en.wikipedia.org/wiki/Dynamic_DNS Dynamic DNS] services work for tying domain names to dynamic IP addresses.

Contributed HTTP-in URL mapping implementations and services:
* A Dynamic DNS service running on Google App Engine (contributed as an example) can be found in the forums here: http://forums.secondlife.com/showthread.php?t=323981
* Static URL service for HTTP-Server with API (under development),can be found [http://lsl.sltools.biz/ here]. (free by SLTools)
* The [http://wiki.apez.biz/URLMap_API Virtual ID URLMap service] provides mapping from a static subdomain of your choice via a REST API (part of the free [http://www.apez.biz Apez Corp] [http://wiki.apez.biz/Development web-services API]).
* Yet another one, running on GAE, with password protected and private domains. http://wiki.secondlife.com/wiki/Public_Object_DNS
* An advanced and extensively featured Dynamic DNS service: [http://lslurl.com LSLurl].
** Second Life Wiki article: [[Lslurl|LSLurl]]

== Resource Limitations ==
* There are a limited number of URLs available in each region, split by land ownership exactly like prim limits.
** Use [[llGetFreeURLs]] to get the exact number of available URLs for the script.
** The number of allowed URLs is the same as the number of allowed prims on the parcel the object is over.
**: ''Object owner does not matter, all objects over a parcel will use the resource pool for that parcel.''
**: ''Like prims, all the parcels owned by the same owner and in the same region share the same pool of resources.''
**: ''If you have two parcels in a region that each support 100 URLs, then you could use all 200 in object(s) on a single parcel.''
** The region's object bonus factor does not apply to available URLs.
**: ''If a parcel has a max of 300 prims in a region with a 2x bonus factor there will only be 150 urls allowed.''
* Each resident has their own unique pool of available URLs with a max of 38 URLs per resident.
** This is 1 per attachment point, but all 38 could be used by a single attachment for example.
* Vehicles are special and lazily moved to resident pools by the following logic:
** Any object that has a resident sitting on it is a 'vehicle'
** Vehicles will use the url resources from the parcel they are over until the cross a parcel border.
**: ''Specifically this prevents anyone from breaking your vending machine by sitting on it and making it a 'vehicle'.''
** When any object using URL resources with a resident sitting on it crosses a parcel boundary the resources will switch to the first sitting resident with enough resources. If no sitting agents have enough resources then the resources from the parcel being moved onto will be used. If even then there are not enough resources to use then the vehicle will be blocked from moving.
**: ''In short we do everything we can to find a pool to host the resources needed by the vehicle, but will block movement if we can't.''
* Parcel Sale: When a parcel is sold such that it changes the total available URLs in the region for either resident (seller or buyer) such that more URLs are being used than are available some objects will be returned.
** The objects returned will be from youngest object to oldest object of those using URLs in each category in order of object category: Temporary, Other, Group, Owner, Selected/Sat upon.
**: ''The '''only''' time objects are possibly returned is when parcels change owner, and only if more resources are being used than allowed.''
**: ''We return youngest temporary objects before older temporary objects before younger 'other' (owned by non-group, non-parcel-owner) objects etc.''

== Other Limitations ==
* Size of the body of the requests will be [[limit]]ed to 2k [[bytes]].
* Size of headers of requests will be limited to 255 bytes. This is per header, not total.
* The size of responses to requests is not currently limited, but this is subject to review during testing.
* The content type of the returned data is always 'text/plain; utf-8'
*: ''Allowing more content type options is a possibility for the future, but not guaranteed.''
* There is a cap of 64 in flight requests per script. This is based on the maximum number of pending events in LSL. After hitting the 64 request limit, the simulator cap server returns '503 Service Unavailable' to the inbound request.
* ''We may throttle the rate we accept hits at the CAP server level as well. This is possible, but has not yet been decided.''
* HTML cannot be used without an external parser, as all output is plain text only. If making such a parser, remember that you should probably restrict access to only Linden Lab HTML URLs as to not have your bandwith stolen.
* It is important to note that when appending a query string to a cap URL there MUST be a trailing slash between the cap guid and the query string token '?'. IE https://sim123.agni.lindenlab.com/cap/f73b4b94-012d-44f2-bd0c-16c328321221?arg=gra will return an HTTP 500, but https://sim123.agni.lindenlab.com/cap/f73b4b94-012d-44f2-bd0c-16c328321221/?arg=gra will succeed. (This doesn't seem to be true.)

== Links ==
* [[LSL_http_server/examples | Script Examples]]
* [[LSL_http_server/design | Design Document]]
* Design Jira:{{jira|SVC-1086}}

{{LSLC|HTTP}}
{{LSLC|Communications}}