VisualGuideToInstallingStendhalStep4: Difference between revisions

Jump to navigation Jump to search
Content deleted Content added
imported>Gummipferd
swapping 4 and 5 to make generateini work
imported>Hendrik Brummermann
added navigation menu
 
(67 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Navigation for Stendhal Top|Building & Hosting}}
==Step 4. Install Stendhal server==


Now let's install the Stendhal server that will run over the marauroa server.
==Step 4. Configure and run the Stendhal server==


Now a ''server.ini'' configuration file will be generated so that the Stendhal server knows where and how to access the MariaDB database which will store the user accounts and other game information.
Go to arianne website [http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection] and download the latest Stendhal server binary.


Double-click the ''runserver.bat'' file:
Here is a direct link to 0.67:
[http://prdownloads.sourceforge.net/arianne/stendhal-server-0.67.zip?download Stendhal-server-0.67]
if there is a later version at the time that you read this guide, please browse the downloads link given previously to find it.


[[File:ConfigureStendhalServer01.png]]
Whatever version you have, the steps below are the same. This guide was written for stendhal-server-0.67.zip.


[[File:ConfigureStendhalServer02.png]]
Unzip the ''stendhal-server-0.67.zip'' file.


When prompted for the name of the database, press [enter] to accept the default.
===Step 4.1. Move binary server files to marauroa===
Copy these 3 server binary ''*.jar'' files to your marauroa folder.
*''stendhal-maps-0.67.jar''
*''stendhal-server-0.67.jar''
*''stendhal-xmlconf-0.67.jar''


[[File:ConfigureStendhalServer03.png]]
Copy these 3 server binary ''*.jar'' files to your marauroa\libs folder.
*''groovy.jar''
*''commons-lang.jar''
*''simple.jar''


When prompted for the name of the database host, press [enter] to accept the default.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step51MoveServerFiles/Step51MoveServerFiles01.png


[[File:ConfigureStendhalServer04.png]]
inside the marauroa/libs folder.


<span id="ConfigureStendhalServer_EnterUserPassword"></span>'''Warning:''' When prompted for the name of the database user you have to write exactly the same username ('''Case SenSiTivE''') you wrote earlier when [[VisualGuideToInstallingStendhalStep2#CreateMariaDBDatabase_SetUserPassword|creating the database at Step 2]].
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step51MoveServerFiles/Step51MoveServerFiles02.png


[[File:ConfigureStendhalServer05.png]]
===Step 4.2. Edit the marauroad.bat file===
Edit the marauroad.bat file by including in the path the name of the stendhal-server and velocity files, version included


'''Warning:''' When prompted for the name of the database user password you have to write exactly the same password ('''Case SenSiTivE''') you wrote earlier when [[VisualGuideToInstallingStendhalStep2#CreateMariaDBDatabase_SetUserPassword|creating the database at Step 2]].
;stendhal-server-0.67.jar


[[File:ConfigureStendhalServer06.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile01.png


After this, you are reminded that you should have granted all permissions to access the MariaDB database named ''marauroa'' to the user named ''Stendhal'' with password ''abc123''. And that is precisely what we have just done already when [[VisualGuideToInstallingStendhalStep2#CreateMySQLDatabase_SetUserPassword|creating the database at Step 2]].
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile02.png


When prompted for the size for the RSA key, press [enter] to accept default.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile03.png


'''Warning''': a RSA key size different than 512 may cause that the server does not work properly. This is a known bug.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step3MarauroaInstall/Step3MarauroaInstall03.png


This key is used for the players' passwords encryption on login, when they are sent from the Stendhal clients to the Stendhal server.
Note for the future: If you choose:
*not to rename ''marauroa-2.5.jar'' file to remove the version from its filename and
*not to edit the ''mararoad.bat'' file


The generation of this key takes a while to finish.
Then, when you want to recompile Stendhal, you will really need to do it or you will have to edit ''build.xml'' file (don't count on me for that, at least for now).


[[File:ConfigureStendhalServer07.png]]
Note for the future: If you choose:
*to rename ''stendhal-server-0.67'' file to remove the version from its filename and
*edit the ''mararoad.bat'' file consequently


Once the RSA key is generated, the server will start automatically.
Then, everytime you recompile Stendhal, the version suffix will be generated again , so it is more comfortable and faster leaving it.


[[File:ConfigureStendhalServer08.png]]


'''To quit the server''', press [CTRL + c]...
Go to [[VisualGuideToInstallingStendhalStep5|Step 5. Configure marauroa to access the MySQL database]]

[[File:ConfigureStendhalServer09.png]]

... and answer ''yes'' to the question (by typing ''y'' or ''s'' or something else in your local language).

[[File:ConfigureStendhalServer10.png]]

'''To start the server again''', just double-click the ''runserver.bat'' file as in the beginning of this step.

The program will detect that the server has already been configured (i.e. that a ''server.ini'' file exists) and will just start the server.

Go to [[VisualGuideToInstallingStendhalStep5|Step 5. Install and run the Stendhal client to play in your local Stendhal server]]


<br>
<br>