Configuring and running Ryzom Core on Linux¶

• Prepare MySQL databases

mysql -uroot -p

CREATE DATABASE nel;
CREATE DATABASE nel_tool;
CREATE DATABASE ring_open;
GRANT ALL ON nel.* TO shard@localhost;
GRANT ALL ON nel_tool.* TO shard@localhost;
GRANT ALL ON ring_open.* TO shard@localhost;

• Remove STRICT_TRANS_TABLES from sql_mode in your MySQL configuration. You can check if you have it by doing

SHOW VARIABLES WHERE Variable_name='sql_mode';

• If you plan to make your shard public, consider this:

< Kaetemi> and only the SU, FS and web services should have a public ip, the other should be behind private for security reasons :)

• Change all occurences of open.ryzom.com in code/ryzom/tools/server/sql/ryzom_default_data.sql to your address (e.g. 192.168.0.1), but remember to keep ports (:4999 etc) as is.

• Popoulate databases with default data

cat code/ryzom/tools/server/sql/ryzom_tables.sql | mysql -ushard
cat code/ryzom/tools/server/sql/ryzom_default_data.sql | mysql -ushard
cat code/ryzom/tools/server/sql/ryzom_admin_default_data.sql | mysql -ushard nel_tool

• Update host for admin app. Change YOUR_ADDRESS to your address (e.g. 192.168.0.1).

USE nel_tool
UPDATE neltool_domains SET domain_as_host='YOUR_ADDRESS' where domain_id=12;

• Change FSListenHost in code/ryzom/server/frontend_service.cfg to your address (e.g. 192.168.0.1)
• Configure Apache with PHP. Make a VirtualHost for the login scripts and admin app (replace DocumentRoot with your own path).

Listen 40916
<VirtualHost *:40916>
  <Directory "/home/nevrax/code/ryzom/tools/server/">
     Options -Indexes FollowSymLinks MultiViews
     IndexOptions FancyIndexing FoldersFirst NameWidth=*
     AllowOverride All
     Order allow,deny
     Allow from all
  </Directory> 
  ServerAdmin admin@localhost
  DocumentRoot /home/nevrax/code/ryzom/tools/server/www
  ServerName localhost
</VirtualHost>
<VirtualHost *:80>
  <Directory "/home/nevrax/code/ryzom/tools/server/">
     Options -Indexes FollowSymLinks MultiViews
     IndexOptions FancyIndexing FoldersFirst NameWidth=*
     AllowOverride All
     Order allow,deny
     Allow from all
  </Directory> 
  ServerAdmin admin@localhost
  DocumentRoot /home/nevrax/code/ryzom/tools/server/admin
  ServerName localhost
</VirtualHost>

• Set NELTOOL_SITEBASE to your server address and NELTOOL_SYSTEMBASE to your path in code/ryzom/tools/server/admin/config.php.

• Make code/ryzom/tools/server/admin/graphs_output/ directory and make it writeable by all to get Hi-Res Shard graphs working in Admin tool.

mkdir -p code/ryzom/tools/server/admin/graphs_output/
chmod o+w code/ryzom/tools/server/admin/graphs_output/

• Create code/ryzom/server/save_shard/rrd_graphs/ directory.
• Run the shard. Remember to have path to the scripts in your PATH. You'll need screen app for this script.
• Ubuntu users, the 'shard/screen' scripts included will not work properly with the default 'dash' shell included in order to fix this run "sudo dpkg-reconfigure dash" and select "no". Alternatively you could modify both code/ryzom/tools/scripts/linux/shard and code/ryzom/server/shard.screen.rc and find/replace any /bin/sh to /bin/bash.

shard start