Manuel de l'installeur Ryzom

From Ryzom Forge Wiki

Revision as of 21:51, 18 October 2016 by Krill (talk | contribs) (Traduction jusqu'au problème n°7 inclus)
Jump to: navigation, search

WIP

Flag-DE

Übersetzung , bitte.

Flag-ES

Traducción, por favor.

Flag-FR

Pour vérifier la qualité du texte technique

Flag-RU

перевод, пожалуйста.


Ryzom Wiki: Ryzom Commons | DE • EN • ESFRRU | Ryzom Forge

1 Qu'est-ce que l'installateur Ryzom ?

L'"Installateur Ryzom" est un nouvel outil pour gérer la migration de la version 2.1 à la 3.0. Il a été créé car le client 2.1 ne supporte pas toutes les plateformes (il ne supporte que Windows 32 bits) et car il est installé au "mauvais" endroit (un MMORPG ne devrait pas être installé dans le C:\Program Files car ce répertoire n'est pas inscriptible pour un utilisateur normal et nécessite des droits d'administrateur).

On l'appelle "Installateur" parce qu'il peut être utilisé pour installer Ryzom à partir de rien et de télécharger les données nécessaires.

2 Comment fonctionne l'Installateur Ryzom ?

La première fois qu'un joueur avec le client en version 2.1 lance le jeut, c'est l'Installateur qui se lance au lieu du client. Il détecte qu'il doit migrer les données existantes et les copie dans un nouvel emplacement (où l'utilisateur peut écrire). Après la migration, il affiche un simple dialogue avec le choix du "profil" (un profil par défaut est créé pendant la migration) et permet de cliquer sur Jouer ou Configurer.

Une fois ceci fait, le joueur peut lancer Ryzom comme d'habitude en cliquant sur une icône ou en utilisant l'Installateur.

Q : Combient de temps dure la migration ?
R : Juste le temps nécessaire à la recopie des fichiers.
Q : Certains ont encore un client plus ancien que la 2.1, comme un 2.0 sur Mac ou même encore plus vieux. Ceux-ci sont-ils également pris en charge ?
R : L'installateur ne patche que les clients Windows car aucun autre client n'utilise le système de patch officiel. Les clients Windows 2.0 patchent en 3.0 via l'Installateur. Si un patch fonctionne, il patche, même sur ces clients 1.x. Ça ne changera rien. Pour les joueurs sous Linux ou OS X, ils devront télécharger l'Installateur. Dans tous les cas, tous les joueurs qui utilisatent des clients bêta seront migrés automatiquement, sans avoir besoin de l'Installateur.

3 Fichier de configuration utilisé ou créé par l'Installateur Ryzom

Chaque choix de l'utilisateur est sauvegardé dans un fichier de configuration appelé ryzom_installer.ini. Vous pouvez ouvrir https://bitbucket.org/ryzom/ryzomcore/src/05465687c514be172eadb4d39d670714219d4558/code/ryzom/tools/client/ryzom_installer/res/ryzom_installer.ini?at=compatibility-develop&fileviewer=file-view-default avec votre navigateur pour voir son contenu par défaut. Ce fichier est intégré dans le binaire de l'Installateur Ryzom et copié dans C:\Users\<your name>\AppData\Local\Ryzom même si vous choisissez un emplacement différent pendant votre migration.

Après la création du profil par défaut (à la fin de la migration), son contenu devrait ressemler à ça :

   version=3
   
   [common]
   language=fr
   source_directory=
   installation_directory=C:/Users/Kervala/AppData/Local/Ryzom
   use_64bits_client=true
   should_uninstall_old_client=true
   installer_filename_windows=ryzom_installer_qt_r.exe
   installer_filename_osx=RyzomInstaller.app/Contents/MacOS/RyzomInstaller
   installer_filename_linux=ryzom_installer_qt
   
   [product]
   name=Ryzom
   publisher="Winch Gate Property Limited"
   url_about=http://ryzom.com/?lang=$LANG
   url_help=http://app.ryzom.com/app_forum/index.php?page=topic/view/22047/1&post149889=$LANG#1
   comments=Science-fantasy MMORPG
   
   [servers]
   size=1
   
   [server_0]
   id=ryzom_live
   name=Atys
   display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
   files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
   data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
   data_download_filename=ryzom_live_data.7z
   data_compressed_size=1500000000
   data_uncompressed_size=7000000000
   client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
   client_download_filename=ryzom_live_client_$ARCH.7z
   client_filename_windows=ryzom_client_r.exe
   client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
   client_filename_linux=ryzom_client
   client_filename_old_windows=client_ryzom_rd.exe
   configuration_filename_windows=ryzom_configuration_qt_r.exe
   configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
   configuration_filename_linux=ryzom_configuration_qt
   comments=
   
   [profiles]
   size=1
   default=0
   
   [profile_0]
   id=0
   name=Ryzom (Atys)
   server=ryzom_live
   executable=
   arguments=
   comments=Default profile created by Ryzom Installer
   desktop_shortcut=true
   menu_shortcut=true
   
  • La section [product] contient des détails sur Ryzom qui seront utilisés dans "App/Remove programs" et d'autres emplacements.
  • Les sections [server_X] contienne les fichiers nécessaires au serveur, les fichiers à copier, l'espace nécessaire, etc... :) Pour le moment, seul ryzom_live (Atys) est supporté.
  • Les [profiles] sont sauvegardés dans différentes sections [profile_X] avec un numéro.
Q : Dans la fenêtre d'édition du profil, on peut encore ajouter des informations du profil en tant qu'arguments pour se connecter automatiquement ? Comme dans un raccourci ?
R : Tout à fait. Et ça mettra à jour les raccourcis s'ils son cochés. Si vous avez plusieurs comptes, ce sera utile. Vous pouvez même choisir un autre client et il affichera sa version. Cela peut être utile si vous voulez utiliser un client DEV par exemple.

L'Installateur Ryzom permet de modifier ce fichier facilement, mais il est toujours bon de comprendre où sont stockées les données des utilisateurs et leur contenu :

  • Les fichiers patchés (client, données, etc...) sont situés dans le répertoire que vous aez choisi pendant la migration ou, par défaut, C:\Users\<your name>\AppData\Local\Ryzom\ryzom_live (là où ryzom_live est l'ID du serveur).
  • Les fichiers utilisateurs ((client.cfg, client.log, user, save, screenshots, music, etc...) sont situés dans C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id>
Q : On peut choisir de les installer ailleurs ?
R : Oui. On peut mettre les données du client où on veut.
L'emplacement qui peut être changé est celui pour C:\Users\<your name>\AppData\Local\Ryzom, C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> ne peut pas être modifié. Peut-être plus tard... Sous Windows, "Local" correspond à des données globales spécifiques à la machine utilisée, "Roaming" contient des données utilisateurs qui doivent être copiées sur chaque machine à laquelle l'utilisateur se connecte (ce qui se justifie dans le cas d'un réseau Windows utilisant un domaine).
Q : Quel est le but de cette structure ?
R : Pouvoir avoir plusieurs fichiers de données pour chaque serveur (Atys, Yubo, Kaghanat, Tempest in the Aether, etc) et plusieurs clients/comptes. Donc si vous avez 4 comptes sur Atys, vous aurez un serveur (ryzom_live) et quatre profils (0, 1, 2, 3) avec des client.cfg différents et des fichiers utilisateurs distincts. Et vous pourrez jouer en même sans avoir quatre copies de toutes les données. Les emplacements de fichiers et du ryzom_installer.ini seront différents sur chaque plateforme.
Q : Pourquoi ne pas tout stocker dans le répertoire où est le jeu ?
R : Parce qu'il faut centraliser le fichier de configuration de l'Installateur Ryzom, ou l'Installateur Ryzom ne le trouvera pas s'il est lancé depuis ailleurs.
Q : Comment puis-je trouver l'endroit où sont situés mes copies d'écran, mon client.fg ou mon client.log ?
R : C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> où 'AppData' est généralement un dossier caché. Il y a au moins trois façons d'ouvrir ce répertoire et de continuer jusqu'à votre emplacement :
*#Ouvrir l'Installateur Ryzom, aller dans Préférenes -> Profils, choisir votre profil à gauche, cliquer sur 'Ouvrir' à côté du 'Répertoire' dans la partie droite.
*#Ouvrir l'Explorateur Windows, entrer %AppData% dans la barre d'adresse, et presser Entrée..
*#Ouvrir l'Explorateur Windows, ouvrir votre répertoire C:\, cliquer sur 'Organiser', choisir l'option 'Dossiers et Recherhe', choisir l'onglet 'Affichage' dans la nouvelle fenêtre. Dans 'Fichiers et dossiers' -> 'Fichiers et dossiers caché', choisir l'option pour 'Afficher les fichiers et dossiers cachés'. Cliquer sur 'OK', et à partir de maintenant, vous pourrez toujours trouver et ouvrir le répertoire AppData.((A vérifier par quelqu'un qui a Windows))
Pour Windows XP, l'emplacement est :
C:\Documents and Settings\yourname\Application Data\Ryzom\0

4 Conseils

  • Ne décompressez jamais manuellement les fichiers 7z que vous avez téléchargés.
  • ryzom_live_data.7z et ryzom_live_client_win32.7z (ou ryzom_live_client_win64.7z) doivent restés non modifiés.
  • Ne lancez jamais ryzom_client_patcher.exe vous-mêmes.

5 Version Linux de l'Installateur Ryzom

La version Linux de l'Installateur Ryzom est disponible sur http://ryzom.com (cliquez simplement sur le logo Linux pour la télécharger).

Vous obtiendrez un ryzom_installer_linux.tar.bz2 à décompresser : il créera un répertoire ryzom_installer_linux directory avec les versions 32 et 64 bits de l'Installateur et un script a ryzom_installer_linux.sh script qui lancera le bon Installateur en fonction de votre plateforme.

Choisissez où vous voulez instaler les données et le client Ryzom (par défaut dans ~/.local/share/Ryzom), attendez jusqu'à ce qu'il ait téléchargé et décompressé tous les fichiers.

Si vous voulez utiliser vos interfaces, configurations, etc... il vous faut juste les copier dans ~/.local/share/Ryzom/0

Si vous avez une message d'erreur 307, téléchargez simplement :

Vous devriez avoir des entrées "Installateur Ryzom" et "Ryzom (Atys)" dans votre menu d'applications.

Si Ryzom ne veut pas démarrer, il est possible que vous deviez installer OpenAL sur votre distribution (vous pouvez le vérifier en essayant de le lancer par ligne de commande).

Pour démarrer Ryzom (et utiliser votre premier profil) depuis les lignes de commande, vous pouvez utiliser : ~/.local/share/Ryzom/ryzom_live/ryzom_client -p 0

6 Comment supprimer l'Installateur et les fichiers ?

Allez dans "Ajouter/supprimer programmes", il devait lancer l'Installateur en mode Désinstaller et vous permettre de choisir les composants que vous voulez désinstaller.

Si quelque chose se passe mal, il vous faudra peut-être vérifier les emplacements suivants :

  • Sous Windows XP :
  • C:\Documents and Settings\<user name>\Local Settings\Application Data\Ryzom
    • C:\Documents and Settings\<user name>\Application Data\Ryzom
  • Souw Windows Vista et plus :
    • C:\Users\<user name>\AppData\Local\Ryzom
    • C:\Users\<user name>\AppData\Roaming\Ryzom

7 Divers problèmes et leur solution

1 Que vérifier et demander si un joueur a un problème

  • une copie d'écran de l'erreur
  • sa plateforme: Windows, Linux, OS X, 32 or 64 bits
  • une copie d'écran de C:\Program Files (x86)\Ryzom
  • une copie d'écran de C:\Users\<login>\AppData\Local\Ryzom
  • une copie d'écran de C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
  • (une copie d'écran d'un autre répertoire si l'Installateur Ryzom n'a pas été installé dans le répertoire par défaut)
  • une copie du contenu de C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini
  • une copie du contenu de C:\Users\<login>\AppData\Roaming\Ryzom\0\client.log
  • une copie du contenu de C:\Users\<login>\AppData\Roaming\Ryzom\0\client.cfg
  • une copie d'écran de C:\Users\<login>\AppData\Roaming\Ryzom\0\user content
  • (si le profil utilisé est différent de 0, remplacer le 0 par le bon numéro de profil avant)

2 L'Installateur Ryzom ne peut pas tourner et affiche une fenêtre de message d'erreur

L'Installateur Ryzom, après installation, utilise des DLLs 32 bits dans C:\Users\<login>\AppData\Local\Ryzom et l'Installateur Ryzom du C:\Users\<login>\AppData\Local\Ryzom\ryzom_live devrait être en 64 bits si vous avez choisi un client 64 bits. Après un patch, le client copie l'Installateur Ryzom à partir de C:\Users\<login>\AppData\Local\Ryzom\ryzom_live vers C:\Users\<login>\AppData\Local\Ryzom et les DLLs du C:\Users\<login>\AppData\Local\Ryzom peuvent donc être incompatibles avec l'Installateur Ryzom copié :( La solution temporaire est de copier msvcp100.dll, msvcr100.dll et ryzom_installer_qt_r.exe depuis C:\Users\<login>\AppData\Local\Ryzom\ryzom_live dans C:\Users\<login>\AppData\Local\Ryzom. Ce problème sera réglé au prochain patch.

3 L'Installateur Ryzom semble bloqué

Si l'Installateur Ryzom semble bloqué, ce peut être parce qu'il y a eu une version précédente de l'Installateur Ryzom qui n'a pas été correctement désinstallée or si le joueur a déplacé des répertoires et que le fichier de configuration est devenu invalide. Dans ce cas, il est possible de le désinstaller complètement en supprimer tout le contenu de C:\Users\<login>\AppData\Local\Ryzom et C:\Users\<login>\AppData\Roaming\Ryzom mais, SVP, assurez-vous avant de ne pas avoir de fichiers que vous vouliez conserver avant de faire ça. Dans ce cas, toujours faire une sauvegarde.

4 Pas assez d'espace disque

Si vous n'avez pas assez d'espace disque, l'Installateur devrait le signaler, et vous devrez choisir un autre emplacement.

5 Erreur 6

Elle signifie que le fichier 7z téléchargé était incomplet et que l'Installateur Ryzom n'a pas pu le décompresser. La meilleure solution est de trouver le fichier dans C:\Users\<login>\AppData\Local\Ryzom et de changer son extension de .7z à .7z.part (donc juste en ajoutant .part). Si vous relancez l'Installateur Ryzom, il devrait essayer de recommencer ce fichier. Si ça prend trop longtemps, vous pouvez le télécharger manuellement (voir l'erreur 307) et le déplacer dans C:\Users\<login>\AppData\Local\Ryzom.

6 Erreur 126 sur une carte ATI/AMD

Si vous avez une carte ATI/AMD et que vous rencontrez une erreur 126 en lançant Ryzom ou la Configuration (ça ne devrait afficher que l'écran "splash" et ensuite l'erreur dans une boite de dialogue), allez dans C:\Windows\System32 et copiez atio6axx.dll dans atiogl64.dll. Après ce changement, Ryzom devrait se lancer :)

7 Erreur 307

C'est un problème avec Sourceforge.

Il faut d'abord fermer l'Installateur Ryzom.

Pour corriger, vous pouvez télécharger manuellement les fichiers nécessaires :

Les données sont toujours nécessaires et vous devrez télécharger le bon client.

Déplacez ensuite tous ces fichiers 7z dans :

  • Windows : C:\Users\<login>\AppData\Local\Ryzom
  • Linux : HOME/.local/share/Ryzom
  • OS X: HOME/Library/Application Support/Ryzom

Et relancer l'Installateur Ryzom : il devrait détecter les fichiers et les décompresser.

8 Direct3D driver / OpenGL

If player used a Direct3D driver with 2.1 client and since client.cfg will be copied, it’ll continue to use D3D. Now that OpenGL is recommended driver for all cards, players could need to switch to it manually clicking on Configure button in Ryzom Installer and select OpenGL (or Auto) instead of Direct3D.

9 point_except handler4_common could not be located in the dynamic link library msvcrt.dll

Error is The procedure entry point_except handler4_common could not be located in the dynamic link library msvcrt.dll, to fix it you need to :

  • Browse to C:\Windows\System32 folder and file this file dwmapi.dll
  • Rename this file from dwmapi.dll to dwmapi.dll_old

10 Player can't start client because of a wrong DLL

  • Edit C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini, remove the directory after *source_directory=* to be sure, it won't copy again from old client
  • Remove completely all DLLs and EXEs in C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
  • Download the right client on SourceForge (see Error 307)
  • Put it to C:\Users\<login>\AppData\Local\Ryzom (don't uncompress it!)
  • Restart Ryzom Installer
  • It should uncompress the new client and you should be able to patch and play after that

11 Case of manually move of “ryzom_life” folder

If player manually moves "ryzom_live" folder or another one, Ryzom Installer won't detect it and player will have to edit his ryzom_installer.ini

12 German players with an English Windows environment

If German player has an English Windows environment than Ryzom will start in English too, even when the user has chosen a German installation (this only chose the language for the installation process, not the language for the game itself)

13 Location of default files under all platforms

  • Windows Vista and up :
    • C:\Users\<login>\AppData\Local\Ryzom
    • C:\Users\<login>\AppData\Roaming\Ryzom
  • Windows XP :
    • C:\Documents and Settings\<login>\Local Settings\Application Data\Ryzom
    • C:\Documents and Settings\<login>\Application Data\Ryzom
  • Linux :
    • HOME/.local/share/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
  • OS X :
    • HOME/Library/Application Support/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)

14 What to do if I do not find a solution to my problem in this list?

Please come on #ryzom on IRC Freenode (direct link: http://webchat.freenode.net/?channels=ryzom and someone will help you in direct!

15 No sound when using OpenAL driver

Be sure to have installed https://www.openal.org/downloads/oalinst.zip (under Windows) or OpenAL package for your distribution (libopenal1 under Debian-based ones). OpenAL is always installed under OS X.

16 Unable to install OS X version of Ryzom Installer

  • Open System Preferences
  • Open the Security & Privacy pane
  • Select the General tab
  • Click on Open anyway next to Ryzom Installer and it'll open Ryzom Installer package

17 If there are any bug with Ryzom Installer

In all cases, if you found a bug with Ryzom Installer, you can download and install latest versions from http://ryzom.com and try it. They'll be updated regularly.

18 My download is very slow

You can close Ryzom Installer, Sourceforge should redirect to a best mirror and your download will resume.

8 White or black textures

The default quality has been improved in v3 clients. By the way, v3 clients use 128 Mo of video memory against 32 Mo for v2's ones.

The textures are sent to the graphic card's memory. If you see them in white or black, it's probably because your graphic card has not got enough memory to stock them. Moreover, if your graphic card does not support the compressed textures, Ryzom detects it and unzips them before to send them.

So in case of white or black graphic issue, please reduce the graphic qualities in Configuration (lower graphic quality and no effects), it should help to fix the problem.