This guide applies to:
- Marauroa 3.0 and above
- Stendhal 0.95 and above
- 1 Setting up a localhost server
- 2 Extras
- 3 Finished
Setting up a localhost server
This guide will teach you how to set up a server on your Linux machine. The required packages are:
- A compiled version of the Stendhal Server, version 1.28
- GNU/Linux (This may be others, the directions should apply almost exactly to any *nix system)
- Command-line access (ask system administrator if it's a problem)
For easy H2 database configuration (which is shipped with Stendhal and is installation-free) just skip straight to Choosing the Java Virtual Machine.
For advanced MySQL configuration, keep reading.
Setting up MySQL
sudo apt-get install mysql-server
Also download the java connector library if necessary (it's called MySQL Connector/J ), and make sure a symbolic/soft link to it named mysql-connector.jar is on the classpath (e.g. in the directory called libs inside the stendhal_server directory) when running maraurorad later.
ln -s /path/to/file-name/mysql-connector-java-5.1.10.jar mysql-connector.jar
After you've installed MySQL, make sure you have a database ready for it. At a command line, type
mysql -u NAME -p
if you need a password for your server (by default, you don't). If you don't need a password, omit the "-u NAME -p" part. At the prompt that appears, type
create database marauroa; grant all on marauroa.* to 'FOO'@'localhost' identified by 'BAR';
FOO and BAR are the username and password to be used by Marauroa, respectively. Replace them with whatever you want. If the user doesn't exist, it will be created. Remember these values (FOO and BAR)! If you get a problem like:
ERROR 1044 (42000): Access denied for user 'FOO'@'localhost' to database 'marauroa'
then you need to login to mysql as the root mysql user, who should have 'grant' access. As root you can then try
grant all on marauroa.* to 'FOO'@'localhost' identified by 'BAR';
Note: It is recommended to edit the MySQL configuration file to disallow external access if you are just going to use it for local testing, or simply use a firewall to block external access to the database.
Choosing the Java Virtual Machine
Stendhal works with OpenJDK or Oracle Java, you will need Java 7 or greater.
For Sun Java: Use your Package manager to download OpenJDK 7 or Oracle Java 7 or greater version. At a command line, type
and if you see anything other than the new java you just installed, then you need to update the java used. At a command line, type
(using sudo if you are an ubuntu user, or as root if you are another linux user) which should give you output something like this:
- java-1.7.0-oracle 53 /usr/lib/jvm/java-1.7.0-oracle
- java-gcj 1042 /usr/lib/jvm/java-gcj
- java-7-openjdk 1061 /usr/lib/jvm/java-7-openjdk
now, lets say you want to use the java-7-openjdk. Then you type
update-java-alternatives --set java-7-openjdk
again to check it worked.
Get the materials
Download a current version of the Stendhal server, stendhal-server-1.28.zip from arianne.sf.net.
If you want to compile it yourself from CVS or the source code provided at the downloads link, then see How to build Stendhal for more info. If you run a Linux System, then you have the necessary tools to get everything else.
Create the server directory
Let's create your folder to run the server from, in your home directory. NOTE: The commands given are for use in the command-line, but you can take the GUI route as well. For some commands, you must run them from the command-line, and I will tell you
cd mkdir stendhal_server
This will create a directory called "stendhal_server" in your home directory. See how easy that was? And how easy to tell what will be in that directory? That's the beauty of organization.
Stendhal server files
Unzip the stendhal server zip which you downloaded, into the stendhal_server directory. Done!
Run the server
The first time you run the server a configuration file for the server (named server.ini) will be generated.
There is a script runserver.sh in the stendhal_server directory - you may need to make it executable first. So
To make it executable, in a command prompt type
chmod u+x runserver.sh
To start it from a command prompt, type
Now, it will ask you questions.
For the fast installation
- hit Enter to accept the defaults, that you want H2 database
- hit Enter so that to build the key, and wait for it to say:
server.ini has been generated
Warning: Any value for the RSA key generation small than 512 may cause the server not to work properly and refuse the client connections.
If you want to use MySQL then see below for more details: When it asks you for...
- Which database system do you want to use? write mysql (mysql)
- database name, hit enter to use the default (marauroa)
- host, hit enter to use the default (localhost)
- user, write the username you used in giving MySQL permissions (FOO)
- password, write the password you used giving MySQL permissions (BAR)
- RSA key size- This is to make sure that the login information is valid and secure.
Warning: Any value for the RSA key generation smaller than 512 may cause the server not to work properly and refuse the client connections.
Download a recent mysql-connector.jar from the MySQL site.
Well, thats everything! When it's finished, you'll have a new file, "server.ini". Don't lose it, as it contains the information to get your server up & running, as well as the key to do that. If Marauroa won't start, and nor will your server, check to see if that INI file is there (at the same directory! NOWHERE ELSE!) and if it is not, try running the runserver.sh script again; the file could have changed when updating the RSA keys
Stopping the Server
In the server window just type CTRL+c
Starting the Server again
To start the stendhal server again you can just type from a command prompt:
Note: Remember that the server configuration file (server.ini) is only generated the first time you run the server unless you delete it.
Well, that's it! Remember, when you use a client to connect you will need to create a new account and at server name localhost.
This is the extras section! Here you have trouble shooting, and hints & tips
In general please see StendhalServerTroubleShooting.
Class not found exceptions
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/log4j/Logger
Please open runserver.sh in a text editor. You'll see the classpath defined there, something like
In this case the user had his log4j.jar in the folder called libs but the classpath expects it to be in the main folder where runserver.sh ran from. So you can: edit the classpath, replacing log4j.jar above with libs/log4j.jar or move the file.
MySQL possible error
If when you try to run the server later, you get this error in the log:
Caused by: java.net.ConnectException: Connection refused
ps xa | grep mysqld
If it shows that mysqld is running with the option "--skip-networking" then comment it out in the "my.cnf" file (It has been reported that the line to comment out is actually: SKIP="--skip-networking", found at: /etc/rc.d/rc.mysqld ).
If you have already commented it out then perhaps you have previously started the server with:
Stop the server and then restart with:
ps xa | grep mysqld
that no "--skip-networking" is present.
Then run the stendhal server again.
(Many thanks to Tam Tam. Original source: http://forums.mysql.com/read.php?39,24742,147169#msg-147169 )
You are the man!
Want to be an admin? Now you can! It's easy! Go to the directory where you extracted stendhal-server-1.28.zip, and browse to data/conf. Edit admins.txt there, with each admin name on a separate line. The name must be EXACT, or it will not work. The server needs '.' on the classpath, which is already done if you are using runserver.sh.
Well, that's it. You're done. Finito. Fi. Whatever. You now have your own localhost server! No one can access yet; sign up for a free dynamic dns service at www.dyndns.com and connect a server they host to your IP. Then, all people have to do is go to whatever you set as your domain name with DynDNS. Party time!