Q-Sims - Troubleshooting: Difference between revisions

From QNAPedia
Jump to navigation Jump to search
m (1 revision imported)
 
No edit summary
Line 1: Line 1:
''by AdNovea - May 2009''<br>
''by AdNovea - May 2009''<br/>'''[[Q-Sims_-_The_OpenSim_metavers_for_QNAP|Q-Sims Homepage]]'''<br/><br/>__TOC__
'''[[Q-Sims - The OpenSim metavers for QNAP|Q-Sims Homepage]]''' <br> <br>
 
__TOC__
== Error during (re)installation with the Q-Sims FULL Edition ==
<br>
== Error during (re)installation with the Q-Sims FULL Edition==
<blockquote>
* If you have entered wrong data or crash during the QSA you may end with a <u>blank page</u>. Go into the '''QSims/web/qsmanager/settings''' folder and delete the '''config.php''' file. The installation (QSA) will restart with the default values.
* During the QSA process, be careful to re-enter the correct passwords. If you made a mistake, you will end with the message below. Have a look at the QSims/web/qsmanager/settings/config.php file to check your entries. You can directly made the correct in this file if any.
<blockquote>
<blockquote>
<pre>
*If you have entered wrong data or crash during the QSA you may end with a <u>blank page</u>. Go into the '''QSims/web/qsmanager/settings''' folder and delete the '''config.php''' file. The installation (QSA) will restart with the default values.
Database error: Link_ID == false, connect failed
*During the QSA process, be careful to re-enter the correct passwords. If you made a mistake, you will end with the message below. Have a look at the QSims/web/qsmanager/settings/config.php file to check your entries. You can directly made the correct in this file if any.
<blockquote><pre>Database error: Link_ID == false, connect failed
MySQL error: 0 ()
MySQL error: 0 ()
Session halted.
Session halted.
</pre>
</pre>
</blockquote>
</blockquote></blockquote>
</blockquote>
 
<br>


== Cannot reach a Grid ==
== Cannot reach a Grid ==
<blockquote>
<blockquote>You try to access a grid but it does not respond (eg. in Hippo clicking "Get Grids Info" returns ''Cannot retrieve grid info from server'').
You try to access a grid but it does not respond (eg. in Hippo clicking "Get Grids Info" returns ''Cannot retrieve grid info from server'').  
*Check if '''Mono is running''' (''in a SSH console type: mono -V'')
* Check if '''Mono is running''' ('' in a SSH console type: mono -V'')
*Check if all servers are running - On QS-Manager, click Administration in the menu to display the server status
* Check if all servers are running - On QS-Manager, click Administration in the menu to display the server status
*A server may be down, start again Q-Sims to fix this problem.
* A server may be down, start again Q-Sims to fix this problem.
*One or more servers may be zombie. Stop Q-Sims to fix this problem.
* One or more servers may be zombie. Stop Q-Sims to fix this problem.
*You have not forwarded the correct ports (''see Installation'')
* You have not forwarded the correct ports (''see Installation'')
*Check if the server(s) is(are) running: '''Type http&nbsp;://&lt;your_ip&gt;:server_port/simstatus/''' where server_port=9000 in Standalone mode and in Grid mode (''9000, 8001, 8002, 8003, 8004, 8006 and 9001-x according to the number of regions''). if the server is running you will get a "OK" displayed or an Error 404 with the following page:
* Check if the server(s) is(are) running: '''Type http ://<your_ip>:server_port/simstatus/''' where server_port=9000 in Standalone mode and in Grid mode (''9000, 8001, 8002, 8003, 8004, 8006 and 9001-x according to the number of regions''). if the server is running you will get a "OK" displayed or an Error 404 with the following page:
<blockquote><div style="background-color: lightgrey; padding: 5px">
<blockquote>
<small>Ooops!<br/><br/>The page you requested has been obsconded with by knomes. Find hippos quick!<br/><br/>If you are trying to log-in, your link parameters should have: "-loginpage http&nbsp;:///?method=login -loginuri http&nbsp;:///" in your link</small>
<div style="background-color: lightgrey; padding: 5px"><small>
</div></blockquote></blockquote>
Ooops!<br>
 
<br>
The page you requested has been obsconded with by knomes. Find hippos quick!<br>
<br>
If you are trying to log-in, your link parameters should have: "-loginpage http :///?method=login -loginuri http :///" in your link
</small></div>
</blockquote>
</blockquote>
<br>


== Cannot login with the Viewer ==
== Cannot login with the Viewer ==
<blockquote>
<blockquote>When you click on the Viewer connect button you get a message telling that you cannot be login.
When you click on the Viewer connect button you get a message telling that you cannot be login.
*Have you completed the installation process? With Q-Sims FULL Edition, the QS-Manager Home page shall be displayed - Do not forget to press the "Home" button
*Check the grid can be reached (''see above'')
*One database is not completely set up (''eg. the Inventory DB for your avatar''). Stop and Restart Q-Sims to complete the DB initialization.
[[File:Q-Sims Avatar Error.jpg|thumb|center|500px|Problem during first access with incomplete database]]
*You may try to log to a region which is no longer available or the previous location is no longer available
[[File:Q-Sims fail 01.jpg|thumb|center|500px|Q-Sims selected region is not available]]
*Clear you '''Viewer cache''' (''Preferences/Web/Clear Now'')
*'''Retry''' (''<span style="color:darkred">I have to do it sometimes 5-10 times in a raw while the server is clearing the previous aborted session and the viewer cache reloading!</span>'') You may have not been correctly reported as logging out the last time and OpenSim believes your are still logged.
[[File:Q-Sims fail 02.jpg|thumb|center|500px|Logging after a incomplete logout]]
*Delete the Opensim '''cache''' directory (/share/xxx_DATA/.qpkg/QSims(_lite)/bin/add-db-xxx)
*The account you are using is '''not confirmed'''. With the Q-Sims FULL Edition, in the QS-Manager admin page, under User management, check the status of the account you want to use.
*Your Login URI is incorrect. You must use port '''9000''' (''or the one set during installation if different from 9000'') to access in Standalone and '''8002''' in grid mode. The login page shown in Hippo tells you the correct URI. In QS-Manager, check the Status box in the top right corner for the correct Login URI.
*You may also select from the region box the region to access otherwise the Viewer will try to teleport you to you last position.
*You have to retry, the Hippo viewer is sometimes reporting you as already logged. This is a cache/timeout issue.
*Your MySQL database may be corrupted or incompatible (''this can be the case after an upgrade'')


* Have you completed the installation process? With Q-Sims FULL Edition, the QS-Manager Home page shall be displayed - Do not forget to press the "Home" button
*If a message says "Regions is not found" and you are sure to have it, keep in mind the time needed for the simulator after a restart to reload all the regions and objects.
* Check the grid can be reached (''see above'')
* One database is not completely set up (''eg. the Inventory DB for your avatar''). Stop and Restart Q-Sims to complete the DB initialization.
[[Image:Q-Sims_Avatar_Error.jpg|thumb|center|500px|Problem during first access with incomplete database]]
* You may try to log to a region which is no longer available or the previous location is no longer available
[[Image:Q-Sims fail 01.jpg|thumb|center|500px|Q-Sims selected region is not available]]
* Clear you '''Viewer cache''' (''Preferences/Web/Clear Now'')
* '''Retry''' (''<span style="color:darkred">I have to do it sometimes 5-10 times in a raw while the server is clearing the previous aborted session and the viewer cache reloading!</span>'') You may have not been correctly reported as logging out the last time and OpenSim believes your are still logged.
[[Image:Q-Sims fail 02.jpg|thumb|center|500px|Logging after a incomplete logout]]
* Delete the Opensim '''cache''' directory (/share/xxx_DATA/.qpkg/QSims(_lite)/bin/add-db-xxx)
* The account you are using is '''not confirmed'''. With the Q-Sims FULL Edition, in the QS-Manager admin page, under User management, check the status of the account you want to use.
* Your Login URI is incorrect. You must use port '''9000''' (''or the one set during installation if different from 9000'') to access in Standalone and '''8002''' in grid mode. The login page shown in Hippo tells you the correct URI. In QS-Manager, check the Status box in the top right corner for the correct Login URI.
* You may also select from the region box the region to access otherwise the Viewer will try to teleport you to you last position.
* You have to retry, the Hippo viewer is sometimes reporting you as already logged. This is a cache/timeout issue.
* Your MySQL database may be corrupted or incompatible (''this can be the case after an upgrade'')
<br>
* If a message says "Regions is not found" and you are sure to have it, keep in mind the time needed for the simulator after a restart to reload all the regions and objects.
</blockquote>
</blockquote>
<br>
 


== Scene rendering issues ==
== Scene rendering issues ==
<blockquote>
<blockquote>You may have some issues while navigating the metavers. For example:
You may have some issues while navigating the metavers. For example:
*Prims are not correctly displayed (''but it take time to load all textures'')
* Prims are not correctly displayed (''but it take time to load all textures'')
*Prims construction is slow on a powerful machine
* Prims construction is slow on a powerful machine
*Prims with light are not visible at night (''light is visible when your avatar is closed or during prim edition'')
* Prims with light are not visible at night (''light is visible when your avatar is closed or during prim edition'')
'''=> IT IS MANDATORY TO <u>UPDATE YOUR GRAPHIC CARD DRIVER</u> TO THE LATEST VERSION.'''</blockquote>


'''=> IT IS MANDATORY TO <u>UPDATE YOUR GRAPHIC CARD DRIVER</u> TO THE LATEST VERSION.'''
</blockquote>
<br>
== It was working and now crashes - I'm tired of this application!  ==
<blockquote>
'''MY RECOMMENDATION''': Leave it as it is for today, just relax and come back tomorrow.<br>
''I know what you feel and I always found the solution to make it work.''<br>
The development is still in alpha status and there is still some limitations.<br><br>


{|width="100%"
== It was working and now crashes - I'm tired of this application! ==
<blockquote>'''MY RECOMMENDATION''': Leave it as it is for today, just relax and come back tomorrow.<br/>''I know what you feel and I always found the solution to make it work.''<br/>The development is still in alpha status and there is still some limitations.<br/><br/>
{| width="100%"
|- style="background-color: #F4F4FF; font: normal 8pt Arial;" valign="middle"
|- style="background-color: #F4F4FF; font: normal 8pt Arial;" valign="middle"
!width="50"|[[Image:Information.png]]
! width="50" | [[File:Information.png|RTENOTITLE]]
|<span style="color: blue">'''Important Note''': OpenSim uses a queuing system and '''YOU MUST KEEP THIS IN MIND'''. Requests are sent to the OpenSim simulator by the viewer for example and processed <u>asynchronously in a FIFO order</u> (''first in-first out''). A high amount of requests can crash the simulator. This is the reason why you have to be patient and wait for the requests to be processed.</span>
| <span style="color: blue">'''Important Note''': OpenSim uses a queuing system and '''YOU MUST KEEP THIS IN MIND'''. Requests are sent to the OpenSim simulator by the viewer for example and processed <u>asynchronously in a FIFO order</u> (''first in-first out''). A high amount of requests can crash the simulator. This is the reason why you have to be patient and wait for the requests to be processed.</span>
|}
|}
<br>
 
'''I have notice crashes:'''
<br/>'''I have notice crashes:'''
* when '''upgrading to a newer version''' of OpenSim and not waiting for the OpenSim.exe to have processed all queue requests before lauching the viewer. The initialization can takes several minutes (''10-15 according to your Sims complexity''). The first time, you better start OpenSim.exe in a [[Q-Sims_-_OpenSim_Console|console]] to monitor the progresses and launch the Viewer when the queuing is completed (''all scripts loaded and asset's storing finished'').
 
* with Sims with lot of prims and/or regions (''eg 5 regions on a TS-639''). Starting a fresh installation of a viewer (''eg. a new visitor join the Sims on a new client machine or you have reinstalled your viewer'') needs to fill in the cache and send a large amount of requests due to the number of regions and objects in the regions.<br>
*when '''upgrading to a newer version''' of OpenSim and not waiting for the OpenSim.exe to have processed all queue requests before lauching the viewer. The initialization can takes several minutes (''10-15 according to your Sims complexity''). The first time, you better start OpenSim.exe in a [[Q-Sims_-_OpenSim_Console|console]] to monitor the progresses and launch the Viewer when the queuing is completed (''all scripts loaded and asset's storing finished'').
You may have to restart several times the viewer <u>and</u> the simulator (''I went up to 15 restarts'') while the cache is filling in.
*with Sims with lot of prims and/or regions (''eg 5 regions on a TS-639''). Starting a fresh installation of a viewer (''eg. a new visitor join the Sims on a new client machine or you have reinstalled your viewer'') needs to fill in the cache and send a large amount of requests due to the number of regions and objects in the regions.
<br>
 
<br>
You may have to restart several times the viewer <u>and</u> the simulator (''I went up to 15 restarts'') while the cache is filling in.<br/><br/>To avoid crashes, you better:
To avoid crashes, you better:
 
* upgrade to newer version ONLY if required (''new mandatory feature or major bug fixes'')
*upgrade to newer version ONLY if required (''new mandatory feature or major bug fixes'')
* Limit the number of regions (''or get a more powerful server''). Read the '''Client Side''' section of '''Requirements''' on the [[Q-Sims_-_The_OpenSim_metavers_for_QNAP|Home]] page.
*Limit the number of regions (''or get a more powerful server''). Read the '''Client Side''' section of '''Requirements''' on the [[Q-Sims_-_The_OpenSim_metavers_for_QNAP|Home]] page.
* '''Do not expect too much''' despite the very good level of maturity of the OpenSim simulator.
*'''Do not expect too much''' despite the very good level of maturity of the OpenSim simulator.
* Limit the number of prims (''try to use as much as possible the prims parameters to build complex forms rather than linking several prims'')
*Limit the number of prims (''try to use as much as possible the prims parameters to build complex forms rather than linking several prims'')
* '''WAIT, WAIT, WAIT, WAIT ... and be patient''' - This may be the most difficult part of your Sims development. This is due to the asynchronous queuing implementation.  
*'''WAIT, WAIT, WAIT, WAIT ... and be patient''' - This may be the most difficult part of your Sims development. This is due to the asynchronous queuing implementation.
</blockquote>
</blockquote>
<br>
 


== Video issues ==
== Video issues ==
<blockquote>
<blockquote>After restoring the MySQL database, you may lost the video feature. The texture of your video prim for what reason is no longer the correct one (''for example has been set to '''Blank Texture''' instead of '''Default Media Texture''''').
After restoring the MySQL database, you may lost the video feature. The texture of your video prim for what reason is no longer the correct one (''for example has been set to '''Blank Texture''' instead of '''Default Media Texture''''').<br>
*Right click the screen and select '''Edit...''', on the '''Object tab''' check if the object is not locked, on the '''Texture tab''' click the texture thumb and select '''Default Media Texture''', click the '''Color tab''' and set to white color, check '''Full bright'''.
* Right click the screen and select '''Edit...''', on the '''Object tab''' check if the object is not locked, on the '''Texture tab''' click the texture thumb and select '''Default Media Texture''', click the '''Color tab''' and set to white color, check '''Full bright'''.<br>
*Read also the [[Q-Sims_-_Add_Music_and_Movies|Audio & Video]] section to check the parameters.
* Read also the [[Q-Sims_-_Add_Music_and_Movies| Audio & Video]] section to check the parameters.
</blockquote>
</blockquote>
<br>
 


== Voice chat issues ==
== Voice chat issues ==
<blockquote>If you encounter some issues with the Voice Chat, please check:
*The '''port 5060''' is correctly forwarded.
*You shall enable the Voice in your '''Viewers Preferences''' (''on each client machine'')
*You must have enabled the '''Voice in each parcel'''.
*'''Adjust the sound card parameters for microphone''' as well as the relative sound level on the Viewer (''there are several cursors to adjust the different levels in the Viewer'')
*if you have <u>re-install FreeSwitch or made a first Q-Sims installation without FreeSwitch and then added FreeSwitch</u>, you miss the FreeSwitch modifications required for Q-Sims.
<blockquote>
<blockquote>
If you encounter some issues with the Voice Chat, please check:
*Stop both Q-Sims and FreeSwitch QPKG.
* The '''port 5060''' is correctly forwarded.
*Goto the Web Interface (''Click the link on the Q-Sims QPKG'') and re-run the Q-Sims QSA (''Installation'') keeping the default values (''previous settings''). Press Apply to re-enter all the values. The FreeSwitch modification will be applied again.
* You shall enable the Voice in your '''Viewers Preferences''' (''on each client machine'')
*Restart the FreeSwitch and Q-Sims QPKG; wait for the servers to be up and running.
* You must have enabled the '''Voice in each parcel'''.
*or [[Q-Sims_-_Add_Voice_Chat#Voice_Chat_manual_installation|manually configure FreeSwitch]]
* '''Adjust the sound card parameters for microphone''' as well as the relative sound level on the Viewer (''there are several cursors to adjust the different levels in the Viewer'')
* if you have <u>re-install FreeSwitch or made a first Q-Sims installation without FreeSwitch and then added FreeSwitch</u>, you miss the FreeSwitch modifications required for Q-Sims.
<blockquote>
* Stop both Q-Sims and FreeSwitch QPKG.  
* Goto the Web Interface (''Click the link on the Q-Sims QPKG'') and re-run the Q-Sims QSA (''Installation'') keeping the default values (''previous settings''). Press Apply to re-enter all the values. The FreeSwitch modification will be applied again.  
* Restart the FreeSwitch and Q-Sims QPKG; wait for the servers to be up and running.
* or [[Q-Sims_-_Add_Voice_Chat#Voice_Chat_manual_installation |manually configure FreeSwitch]]
</blockquote>
</blockquote>
* You must use the default FreeSwitch password (''password'') or you must modify the freeswitch configuration files accordingly.
*You must use the default FreeSwitch password (''password'') or you must modify the freeswitch configuration files accordingly.
* <u>DON'T RUSH</u> each server needs time to get up and running. During debug you better have two different consoles to monitor the progression of each service and choose the Standalone mode. Go into the Q-Sims root directory, type '''cd bin''', type '''mono OpenSim.exe'''. In the second console type '''./freeswitch.sh start''' once Q-Sims is ready.
*<u>DON'T RUSH</u> each server needs time to get up and running. During debug you better have two different consoles to monitor the progression of each service and choose the Standalone mode. Go into the Q-Sims root directory, type '''cd bin''', type '''mono OpenSim.exe'''. In the second console type '''./freeswitch.sh start''' once Q-Sims is ready.
* '''Stop all applications using port 5060''' other than FreeSwitch such as Asterisk (''I have been trapped by Asterisk running on port 5060 even it was disabled on the QNAP page but was started despite the disabling after a reboot'')
*'''Stop all applications using port 5060''' other than FreeSwitch such as Asterisk (''I have been trapped by Asterisk running on port 5060 even it was disabled on the QNAP page but was started despite the disabling after a reboot'')
</blockquote>
</blockquote>
<br>


== User registration issues (''Q-Sims FULL Edition'')==
 
<blockquote>
== User registration issues (''Q-Sims FULL Edition'') ==
If the user cannot send mail during registration:
<blockquote>If the user cannot send mail during registration:
* Check the '''php.ini''' and update with your ISP mail parameters (''below are the default values in the initial php.ini'')
*Check the '''php.ini''' and update with your ISP mail parameters (''below are the default values in the initial php.ini'')
<pre>
<pre> [mail function]
  [mail function]
   SMTP = localhost
   SMTP = localhost
   smtp_port = 25
   smtp_port = 25
   sendmail_path = /usr/sbin/sendmail -t -i
   sendmail_path = /usr/sbin/sendmail -t -i
</pre>
</pre>
* or overwrite the php.ini default value by adding these lines with your ISP mail parameters at the top of the '''/share/xxx_DATA/.qpkg/QSims/web/qsmanager/settings/config.php''' file:
 
<pre>
*or overwrite the php.ini default value by adding these lines with your ISP mail parameters at the top of the '''/share/xxx_DATA/.qpkg/QSims/web/qsmanager/settings/config.php''' file:
  ini_set("SMTP","smtp.your_isp.com" );
<pre> ini_set("SMTP","smtp.your_isp.com" );
   ini_set("smtp_port ",25);
   ini_set("smtp_port ",25);
   ini_set('sendmail_from', 'user@your_isp.com');  
   ini_set('sendmail_from', 'user@your_isp.com');  
</pre>
</pre>
* Reboot your Apache server with new parameters
 
<pre>
*Reboot your Apache server with new parameters
# /etc/init.d/Qthttpd.sh restart
<pre># /etc/init.d/Qthttpd.sh restart
</pre>
</pre>
NOTE: PHP MAIL function looks a little bit erratic. I set some settings which did not worked but all of a sudden were working - no clear answer on the web regarding the topic "''Cannot send mail outside domain''" neither. So good luck.
NOTE: PHP MAIL function looks a little bit erratic. I set some settings which did not worked but all of a sudden were working - no clear answer on the web regarding the topic "''Cannot send mail outside domain''" neither. So good luck.
</blockquote>
</blockquote>
<br>
 


== Debugging your region/parcel ==
== Debugging your region/parcel ==
<blockquote>
<blockquote>
* Cannot set the parcel property
*Cannot set the parcel property
<blockquote>
<blockquote>
* you are not the '''parcel owner''', connect with the owner account
*you are not the '''parcel owner''', connect with the owner account
* you have issues with the UUIDs. Check the regions UUID in the bin/Regions directory the '''zzzzz.xml''' or '''zzzzz.ini''' files that correspond to the regions with troubles and the UUID of the owner. Analyze and correct the issue accordingly.
*you have issues with the UUIDs. Check the regions UUID in the bin/Regions directory the '''zzzzz.xml''' or '''zzzzz.ini''' files that correspond to the regions with troubles and the UUID of the owner. Analyze and correct the issue accordingly.
</blockquote>
</blockquote>
<br>
 
* After some building, you may encounter some troubles with scripts and/or objects. Fortunately, there is some tools for debugging.<br>
 
Click in the menu bar '''World''' and '''Region/Estate...'''. Select the Debug tab and you can have some information and actions for debugging.
*After some building, you may encounter some troubles with scripts and/or objects. Fortunately, there is some tools for debugging.
<br>
 
[[Image:Q-Sims_Region_Debug_1.jpg|thumb|center|500px|Region/Estate debugging screen]]
Click in the menu bar '''World''' and '''Region/Estate...'''. Select the Debug tab and you can have some information and actions for debugging.<br/>[[File:Q-Sims Region Debug 1.jpg|thumb|center|500px|Region/Estate debugging screen]] Select '''Get To Colliders...''' or '''Get Top Scripts...'''to display the list of objects/scripts involved. Selecting one object from the list will display the ''beacon'' (''red arrow'') to help to locate the selected object.
Select '''Get To Colliders...''' or '''Get Top Scripts...'''to display the list of objects/scripts involved. Selecting one object from the list will display the ''beacon'' (''red arrow'') to help to locate the selected object.
</blockquote>
</blockquote>
<br>
 


== Economy does not work ==
== Economy does not work ==
<blockquote>
<blockquote>Economy is not yet functional in Q-Sims FULL Edition running Private grid.<br/>Some Public grids have enable some monetary functions.<br/><br/>If the banker selection is not correct, you must reselect the Banker after a reinstallation.<br/>The Banker selection will update the newly created configuration with your selection.</blockquote>
Economy is not yet functional in Q-Sims FULL Edition running Private grid.<br>
 
Some Public grids have enable some monetary functions.<br>
<br>
If the banker selection is not correct, you must reselect the Banker after a reinstallation.<br>
The Banker selection will update the newly created configuration with your selection.
</blockquote>
<br>


== Avatar issues ==
== Avatar issues ==
<blockquote>The snapshot below shows the representation of an undefined avatar. Such situation occurs:
*whenever a new avatar arrives into a region
*when the inventory database that contents the avatars textures cannot be reached.
[[File:Q-Sims avatar issue.jpg|thumb|center|500px|incomplete avatar represented as a ghost]]
*With an incompletely loaded inventory, your avatar can appear grayed.
<blockquote>
<blockquote>
The snapshot below shows the representation of an undefined avatar. Such situation occurs:
*You shall "''rebake''" your avatar using the Advanced menu or press '''CTRL + ALT + R'''
* whenever a new avatar arrives into a region
*Edit one parameters of the appearance to return to normal.
* when the inventory database that contents the avatars textures cannot be reached.
*This may work for the current session/region only and needs to be redone.
 
[[Image:Q-Sims_avatar_issue.jpg|thumb|center|500px|incomplete avatar represented as a ghost]]
 
* With an incompletely loaded inventory, your avatar can appear grayed.
<blockquote>
* You shall "''rebake''" your avatar using the Advanced menu or press '''CTRL + ALT + R'''
* Edit one parameters of the appearance to return to normal.  
* This may work for the current session/region only and needs to be redone.
</blockquote>
</blockquote>
[[Image:Q-Sims_Avatar_grey.jpg|thumb|center|500px|incomplete avatar represented as a ghost]]
[[File:Q-Sims Avatar grey.jpg|thumb|center|500px|incomplete avatar represented as a ghost]]
</blockquote>
</blockquote>
<br>
 


== Issues with Mono ==
== Issues with Mono ==
<blockquote>
<blockquote>
* Check if the servers (''OpenSim and UGAIM with Private grid'') are running using the command: '''http ://<your_ip>:server_port/simstatus'''.  
*Check if the servers (''OpenSim and UGAIM with Private grid'') are running using the command: '''http&nbsp;://&lt;your_ip&gt;:server_port/simstatus'''.
* Shall problems occur, try to increase the number of threads.
*Shall problems occur, try to increase the number of threads.
<blockquote><pre>
<blockquote><pre>export MONO_THREADS_PER_CPU=150
export MONO_THREADS_PER_CPU=150
</pre>
</pre>
</blockquote>
</blockquote></blockquote>
</blockquote>
 
<br>


== Issues with TwonkyMedia ==
== Issues with TwonkyMedia ==
<blockquote>
<blockquote>
*if you have selected the default '''port 9000''' for OpenSim connection and the uPnP MediaCenter (''TwonkyMedia'') is enabled on your NAS, the port 9000 is already used''.  
*if you have selected the default '''port 9000''' for OpenSim connection and the uPnP MediaCenter (''TwonkyMedia'') is enabled on your NAS, the port 9000 is already used''.''
* With the OSGrid.org Public grid you cannot change the default port 9000. Therefore you may need to change your MediaCenter default port (e.g. 9090)<br>
*With the OSGrid.org Public grid you cannot change the default port 9000. Therefore you may need to change your MediaCenter default port (e.g. 9090)
* You may also try to stop and restart the TwonkyMedia server because "''TwonkyMedia server uses the TCP ports starting at 9000 until a free port is found''". Keep in mind that each region uses a 900x port. Therefore with a Sims made of 3 regions, the ports 9000, 9001 and 9002 will be used.
*You may also try to stop and restart the TwonkyMedia server because "''TwonkyMedia server uses the TCP ports starting at 9000 until a free port is found''". Keep in mind that each region uses a 900x port. Therefore with a Sims made of 3 regions, the ports 9000, 9001 and 9002 will be used.
</blockquote>
</blockquote>
<br>
 


== Cannot teleport ==
== Cannot teleport ==
* '''Cannot log to osgrid.org:'''
 
*'''Cannot log to osgrid.org:'''
<blockquote>
<blockquote>
* see Issues with TwonkyMedia above
*see Issues with TwonkyMedia above
* Check the real availability of your XY location on the grid.
*Check the real availability of your XY location on the grid.
* if you have not selected the default '''port 9000''' for OpenSim connection (''eg. uPnP is enabled on your NAS and uses the port 9000 already'')
*if you have not selected the default '''port 9000''' for OpenSim connection (''eg. uPnP is enabled on your NAS and uses the port 9000 already'')
<blockquote>
<blockquote>
* you shall move your region (default.xml) to a Internet accessible directory
*you shall move your region (default.xml) to a Internet accessible directory
* you must embrace the content into &lt;Regions&gt; tags.
*you must embrace the content into &lt;Regions&gt; tags.
<pre>
<pre><Regions>
<Regions>
<Root>
<Root>
<Config sim_UUID=.....  
<Config sim_UUID=.....  
Line 232: Line 195:
</Regions>
</Regions>
</pre>
</pre>
* you need to update in the '''bin/OpenSim.ini''' the following parameters to provide the Region's file path:
 
<pre>
*you need to update in the '''bin/OpenSim.ini''' the following parameters to provide the Region's file path:
;region_info_source = "filesystem"
<pre>;region_info_source = "filesystem"
region_info_source = "web"
region_info_source = "web"
regionload_webserver_url = "http://example.com/default.xml";
regionload_webserver_url = "http://example.com/default.xml";
</pre>
</pre>
</blockquote>
</blockquote>
* Check your server is running on your NAS
*Check your server is running on your NAS
* Does your Q-Sims appear in the regions box on the Hippo screen?
*Does your Q-Sims appear in the regions box on the Hippo screen?
* Have selected your region in the Hippo's Region box before connecting?
*Have selected your region in the Hippo's Region box before connecting?
</blockquote>
</blockquote>
*''' Voice chat no longer working:'''
*'''Voice chat no longer working:'''
<blockquote>
<blockquote>
* After an OpenSim upgrade (''overwrite of the bin folder with the new version''), you may lost the FreeSwitch settings.<br>Manually restore the [[Q-Sims_-_Add_Voice_Chat#Voice_Chat_manual_installation |Freeswitch configuration]] or if the OpenSim.ini was backuped (''Q-Sims FULL Edition'') use it.
*After an OpenSim upgrade (''overwrite of the bin folder with the new version''), you may lost the FreeSwitch settings.<br/>Manually restore the [[Q-Sims_-_Add_Voice_Chat#Voice_Chat_manual_installation|Freeswitch configuration]] or if the OpenSim.ini was backuped (''Q-Sims FULL Edition'') use it.
</blockquote>
</blockquote>
== LINKS ==
== LINKS ==
<blockquote>
<blockquote>If you need to chat with others OpenSim and/or OSGrid.org users or administrators, connect your IRC at:
If you need to chat with others OpenSim and/or OSGrid.org users or administrators, connect your IRC at:
*[irc://irc.freenode.net/opensim irc://irc.freenode.net/opensim]
* irc://irc.freenode.net/opensim
*[irc://irc.freenode.net/osgrid irc://irc.freenode.net/osgrid]
* irc://irc.freenode.net/osgrid
<br/>Websites and forums are available at:
<br>
*[http://opensimulator.org http://opensimulator.org]
Websites and forums are available at:
*[http://osgrid.org http://osgrid.org]
* http://opensimulator.org
* http://osgrid.org
</blockquote>
</blockquote>
<br>
<br/><br/>
<br>
[[Category:Communications]] [[Category:QPKG]] [[Category:Q-Sims]]
<br>  
 
[[Category:Communications]] [[Category:QPKG|Q]] [[Category:Q-Sims|Q]]

Revision as of 18:38, 5 August 2015

by AdNovea - May 2009
Q-Sims Homepage

Error during (re)installation with the Q-Sims FULL Edition

  • If you have entered wrong data or crash during the QSA you may end with a blank page. Go into the QSims/web/qsmanager/settings folder and delete the config.php file. The installation (QSA) will restart with the default values.
  • During the QSA process, be careful to re-enter the correct passwords. If you made a mistake, you will end with the message below. Have a look at the QSims/web/qsmanager/settings/config.php file to check your entries. You can directly made the correct in this file if any.
Database error: Link_ID == false, connect failed
MySQL error: 0 ()
Session halted.


Cannot reach a Grid

You try to access a grid but it does not respond (eg. in Hippo clicking "Get Grids Info" returns Cannot retrieve grid info from server).

  • Check if Mono is running (in a SSH console type: mono -V)
  • Check if all servers are running - On QS-Manager, click Administration in the menu to display the server status
  • A server may be down, start again Q-Sims to fix this problem.
  • One or more servers may be zombie. Stop Q-Sims to fix this problem.
  • You have not forwarded the correct ports (see Installation)
  • Check if the server(s) is(are) running: Type http ://<your_ip>:server_port/simstatus/ where server_port=9000 in Standalone mode and in Grid mode (9000, 8001, 8002, 8003, 8004, 8006 and 9001-x according to the number of regions). if the server is running you will get a "OK" displayed or an Error 404 with the following page:

Ooops!

The page you requested has been obsconded with by knomes. Find hippos quick!

If you are trying to log-in, your link parameters should have: "-loginpage http :///?method=login -loginuri http :///" in your link


Cannot login with the Viewer

When you click on the Viewer connect button you get a message telling that you cannot be login.

  • Have you completed the installation process? With Q-Sims FULL Edition, the QS-Manager Home page shall be displayed - Do not forget to press the "Home" button
  • Check the grid can be reached (see above)
  • One database is not completely set up (eg. the Inventory DB for your avatar). Stop and Restart Q-Sims to complete the DB initialization.
Problem during first access with incomplete database
  • You may try to log to a region which is no longer available or the previous location is no longer available
Q-Sims selected region is not available
  • Clear you Viewer cache (Preferences/Web/Clear Now)
  • Retry (I have to do it sometimes 5-10 times in a raw while the server is clearing the previous aborted session and the viewer cache reloading!) You may have not been correctly reported as logging out the last time and OpenSim believes your are still logged.
Logging after a incomplete logout
  • Delete the Opensim cache directory (/share/xxx_DATA/.qpkg/QSims(_lite)/bin/add-db-xxx)
  • The account you are using is not confirmed. With the Q-Sims FULL Edition, in the QS-Manager admin page, under User management, check the status of the account you want to use.
  • Your Login URI is incorrect. You must use port 9000 (or the one set during installation if different from 9000) to access in Standalone and 8002 in grid mode. The login page shown in Hippo tells you the correct URI. In QS-Manager, check the Status box in the top right corner for the correct Login URI.
  • You may also select from the region box the region to access otherwise the Viewer will try to teleport you to you last position.
  • You have to retry, the Hippo viewer is sometimes reporting you as already logged. This is a cache/timeout issue.
  • Your MySQL database may be corrupted or incompatible (this can be the case after an upgrade)
  • If a message says "Regions is not found" and you are sure to have it, keep in mind the time needed for the simulator after a restart to reload all the regions and objects.


Scene rendering issues

You may have some issues while navigating the metavers. For example:

  • Prims are not correctly displayed (but it take time to load all textures)
  • Prims construction is slow on a powerful machine
  • Prims with light are not visible at night (light is visible when your avatar is closed or during prim edition)

=> IT IS MANDATORY TO UPDATE YOUR GRAPHIC CARD DRIVER TO THE LATEST VERSION.


It was working and now crashes - I'm tired of this application!

MY RECOMMENDATION: Leave it as it is for today, just relax and come back tomorrow.
I know what you feel and I always found the solution to make it work.
The development is still in alpha status and there is still some limitations.

RTENOTITLE Important Note: OpenSim uses a queuing system and YOU MUST KEEP THIS IN MIND. Requests are sent to the OpenSim simulator by the viewer for example and processed asynchronously in a FIFO order (first in-first out). A high amount of requests can crash the simulator. This is the reason why you have to be patient and wait for the requests to be processed.


I have notice crashes:

  • when upgrading to a newer version of OpenSim and not waiting for the OpenSim.exe to have processed all queue requests before lauching the viewer. The initialization can takes several minutes (10-15 according to your Sims complexity). The first time, you better start OpenSim.exe in a console to monitor the progresses and launch the Viewer when the queuing is completed (all scripts loaded and asset's storing finished).
  • with Sims with lot of prims and/or regions (eg 5 regions on a TS-639). Starting a fresh installation of a viewer (eg. a new visitor join the Sims on a new client machine or you have reinstalled your viewer) needs to fill in the cache and send a large amount of requests due to the number of regions and objects in the regions.

You may have to restart several times the viewer and the simulator (I went up to 15 restarts) while the cache is filling in.

To avoid crashes, you better:

  • upgrade to newer version ONLY if required (new mandatory feature or major bug fixes)
  • Limit the number of regions (or get a more powerful server). Read the Client Side section of Requirements on the Home page.
  • Do not expect too much despite the very good level of maturity of the OpenSim simulator.
  • Limit the number of prims (try to use as much as possible the prims parameters to build complex forms rather than linking several prims)
  • WAIT, WAIT, WAIT, WAIT ... and be patient - This may be the most difficult part of your Sims development. This is due to the asynchronous queuing implementation.


Video issues

After restoring the MySQL database, you may lost the video feature. The texture of your video prim for what reason is no longer the correct one (for example has been set to Blank Texture instead of Default Media Texture).

  • Right click the screen and select Edit..., on the Object tab check if the object is not locked, on the Texture tab click the texture thumb and select Default Media Texture, click the Color tab and set to white color, check Full bright.
  • Read also the Audio & Video section to check the parameters.


Voice chat issues

If you encounter some issues with the Voice Chat, please check:

  • The port 5060 is correctly forwarded.
  • You shall enable the Voice in your Viewers Preferences (on each client machine)
  • You must have enabled the Voice in each parcel.
  • Adjust the sound card parameters for microphone as well as the relative sound level on the Viewer (there are several cursors to adjust the different levels in the Viewer)
  • if you have re-install FreeSwitch or made a first Q-Sims installation without FreeSwitch and then added FreeSwitch, you miss the FreeSwitch modifications required for Q-Sims.
  • Stop both Q-Sims and FreeSwitch QPKG.
  • Goto the Web Interface (Click the link on the Q-Sims QPKG) and re-run the Q-Sims QSA (Installation) keeping the default values (previous settings). Press Apply to re-enter all the values. The FreeSwitch modification will be applied again.
  • Restart the FreeSwitch and Q-Sims QPKG; wait for the servers to be up and running.
  • or manually configure FreeSwitch
  • You must use the default FreeSwitch password (password) or you must modify the freeswitch configuration files accordingly.
  • DON'T RUSH each server needs time to get up and running. During debug you better have two different consoles to monitor the progression of each service and choose the Standalone mode. Go into the Q-Sims root directory, type cd bin, type mono OpenSim.exe. In the second console type ./freeswitch.sh start once Q-Sims is ready.
  • Stop all applications using port 5060 other than FreeSwitch such as Asterisk (I have been trapped by Asterisk running on port 5060 even it was disabled on the QNAP page but was started despite the disabling after a reboot)


User registration issues (Q-Sims FULL Edition)

If the user cannot send mail during registration:

  • Check the php.ini and update with your ISP mail parameters (below are the default values in the initial php.ini)
  [mail function]
  SMTP = localhost
  smtp_port = 25
  sendmail_path = /usr/sbin/sendmail -t -i
  • or overwrite the php.ini default value by adding these lines with your ISP mail parameters at the top of the /share/xxx_DATA/.qpkg/QSims/web/qsmanager/settings/config.php file:
  ini_set("SMTP","smtp.your_isp.com" );
  ini_set("smtp_port ",25);
  ini_set('sendmail_from', 'user@your_isp.com'); 
  • Reboot your Apache server with new parameters
# /etc/init.d/Qthttpd.sh restart

NOTE: PHP MAIL function looks a little bit erratic. I set some settings which did not worked but all of a sudden were working - no clear answer on the web regarding the topic "Cannot send mail outside domain" neither. So good luck.


Debugging your region/parcel

  • Cannot set the parcel property
  • you are not the parcel owner, connect with the owner account
  • you have issues with the UUIDs. Check the regions UUID in the bin/Regions directory the zzzzz.xml or zzzzz.ini files that correspond to the regions with troubles and the UUID of the owner. Analyze and correct the issue accordingly.


  • After some building, you may encounter some troubles with scripts and/or objects. Fortunately, there is some tools for debugging.

Click in the menu bar World and Region/Estate.... Select the Debug tab and you can have some information and actions for debugging.

Region/Estate debugging screen

Select Get To Colliders... or Get Top Scripts...to display the list of objects/scripts involved. Selecting one object from the list will display the beacon (red arrow) to help to locate the selected object.


Economy does not work

Economy is not yet functional in Q-Sims FULL Edition running Private grid.
Some Public grids have enable some monetary functions.

If the banker selection is not correct, you must reselect the Banker after a reinstallation.
The Banker selection will update the newly created configuration with your selection.


Avatar issues

The snapshot below shows the representation of an undefined avatar. Such situation occurs:

  • whenever a new avatar arrives into a region
  • when the inventory database that contents the avatars textures cannot be reached.
incomplete avatar represented as a ghost
  • With an incompletely loaded inventory, your avatar can appear grayed.
  • You shall "rebake" your avatar using the Advanced menu or press CTRL + ALT + R
  • Edit one parameters of the appearance to return to normal.
  • This may work for the current session/region only and needs to be redone.
incomplete avatar represented as a ghost


Issues with Mono

  • Check if the servers (OpenSim and UGAIM with Private grid) are running using the command: http ://<your_ip>:server_port/simstatus.
  • Shall problems occur, try to increase the number of threads.
export MONO_THREADS_PER_CPU=150


Issues with TwonkyMedia

  • if you have selected the default port 9000 for OpenSim connection and the uPnP MediaCenter (TwonkyMedia) is enabled on your NAS, the port 9000 is already used.
  • With the OSGrid.org Public grid you cannot change the default port 9000. Therefore you may need to change your MediaCenter default port (e.g. 9090)
  • You may also try to stop and restart the TwonkyMedia server because "TwonkyMedia server uses the TCP ports starting at 9000 until a free port is found". Keep in mind that each region uses a 900x port. Therefore with a Sims made of 3 regions, the ports 9000, 9001 and 9002 will be used.


Cannot teleport

  • Cannot log to osgrid.org:
  • see Issues with TwonkyMedia above
  • Check the real availability of your XY location on the grid.
  • if you have not selected the default port 9000 for OpenSim connection (eg. uPnP is enabled on your NAS and uses the port 9000 already)
  • you shall move your region (default.xml) to a Internet accessible directory
  • you must embrace the content into <Regions> tags.
<Regions>
	<Root>
	<Config sim_UUID=..... 
	... object_capacity="0" />
	</Root>
</Regions>
  • you need to update in the bin/OpenSim.ini the following parameters to provide the Region's file path:
;region_info_source = "filesystem"
region_info_source = "web"
regionload_webserver_url = "http://example.com/default.xml";
  • Check your server is running on your NAS
  • Does your Q-Sims appear in the regions box on the Hippo screen?
  • Have selected your region in the Hippo's Region box before connecting?
  • Voice chat no longer working:
  • After an OpenSim upgrade (overwrite of the bin folder with the new version), you may lost the FreeSwitch settings.
    Manually restore the Freeswitch configuration or if the OpenSim.ini was backuped (Q-Sims FULL Edition) use it.

LINKS

If you need to chat with others OpenSim and/or OSGrid.org users or administrators, connect your IRC at:


Websites and forums are available at: