StendhalLocalhostServerOnLinux: Difference between revisions

Jump to navigation Jump to search
← Older edit
Content deleted Content added
imported>Hendrik Brummermann
→Getting the materials: added openjdk
imported>Kribbel
m link for skipping
 
(82 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Navigation for Stendhal Top|Building & Hosting}}

This guide applies to:
This guide applies to:
*Marauroa 2.1 and above
*Marauroa 3.0 and above
*Stendhal 0.65.5 and above
*Stendhal 0.95 and above
<br>
<br>
= Setting up a localhost server =
= Setting up a localhost server =
This guide will teach you how to set up a server on your Linux machine. The server will be a local one, so people from around the world cannot get to your server. Only those who are directly connected to you via a LAN can connect to this server. The required packages are:
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 {{version}}
*A compiled version of the Stendhal Server, version {{version}}
*GNU/Linux ''(This may be others, the directions should apply almost exactly to any *nix system)''
*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)''
*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 '''[[StendhalLocalhostServerOnLinux#Choosing_the_Java_Virtual_Machine|Choosing the Java Virtual Machine]]'''.
'''Optionally''':
*MySQL ''sudo apt-get install mysql-server''
Otherwise you can just use the H2 database which is shipped with Stendhal and is installation-free.


For '''advanced''' MySQL configuration, keep reading.
== Getting the materials ==
Download a current version of the Stendhal server, stendhal-server-{{version}}.zip from [http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection arianne.sf.net].


== Setting up MySQL ==
If you want to compile it yourself from CVS or the source code provided at the downloads link, then see [[HowToBuildStendhal|How to build Stendhal]] for more info. If you run a Linux System, then you have the necessary tools to get everything else.


Install MySQL:
Stendhal works with OpenJDK or Sun Java, you will need Java 5 or greater.


sudo apt-get install mysql-server
For Sun Java: Use your Package manager to download '''OpenJDK 6''' or Sun Java 1.5 or greater version. At a command line, type
java -version
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
update-java-alternatives --list
(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:


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.
*java-1.5.0-sun 53 /usr/lib/jvm/java-1.5.0-sun
*java-gcj 1042 /usr/lib/jvm/java-gcj
*java-6-openjdk 1061 /usr/lib/jvm/java-6-openjdk


For example:
now, lets say you want to use the java-6-openjdk. Then you type
update-java-alternatives --set java-6-openjdk
Now run ''java --version'' again to check it worked.


ln -s /path/to/file-name/mysql-connector-java-5.1.10.jar mysql-connector.jar
= 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.
After you've installed MySQL, make sure you have a database ready for it.
Line 45: Line 35:
create database marauroa;
create database marauroa;
grant all on marauroa.* to 'FOO'@'localhost' identified by 'BAR';
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)!
'''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:
If you get a problem like:
ERROR 1044 (42000): Access denied for user 'FOO'@'localhost' to database 'marauroa'
ERROR 1044 (42000): Access denied for user 'FOO'@'localhost' to database 'marauroa'
Line 52: Line 42:
again
again


'''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.
= Makin' the cake =

== 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
java -version
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
update-java-alternatives --list
(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
Now run
java -version
again to check it worked.

== Get the materials ==
Download a current version of the Stendhal server, ''stendhal-server-{{version}}.zip'' from [http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection arianne.sf.net].

If you want to compile it yourself from CVS or the source code provided at the downloads link, then see [[HowToBuildStendhal|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 ==
== Create the server directory ==
Line 62: Line 76:
== Stendhal server files ==
== Stendhal server files ==
Unzip the stendhal server zip which you downloaded, into the stendhal_server directory.
Unzip the stendhal server zip which you downloaded, into the stendhal_server directory.

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>
Done!
Done!


== Configure marauroa ==
== Run the server ==
The first time you run the server a configuration file for the server (named ''server.ini'') will be generated.
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
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
./runserver.sh


Now, it will ask you questions.
Now, it will ask you questions.


===H2===
=== H2 database ===
For the '''fast''' installation
For the '''fast''' installation
* hit ''Enter'' to accept the defaults, that you want '''H2''' database
* hit ''Enter'' to accept the defaults, that you want '''H2''' database
Line 93: Line 97:
server.ini has been generated
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.
===MySQL===

=== MySQL database ===
If you want to use MySQL then see below for more details:
If you want to use MySQL then see below for more details:
When it asks you for...
When it asks you for...
Line 99: Line 105:
*database name, hit enter to use the default (marauroa)
*database name, hit enter to use the default (marauroa)
*host, hit enter to use the default (localhost)
*host, hit enter to use the default (localhost)
*user, write the username you used in giving MySQL permissions (FOO)
*user, '''write the username you used in giving MySQL permissions (FOO)'''
*password, write the password you used giving MySQL permissions (BAR)
*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.
*port, anything above 1024. 32160 is the default for stendhal, but it can be anything above 1024
'''Warning:''' Any value for the RSA key generation smaller than 512 may cause the server not to work properly and refuse the client connections.
*game, type "stendhal" (or a number for that, if a multiple-choice menu appears)
*turn time, or how long the server takes to process each event, choose anything above 200, but below 1000. This is in milliseconds. default is 300
*log and stats generation logs, use the default ("./") - it's in the same directory as everything else
*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


Download a recent mysql-connector.jar from the [https://dev.mysql.com/downloads/connector/j/ 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, try running the GenerateINI command again; the file could have change with updating the RSA keys


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
== Starting Server ==
To start the stendhal server you can just type
java -jar stendhal-server-{{version}}.jar


== Stopping the Server ==
Or, there is a script runserver.sh in the stendhal_server directory - you may need to make it executable first.
In the server window just type '''CTRL+c'''
So

cd /path/to/stendhal_server
== Starting the Server again ==
To make it executable, in a command prompt type
To start the stendhal server again you can just type from a command prompt:
chmod u+x runserver.sh
To start it from a command prompt, type
./runserver.sh
./runserver.sh

'''Note:''' Remember that the server configuration file (''server.ini'') is only generated the first time you run the server unless you delete it.


== Have fun ==
== Have fun ==
Line 134: Line 136:
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/log4j/Logger
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/log4j/Logger
</pre>
</pre>

''<span style="color:red;">DEPRECATED:</span> "log4j.jar" is now intended to be located in "libs" directory''

Please open runserver.sh in a text editor. You'll see the classpath defined there, something like
Please open runserver.sh in a text editor. You'll see the classpath defined there, something like
LOCALCLASSPATH=.:data/script/:data/conf/:stendhal-server-$STENDHAL_VERSION.jar:marauroa.jar:mysql-connector.jar:log4j.jar:commons-lang.jar
LOCALCLASSPATH=.:data/script/:data/conf/:stendhal-server-$STENDHAL_VERSION.jar:marauroa.jar:mysql-connector.jar:log4j.jar:commons-lang.jar
Line 139: Line 144:
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.
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.


=== Note for Slackware users: ===
=== MySQL possible error ===


If when you try to run the server later, you get this error in the log:
If when you try to run the server later, you get this error in the log:
Line 168: Line 173:
(Many thanks to Tam Tam. Original source: http://forums.mysql.com/read.php?39,24742,147169#msg-147169 )
(Many thanks to Tam Tam. Original source: http://forums.mysql.com/read.php?39,24742,147169#msg-147169 )


== Server bonuses ==
== Server bonuses ==
=== You are the man! ===
=== You are the man! ===
Retrieved from "https://meet.konsthol.eu/w/index.php?title=StendhalLocalhostServerOnLinux"