StendhalLocalhostServerOnLinux: Difference between revisions

For '''advanced''' MySQL configuration, install MySQL:

== Getting the materials ==

= Setting up MySQL =

'''You can skip this whole step if you want the fast installation with an H2 database: Go to Makin' the cake'''

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';

again

= Makin' the cake =

Now check you have the following files in the stendhal_server directory:

*stendhal-server-{{version}}.jar

*stendhal-xmlconf-{{version}}.jar

*stendhal-maps-{{version}}.jar

*groovy.jar

*simple.jar

*marauroa.jar

*log4j.jar

*log4j.properties

*jython.jar

*mysql-connector.jar ''optional''

*commons-lang.jar

... or in a directory called ''lib'' or ''libs'' inside the stendhal_server directory. If any are in ''lib'' or ''libs'' please move them up into the main stendhal_server directory.

<small>If any of the latter jars are missing you can fetch them here: http://arianne.cvs.sourceforge.net/arianne/stendhal/libs/</small>

== Configure marauroa ==

Time to configure Marauroa and the database access. In the command-line (not in GUI!), run:

java -cp stendhal-server-{{version}}.jar games.stendhal.server.core.engine.GenerateINI

===H2===

===MySQL===

*user, write the username you used in giving MySQL permissions (FOO)

*password, write the password you used giving MySQL permissions (BAR)

*RSA key size, choose anything smaller than 1024 bits, but greater than 512 (or equal to). This is to make sure that the login information is valid and secure. Like the prompt says, anything greater than 1024 can take a LONG time. But, if you have ~30 minutes to spare (more or less, depending on your comp), you could use the extra security

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, try running the GenerateINI command again; the file could have change with updating the RSA keys

== Starting Server ==

To start the stendhal server you can just type

java -jar stendhal-server-{{version}}.jar

Or, there is a script runserver.sh in the stendhal_server directory - you may need to make it executable first.

So

cd /path/to/stendhal_server

To make it executable, in a command prompt type

chmod u+x runserver.sh

To start it from a command prompt, type

=== MySQL ===