Last updated September 19, 2011 19:02, by javydreamercsw

## Installation Guide

This guide has been written based on the pain of the first volunteers to try the game.

## Requirements

• A computer: To serve as server

Since version 0.03 jWrestling is bundled with Derby database by default. No database is required for demo purposes.

• A database: To host the server's database. I suggest MySQL for a full fledged server or Derby for demo purposes. Basically any Database you can find is supported out of the box!
• Java Drivers: The database you select must have a JDBC driver. I bundle the MySQL driver in the lib folder but feel free to upgrade it if its older. Also Derby drivers are available in the bundle.
• jWrestling Server and Client
• Latest Java
• Some time!

## Instructions

• Expand the jWrestling Server zip file in the place of your choosing. I'll refer to that place as <server dir> from now on. (for instructions on how to unzip a zip file on windows go here)
• Lets explore its contents. You should have:
• a lib folder with some needed libraries
• a log folder where your logs will reside
• a jwrestling-server-xx.jar
• a marauroa.bat file
• server.ini file
• First we need to modify the server.ini file. I'll explain both ways of doing it and you decide the best.

## Manual Modification

If you are using the server for demo purposes just ignore this section. Since version 0.03 jWrestling is setup to work with Derby out of the box. No configuration required!

If your only intent is only trying the game this is ok. This is not suggested if you are going to have the server available to others!!! Why? This file has a key in it that right now is know everywhere. So anyone can hack into your system.

Continue only if you want to set up a proper server.

Now that the warning is out there you need to modify the following within the server.ini file:

• Look for this entry: Pre-defined Mysql. It should have something like: jdbc_url=jdbc:mysql://localhost:3306/jwrestling. Localhost is the name of your host. For tests localhost is Ok. 3306 is the port on which MySQL is listening. If you followed the installation wizard without modifications it should be 3306. And last but not least jwrestling is the name of the database. You can refer here on a tutorial on how to create your database.
• Look for this entry: jdbc_user=jwrestling_user. Here you should use the username of an existing username with all permissions on the database jwrestling. You can create one with this SQL command: CREATE USER jwrestling_user IDENTIFIED BY 'password. Obviously change password for anything you want.
• Look for this entry: jdbc_pwd=password. Here use the password from the previous step.
• The rest should be Ok for now.

For a secure server check section Automated Modification

TODO

## Running the server

Well, you should be ready to start the server if you followed the above steps. Just double click on marauroad.bat and you should see something like this:

C:\Users\Javier\Documents\jWrestling Project\jWrestling\dist>set LOCAL_CLASSPATH
=jwrestling-server-0.02.jar;lib\AbsoluteLayout.jar;lib\derby.jar;lib\derbyclient.jar;
lib\log4j-1.2.15.jar;lib\marauroa-2.6.3-jwrestling.jar;lib\marauroa-simple-server.jar;
lib\mysql-connector-java-5.1.6-bin.jar;lib\swing-layout-1.0.4.jar;

lib\marauroa-2.6.3-jwrestling.jar;lib\marauroa-simple-server.jar;
Marauroa - arianne's open source multiplayer online framework for game development -
Running on version 2.6.3
(C) 1999-2007 Miguel Angel Blanch Lardin

This program is free software; you can redistribute it and/or modify
the Free Software Foundation; either version 2 of the License, or(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Configuring Log4J using games/jwrestling/server/log4j.properties
INFO  [marauroad ] jWrestlingDatabase       (243 ) - Starting jWrestling Database
INFO  [marauroad ] SimpleObjectFactory      (243 ) - Using games.jwrestling.server.entity.player.PlayerRPC as client object class.
DEBUG [marauroad ] jWrestlingRPClass        (124 ) - Creating attribute: xxx in the database...
DEBUG [marauroad ] jWrestlingRPClass        (124 ) - Creating attribute: xxx in the database...
.
.
.
INFO  [marauroad ] SimpleRuleProcessor      (243 ) - Running jWrestling Server version x.xx
INFO  [marauroad ] marauroad                (243 ) - marauroa is up and running... (startup time: 17.4 s)
INFO  [marauroad ] Statistics               (243 ) - Total/Used memory: 28384/20212

Note: Based on the settings the Debug messages might be displayed or not.

### Troubleshooting

• If you don't, i.e. the screen closes suddenly, there's something wrong.
• Make sure you followed the instructions in the Instructions section and the configurations sections.
• If you customized the server.ini file make sure that the information provided is correct.
• Make sure there's no other instances of the server running.

If it still doesn't work, look into the log folder for error logs and feel free to contact us at Tech Support, looking in the FAQ page in the wiki or the appropriate mailing list.

## Next

Starting the client