InstallingStendhal
Install MySQL
Download the appropriate MySQL install package from http://dev.mysql.com/downloads/
Also download the java connector library from the 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.
Download Marauroa
Download Marauroa from http://arianne.sourceforge.net/?arianne_url=servers/server_marauroa or check out the cvs version and build it.
Start MySQL
Refer to the MySQL installation documentation for details.
If you used the noinstall package, you can run bin/mysqld.exe.
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.
Configure MySQL and create .ini file
Read at Marauroa configuration how to create a database and how to create the configuration .ini file for marauroa.
On some systems, after launching marauroad you may get error like:
ERROR [main ] AdapterFactory (68 ) - marauroa.server.db.DatabaseConnectionException: Unable to create a connection to: jdbc:mysql://localhost/marauroa marauroa.server.db.DatabaseConnectionException: Unable to create a connection to: jdbc:mysql://localhost/marauroa ... <skipped> Caused by: java.sql.SQLException: Unknown initial character set index '192' received from server. Initial client character set can be forced via the 'characterEncoding' property. ... <skipped>
What you can do in this case: open your mysqld configuration file ( /etc/my.cnf for *nix or \my.ini for Windows) and edit these settings:
collation_server = <...> character_set_server = <...>
Change them to:
collation_server = latin1_swedish_ci character_set_server = latin1
then restart mysqld.
#/service mysqld restart (for Red Hat clones) #/etc/rc.d/rc.mysqld restart (for Slackware) $/sudo /etc/init.d/mysqld restart (for Debian/Ubuntu) stop and start mysqld service (in Windows services window)
Or you can reboot your system.
For learning more about character sets in mysql, see http://dev.mysql.com/doc/refman/5.0/en/charset.html
Copy Stendhal to the Marauroa classpath
Marauroa is just the middleware to make everything run.
But you need to feed it with games. To make Marauroa run Stendhal, just copy the result of compiling stendhal to marauroa folder.
If you download Marauroa, and unzip it you will see this:
C:\...\marauroa-0.90>dir
19/02/2005 19:51 <DIR> .
19/02/2005 19:51 <DIR> ..
19/02/2005 13:28 133 AUTHORS
19/02/2005 13:28 141 BUGS
19/02/2005 13:28 18.332 COPYING
19/02/2005 13:28 719.950 jython.jar
19/02/2005 13:28 18.332 LICENSE
19/02/2005 13:28 149.364 marauroa-0.90.jar
19/02/2005 13:28 1.294 marauroa.ini
19/02/2005 13:28 162 marauroad.bat
19/02/2005 13:28 235.712 mysql-connector-java-3.0.15-ga-bin.jar
19/02/2005 13:28 13.930 README
10 files 1.157.350 bytes
2 dirs 19.775.102.976 bytes free
Installing the Stendhal server module
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.
Copy stendhal-server-0.00.jar into Marauroa folder:
copy stendhal-server-0.00.jar D:\.....\marauroa
Go to Marauroa folder and edit marauroad.bat file, that should looks like:
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
Did you noticed the added stendhal-server-0.00.jar file?
Congrats! You have successfully installed Stendhal in a Marauroa server.
Start the server
Now start marauroa server by running runserver.bat
See also
- Initial steps with Stendhal guide.