Configuring the Ryzom API
You will need to configure the Ryzom API before you configure the Ryzom App, as the App is dependent upon the API. |
Configuring the Web Server
First you will need to create a new virtual host for the web server. It is important to note that the Ryzom API and App make the assumption that you will have a fully qualified sub-domain associated with each of them. It is not tested on a local installation at this point.
First create your new vitrual host configuration in Apache.
###################### # Ryzom API Site # ###################### <VirtualHost *:80> <Directory "/home/username/ryzom/code/web/"> Options -Indexes FollowSymLinks MultiViews IndexOptions FancyIndexing FoldersFirst NameWidth=* AllowOverride All Order allow,deny Allow from all </Directory> ServerAdmin admin@localhost DocumentRoot /home/username/ryzom/code/web/api ServerName api.domain.org </VirtualHost> |
Configuring the API
Next you will need to copy the default configuration files for use:
Modify the Server Config
You will need to modify the following variables in the server/config.php file:
You will need to modify the following code in the common/config.php file so that the URL matches where your API and App will be hosted:
We still need documentation regarding:
|
Configuring the Ryzom App
Configuring the Web Server
First you will need to create a new virtual host for the web server. It is important to note that the Ryzom API and App make the assumption that you will have a fully qualified sub-domain associated with each of them. It is not tested on a local installation at this point.
First create your new vitrual host configuration in Apache.
####################### Ryzom App Site #######################<VirtualHost *:80> <Directory "/home/username/ryzom/code/web/"> Options -Indexes FollowSymLinks MultiViews IndexOptions FancyIndexing FoldersFirst NameWidth=* AllowOverride All Order allow,deny Allow from all </Directory> ServerAdmin admin@localhost DocumentRoot /home/username/ryzom/code/web/app # The client hardcodes /start/ for WebIG sessions: Alias /start/ /home/username/ryzom/code/web/app ServerName app.domain.org</VirtualHost> |
Configuring the App
Next you will need to copy the default configuration file for use:
Once copied you will want to edit it and define the RYAPP_URL variable.
Build the Database
You will need to execute two scripts to build the basic API database and the test application database.
Next execute the following to grant the webdb user access, using the values you set earlier in the setup. First open MySQL up and then execute the following:
You will need to add or modify the following configuration variables to match your shard's virtual hosts:
WebIgMainDomain = "app.domain.org"; // These are the domains which the client is allowed to execute Lua code from. WebIgTrustedDomains = { "shard.domain.org", "app.domain.org", "api.domain.org" } |
Problem: If you receive the following error:
PHP Notice: Use of undefined constant RYAPI_WEBDB_PASS - assumed 'RYAPI_WEBDB_PASS' in /home/username/ryzomcore/web/api/common/db_lib.php on line 136 |
Solution: You need to ensure that the RYAPI_MODE is set to server. The client mode is intended for remote third-party API use.
Problem: When you go to the login screen you see the input boxes with a black background but no images.
Solution: In your api/common/config.php and your app/config.php ensure that the URL fields have a trailing slash, e.g. http://api.domain.org/