Comment installer la version de développement de Looking Glass

Bienvenue sur le Projet Looking Glass !

Ce document est conçu pour vous permettre d'installer et d'utiliser rapidement la version de développement du projet Looking Glass.

Pour commencer vous devrez configurer votre environnement. Une fois que vous aurez vérifié que votre environnement est configuré correctement vous pourrez télécharger et installer Looking Glass.

1. Plateforme requise Configuration matérielle et logicielle
2. Configurer votre environnement pour Looking Glass Télécharger et installer les composants requis
3. Installer la version de développement de Looking Glass
4. Lancer Looking Glass Comment lancer une session du bureau Looking Glass
5. Problèmes
6. Rester informé sur Looking Glass Comment rester en contact !
7. Quelques derniers mots

1. Plateforme requise

Avant que vous ne commenciez à configurer votre environnement pour Looking Glass, vérifiez que votre système dispose des pré-requis minimaux suivants :

Composant Plateforme Linux
Système d'exploitation La plupart des distributions Linux modernes devraient fonctionner, même si des problèmes ont été rapportés avec une installation de java par portage. Nous vous suggérons de suivre ce guide pour l'installation manuelle de tous les composants plutôt que d'utiliser portage.
CPU 2 GHz ou plus rapide recommandé
RAM 512MO
Carte graphique*
Carte graphique accélératrice 3D avec des pilotes supportant l'OpenGL, version 1.2 ou ultérieure.
ATTENTION ! Une profondeur d'affichage de 24 bits est requise ! Voyez les instructions qui suivent pour configurer ceci.

Cartes testées :
  • NVIDIA GeForce 2 ou équivalent utilisant la version 1.0-5336 et 1.0-6629 des pilotes NVIDIA.
    Voyez consulter les astuces d'installation du pilote NVIDIA.

    NOTE : Il est particulièrement important de consulter ces instructions si vous avez récemment mis à jour votre pilote en 1.0-6629, parce que LG3D a besoin d'étapes de configuration additionnelles avec ce pilote.

Pour les instructions de configuration des pilotes de cartes spécifiques, veuillez consulter : Installer et configurer les pilotes de matériel pour Looking Glass

Si vous réussissez à installer Looking Glass sur d'autres cartes, veuillez nous le faire savoir en utilisant le forum de discussion.
Espace disque 350MO

2. Configurer votre environnement pour Looking Glass

Avant que vous ne puissiez lancer Looking Glass, vous devez installer un certain nombre de composants Java. Le moyen le plus simple pour cela est de tous les télécharger et ensuite de les installer dans l'ordre listé ci-dessous.

Télécharger les composants

Note : Le guide d'installation suppose que vous téléchargiez tous les composants dans /tmp.

  1. Java 2 SDK, Standard Edition 1.5.0 ou ultérieur
    http://java.sun.com/j2se/1.5.0/download.jsp

    Note : Le guide d'installation suppose que vous téléchargiez la version RPM du JDK.

  2. Java 3D SDK 1.3.2 ou ultérieur
    https://j3d-core.dev.java.net/servlets/ProjectDocumentList

    Note : Naviguez jusqu'au sous dossier j3d-core/Release_Builds/1.3.2 et téléchargez java3d-1_3_2-linux-i586.zip.


  3. Java Advanced Imaging API (JAI) 1.1.2 JDK
    http://java.sun.com/products/java-media/jai/downloads/download-1_1_2.html

    Note : Choisissez le JDK(TM) Install: Bundle for installation in a JDK Download. Après avoir lu et accepté la licence, choisissez le lien Linux JDK Install (jai-1_1_2-lib-linux-i586-jdk.bin).

Installer les composants

Après avoir téléchargé tous les composants, installez les en suivant les instructions ci-dessous.

  1. Tout d'abord passez en root :

    % su root
    Password:
    donnez le mot de passe root
    #

  2. Installez le SDK Java 2 :

    # cd /tmp
    # /bin/bash jdk-1_5_0_02-linux-i586-rpm.bin
    # rm jdk-1_5_0_02-linux-i586.rpm
    # rm jdk-1_5_0_02-linux-i586-rpm.bin


  3. Installez le SDK Java 3D :

    # cd /tmp
    # unzip java3d-1_3_2-linux-i586.zip
    # cd /usr/java/jdk1.5.0/jre
    # unzip /tmp/java3d-1_3_2-linux-i586/j3d-132-linux-x86.zip
    # cd /tmp
    # rm -r java3d-1_3_2-linux-i586/


  4. Installez le Java Advanced Imaging API:

    # cd /usr/java/jdk1.5.0
    # /bin/bash /tmp/jai-1_1_2-lib-linux-i586-jdk.bin


  5. Quittez le shell root :

    # exit
    %


  6. Diverses variables d'environnement doivent maintenant être réglées dans votre profil shell. Voici les exemples appropriés pour bash(1) :

    JAVA_HOME=/usr/java/jdk1.5.0
    PATH=$JAVA_HOME/bin:$PATH

3. Installer la version de développement de Looking Glass

Enregistrez vous sur le site web java.net

Si vous ne vous êtes pas inscrit précedemment sur java.net alors vous allez devoir créer un compte :

  1. Allez sur http://www.java.net et cliquez sur le lien Register en haut de la page.
  2. Entrez votre nom d'utilisateur et votre adresse mail préférés et cliquez ensuite sur le bouton [Register].
  3. Vous recevrez un mail avec les instructions afin de donner un mot de passe à votre compte. Une fois que vous aurez entré votre mot de passe et accepté le contrat de participation du site java.net, vous serez connecté.

Téléchargez le paquet d'installation de Looking Glass

  1. Allez sur https://lg3d-core.dev.java.net et cliquez sur Documents & files dans la section Project tools de la barre latérale.
  2. Naviguez jusqu'à lg3d-core/stable_builds dans l'arborescence. Vous verrez un tableau contenant une liste de compilations stables.
  3. Cliquez sur le lien nommé Release_x.y.z (où x.y.z est la version de la compilation, par exemple 0.6.1) et choisissez un dossier où télécharger le fichier, par exemple /tmp
  4. Allez dans le dossier où vous voulez installer Looking Glass est décompressez les fichiers :

    % cd /home/username
    % tar -zxf /tmp/lg3d-x.y.z.tar.gz


    Note : remplacez x.y.z avec la version de la compilation que vous avez téléchargée (par exemple 0.6.1).

    Les fichiers seront décompressés dans un dossier nommé lg3d dans le dossier courant.
La version actuelle de LG3D est la 0.6.1. Avant de commencer à l'utiliser, veuillez lire les notes de version.

Configurer le nombre de couleurs de votre affichage

La version de développement du projet Looking Glass nécessite une profondeur d'affichage d'au moins 24 bits. De nombreux systèmes sont configurés par défaut avec une profondeur de 16 bits, et la version de développement du projet Looking Glass ne fonctionnera pas correctement avec cette dernière. Vous pouvez connaître la profondeur d'affichage actuelle en lançant la commande suivante :

% xdpyinfo | grep "depth of root"
depth of root window:   24 planes

Si vous voyez une valeur inférieure à 24, vous devez changer la profondeur de couleur. La manipulation pour effectuer ce changement dépend de votre plateforme. Consultez les instructions de configuration pour votre plateforme ci-dessous :

Java Desktop System 1 et 2, ou SUSE8.1:

  1. Depuis une session graphique, lancez la commande sax2 :

    % /usr/X11R6/bin/sax2
    SaX: root Password:
    donnez le mot de passe root

  2. Dans l'application SaX2, cliquez sur Couleur et Résolution puis cliquez ensuite sur le bouton [Propriétés...] pour le bureau en cours de configuration.
  3. Dans le paneau Choix de la couleur..., cliquez sur le menu et choisissez 16.7 Mio. [24 Bit].
  4. Sur l'onglet Resolution(s) for 16.7 Mio. [24 Bit] colors, choisissez la résolution que vous préférez pour votre bureau et cliquez sur [Ok].
  5. Cliquez sur le bouton [Finish], puis sur [Finalize>>].
  6. Le dialogue SaX2 final steps... s'ouvrira. Cliquez sur le bouton [Test...] pour essayer la nouvelle résolution.
  7. Un écran bleu de test devrait apparaître, cliquez sur le bouton [Save] si l'affichage semble stable, et ensuite sur [Ok] quand vous retournez sur la fenêtre de SaX2, et enfin sur [Yes] pour quitter SaX2.
  8. Si l'écran de test n'apparaît pas correctement, il se quittera après 30 secondes et votre session de bureau précédente sera restaurée. Vous devriez alors essayer une autre résolution avec la profondeur de couleurs de 24 bits afin de trouver une résolution qui marche pour votre système.
  9. Quand vous serez satisfait des réglages, déconnectez vous et re-connectez sur la session de bureau et vérifiez que la profondeur de couleur est maintenant de 24 bit ou supérieur en utilisant la commande xdpyinfo comme ci-dessus.

RedHat Fedora 2:

  1. Tout d'abord passez en root :

    % su root
    Password:
    donnez le mot de passe root
    #

  2. Éditez le fichier : /etc/X11/xorg.conf
  3. Localisez la section du fichier nommée : Section "Screen"
  4. Dans cette section, localisez l'entrée : Identifier "Screen0"
    Changez les propriétés DefaultDepth et DefaultFbBpp en :

    DefaultDepth 24
    DefaultFbBpp 32

  5. Enregistrez le fichier, puis déconnectez vous et re-connectez sur la session de bureau et vérifiez que la profondeur de couleur est maintenant de 24 bit ou supérieur en utilisant la commande xdpyinfo comme ci-dessus.

RedHat 8, RedHat 9 et autres plateformes Linux :

Many Linux platforms use the XF86Config file to configure the display properties. To change the color depth on these systems:

  1. Tout d'abord passez en root :

    % su root
    Password:
    donnez le mot de passe root
    #

  2. Éditez le fichier : /etc/X11/XF86Config
  3. Localisez la section du fichier nommée : Section "Screen" et passez la propriété DefaultDepth à 24 :

    DefaultDepth     24

  4. Dans cette section, localisez la sous section nommée "Display":

    SubSection "Display"

    et modifiez la propriété Depth en :

    Depth     24

  5. Enregistrez le fichier, puis déconnectez vous et re-connectez sur la session de bureau et vérifiez que la profondeur de couleur est maintenant de 24 bit ou supérieur en utilisant la commande xdpyinfo comme ci-dessus.

4. Lancer le Projet Looking Glass

Il y a deux façons de lancer le Projet Looking Glass : dans une fenêtre dans un environnement de bureau existant et en tant que bureau en plein écran. Seul le mode bureau plein écran supporte l'une des fonctionnalités clé du Projet Looking Glass : l'intégration des applications X11 natives, non modifiées. Le moyen le plus simple pour vérifier si votre installation du Projet Looking Glass est correcte est de lancer la démonstration dans un bureau existant. Une fois que vous êtes satisfait d'un fonctionnement correct, vous pouvez configurer votre système pour lancer le Projet Looking Glass en plein écran. Remarquez que l'utilisation du Projet Looking Glass dans une fenêtre est un bon moyen pour développer et tester des applications 3D et des améliorations du gestionnaire de fenêtres (Scene Manager).

Lancer le Projet Looking Glass dans un environnement de bureau existant

Dans ce mode, une session du Projet Looking Glass va être lancée dans une fenêtre de votre bureau. C'est le moyen le plus simple pour lancer le Projet Looking Glass mais ce mode ne vous permettra que de lancer des applications 3D du Projet Looking Glass, comme par exemple le sélecteur de CD. Les applications X11, comme xterm, vont apparaître dans la session de X d'où vous avez lancé la session du Projet Looking Glass.

  1. Connectez vous à votre compte et allez dans le dossier où vous avez installé le Projet Looking Glass :

    % cd /home/username/lg3d/bin

  2. Et lancez la session du Projet Looking Glass :

    % ./lg3d-dev

Si vous avez réussi l'installation du Projet Looking Glass vous devriez voir le bureau familier du Projet Looking Glass dans une fenêtre sur votre bureau :

Project Looking Glass Screenshot

En cliquant sur l'icone du CD sur la barre des taches, vous ouvrirez l'afficheur de CD, une application 3D de démonstration. Passez la souris sur la pile de CD et cliquez sur les images de CD pour voir l'application en action. Pour plus d'informations sur les opération, cliquez sur l'icone à gauche de celle de l'afficheur de CD dans la barre des tâches. Ceci ouvrira une fenêtre résumant les opérations supportées par la démo. Remarquez que l'icone la plus à gauche, un ordinateur, lance une fenêtre xterm. Cet élément montre l'intégration d'applications X11 et n'est supporté qu'en mode plein écran. Voyez la section suivante pour des informations sur la configuration.

Lancer le Projet Looking Glass en plein écran

Ce mode vous permet de lancer le Projet Looking Glass en plein écran et d'y lancer n'importe quelle application, y compris des applications X11 natives. Vous devez tout d'abord fermer votre session X avant de lancer le Projet Looking Glass. Ce mode ne peut être utilisé que sur des systèmes Linux. Éventuellement, il deviendra le mode de base pour l'exécution de LG3D et sera supporté sur Linux et Solaris.

NOTE: Ce mode est encore en cours de construction. Actuellement, peu d'applications X11 marchent sans bug dans ce mode. Il y a encore beaucoup de travail de débuggage à faire. Des applications importantes comme mozilla, staroffice, evolution et la plupart des applications GNOME auront des problèmes signifiants. Nous travaillons activement sur la résolution de ces problèmes. Veuillez remplir un rapport de bug pour chaque problème que vous trouvez.

Les instructions dépendent de la plateforme, donc suivez les instructions correspondant à la votre. Si votre plateforme n'est pas listée, il y a des chances pour que le processus soit très proche donc utilisez ces instructions comme base et faites nous savoir ce qui diffère !

Sun Java Desktop System/SuSE 8.1 :

Ndt : J'ai délibérement modifié ces instructions : si elles ne marchent pas, précisez qu'elles proviennent de cette traduction !
JDS/SuSE 8.1 utilisent le gestionnaire d'affichage X (X Display Manager ou xdm) pour gérer les sessions utilisateur. Pour lancer le Projet Looking Glass vous devez tout d'abord quitter xdm. Étant donné que ce processus est lancé par un service, il vous suffit de quitter ce service :

  1. Fermez toutes les applications de votre bureau et enregistrez tous les fichiers ouverts.
  2. Ensuite passez en root :

    % su root
    Password:
    donnez le mot de passe root
    #

  3. Désactivez le service xdm :

    # /etc/init.d/xdm stop

  4. Maintenant passez à la section Lancer la session bureau du Projet Looking Glass

Note : Pour réactiver le gestionnaire d'affichage X, entrez la commande suivant en tant que root :

# /etc/init.d/xdm start

RedHat 9 :

RedHat utiliser le gestionnaire d'affichage GNOME (GNOME Display Manager ou gdm) pour gérer les sessions utilisateur. Il n'est pas nécessaire de désactiver gdm, vous pouvez simplement passer à un niveau d'exécution où gdm n'est pas actif :

  1. Tout d'abord passez en root :

    % su root
    Password:
    donnez le mot de passe root
    #

  2. Maintenant fermez toutes les applications de votre bureau et enregistrez tous les fichiers ouverts. Ensuite passez au niveau d'exécution 4 :

    # /sbin/init 4

    Votre session X devrait se fermer et vous devriez retourner au prompt de la console.

  3. Maintenant passez à la section Lancer la session bureau du Projet Looking Glass

Note : Pour relancer le gestionnaire d'affichage GNOME, lancez la commande suivant en tant que root depuis la console :

# /sbin/init 5

Fedora Core 3 64-bit:

Le lancement du Projet Looking Glass en plein écran sur la version 64 bits de Fedora Core 3 nécessite quelques changements spécifiques. Remarquez que vous aurez besoin d'accéder à un système Linux 32 bits ou aux modules X11 32 bits pour Linux afin de suivre ces instructions.

  1. Vous devez copier le contenu du dossier /usr/X11R6/lib/modules d'un système Linux 32 bits dans le même dossier sur votre système 64 bits. Avant d'effectuer cette action, sauvegardez le contenu du dossier /usr/X11R6/lib/modules de votre système 64 bits :

    # cd /usr/X11R6/lib
    # cp -r modules modules.orig

    Maintenant, utilisez la commande scp pour copier de façon sécurisée les fichiers du système 32 bits à celui 64 bits :

    # scp -r root@32bithost:/usr/X11R6/lib/modules /usr/X11R6/lib/modules

    32bithost est le nom d'hôte du système Linux 32 bits.

  2. Vérifiez que votre fichier xorg.conf est configuré pour une profondeur d'affichage de 24 bits comme affiché en gras ci-dessous :

    Section "Screen"
    Identifier "Screen0"
    Device "Videocard0"
    Monitor "Monitor0"
    DefaultDepth 24
    SubSection "Display"
    Viewport 0 0
    Depth 24
    Modes "1680x1050" "1280x800" "1024x768" "800x600" "640x480"
    EndSubSection
    EndSection

  3. Effectuez les instructions de la section suivant pour lancer la session plein écran.

    [Les instructions de cette section sont la propriété de qgonjon et marve. Voyez ce fil de discussion.]

Lancer la session bureau du Projet Looking Glass

Pour lancer une session bureau du Projet Looking Glass depuis la console (pas depuis une session X) :

  1. Passez en root et allez dans le dossier où vous avez installé le Projet Looking Glass :

    # cd /home/username/lg3d/bin

  2. Lancez la session bureau du Projet Looking Glass :

    # ./lg3d-session

    Après quelques secondes, le bureau du Projet Looking Glass devrait apparaître. Félicitation ! Si vous avez des problèmes pour lancer la session bureau, consultez la section dépannage pour obtenir une assitance.

Explorez le bureau du Projet Looking Glass et commencez à rêvez à de nouvelles façons d'améliorer l'expérience de l'utilisateur du bureau avec la 3D ! Quand vous serez prêt à développer, allez consulter le Guide du développeur du Projet Looking Glass pour des informations à propos du développement avec LG3D.

5. Assistance

Pas de pointeur

Ceci arrive sur la Fedora Core 2, et pourrait se produire aussi sur d'autres configurations. Un contournement connu (de sgiunchi) est de lancer les commandes suivantes (en tant que root) :

# ln -s /etc/X11/xorg.conf /etc/X11/XF86Config-4

ndT : ces instructions me semblent complètement obsolètes, je ne les traduis donc pas... The correct long term fix is to upgrade the X11 release which is included in lg3d-core. It is currently an Xorg 6.7 pre-release and it needs to be upgraded to the latest Xorg stable release.

Exception in thread "main" java.lang.UnsatisfiedLinkError: /usr/java/jdk1.5.0/jre/lib/i386/libj3dcore-ogl.so:
/usr/java/jdk1.5.0/jre/lib/i386/libj3dcore-ogl.so: symbol glMultiDrawArraysEXT, version LIBGL not defined in file libGL.so.1 with link time reference

Cette erreur apparaît avec les pilotes des cartes ATI où l'extension glMultiDrawArraysEXT manque. La solution à ce problème est de remplacer le pilote des cartes Radeon par le pilote du projet Direct Rendering Open Source (DRI). Pour des instructions sur l'installation des pilotes de rendu direct, veuillez consulter le guide d'installation du pilote DRI pour les ATI Radeon.

Remarquez que mettre à jour libGL.so à la dernière version des librairies Mesa ne résoud pas ce problème.

pkill: 27863 - Operation not permitted
java.rmi.server.ExportException: Port already in use: 1099; nested exception is:
      java.net.BindException: Address already in use...

Ce message indique qu'un processus rmiregistry est déjà lancé que que lg3d-dev a été incapable d'en lancer une nouvelle instance. Habituellement, cela se produit quand le processus rmiregistry a été lancé par root et que lg3d-dev est lancé par un utilisateur non-root. La solution à ce problème est d'arrêter l'instance lancée par root de rmiregistry. Passez en root et quittez le processus :

% su root
Password: donnez le mot de passe root
# pkill rmiregistry
# exit

Maintenant relancez la commande lg3d-dev en tant qu'utilisateur non-root afin de lancer le Projet Looking Glass.

Fatal Server error: Cannot establish any listening sockets

Le message suivant est affiché quand vous lancez le Projet Looking Glass en utilisant lg3d-session:

_XSERVTransSocketUNIXCreateListener: ...SocketCreateListener() failed
_XSERVTransMakeAllCOTSServerListeners: server already running

Fatal server error:
Cannot establish any listening sockets - Make sure an X server
isn't already running

Tout d'abord, vérifiez que vous n'avez pas une session X11 lancée sur l'affichage sur lequel vous lancez lg3d-session. Ensuite vérifiez si vous avez un fichier /tmp/.X11-unix/X0 laissé par une session précédente. Pour résoudre le problème, supprimez ce fichier et relancez lg3d-session.

Les mises à jour de l'écran sont vraiment lentes

Ceci signifie habituellement que l'accélération graphique n'est pas configurée correctement. Voici quelques choses à vérifier avant tout :

libGL error: failed to open DRM: operation not permitted

(Cette erreur peut apparaître en utilisant lg3d-dev).

Si le Projet Looking Glass fonctionne vraiment lentement, même si l'accélération 3D est activée, vérifiez si les messages d'erreur suivants apparaissent dans la console :

libGL error: failed to open DRM: Operation not permitted
libGL error: reverting to (slow) indirect rendering

Cela signifie que votre compte utilisateur n'a pas les permissions pour utiliser DRI (infrastructure de rendu direct). Dans certains cas seul root est autorisé à utiliser le rendu direct. Ce problème semble n'affecter que les utilisateurs de RedHat et pas ceux de JDS/SuSE. Si vous avez ce problème, vous devez modifier les permissions DRI dans votre fichier XFree86Config ou XF86Config en :

Section "DRI"
Group "video"
Mode 0666
EndSection

Vous devrez aussi modifier les permissions du profil <dri> dans /etc/security/console.perms de 0600 à 0666:

<xconsole> 0600 <dri> 0666 root

et si vous utilisez une carte NVIDIA, modifiez les permissions sur /dev/nvidia* en 0666:

# chmod a+rw /dev/nvidia*

An unexpected exception has been detected in native code outside the VM

Le Projet Looking Glass quitte avec l'exception suivante, même si vous avez vérifié que vous avez activé l'accélération 3D :

An unexpected exception has been detected in native code outside the VM.
Unexpected Signal : 11 occurred at PC=0x0
Function=[Unknown.]
Library=(N/A)

Vérifiez si les messages suivants apparaissent dans le texte de l'exception :

<addr-range> r-xp 00000000 03:05 61763 /usr/lib/GL/libGL.so.1.3.mesasoft
<addr-range> rw-p 001b4000 03:05 61763 /usr/lib/GL/libGL.so.1.3.mesasoft

Si oui, vous avez les librairies MESA pour l'OpenGL logiciel installées. Utilisez le gestionnaire de paquet de votre distribution (par exemple rpm) pour les supprimer et allez ensuite en tant que root dans /usr/lib et vérifiez que les liens symboliques suivants existent et pointent vers les bonnes librairies OpenGL. Vous devriez avoir des liens qui ressemblent à ceci (avec x et y des nombres) :

libGLcore.so.1 -> libGLcore.so.1.x
libGL.so -> libGL.so.x
libGLU.so -> libGLU.so.x.y.z

Si ces liens sont incorrects, passez en root et créez les. Par exemple, si vous avez un fichier libGLU.so.1 mais pas de lien libGLU.so link, alors créez ce dernier :

# ln -s /usr/lib/libGLU.so.1 /usr/lib/libGLU.so

Repétez cette opération pour chacun des liens manquants.

Failed to load the NVIDIA driver

Il y a plusieures raisons pour que le pilote n'arrive pas à s'initialiser correctement :

Consultez aussi :

Notes de version pour développeur du Projet Looking Glass

Plus d'informations sur les problèmes actuels et les bugs peuvent être trouvés sur lg3d-core Project Tools > Issue tracker. Vous pouvez chercher un bug ou un problème spécifique.

6. Rester connecté avec le Projet Looking Glass

Le Projet Looking Glass évolue continuellement. La meilleure façon pour rester informé de ses développements est de s'inscrire aux mailing lists du projet. Cliquez sur Mailing lists dans la section Project tools de la barre latérale sur https://lg3d.dev.java.net/. Il y a de nombreuses mailing list, choisissez celles correspondant à votre niveau d'intéressement.

7. Quelques derniers mots

Merci pour votre implication dans le Projet Looking Glass ! Nous attendons avec impatience vos contibutions à cet excitante expérience pour un nouveau bureau !

L'équipe de développement du Projet Looking Glass

Consultez aussi :

Notes de version pour développeur du Projet Looking Glass
Guide du développeur du Projet Looking Glass
Installer et configurer les pilotes de matériel pour Looking Glass


$Revision: 1.3 $ $Date: 2005/04/15 17:52:29 $