VisualGuideToInstallingStendhalStep5: Difference between revisions

Content deleted Content added
imported>Gummipferd
m VisualGuideToInstallingStendhalStepX moved to VisualGuideToInstallingStendhalStep5
imported>Gummipferd
swapping 4 and 5 to make generateini work; edited the java command; removed the last few lines as they arent true anymore
Line 1:
==Step 5. InstallConfigure Stendhalmarauroa serverto access the MySQL database==
--[[User:Javydreamercsw|Javydreamercsw]] 09:35, 5 March 2008 (PST) (Update: eliminated the screens no longer used by marauroa while creating ini file)<br>
Now you will generate a marauroa *.ini file so that marauroa knows where and how to access the database with the user accounts and other info.
 
Open a command prompt window.
Now let's install the Stendhal server that will run over the marauroa server.
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step3MarauroaInstallStep4MarauroaConfiguration/Step3MarauroaInstall03Step4MarauroaConfiguration01.png
Go to arianne website [http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection] and download the latest Stendhal server binary.
 
cd to ''marauroa/libs'' folder (that contains ''marauroa.jar'')
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.
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstallStep4MarauroaConfiguration/Step51MoveServerFiles/Step51MoveServerFiles01Step4MarauroaConfiguration02.png
Whatever version you have, the steps below are the same. This guide was written for stendhal-server-0.67.zip.
 
At prompt, copy from here:
Unzip the ''stendhal-server-0.67.zip'' file.
 
java -cp libs/marauroa-2.5.jar;stendhal-server-0.XX.jar games.stendhal.server.core.engine.GenerateINI
===Step 5.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''
 
which is Case SenSiTivE! And remember to change the 0.XX to whatever version you have. (the photos below are outdated so they look a little different - don't worry!)
Copy these 3 server binary ''*.jar'' files to your marauroa\libs folder.
*''groovy.jar''
*''commons-lang.jar''
*''simple.jar''
 
Now USE your mouse and right-click anywhere inside the window and choose paste.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step51MoveServerFiles/Step51MoveServerFiles01.png
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstallStep4MarauroaConfiguration/Step51MoveServerFiles/Step51MoveServerFiles02Step4MarauroaConfiguration03.png
inside the marauroa/libs folder.
 
Then press <tt>enter</tt>
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step51MoveServerFiles/Step51MoveServerFiles02.png
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstallStep4MarauroaConfiguration/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile01Step4MarauroaConfiguration04.png
===Step 5.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:''' depending on how you have copied it maybe there's no need to press <tt>enter</tt> this time after you paste (you might have copied the <tt>enter</tt> character too).
;stendhal-server-0.67.jar
 
When prompted for the name of the database:
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile01.png
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstallStep4MarauroaConfiguration/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile02Step4MarauroaConfiguration06.png
 
'''Warning:''' Now copy the name of the database from here, don't press <tt>enter</tt> to accept the default as at the time of this guide it seems it doesn't work. So '''copy''' from here:
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstall/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile03.png
 
marauroa
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step3MarauroaInstall/Step3MarauroaInstall03.png
 
and USE your mouse and right-click anywhere inside the window and choose paste.
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
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step5StendhalServerInstallStep4MarauroaConfiguration/Step52EditMarauroadBatFile/Step52EditMarauroadBatFile03Step4MarauroaConfiguration07.png
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).
 
Then press <tt>enter</tt>
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
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration08.png
Then, everytime you recompile Stendhal, the version suffix will be generated again , so it is more comfortable and faster leaving it.
 
When prompted for the name of the database host, this time you can safely press <tt>enter</tt> to accept the default localhost
 
<span id="ConfigureMarauroa_EnterUserPassword"></span>'''Warning:''' When prompted for the name of the database user you have to write exactly the same user you chose earlier when [[VisualGuideToInstallingStendhalStep2#CreateMySQLDatabase_SetUserPassword|creating the database at Step 2]]. So copy from here:
 
stendhal_user
 
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt>
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration09.png
 
'''Warning:''' When prompted for the name of the database user password you have to write exactly the same password you chose earlier when [[VisualGuideToInstallingStendhalStep2#CreateMySQLDatabase_SetUserPassword|creating the database at Step 2]]. So copy from here:
 
stendhal_passwd
 
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt>
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration10.png
 
Here, like I have just done, it reminds you that you should have granted all permissions to access the marauroa database to the user ''stendhal_user'' with password ''stendhal_passwd''. And that is precisely what we have just done already when [[VisualGuideToInstallingStendhalStep2#CreateMySQLDatabase_SetUserPassword|creating the database at Step 2]].
 
Note: Depending on the power and memory of your PC you can get warnings (later in the server window) of turn time overflow (I do) if you set it this value or lower but that does not hurt (I think).
 
When prompted for the size for the RSA key:
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration16.png
 
Press <tt>enter</tt> to accept default
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration17.png
 
I think this key is used for users' passwords encryption inside the database.
For the use we are going to make of it I do not think we need this security measure so I would write 0 or 1, but to be on the safe side, let's press <tt>enter</tt> to accept the default (512) and wait a while or longer to finish.
 
Roughly estimated time (one Mississippi, two Mississippi...) on my computer: 45 seconds (who knows if more, who knows if less)
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration18.png
 
Close the window:
Type exit or simply click on the X (yes, I will be declared a genius for this sentence)
 
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration19.png