Configuring and running Ryzom Core server on GNU/Linux
...
| Panel |
|---|
sudo apt-get install apache2 php5 php5-mysql php5-gd |
Making changes in services config files
...
| Tip |
|---|
If your frontend service is available through a firewall using NAT and a mapped IP address this is how you can advertise that external IP address. For example if your FS is on 192.168.1.100 internally but your firewall maps 74.125.225.210 through to your FS you would want to configure FSListenHost to be the address the clients connect to: 74.125.225.210. |
Configuring Apache and web tools
...
| Note |
|---|
For current Ubuntu versions , you can just edit "the file default" @ in /etc/apache2/sites-available/ - substituting what is listed below for what is already there. . It may be helpful to break this into multiple site configuration files but isn't necesasry. |
| Warning | ||
|---|---|---|
| Column | | |
| ||
| Section | ||
match where your source is checked out! |
| Panel | ||||
|---|---|---|---|---|
| ||||
Listen 40916
<VirtualHost *:40916>
<Directory "/home/username/ryzom/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/username/ryzom/code/ryzom/tools/server/www
ServerName localhost
</VirtualHost>column | ||||
|
| Panel | ||||
|---|---|---|---|---|
| ||||
<VirtualHost *:80>
<Directory "/home/username/ryzom/code/ryzom/tools/server/">
Options -Indexes FollowSymLinks MultiViews
IndexOptions FancyIndexing FoldersFirst NameWidth=*
AllowOverride All
Order allow,deny
Allow from all
</Directory>
ServerAdmin admin@localhost
# You can change this if you want. DocumentRoot /home/username/ryzom/code/ryzom/tools/server/admin # Admin Tool Alias /admin/ /home/username/ryzom/code/ryzom/tools/server/admin ServerName localhost </VirtualHost> |
| Section | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
- Restart Apache by typing the following.
| Tip |
|---|
You can place these into the same configuration file or separately, it's up to you. If you want to serve up some unique content, a signup page or something along those lines you can change the main website's DocumentRoot so long as the admin tool alias is still there. |
| Info | ||
|---|---|---|
| ||
|
| Note |
|---|
In order to execute system commands like restarting services you will need to be able to log in as root or execute the command using sudo, e.g.: sudo /etc/init.d/apache2 restart |
...
Note: If you are using ubuntu 10.4 you will need to type.
...
- Restart Apache by typing the following.
/etc/init.d/apache2 restart
...
cd code/ryzom/tools/server/admin/templates/ cp -r default default_c chmod a+w default_c
Setting up MySQL
...
| Note |
|---|
The configuration files in code/ryzom/server expect your user to be named 'shard' with NO PASSWORD. If you decide to use a different name for your MySQL user, or assign it a password, you will need to go through the .cfg files and change these values from 'shard' and "" wherever they appear. (they appear in several of the .cfg files) Since this (and a password) can lead to unexpected errors (eg. error '4000' |
...
) it |
...
is best to make sure everything works |
...
correctly with the defaults first. |
| Warning | ||
|---|---|---|
|
...
If you |
...
are getting strange errors |
...
some config files may have Windows editor "control-M" endline characters, which appears as a blue ^M in vim. You can remove it with this vi command |
...
, noting that ^M is |
...
typed by pressing Ctrl+V followed by Ctrl+M |
...
: ryzom/code# find . -name "*.cfg" -name "*.php" | xargs grep -l '^M'
vim <listed filename> # if there are none, Vim will gladly eat your shell if you xargs it
:%s/^M//g |
...
You may also skip this section and use the next section entitled "Setting up MySQL (Alternative)". It condenses all the steps listed below into a pre-generated MySQL file that you import.
...
/home/ryzom/code/ryzom/server/save_shard/rrd_graphs
Import in phpMyAdmin.
Running the shard
- Make sure $RYZOM_PATH is set correctly: export RYZOM_PATH="/home/user/ryzom/code/ryzom"
...
| Panel | ||||
|---|---|---|---|---|
| ||||
cp ./build/bin/ryzom_admin_service $RYZOM_PATH/server/src/ryzom_admin_service/ryzom_admin_service cp ./build/bin/ryzom_ai_service $RYZOM_PATH/server/src/ai_service/ai_service cp ./build/bin/ryzom_backup_service $RYZOM_PATH/server/src/backup_service/backup_service cp ./build/bin/ryzom_dynamic_scenario_service $RYZOM_PATH/server/src/dynamic_scenario_service/dynamic_scenario_service cp ./build/bin/ryzom_entities_game_service $RYZOM_PATH/server/src/entities_game_service/entities_game_service cp ./build/bin/ryzom_frontend_service $RYZOM_PATH/server/src/frontend_service/frontend_service cp ./build/bin/ryzom_gpm_service $RYZOM_PATH/server/src/gpm_service/gpm_service cp ./build/bin/ryzom_ios_service $RYZOM_PATH/server/src/input_output_service/input_output_service cp ./build/bin/ryzom_log_analyser_service $RYZOM_PATH/server/src/log_analyser_service/log_analyser_service cp ./build/bin/ryzom_logger_service $RYZOM_PATH/server/src/logger_service/logger_service cp ./build/bin/ryzom_mail_forum_service $RYZOM_PATH/server/src/mail_forum_service/mail_forum_service cp ./build/bin/ryzom_mirror_service $RYZOM_PATH/server/src/mirror_service/mirror_service cp ./build/bin/ryzom_naming_service $RYZOM_PATH/server/src/ryzom_naming_service/ryzom_naming_service cp ./build/bin/ryzom_pd_support_service $RYZOM_PATH/server/src/pd_support_service/pd_support_service cp ./build/bin/ryzom_persistant_data_service $RYZOM_PATH/server/src/persistant_data_service/persistant_data_service cp ./build/bin/ryzom_reference_builder_service $RYZOM_PATH/server/src/pd_reference_builder/pd_reference_builder cp ./build/bin/ryzom_session_browser_service $RYZOM_PATH/server/src/session_browser_server/session_browser_server cp ./build/bin/ryzom_shard_unifier_service $RYZOM_PATH/server/src/shard_unifier_service/shard_unifier_service cp ./build/bin/ryzom_tick_service $RYZOM_PATH/server/src/tick_service/tick_service cp ./build/bin/ryzom_welcome_service $RYZOM_PATH/server/src/ryzom_welcome_service/ryzom_welcome_service |
You'll need to install the GD module for php5 before rrdtool will work properly:
...
- Remember to have path to the scripts in your PATH. You'll need screen app for this script.
(Great screen how-to at: http://www.rackaid.com/resources/linux-screen-tutorial-and-how-to/ )
...
momentarily pressing "ctrl" and "a" together and then press "n" to cycle through.Client login errors
- If your client gives you error messages on connect, check Client Connect Errors.
Notes
If you want to use your shard with the core client, you will have to copy the following file into code/ryzom/common/data_common:
...