PageRenderTime 22ms CodeModel.GetById 15ms app.highlight 2ms RepoModel.GetById 2ms app.codeStats 0ms

/indra/newview/linux_tools/client-readme.txt

https://bitbucket.org/lindenlab/viewer-beta/
Plain Text | 244 lines | 195 code | 49 blank | 0 comment | 0 complexity | e70702fa5dc4a59dc7b14507f64292ef MD5 | raw file
  1Second Life - Linux Beta README
  2-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  3
  4This document contains information about the Second Life Linux
  5client, and isn't meant to serve as an introduction to Second
  6Life itself - please see <http://www.secondlife.com/whatis/>.
  7
  81. Introduction
  92. System Requirements
 103. Installing & Running
 114. Known Issues
 125. Troubleshooting
 13   5.1. 'Error creating window.'
 14   5.2. System hangs
 15   5.3. Blank window after minimizing it
 16   5.4. Audio
 17   5.5. 'Alt' key for camera controls doesn't work
 18   5.6. In-world streaming movie, music and Flash playback
 196. Advanced Troubleshooting
 20   6.1. Audio
 21   6.2. OpenGL
 227. Obtaining and working with the client source code
 238. Getting more help, and reporting problems
 24
 25
 261. INTRODUCTION
 27-=-=-=-=-=-=-=-
 28
 29Hi!  This is a BETA release of the Second Life client for Linux.
 30The 'beta' status means that although we're still smoothing-out a few rough
 31edges, this version of the client is functionally complete and should
 32work quite well 'out of the box' for accessing Second Life.
 33
 34We encourage you to try it out and let us know of its compatibility
 35with your system.  Be aware that although this is a 'beta' client, it connects
 36to the main Second Life world and changes you make there are permanent.
 37
 38You will have either obtained this client from secondlife.com (the official
 39site) or from a third-party packager; if you encounter any problems then
 40we recommend trying the latest official builds from secondlife.com which are
 41updated often.
 42
 43Please enjoy!
 44
 45
 462. SYSTEM REQUIREMENTS
 47-=-=-=-=-=-=-=-=-=-=-=
 48
 49Minimum requirements:
 50    * Internet Connection: Cable or DSL
 51    * Computer Processor: 800MHz Pentium III or Athlon or better
 52      (recommended: 1.5GHz or more)
 53    * Computer Memory: 512MB (recommended: 768MB or more)
 54    * Linux Operating System: A reasonably modern 32-bit Linux environment
 55          is required.  If you are running a 64-bit Linux distribution then
 56          you will need its 32-bit compatibility environment installed, but
 57          this configuration is not currently supported.
 58    * PulseAudio or ALSA Linux system sound software.  A recent PulseAudio
 59      is the recommended configuration; see README-linux-voice.txt for more
 60      information.
 61    * Video/Graphics Card:
 62          o nVidia GeForce 2, GeForce 4mx, or better (recommend one of the
 63            following: 6700, 6800, 7600, 7800, 7900, 8400, 8500, 8600,
 64            8800, Go 7400, Go 7600, Go 7800, Go 7900, +)
 65          o OR ATI Radeon 8500, 9250, or better
 66          (nVidia cards are recommended for the Linux client)
 67
 68      **NOTE**: Second Life absolutely requires you to have recent, correctly-
 69      configured OpenGL 3D drivers for your hardware - the graphics drivers
 70      that came with your operating system may not be good enough!  See the
 71      TROUBLESHOOTING section if you encounter problems starting Second Life.
 72
 73For a more comfortable experience, the RECOMMENDED hardware for the Second
 74Life Linux client is very similar to that for Windows, as detailed at:
 75<https://secondlife.com/corporate/sysreqs.php>
 76
 77
 783. INSTALLING & RUNNING
 79-=-=-=-=-=-=-=-=-=-=-=-
 80
 81The Second Life Linux client can entirely run from the directory you have
 82unpacked it into - no installation step is required.  If you wish to
 83perform a separate installation step anyway, you may run './install.sh'
 84
 85Run ./secondlife from the installation directory to start Second Life.
 86
 87For in-world MOVIE and MUSIC PLAYBACK, you will need (32-bit) GStreamer 0.10
 88installed on your system.  This is optional - it is not required for general
 89client functionality.  If you have GStreamer 0.10 installed, the selection of
 90in-world movies you can successfully play will depend on the GStreamer
 91plugins you have; if you cannot play a certain in-world movie then you are
 92probably missing the appropriate GStreamer plugin on your system - you may
 93be able to install it (see TROUBLESHOOTING).
 94
 95User data is stored in the hidden directory ~/.secondlife by default; you may
 96override this location with the SECONDLIFE_USER_DIR environment variable if
 97you wish.
 98
 99
1004. KNOWN ISSUES
101-=-=-=-=-=-=-=-
102
103* No significant known issues at this time.
104
105
1065. TROUBLESHOOTING
107-=-=-=-=-=-=-=-=-=
108
109The client prints a lot of diagnostic information to the console it was
110run from.  Most of this is also replicated in ~/.secondlife/logs/SecondLife.log
111- this is helpful to read when troubleshooting, especially 'WARNING' and
112'ERROR' lines.
113
114VOICE PROBLEMS?  See the separate README-linux-voice.txt file for Voice
115  troubleshooting information.
116
117SPACENAVIGATOR OR JOYSTICK PROBLEMS?  See the separate
118  README-linux-joystick.txt file for configuration information.
119
120PROBLEM 1:- Second Life fails to start up, with a warning on the console like:
121   'Error creating window.' or
122   'Unable to create window, be sure screen is set at 32-bit color' or
123   'SDL: Couldn't find matching GLX visual.'
124SOLUTION:- Usually this indicates that your graphics card does not meet
125   the minimum requirements, or that your system's OpenGL 3D graphics driver is
126   not updated and configured correctly.  If you believe that your graphics
127   card DOES meet the minimum requirements then you likely need to install the
128   official so-called 'non-free' nVidia or ATI (fglrx) graphics drivers; we
129   suggest one of the following options:
130 * Consult your Linux distribution's documentation for installing these
131   official drivers.  For example, Ubuntu provides documentation here:
132   <https://help.ubuntu.com/community/BinaryDriverHowto>
133 * If your distribution does not make it easy, then you can download the
134   required Linux drivers straight from your graphics card manufacturer:
135   - nVidia cards: <http://www.nvidia.com/object/unix.html>
136   - ATI cards: <http://ati.amd.com/support/driver.html>
137
138PROBLEM 2:- My whole system seems to hang when running Second Life.
139SOLUTION:- This is typically a hardware/driver issue.  The first thing to
140   do is to check that you have the most recent official drivers for your
141   graphics card (see PROBLEM 1).
142SOLUTION:- Some residents with ATI cards have reported that running
143   'sudo aticonfig --locked-userpages=off' before running Second Life solves
144   their stability issues.
145SOLUTION:- As a last resort, you can disable most of Second Life's advanced
146   graphics features by editing the 'secondlife' script and removing the '#'
147   from the line which reads '#export LL_GL_NOEXT=x'
148
149PROBLEM 3:- After I minimize the Second Life window, it's just blank when
150   it comes back.
151SOLUTION:- Some Linux desktop 'Visual Effects' features are incompatible
152   with Second Life.  One reported solution is to use your desktop
153   configuration program to disable such effects.  For example, on Ubuntu 7.10,
154   use the desktop toolbar menu to select System -> Preferences -> Appearance,
155   then change 'Visual Effects' to 'None'.
156
157PROBLEM 4:- Music and sound effects are silent or very stuttery.
158SOLUTION:- The most common solution is to ensure that you have the 'esd'
159   program (part of the 'esound' package) installed and running before you
160   start Second Life.  Users of Ubuntu (and some other) Linux systems can
161   simply run the following to install and configure 'esound':
162     sudo apt-get install esound
163  For others, simply running 'esd&' from a command-line should get it running.
164
165PROBLEM 5:- Using the 'Alt' key to control the camera doesn't work or just
166   moves the Second Life window.
167SOLUTION:- Some window managers eat the Alt key for their own purposes; you
168   can configure your window manager to use a different key instead (for
169   example, the 'Windows' key!) which will allow the Alt key to function
170   properly with mouse actions in Second Life and other applications.
171
172PROBLEM 6:- In-world movie, music, or Flash playback doesn't work for me.
173SOLUTION:- You need to have a working installation of GStreamer 0.10; this
174   is usually an optional package for most versions of Linux.  If you have
175   installed GStreamer 0.10 and you can play some music/movies but not others
176   then you need to install a wider selection of GStreamer plugins, either
177   from your vendor (i.e. the 'Ugly' plugins) or an appropriate third party.
178   For Flash playback, you need to have Flash 10 installed for your normal
179   web browser (for example, Firefox).  PulseAudio is required for Flash
180   volume control / muting to fully function inside Second Life.
181
182
1836. ADVANCED TROUBLESHOOTING
184-=-=-=-=-=-=-=-=-=-=-=-=-=-
185
186The 'secondlife' script which launches Second Life contains some
187configuration options for advanced troubleshooters.
188
189* AUDIO - Edit the 'secondlife' script and you will see these audio
190  options: LL_BAD_OPENAL_DRIVER, LL_BAD_FMOD_ESD, LL_BAD_FMOD_OSS, and
191  LL_BAD_FMOD_ALSA.  Second Life tries to use OpenAL, ESD, OSS, then ALSA
192  audio drivers in this order; you may uncomment the corresponding LL_BAD_*
193  option to skip an audio driver which you believe may be causing you trouble.
194
195* OPENGL - For advanced troubleshooters, the LL_GL_BLACKLIST option lets
196  you disable specific GL extensions, each of which is represented by a
197  letter ("a"-"o").  If you can narrow down a stability problem on your system
198  to just one or two GL extensions then please post details of your hardware
199  (and drivers) to the Linux Client Testers forum (see link below) along
200  with the minimal LL_GL_BLACKLIST which solves your problems.  This will help
201  us to improve stability for your hardware while minimally impacting
202  performance.
203  LL_GL_BASICEXT and LL_GL_NOEXT should be commented-out for this to be useful.
204
205
2067. OBTAINING AND WORKING WITH THE CLIENT SOURCE CODE
207-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
208
209We're pleased to have released the Second Life client's source code under
210an Open Source license compatible with the 'GPL'.  To get involved with client
211development, please see:
212<http://wiki.secondlife.com/wiki/Open_Source_Portal>
213
214
2158. GETTING MORE HELP AND REPORTING PROBLEMS
216-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
217
218For general help and support with Second Life:
219<http://secondlife.com/community/support.php>
220
221For problems and discussion concerning unofficial (not secondlife.com)
222releases, please contact your packager or the SLDev mailing list:
223<https://lists.secondlife.com/cgi-bin/mailman/listinfo/sldev>
224
225In-world help: Please use the 'Help' menu in the client for various
226non-Linux-specific Second Life help options.
227
228In-world discussion: There is a 'Linux Client Users' group
229inside Second Life which is free to join.  You can find it by pressing
230the 'Search' button at the bottom of the window and then selecting the
231'Groups' tab and searching for 'Linux'.  This group is useful for discussing
232Linux issues with fellow Linux client users who are online.
233
234The Second Life Issue Tracker:
235<http://jira.secondlife.com/>
236This is the right place for finding known issues and reporting new
237bugs in all Second Life releases if you find that the Troubleshooting
238section in this file hasn't helped (please note, however, that this is
239not a support forum).
240
241Linux Client Testers forum:
242<http://forums.secondlife.com/forumdisplay.php?forumid=263>
243This is a forum where Linux Client users can help each other out and
244discuss the latest updates.