Setting Up a Shard

Revision as of 12:27, 2 August 2011 by Diafero (Talk | contribs) (start of the tutorial)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This tutorial documents the smallest possible setup for a Shard. It is intended to be used on a "normal" PC, to develop ages or the actual server and client software. You can however easily build a "production-style" Shard on top of this.

Preparation

You will need both a Windows machine for the client, and a Linux machine for the software. It is possible to do it all on one PC using a virtual machine and possible Wine, but that's beyond the scope of this tutorial.

On your Windows box, you need to

On the Linux machine

  • Set up the [[Development:DirtSand|DirtSand] server
  • Download the Python and age files (yeah, both machines need these)

Server setup

The DirtSand server is not yet quite ready, we need to give it some final touches

Encryption keys

The connection between the server and the client is always encrypted. To make this work, you need to generate the necessary keys. Don't worry, DirtSand has it all built in (the paths assume that you installed DirtSand into ~/dirtsand, which is what the installation tutorial does):

cd ~/dirtsand
bin/dirtsand # start the server, another prompt will open (you can ignore any errors)
ds-902> keygen new # This may take some time and will generate some random series of characters
ds-902> quit # quit the server, go back to the shell

Dataserver

Client setup