VisualGuideToInstallingStendhalStep4: Difference between revisions

From Arianne
Jump to navigation Jump to search
← Older edit
Content deleted Content added
imported>Kymara
imported>Hendrik Brummermann
added navigation menu
 
(110 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==
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-1.34'' 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 marauroa.server.generateini


[[File:ConfigureStendhalServer03.png]]
OR if you are doing this for stendhal 0.63 then you should do


When prompted for the name of the database host, press [enter] to accept the default.
java -cp marauroa.jar:stendhal-server-0.63.jar games.stendhal.server.GenerateINI


[[File:ConfigureStendhalServer04.png]]
which is Case SenSiTivE!


<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]].
Now USE your mouse and right-click anywhere inside the window and choose paste.


[[File:ConfigureStendhalServer05.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration03.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]].
Then press <tt>enter</tt>


[[File:ConfigureStendhalServer06.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration04.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]].
'''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).


When prompted for the name of the *.ini file:
When prompted for the size for the RSA key, press [enter] to accept default.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration05.png


'''Warning''': a RSA key size different than 512 may cause that the server does not work properly. This is a known bug.
just press <tt>enter</tt> and this way you accept the default ''marauroa.ini''


This key is used for the players' passwords encryption on login, when they are sent from the Stendhal clients to the Stendhal server.
When prompted for the name of the database:


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


[[File:ConfigureStendhalServer07.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:


Once the RSA key is generated, the server will start automatically.
marauroa


[[File:ConfigureStendhalServer08.png]]
and USE your mouse and right-click anywhere inside the window and choose paste.


'''To quit the server''', press [CTRL + c]...
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration07.png


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


... and answer ''yes'' to the question (by typing ''y'' or ''s'' or something else in your local language).
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration08.png


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


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_user


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/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]].

When prompted for the number of the UDP port used by the database you have to use the UDP port that is the default when running the client (if it is easy why complicate it...). So copy from here:

32160

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/Step4MarauroaConfiguration11.png

When prompted for the name of the game (yes, you just intended to install Stendhal server after all... I haven't forgot that) obviously, copy from here:

stendhal

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/Step4MarauroaConfiguration13.png

When prompted for the number of the turn time (Ok, I confess I don't really understand the message that has appeared but.. who cares? Not me!) Copy from here:

300

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/Step4MarauroaConfiguration14.png

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 path for logs:
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration15.png

Press <tt>enter</tt> to accept default

Also when Prompted for the path for statistics press <tt>enter</tt> to accept default.

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>

Latest revision as of 17:07, 16 February 2012


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.

Double-click the runserver.bat file:

When prompted for the name of the database, press [enter] to accept the default.

When prompted for the name of the database host, press [enter] to accept the default.

Warning: When prompted for the name of the database user you have to write exactly the same username (Case SenSiTivE) you wrote earlier when creating the database at Step 2.

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 creating the database at Step 2.

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 creating the database at Step 2.

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.

This key is used for the players' passwords encryption on login, when they are sent from the Stendhal clients to the Stendhal server.

The generation of this key takes a while to finish.

Once the RSA key is generated, the server will start automatically.

To quit the server, press [CTRL + c]...

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

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




Back to Visual Installation Guide Step-By-Step
Back to stendhal main wiki page

Retrieved from "https://meet.konsthol.eu/w/index.php?title=VisualGuideToInstallingStendhalStep4&oldid=107223"