VisualGuideToInstallingStendhalStep4: Difference between revisions

Jump to navigation Jump to search
← Older edit
Content deleted Content added
imported>Javydreamercsw
imported>Hendrik Brummermann
added navigation menu
 
(80 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Navigation for Stendhal Top|Building & Hosting}}
⚫
==Step 4. Configure marauroa to 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)
⚫
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.


⚫
==Step 4. Configure and run the Stendhal server==
Open a command prompt window.


⚫
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.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration01.png


Double-click the ''runserver.bat'' file:
cd to ''marauroa/libs'' folder (that contains ''marauroa.jar'')


[[File:ConfigureStendhalServer01.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration02.png


[[File:ConfigureStendhalServer02.png]]
At prompt, copy from here:


⚫
When prompted for the name of the database, press [enter] to accept the default.
java -cp marauroa.jar;stendhal-server-0.XX.jar games.stendhal.server.core.engine.GenerateINI


[[File:ConfigureStendhalServer03.png]]
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!)


⚫
When prompted for the name of the database host, press [enter] to accept the default.
Now USE your mouse and right-click anywhere inside the window and choose paste.


[[File:ConfigureStendhalServer04.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration03.png


⚫
<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]].
Then press <tt>enter</tt>


[[File:ConfigureStendhalServer05.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration04.png


⚫
'''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]].
'''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).


[[File:ConfigureStendhalServer06.png]]
⚫
When prompted for the name of the database:


⚫
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/Step4MarauroaConfiguration/Step4MarauroaConfiguration06.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:
When prompted for the size for the RSA key, press [enter] to accept default.


'''Warning''': a RSA key size different than 512 may cause that the server does not work properly. This is a known bug.
marauroa


This key is used for the players' passwords encryption on login, when they are sent from the Stendhal clients to the Stendhal server.
and USE your mouse and right-click anywhere inside the window and choose paste.


The generation of this key takes a while to finish.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration07.png


[[File:ConfigureStendhalServer07.png]]
Then press <tt>enter</tt>


Once the RSA key is generated, the server will start automatically.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration08.png


[[File:ConfigureStendhalServer08.png]]
⚫
When prompted for the name of the database host, this time you can safely press <tt>enter</tt> to accept the default localhost


'''To quit the server''', press [CTRL + c]...
⚫
<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:


[[File:ConfigureStendhalServer09.png]]
stendhal_user


... and answer ''yes'' to the question (by typing ''y'' or ''s'' or something else in your local language).
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt>


[[File:ConfigureStendhalServer10.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration09.png


'''To start the server again''', just double-click the ''runserver.bat'' file as in the beginning of this step.
⚫
'''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:


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.
stendhal_passwd


⚫
Go to [[VisualGuideToInstallingStendhalStep5|Step 5. Install and run the Stendhal client to play in your local Stendhal server]]
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

If you have managed to get here, congrats! You have just configured your Marauroa server.
*Now the bad news: marauroa is only a framework that doesn't provide any content... So you have just the bare bones of your server.
*And now the good news: this was the difficult part.

''"And, yes, I know the jokes of this kind are: good news first, bad news later."''


⚫
Go to [[VisualGuideToInstallingStendhalStep5|Step 5. Install Stendhal server]]


<br>
<br>
Retrieved from "https://meet.konsthol.eu/w/index.php?title=VisualGuideToInstallingStendhalStep4"