For Debian/Ubuntu users you will need to install the following packages:
sudo apt-get install apache2 php5 php5-mysql php5-gd rrdtool screen |
code/ryzom/server/frontend_service.cfg
to your address (e.g. 192.168.0.1). If you set up server on different machine, remember it has to be address that's reachable on client host.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. |
/etc/apache2/httpd.conf
) for the login scripts and admin app (replace DocumentRoot with your own path).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. |
Don't forget to change the paths used below to match where your source is checked out! |
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> |
<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> |
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. |
|
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 |
/etc/init.d/apache2 restart
code/ryzom/tools/server/admin/config.php
.code/ryzom/server/save_shard/rrd_graphs/
directory.mkdir -p code/ryzom/server/save_shard/rrd_graphs/
code/ryzom/tools/server/admin/graphs_output
directory is writeable by all.chmod a+w code/ryzom/tools/server/admin/graphs_output
code/ryzom/tools/server/www/login/config.php
(NOTE: log directory has to be writeable by webserver and it's not wise to give it write access to the directory where script is.)$LogRelativePath = 'logs/';
code/ryzom/tools/server/www/login/logs/
directory and make it writeable by all for login script logs.mkdir -p code/ryzom/tools/server/www/login/logs/ chmod a+w code/ryzom/tools/server/www/login/logs/
cd code/ryzom/tools/server/admin/templates/ cp -r default default_c chmod a+w default_c
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. |
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:
|
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.
SHOW VARIABLES WHERE Variable_name='sql_mode';
SET @@global.sql_mode= '';
* Login to the MySQL database server using the command line: 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; FLUSH PRIVILEGES; |
If you use different usernames and password for database, you need to change the following files:
|
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.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
USE nel_tool; UPDATE neltool_domains SET domain_as_host='YOUR_ADDRESS' where domain_id=12;
If you plan to make your shard public only the SU, FS and web services should have a public IP. The other services should all be behind a firewall for security reasons. |
If you're running on Ubuntu or Debian, the default shell is actually dash and the shard/screen scripts will not run correctly in dash. The steps following will have you switch to bash. If you want to keep using dash as the default shell then you will need change the shebang from /bin/sh to /bin/bash in the following files:
|
Great screen how-to at: http://www.rackaid.com/resources/linux-screen-tutorial-and-how-to/ |
# if you're on Ubuntu or Debian - disable dash: [[ `lsb_release -si` = 'Ubuntu' ]] || [[ `lsb_release -si` = 'Debian' ]] &&\ # Change your selection to 'no' so it uses bash instead. sudo dpkg-reconfigure dash echo "export RYZOM_PATH=/home/user/ryzom/code/ryzom" >> ~/.bashrc echo "export PATH=$PATH:$RYZOM_PATH/tools/scripts/linux" >> ~/.bashrc source ~/.bashrc |
|
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: