Revision as of 13:52, 15 October 2016

Translation requested, please.

1 What is Ryzom Installer?

"Ryzom Installer" is a new tool to handle the migration from 2.1 to 3.0. It has been created because 2.1 client doesn't support all platforms (it only supports Windows 32 bits) and it is installed in a "wrong" location (a MMORPG shouldn't be installed in C:\Program Files because this directory is not writable by a normal user and requires Administrator permissions).

It’s called "Installer" because it can be used to install Ryzom from scratch and download required data.

2 How does Ryzom Installer works?

The first time a player on version 2.1 client launches the game, it’s the Installer that launches instead of client. It detects it must migrate current data and copies them to a new location (where user can write). After the migration, it displays a simple dialog with the choice of a "profile" (a default one is created during migration) and allows to click on Play or Configure.

Once everything is done, the player is able to launch Ryzom as usual clicking on an icon or using the Installer.

Q: How much time the migration takes?
A: Only the time needed to copy the files.

Q: Some are still having an older client than 2.1, like 2.0 on Mac or even older ones. Are any of these supported here as well?
A: It patches only Windows client because no other client is using official patch system. Windows 2.0 clients patch to 3.0 using Installer. If patch is working, it patches, even with 1.x clients. It won't change anything. For Linux and OS X players, they’ll have to download the Installer. In all cases, all players who are using beta clients are migrating automatically, without the need of the Installer.

3 Configuration file used or created by Ryzom Installer

Each user choice is saved in a configuration file named ryzom_installer.ini. You can open https://bitbucket.org/ryzom/ryzomcore/src/05465687c514be172eadb4d39d670714219d4558/code/ryzom/tools/client/ryzom_installer/res/ryzom_installer.ini?at=compatibility-develop&fileviewer=file-view-default with your browser to see its default content. This file is integrated into Ryzom Installer binary and is copied in C:\Users\<your name>\AppData\Local\Ryzom even if you chose a different location during migration.

After the default profile is created (at the end of the migration), its content should be like that :

   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
   
  - [product] section contains details on Ryzom that will be used in "App/Remove programs" and other locations.
  - [server_X] sections include files required by a server, files to copy, space required, etc... :) for the moment, only ryzom_live (= Atys) is supported.
  - [profiles] are saved in different sections [profile_X] with a number.

Q: In edit profile window we still can put in login details in arguments to automatically log in? same like in a shortcut?
A: Indeed. And it'll update shortcuts if they are checked. if you have several accounts, it'll be useful. You can even choose another client and it'll display its version. It can be useful if you want to use a DEV client for example.

Ryzom Installer allows to edit this file easily, but that's always good to understand where are stored users data and their content:

• Patched files (client, data, etc...) are located in the directory you chose during migration or, by default, C:\Users\<your name>\AppData\Local\Ryzom\ryzom_live (where ryzom_live is the ID of the server).
• Users files (client.cfg, client.log, user, save, screenshots, music, etc...) are located in C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id>

Q:Can we choose to install them elsewhere?
A:Yes. We can put where we want the client data.
The location that can be changed is the one to C:\Users\<your name>\AppData\Local\Ryzom, C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> can't be changed. Perhaps later...  Under Windows, “Local“ is big data specific to current machine, “Roaming” is user data that must be copied on each machine user is connected (it makes sense in the case on a Windows network using a domain).

Q: What is the goal of this structure?
A: Being able to have several data files for each server (Atys, Yubo, Kaghanat, Tempest in the Aether, etc) and several clients/accounts. So if you have 4 accounts on Atys, you'll have one server (ryzom_live) and 4 profiles (0, 1, 2, 3) with different client.cfg and distinct user files. And you'll be able to play simultaneously without having 4 copies of whole data. The locations of files and ryzom_installer.ini will be different on each platform.

Q: Why isn't it stored in the same directory the game is?
A: Because we need to centralize the configuration file else Ryzom Installer won't find it if we launch it from elsewhere.

Q: How can I find the folder where my screenshots, client.fg or client.log are located?
A: C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> where 'AppData' is usually a hidden folder. There are at least 3 ways to open the folder and to go ahead to your location:
*#Open the Ryzom Installer, go to Settings -> Profile, choose your Profile on the left, click on 'Open' next to  'Directory' on the right side.
*#Go to Windows Explorer and type in the address bar %AppData% and press enter.
*#Go to Windows Explorer, open your C:\ drive, click on 'Organize', select 'Folder and Search' option, Select 'View' tab in the new window. Under 'Files and Folders' -> 'Hidden files and folders', select the option to 'Show hidden files, folders and drives'. Click on 'OK' and from now on you always can find and open AppData directory.
For Windows XP the location is:
C:\Documents and Settings\yourname\Application Data\Ryzom\0

4 Advices

• Never uncompress the downloaded 7z files manually.
• Both ryzom_live_data.7z and ryzom_live_client_win32.7z (or ryzom_live_client_win64.7z) must be let untouched.
• Never launch ryzom_client_patcher.exe yourself.

5 Linux version of Ryom Installer

Linux version of Ryzom Installer is available on http://ryzom.com (just click on Linux logo to download it).

You get a ryzom_installer_linux.tar.bz2 to uncompress, it'll create a ryzom_installer_linux directory with 32 and 64 bits versions of Installer and a ryzom_installer_linux.sh script that'll launch the right Installer depending on your platform.

Choose where you want to install Ryzom data and client (by default in ~/.local/share/Ryzom), wait until it downloaded and uncompress all files.

If you want to use your interfaces, configurations, etc... you just need to copy them to ~/.local/share/Ryzom/0

If you have error 307 message, just download :

• https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
• https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
• https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download

You should have "Ryzom Installer" and "Ryzom (Atys)" entries in your applications menu.

If Ryzom doesn't want to start, you may need to install OpenAL on your distribution (you can check that by trying to launch it using command-line).

To start Ryzom (and use your first profile) from command-line, you can use : ~/.local/share/Ryzom/ryzom_live/ryzom_client -p 0

6 How to remove the installer and files?

Go in "Add/Remove programs, it should launch Installer in Uninstaller mode and allow to check components you want to uninstall.

If something went wrong, you may need to check these locations :

• Under Windows XP :
• C:\Documents and Settings\<user name>\Local Settings\Application Data\Ryzom
  • C:\Documents and Settings\<user name>\Application Data\Ryzom

• Under Windows Vista and up :
  • C:\Users\<user name>\AppData\Local\Ryzom
  • C:\Users\<user name>\AppData\Roaming\Ryzom

7 Different problems and their solutions

1 What to check and to ask when a player has a problem

• a screenshot of the error
• what is their platform : Windows, Linux, OS X, 32 or 64 bits
• screenshot of C:\Program Files (x86)\Ryzom
• screenshot of C:\Users\<login>\AppData\Local\Ryzom
• screenshot of C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
• (screenshot of another directory if they didn’t install Ryzom Installer in default directories)
• copy-paste of C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini
• copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.log
• copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.cfg
• screenshot of C:\Users\<login>\AppData\Roaming\Ryzom\0\user content
• (if they used a profile different of 0, replace the 0 by the right profile ID before)

2 Ryzom Installer can't run and displays an error message box

Ryzom Installer, after installing it, is using 32 bits DLLs in C:\Users\<login>\AppData\Local\Ryzom and Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live should be in 64 bits if you chose a 64 bits client. After a patch, client is copying Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom and then DLLs in C:\Users\<login>\AppData\Local\Ryzom could be incompatible with the copied Ryzom Installer :( The temporary fix is to copy both msvcp100.dll, msvcr100.dll and ryzom_installer_qt_r.exe from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom. This will be fixed in next patch.

3 Ryzom Installer seems blocked/stalled

If Ryzom Installer seems blocked/stalled, it can be because there was a previously version of Ryzom Installer that wasn’t properly uninstalled or if player moved directories and configuration file became invalid. In this case, it’s possible to uninstall it completely by removing whole content of C:\Users\<login>\AppData\Local\Ryzom and C:\Users\<login>\AppData\Roaming\Ryzom but please be sure that player hasn’t files he would like to keep before doing that. In that case, always make a backup.

4 Not enough disk space

If players have not enough disk space, it should notify them and they'll have to chose another location.

5 Error 6

It means than the downloaded 7z file was incomplete and Ryzom Installer couldn't uncompress it. The best fix is to find the file in C:\Users\<login>\AppData\Local\Ryzom and to change its extension from .7z to .7z.part (just adding a .part). If you restart Ryzom Installer, it should try to resume the file. If it takes too long, you can download it manually (see error 307) and move it to C:\Users\<login>\AppData\Local\Ryzom.

6 Error 126 on a ATI/AMD card

If a player with an ATI/AMD card has an error 126 when launching Ryzom or Configuration (it should only display the splash screen and then the error in a dialog), you need to go to C:\Windows\System32 and copy atio6axx.dll to atiogl64.dll After this change, Ryzom should launch :)

7 Error 307

It’s a problem with Sourceforge.

First you need to close Ryzom Installer.

To fix that you can manually download the required files :

• Data : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live _data.7z/download
• Windows 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live _client_win64.7z/download
• Windows 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live _client_win32.7z/download
• Linux 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live _client_linux64.7z/download
• Linux 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live _client_linux32.7z/download
• OS X client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live _client_osx.7z/download

Data are always required and you need to download the right client.

Then you move all these 7z files in :

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

And relaunch Ryzom Installer, it should detect files and uncompress them.

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!