InstallingStendhal: Difference between revisions

← Older edit

Content deleted Content added

Inline

@@ Line 1: / Line 1: @@
+{{Navigation for Stendhal Top|Building & Hosting}}
-== Install MySQL ==
+This is a generic guide. You may prefer a specific installation guide for [[Easy_Stendhal_Server Installation_On_Windows|Windows]] or [[StendhalLocalhostServerOnLinux|Linux]]
-Download the appropriate MySQL install package from http://dev.mysql.com/downloads/
+__toc__
+== Download Stendhal server ==
+The server files are available as a .zip.
-Also download the java connector library from the [http://dev.mysql.com/downloads/ same place] (it's called "MySQL Connector/J" ), unzip it, and make sure it is on the classpath when running maraurorad later. You can save this download if you get compiled version of Marauroa.
+* Go to [http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection download files] and download stendhal-server-{{version}}.zip
+* Save
+* Extract
-== Download Maraurora ==
+== Configure server ==
+From where you extracted the files to, type command:
-Download Maraurora from http://arianne.sourceforge.net/?arianne_url=servers/server_marauroa
-or check out the cvs version and build it.
+ java -cp stendhal-server-{{version}}.jar games.stendhal.server.core.engine.GenerateINI
-== Start MySQL ==
-Refer to the MySql installation documentation for details.
+For easy H2 database configuration just hit enter to accept each default and skip straight to [[InstallingStendhal#Start_the_server|Start the server]].
-If you used the noinstall package, you can run bin/mysqld.exe.
+For MySQL configuration (advanced):
-Make sure to edit the configuration files 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.
+<small>
+*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)
+*port, anything above 1024. 32160 is the default for stendhal, but it can be anything above 1024
+*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.</small>
-== Configure MySQL and create .ini file ==
-Read at [[http://arianne.sourceforge.net/wiki/index.php/InitialStepsWithMarauroa#Configuration Marauroa configuration]] how to create a database and how to create the configuration .ini file for marauroa.
+=== Install MySQL (optional) ===
-== Copy Stendhal to the Maraurora classpath ==
+'''You only need to do this if you chose the advanced MySQL option, not H2'''
-Marauroa is just the middleware to make everything run.<br>
+Download the appropriate MySQL install package from http://dev.mysql.com/downloads/
-But you need to feed it with games. To make Marauroa run Stendhal, just copy the result of compiling stendhal to marauroa folder.
+Also download the java connector library from the [http://dev.mysql.com/downloads/ same place] (it's called "MySQL Connector/J" ), unzip it, and make sure it is on the classpath when running maraurorad later. You can save this download if you get compiled version of Marauroa.
-If you download Marauroa, and unzip it you will see this:
-<pre>
-C:\...\marauroa-0.90>dir
-/02/2005  19:51    <DIR>          .
-/02/2005  19:51    <DIR>          ..
-/02/2005  13:28               133 AUTHORS
-/02/2005  13:28               141 BUGS
-/02/2005  13:28            18.332 COPYING
-/02/2005  13:28           719.950 jython.jar
-/02/2005  13:28            18.332 LICENSE
-/02/2005  13:28           149.364 marauroa-0.90.jar
-/02/2005  13:28             1.294 marauroa.ini
-/02/2005  13:28               162 marauroad.bat
-/02/2005  13:28           235.712 mysql-connector-java-3.0.15-ga-bin.jar
-/02/2005  13:28            13.930 README
-files      1.157.350 bytes
-dirs  19.775.102.976 bytes free
-</pre>
-=== Installing the Stendhal server module ===
+=== Start MySQL (optional) ===
+'''You only need to do this if you chose the advanced MySQL option, not H2'''
-Either if you compiled it or if you downloaded a compiled version from Website you need to copy stendhal-server-X.XX.jar file to Marauroa folder so server can see it.  You can find this file in stendhal\lib.
+Refer to the MySQL installation documentation for details.
+If you used the noinstall package, you can run bin/mysqld.exe.
-Copy stendhal-server-0.00.jar into Marauroa folder:
-<pre>
-  copy stendhal-server-0.00.jar D:\.....\marauroa
-</pre>
+Make sure to edit the configuration files 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.
-Go to Marauroa folder and edit marauroad.bat file, that should looks like:
-<pre>
-set LOCALCLASSPATH=.;stendhal-server-0.00.jar;marauroa-0.90.jar;jython.jar;mysql-connector-java-3.0.15-ga-bin.jar
-java -cp "%LOCALCLASSPATH%" marauroa.server.marauroad -c marauroa.ini -l
-</pre>
+=== Configure MySQL (optional) ===
-Did you noticed the added stendhal-server-0.00.jar file?
+Read at [[InitialStepsWithMarauroa#Configuration|Marauroa configuration]] how to create a database which matches the options given in the configuration file server.ini which you made above.
+The mysql command is:
-Congrats! You have successfully installed Stendhal in a Marauroa server.<br>
+ create database marauroa;
+ grant all on marauroa.* to 'FOO'@'localhost' identified by 'BAR';
 == Start the server ==
-Now start marauroa server by running marauroad.bat
+Now start marauroa server by running runserver.bat, or runserver.sh, or
+ java -jar stendhal-server-{{version}}.jar
 == See also ==
-* [[InitialStepsWithStendhal | Initial steps with Stendhal]] guide.
+* [[StendhalServerTroubleShooting|Trouble shooting]]
+* [[StendhalPublicServer|Host an online Stendhal server]]
 <br>

InstallingStendhal: Difference between revisions

Navigation menu

Search