Difference between revisions of "DIRTSAND:Getting Started"
(No difference)
|
Revision as of 22:14, 14 May 2012
This tutorial will help you set up your own fully-functional shard using DIRTSAND, a server software for MO:UL clients by H'uru.
Contents
Prerequisites
You'll need a few tools to compile and set up DIRTSAND. Most of these consist of development libraries (frequently suffixed with -dev in repositories):
- GCC 4.6+ (other C++11-compliant compilers might work, but haven't been tested),
- PostgreSQL: you will need both the libraries (for compiling) and the database server (for the vault),
- OpenSSL (libssl),
- libreadline,
- zlib,
- git: used to acquire the source code for DIRTSAND,
- cmake: used to create the makefiles for GCC 4.6+.
Additionally, a client to test the working status would be useful. See the getting started guide for help on this subject. Your client will need to be able to connect to port 14617, so you might have to open it up on your firewall.
Finally, it is recommended that you create a UNIX user to run DIRTSAND with an associated home directory containing DIRTSAND:
sudo useradd dirtsand -d /opt/dirtsand -m -p <password> -s /bin/bash
Compiling
The first step is to download and compile DIRTSAND for your system; make sure you have all the appropriate libraries installed. First, clone the H'uru repository:
git clone git://github.com/H-uru/dirtsand.git dirtsand cd dirtsand
Once you have the sources, you'll need to run CMake and G++ to compile the code:
mkdir build && cd build cmake -DCMAKE_INSTALL_PREFIX=/opt/dirtsand .. make && sudo make install cd ..
If your system complains about missing libraries but you have installed them, you can use the CMake GUI to point to the libraries' location.
Database Setup
You will need a PostgreSQL server which DIRTSAND can access with a user capable of adding schemas, tables, etc. into. For the proposed installation here, a dirtsand
database with ownership set to a dirtsand
user (such as the one created beforehand in this tutorial).
sudo -u postgres psql -d template1 template1=# CREATE USER dirtsand WITH PASSWORD '<password>'; template1=# CREATE DATABASE dirtsand WITH TEMPLATE = template0 ENCODING = 'UTF8'; template1=# ALTER DATABASE dirtsand OWNER TO dirtsand; template1=# \q
The next step is to enable UUID functionnality for PostgreSQL. The technique for this varies depending on PostgreSQL's version. Until PostgreSQL 9.1, the extension had to be manually loaded into PostgreSQL:
sudo -u postgres psql -d dirtsand < /path/to/uuid-ossp.sql
In Ubuntu with PostgreSQL 8.4, for example, the path is /usr/share/postgresql/8.4/contrib/uuid-ossp.sql
.
From 9.1 and onwards, you need to make sure the postgresql-contrib
package is installed (the name will vary depending on your distribution) then load the extension:
psql CREATE EXTENSION "uuid-ossp";
Now you need to load the initial structure for your DB, the SQL files being available in DIRTSAND's source code:
sudo -u postgres psql -d dirtsand < db/dbinit.sql sudo -u postgres psql -d dirtsand < db/functions.sql
Your database should now be ready.
Configuring
DIRTSAND is configured from a dirtsand.ini
file placed in the execution directory for DIRTSAND. It needs to be adjusted to connect to your database, to have all the appropriate RC4 keys, which DIRTSAND can automatically generate for you:
bin/dirtsand ds-902> keygen new ds-902> quit
After running for a bit, this will output six keys to be copied into your dirtsand.ini
file and six others into your client's server.ini
(this requires either PlasmaClient or the H'uru fork of CWE). You can safely ignore all startup errors. A sample file for dirtsand.ini
has been placed in the source directory; you need to fill it in with your keys and database details (and any other configuration details you need to fill in):
sudo cp dirtsand.sample.ini /opt/dirtsand/dirtsand.ini sudo chown dirtsand /opt/dirtsand/dirtsand.ini su - dirtsand nano dirtsand.ini
Replace the dummy values with the output under "Server keys".
You'll also have to specify the external host addresses for your DIRTSAND server (it can either be an IP number of a domain name).
Files Setup
Your server now needs to be provided with files to distribute to clients. These include SDL files, Python scripts, data files, client files, and so on.
You will need the files available from the moul-scripts repository.
WARNING: the current moul-scripts appear to be broken in some aspect which prevents GUM (see below) from generating the manifests. Until such a time as the issue is tracked down and fixed, it is recommended that you use the Gehn Shard scripts instead.
DISCLAIMER: it is currently forbidden to distribute Cyan-created content (age models, sound effects). Therefore, your clients must already have all the required data files (excluding fan content you are allowed to distribute).
Ages and SDL
You will first need to create two folders for the .age
and .sdl
files, as specified in your dirtsand.ini
configuration. Into these folders you must copy only the .age
and .sdl
files, in unencrypted form (available from the moul-scripts repo).
File Server
The file server is optional if you are using only Internal clients, but is required by External clients and to update automatically all client connecting to your server. This consists of a series of manifest files (.mfs
) of the following format:
remote_filename.ext,local_filename.ext.gz,decompressed_hash,compressed_hash,decompressed_size,compressed_size,flags
Make sure the path to the local file is specified using Windows folder separators (backslahes: "\"). The bin/dsData.sh
script can automatically generate a manifest line for a specified file. The lines must reflect the details for the encrypted versions of the files.
There is currently no official manifest generator for DIRTSAND. However, Lyrositor has provided a script for this purpose heavily based on branan's (a.k.a PaladinOfKaos) script. It is available for download here: Generator of Uru Manifests. You will need a reference installation containing the unencrypted .pak</code file and <code>.sdl
files in Python
and SDL
, along with all the files from the dat
and sfx
folders from MO:ULa. On top of the dat<code> folder, you should then copy the <code>dat
folder from moul-scripts to get the unencrypted versions. It requires Python 2.7 and libHSPlasma for Python.
Note on Python: the Python scripts need to be compressed into a Python.pak
file. This can be achieved using the plPythonPack.exe
tool obtained from compiling CWE (the tool only uses relative paths).
Running
If all went well, you can now start your server:
bin/dirtsand dirtsand.ini
And that's it. You will obtain an interactive terminal to operate DIRTSAND which will output log messages as they are printed. You might find it useful however to start DIRTSAND in a GNU screen/Byobu or X session.
Adding Accounts
You might find it difficult to connect without an account. To add one in DIRTSAND, type the following command into DIRTSAND's terminal:
addacct <username> <password>
Accounts can also be manually inserted into the DB.
Customizing
DIRTSAND allows for a certain degree of flexibility. Here are a few things you can do:
- Changing default Neighborhood names: the prefixes for Hood names is set in the DB under "game->PublicAges", in the "AgeFilename" row and in the "AgeUserName"/"AgeDesc" fields; simply edit it to change the value.
Developing
If you are interested in lending a hand to DIRTSAND's development, visit the appropriate page.