The Source for Java Technology Collaboration


Home | Changes | Index | Search | Go

Installation

Project Looking Glass Installation Notes for Ubuntu "Breezy Badger" 5.10 and "Dapper Drake" 6.06 Beta 2


The .deb package will add Project Looking Glass to the gdm login screen. If you are not using gdm then you will have to start lg3d by hand.

  • Install the 3 .deb packages from the binary downloads page.
  • Install the hardware accelerated OpenGL support for your graphics cards
    • Nvidia
      • sudo apt-get install nvidia-glx
      • sudo nvidia-glx-config enable
      • sudo gedit /etc/X11/xorg.conf, search for the dri module line and comment it out
      • restart the gdm (reboot ?)
    • ATI : TBD
    • Intel : TBD
  • Select Project Looking Glass from gdm login screen

Project Looking Glass Installation Notes for Windows XP

  • Install the windows .exe package from the binary downloads page.
  • Start Project Looking Glass from the start menu

If you experience problems install the latest graphics card driver from the manufacturers website


Project Looking Glass Installation Notes for JDS/Linux


I just installed Looking Glass 3D (open source) on top of JDS on a Sun Java W1100z workstation with NVIDIA Quadro FX 500 graphics card in session mode. The result is a more powerful Looking Glass than the simple window mode. It allows some simple capturing of X11 apps as previously known from the proof- of-concept version through LG3D?'s own X11 server and a more immersive user experience.

The installation was not trivial and the current instructions on:

https://lg3d-core.dev.java.net/lg3d-getting-started.html

don't work out of the box for Sun Java Workstations Wx100z running JDS with the newest NVIDIA drivers, due to an xorg.conf vs XFree86Config? conflict and due to a new NVIDIA feature that forbids GLX in conjunction with the Composite extension. So I thought I'll summarise below what I did to save others some Google time.

[Note from Deron Johnson: the web page referenced as subsequently been updated to include the instructions contained herein]

0. Initial setup: - Make sure you have JDS up and running on your machine. This HowTo? assumes a Sun Java Workstation Wx100z with an NVIDIA Quadro FX frame buffer running JDS release 2. Check:

http://blogs.sun.com/roller/page/rolfk/20040825#how_to_install_sun_java

For some installation hints.

Other hints on getting the NVIDIA drivers to work are available from:

https://lg3d-core.dev.java.net/nvidia-driver-install-tips.html

- Note: SAX2 routinely breaks important OpenGL? symlinks from the NVIDIA driver set. Therefore, the recommended course of action is to:

- Install NVIDIA drivers using their installer,
- Configure color depth and resolution using SAX2 (24 Bit required),
- Re-Install NVIDIA drivers to fix broken links.

- Make sure you configure the graphics driver to run in 24 bit mode.

- Make sure your 3D acceleration works by testing an OpenGL? program such as glxgears with a large window and see if it reports a high frame rate (>100).

1. Install Looking Glass 3D prerequisites:

- Follow the Looking Glass Getting started document Steps 1 and 2:

https://lg3d-core.dev.java.net/lg3d-getting-started.html

Note
When installing Java 3D, use the latest experimental build and make sure you install the .jar version, not the .rpm version. The latter does not correctly find the required libraries although they are there.


- Instead of setting JAVA_HOME and PATH in your profile, it is more advisable to modify the Looking Glass startup scripts as described below.

2. Install and test Looking Glass Developer's Release:

- Follow Step 3 of the Getting Started document.

- It is recommended to set the required environment in the Looking Glass startup scripts by adding:

# Set environmental settings for JDK 5
setenv JAVA_HOME /usr/java/jdk1.5.0_01
setenv PATH $JAVA_HOME/bin:$PATH

to the top of the lg3d-dev and lg3d-session scripts. Make sure the version part of your jdk directory is set correctly, in this example it's 1.5.0_01.

Make sure that Looking Glass runs well in window mode by running ${YOUR_LG3D_PATH}/bin/lg3d-dev.

3. Modifying the installation to allow for Looking Glass session mode:

- The Looking Glass 3D project comes with a session mode. The session mode is designed to replace xdm and your standard window manager. However, with the latest versions of the NVIDIA drivers and due to differences in the X.org vs. XFree86 config files, session mode does not work out of the box and needs fixing.

- Disabling traditional xdm mode:

- Warning: You will only be able to login in text mode on your console after disabling xdm.

- Follow the instructions in Step 4 of the Looking Glass Getting Started document under the "Running Project Looking Glass full-screen" section, JDS/SuSe 8.1 subsection.

- On many systems, you can reenable xdm by entering the following commands:

init 3
chkconfig -a xdm
init 5

(If this doesn't work, you will need to reboot).

You can only run LG3D? in session mode if you have xdm disabled.

- Fixing X.org vs XFree86 related issues:

- JDS still uses XFree86 as the X server. Project Looking Glass's X11 server that is used to capture X11 programs is based on X.org. LG3D? in session mode will start an X.org server that will read in JDS' /etc/XFree86config as it's default configuration file.

However, using the latest NVIDIA drivers, there are two problems that will result in two particular errors:

1. (EE) Failed to load module "Keyboard" (module does not exist, 0)
2. (EE) GLX is not supported with the Composite extension

- To fix both issues, you need to create a file named /etc/X11/xorg.conf which contains a copy of /etc/X11/X11/XF86Config, but with some modifications. Most of these modifications are compatible with XFree86, but if you want to avoid changing the configuration that XFree86 sees then you should make a copy of XF86Config? named xorg.conf. Otherwise, it is best to make a symbolic link to XF86Config? and name it xorg.conf.

- Edit the /etc/X11/xorg.conf file:

To fix error #1:

- Find the InputDevice? section for loading the keyboard module. It should look like:

Section "InputDevice"
Driver "Keyboard"
Identifier "Keyboard[0]"
Option "MapName" "Standard Keyboard [ pc104 ]"
Option "Protocol" "Standard"
Option "XkbLayout" "us"
Option "XkbModel" "pc104"
Option "XkbRules" "xfree86"
EndSection?

- Replace the Driver line as follows:

Change:

Driver "Keyboard"

to:

Driver "kbd"

- More information about this fix is available here:

http://www.javadesktop.org/forums/thread.jspa?messageID=38198

To fix error #2:

- Find the "Device" Section that loads the NVIDIA driver. It should look like:

Section "Device"
BoardName? "0x032B"
BusID? "9:0:0"
Driver "nvidia"
Identifier "Device[0]"
VendorName? "NVidia"
EndSection?

- Insert the following line after the "VendorName" line:

Option "AllowGLXWithComposite" "true"

- More information about this fix is available on:

http://www.javadesktop.org/forums/thread.jspa?forumID=56&threadID=6990&messageID=42217

4. That's it. Now you should be able to run Looking Glass in session mode by starting the bin/lg3d-session script in your Looking Glass folder.

I hope this HowTo? has saved you a minute or two of Googling around and enabled you to have another fine Wx100z demo. Of course, things change, YMMV and I may have left a typo in this tutorial, so let me know if you run into issues and I'll try to help you as best as I can.

This HowTo? document wouldn't have been possible without the generous donation of Sun Java Workstation W1100z machines to the Technical Systems Ambassadors by NSG product marketing. Thank you!

Best regards and hope this helps, Constantin

-- Constantin Gonzalez
Sun Microsystems GmbH?
Consultant Core Technology
Germany
Client Solutions
http://www.sun.de/
Tel.: +49 89/4 60 08-25 91
http://blogs.sun.com/constantin/

(With minor modifications and html conversion by Deron Johnson)

Topic Installation . { Edit | Ref-By | Printable | Diffs r5 < r4 < r3 < r2 < r1 | More }
 XML java.net RSS

Revision r5 - 10 May 2006 - 11:10:17 - Main.ekerazha
Parents: WebHome > ProjectLookingGlass