View source for Q-Sims - on OSGrid

__NOTOC__ ''by AdNovea - June 2009''<br> '''[[Q-Sims - The OpenSim metavers for QNAP|Q-Sims Homepage]]''' <br> <br> __TOC__ <br> <br> 

= HowTo: quickly deploy your Sims using a Free Public Grid  =

This page provides the instructions to implement a basic metavers with a minimum administration using Public grid ( ''we assume using the '''OSGrid.org''' in the sequel'' ). <br> For details, please refer to the other wiki pages of the Q-Sims tutorial, the troubleshooting section and the Public grids' forum.<br> 
<blockquote>
== Foreword  ==
<blockquote>Despite we recommend the OSGrid.org or ScienceSim.com grids*, you can choose any public/private grid. There are several public grids available. The registration process shall be&nbsp; pretty much the same for all.<br> A list of the major Public grids available today is available at [http://opensimulator.org/wiki/Grid_List OpenSimulator.org]<br> <small>''* Neither AdNovea nor QNAP have links with osgrid.org or sciencesim.com other than regular registered members.''</small> 
=== About OSGrid.org  ===

'''[http://www.osgrid.org OSgrid]''', the largest running OpenSimulator grid, is officially a <u>Californian Nonprofit Public Benefit Corporation</u>. It is '''completely free''' to <u>connect your own regions</u> to the grid. OSGrid has grown from 4-sims and a thin user auth service (''Feb '07'') to a vibrant community of over 13,000 developers, landowners,and residents in nearly 2,450 independently operated regions. OSGrid officially turned 2 on july 23rd 2009 and the grid claimed 23,000 registered accounts, about 4,000 unique logins within the&nbsp;[http://www.valleypistachio.com/ buy pistachios ]latest 30 Days and every days about 50 In-world residents.<br> ''<br>Download [http://www.osgrid.org/elgg/pg/utilities/software OpenSim] simulator configured for OSGrid.org''<br> 

=== About ScienceSim.com  ===

'''[http://www.sciencesim.com ScienceSim]''' is a team of researchers and technology strategists, <u>funded by Intel’s server business</u> and working with OpenSim open source technology, had a goal of creating an environment for experimentation in virtual worlds. We wanted a '''turnkey kit''' that companies or researchers could download and develop specific applications in virtual worlds, data visualization and analysis. ScienceSim hosts 66 regions (''aug 09'') as of today and 25 plazas (''5x5 regions'') already reserved.<br> ''<br>Download [http://island.sciencesim.com/repository/ OpenSim] simulator configured for ScienceSim.com''<br> <br> 

{|
|- valign="middle" style="background-color: rgb(244, 244, 255); font: 8pt Arial;"
| [[Image:Information.png]] &nbsp; 
| Thanks to the '''[[#Teleportation_between_Public_Grids|Hypergrid]] teleportation''' capability provided by the here above Public grids, you do not need to register to different Public grids. You will be able with your account and avatar to teleport to the other supported Public grids. This is a functionality made possible by the metaverses running on the OpenSim simulator.
|}

<br> &lt;/blockquote&gt; 

== What do you need?  ==
<blockquote>Redirect the ports on your router: <blockquote>
{|
|- bgcolor="#aaaaaa"
! width="100" | '''Ports''' 
! '''Services'''<br>
|- bgcolor="#eeeeee"
| &nbsp; '''9005'''<br> &nbsp; 
| OpenSim listener port (''used for remote administration'')<br> 
''For a different port, read the topic about [[Q-Sims - Troubleshooting#Issues_with_TwonkyMedia|changing the port]]''. 

|- bgcolor="#eeeeee"
| &nbsp; '''20800''' <br> 
| Remote Grids data access<br>''required to used the QS-Manager remote admin console''
|- bgcolor="#eeeeee"
| &nbsp; '''5060''' 
| FreeSwitch Voice chat port<br>''only if you intend to use the voice chat and have installed FreeSwitch QPKG''
|}
</blockquote> 
Download the following files: 
<blockquote>
*'''Optware''' QPKG - [http://forum.qnap.com/viewforum.php?f=124 Download] and install from the QNAP Admin pages 
*'''Mono''' QPKG - Download and install from the QNAP Admin pages 
*'''Q-Sim LITE Edition''' ''- Download and install from the QNAP Admin pages'' 
*'''OpenSim binary''' - Download form [http://www.osgrid.org/elgg/pg/utilities/software osgrid.org] or let the Installer do it 
*'''FreeSwitch''' QPKG - Download and install from the QNAP Admin pages 
*'''optional - required [[Q-Sims - Add Voice Chat#Voice_Chat_manual_installation|manual installation]] if you want to enable the Voice chat capability''
</blockquote> 
<small>'''''NOTE''': MySQL shall be enabled on your NAS server if you intend to use the Q-Sims FULL Edition (required by QS-Manager)''</small> <br> 
</blockquote> 
<br> 

== Register on OSGrid.org Free Public Grid  ==

#Goto [http://osgrid.org http://osgrid.org] and fill-in the registration form. 
#Find a Free '''location''' for your Sims and note the XY position: Browse the grid '''Map''' to locate a free location.<br> <br> [[Image:Q-Sim map osgrid.jpg|thumb|center|500px]]

{|
|- valign="middle" style="background-color: rgb(255, 248, 248); font: 8pt Arial;"
| [[Image:Critical.png]] &nbsp; 
| <span style="color: red;">'''IMPORTANT''': Your location will become available for anyone who wishes to take it if your Sims server is down more than 24 hours in a row or stopped properly.</span>
|}

<br> <br> 

== Installation with Q-Sims LITE Edition  ==

*Install and Enable '''Optware''' 
*Install and Enable '''Mono''' 
*Install and Enable '''FreeSwitch''' (''optional'')

<br> 

#Once the '''Q-Sims QPKG''' is installed, <span style="color: red;">'''DO NOT ENABLE'''</span>. Click the '''Web Page''' link and log in using your Admin account.<br> <br> [[Image:Q-Sims Lite-install-01.jpg|thumb|center|500px|Q-Sims Lite-install-01.jpg]] <br> 
#Select your level of expertise: 
#*'''standard user''': Only public grids which offer preconfigured OpenSim binary packages are listed during the QSA (''Quick Start Assistant'') process. You will have either a fully automatic retrieval of the binary or to copy/paste the binary archive URL. 
#*'''Linux expert''': Public grids which require to compile and configure manually the OpenSim simulator will be also available during the QSA.<br> <br>

[[Image:Q-Sims Lite-install-02.jpg|thumb|center|500px|Q-Sims Lite-install-02.jpg]] <br> 

#
#*For public grids which offer binary packages, you will click on the '''See archive list''' button to get to the download page. Right click on the archive and copy the URL. Paste the URL into the textbox and press the '''Apply''' button.<br> 
#*For public grids which do not make available binary packages, you will have to compile and [http://www.bankerslifeinsurance.com/ bankers life] configure the OpenSim simulator yourself. Source code is available on the [http://opensimulator.org/wiki/Download OpenSim simulator web site]. Then create an archive that content the /bin folder. Browse to this archive and press the '''Apply''' button.<br> <br> [[Image:Q-Sims Lite-install-03.jpg|thumb|center|500px|Q-Sims Lite-install-03.jpg]] <br> 
#Download and decompression take a couple of minutes.<br> You can use<span class="plainlinks">&nbsp;the two buttons below to: 
</span>

#*'''Register''' an account

#*'''Find a free location''' for your Sims

 [[Image:Q-Sims Lite-install-04.jpg|thumb|center|500px|Q-Sims Lite-install-04.jpg]] 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

#Once the OpenSim binary is installed, there is a new entry on this QSA screen. The '''Keep current version''' is selected. You shall now press the '''Continue''' button. 
#*''lately, the QSA could be used to upgrade the OpenSim simulator and reconfigure Q-Sims. This explain these two options.'' <br> [[Image:Q-Sims Lite-install-05.jpg|thumb|center|500px|Q-Sims Lite-install-05.jpg]] <br> 
#Fill in your '''account''' and '''location''' parameters. You shall enter your DNS or external IP and make sure your ISP if not filtering the port 9005. The port can be changed here (''you must be familiar with ports to do so'').<br> <br> [[Image:Q-Sims Lite-install-06.jpg|thumb|center|500px|Q-Sims Lite-install-06.jpg]] <br> 
#You may enable or not the Voice Chat (''FreeSwicth QPKG must be installed''). The default account ''freeswitch/password'' is used. Select or not the Voice chat then press the '''Apply''' and '''Continue''' buttons.<br> <br> [[Image:Q-Sims Lite-install-07.jpg|thumb|center|500px|Q-Sims Lite-install-07.jpg]] <br> 
#Once the QSA reaches the end, you may '''Enable the Q-Sims QPKG''' and press the '''Continue''' button.<br> <br> [[Image:Q-Sims Lite-install-08.jpg|thumb|center|500px|Q-Sims Lite-install-08.jpg]] <br> 
#The '''QSM Lite manager''' homepage displays the OpenSim <span class="plainlinks">server <span class="plainlinks">status.
 They are some menu items to help to manage Q-Sims LITE Edition: 

#*'''Installation''': can be reused to reconfigure Q-Sism (''e.g. enable/disable the Voice Chat'') 

#*'''Regions''': create additional regions - but <u>cannot delete those regions</u>. Please carefully check the capabilities of your NAS BEFORE adding regions. Regions have unique identifier (UUID) you shall not


</span></span>



<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

<br> 

modify, erase or loose. If UUID is incorrect you cannot reach your regions anymore. 

#*'''Admin console''': is still under implementation (''all entries are not working''). You can gracefully stop your simulator or send messages (''pop-ups'') to all visitors. 
#*'''Log files''': can be read out for the OpenSim simulator, the debugger and the watchdog. 
#*'''Help''': is a link to the Q-Sims QNAP Wiki pages 
#*'''About''': gives a short description of the applications involved into Q-Sims. <br> [[Image:Q-Sims Lite-install-09.jpg|thumb|center|500px|Q-Sims Lite-install-09.jpg]] <br>&lt;/span&gt;

== Installation with Q-Sims FULL Edition (''optional'')  ==

''Read more about [[Q-Sims - Installation|Q-Sims FULL Edition installation]]'' and <br> 

#Enable Optware QPKG 
#Enable Mono QPKG 
#Enable Q-Sims 
#Click on the Q-Sims QPKG page administration link to start QS-Manager and run the QSA (''Quick Start Assistant'') 
#*'''Page 1'''&nbsp;: Forward the ports 
#*'''Page 2'''&nbsp;: Select Standalone mode 
#*'''Page 3'''&nbsp;: External Host Name, domain name or IP: '''osgrid.org''', XY Coordinate (default 1000,1000): is your selected XY position on the osgrid 
#*'''Page 4'''&nbsp;: Select a SQlite database 
#Start Q-Sims (''then wait a minute'') 
#Start FreeSwitch OPKG if required

<br> 

<br> 

== Other information  ==
<blockquote>
*Your Q-Sims '''SQLite database''' will be nightly backuped <u>BUT</u> your assets and inventory remains on the osgrid.org servers.<br>You may also <span style="color: darkgreen;">run a '''save oar''' command</span> from your [[Q-Sims - OpenSim Console#The_OpenSim_Console|OpenSim console]] to backup your terrain and assets. Your <u>avatar and inventory cannot be backuped</u> unless on the osgrid server which is not under your control! 
*To [[Q-Sims - Upgrading#OpenSim_manual_upgrade|upgrade]] to a newer OpenSim version from OSGrid, download the archive from [http://www.osgrid.org/elgg/pg/utilities/software orgrig.org] and overwrite the bin folder content (''as of july 09, osgrid default assumes you are using a SQLite database'') or run the Q-Sims LITE Edition Installation to upgrade and reconfigure. &lt;/blockquote&gt; <br> &lt;/blockquote&gt;

= Access your Sims  =
<blockquote>
*Download and launch the Hippo Viewer (''see the Hippo vierwer configuration [[Q-Sims - Viewers setup#Setup|page]]'') 
*Click on the '''Grid''' button and then on the '''Grid''' tab 
*Select '''osgrid''' in the drop list <u>OR</u> click '''Add''' and type the '''Login URI''' for your Public metavers 
*Press '''Get Grid Info''', press '''Default''' and '''Ok''' 
*In the '''Region list''' on the bottom left, seek for your Sims name using either the names or your registered XY position and press '''Connect'''.<br><br>

{| width="100%"
|-
| [[Image:Q-Sims osgrid integration.jpg|thumb|center|300px]] 
| [[Image:Q-Sims sciencesim integration.jpg|thumb|center|300px]]
|}

&lt;/blockquote&gt; 

= Teleportation between Public Grids  =
<blockquote>The OpenSim simulator is now widely used for metaverses implementation. Thanks to the '''Hypergrid''' function, teleportation with the same avatar between grids running OpenSim simulators is made possible. For example, as a registered member on OSGrig.org but not on ScienceSim.com you will be entitled to navigate the latter metavers thanks to a '''hypergrid teleportation''' to ScienceSim. This might be handled or not by the Public grid you are registered to.<br> <br> List of OpenSim [http://opensimulator.org/wiki/Public_Hypergrid_Nodes Hypergrid-enabled] metaverses<br> <br> '''NOTE''': Public grids may run on different versions of the OpenSim simulator that may prevent correct teleportation.<br> <br> [[Image:Q-Sims Hypergrid teleportation.jpg|thumb|center|500px]] </blockquote> 
<br> 

= Troubleshooting  =
<blockquote>Shall you have '''problems''', check the '''bin/OpenSim.ini''' file to find out the issue. 
*'''No more Voice Chat''' Maybe the FreeSwitch configuration has been overwritten into OpenSims.ini 
*'''Cannot run''' Maybe you have port conflicts. ''Read more about&nbsp;''
[[Q-Sims - Troubleshooting#Issues_with_OSGrid.org|changing the port]]''. '' 
*'''Crashed&nbsp;!''' Check if you have made a "chmod -R 777 bin" after overwriting the bin folder with the new release archive content? 
*'''Cannot connect to OSGRid''' Create an account, check for a free location, download the OpenSim version required. Check the OpenSim.ini file section below:
<blockquote><pre>[Network]
http_listener_port = 9005
http_listener_ssl = false 
http_listener_cn = "localhost"
http_listener_sslport = 9001
http_listener_ssl_cert = "" 
grid_server_url = "http://osgrid.org:8001"
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"
messaging_server_url = "http://osgrid.org:8006"
</pre></blockquote> 
*'''Cannot connect to ScienceSim''' Create an account, check for a free location, download the OpenSim version required. Check the OpenSim.ini file section below:
<blockquote><pre>[Network]
http_listener_port = 9005
remoting_listener_port = 8895
http_listener_ssl = false 
http_listener_cn = "localhost"
http_listener_sslport = 9001
http_listener_ssl_cert = "" 
remoteDataPort = 20800
grid_server_url = "http://island.sciencesim.com:8001"
grid_send_key = "agMMtrwx1B22974kK"
grid_recv_key = "agMMtrwx1B22974kK"
user_server_url = "http://island.sciencesim.com:8002"
user_send_key = "agMMtrwx1B22974kK"
user_recv_key = "agMMtrwx1B22974kK"
asset_server_url = "http://island.sciencesim.com:8003"
inventory_server_url = "http://island.sciencesim.com:8004"
message_server_url = "http://island.sciencesim.com:8006"
</pre></blockquote> &lt;/blockquote&gt; 
<br> <br> &lt;/blockquote&gt; &lt;/blockquote&gt; 
</blockquote></blockquote></blockquote> </blockquote> </blockquote> 

[[Category:Q-Sims]]