VisualGuideToInstallingStendhalStep4: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Oslsachem No edit summary |
imported>Hendrik Brummermann added navigation menu |
||
| (133 intermediate revisions by 6 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.31.1'' 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]] |
|||
and USE your mouse and right-click anywhere inside the window and choose paste. |
|||
When prompted for the name of the database host, press [enter] to accept the default. |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration03.png |
|||
[[File:ConfigureStendhalServer04.png]] |
|||
Then press <tt>enter</tt> |
|||
<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/Step4MarauroaConfiguration/Step4MarauroaConfiguration04.png |
|||
[[File:ConfigureStendhalServer05.png]] |
|||
'''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). |
|||
'''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]]. |
|||
When prompted for the name of the *.ini file: |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration05.png |
|||
[[File:ConfigureStendhalServer06.png]] |
|||
just press <tt>enter</tt> and this way you accept the default ''marauroa.ini'' |
|||
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]]. |
|||
When prompted for the name of the database: |
|||
When prompted for the size for the RSA key, press [enter] to accept default. |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration06.png |
|||
'''Warning''': a RSA key size different than 512 may cause that the server does not work properly. This is a known bug. |
|||
'''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: |
|||
This key is used for the players' passwords encryption on login, when they are sent from the Stendhal clients to the Stendhal server. |
|||
marauroa |
|||
The generation of this key takes a while to finish. |
|||
and USE your mouse and right-click anywhere inside the window and choose paste. |
|||
[[File:ConfigureStendhalServer07.png]] |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration07.png |
|||
Once the RSA key is generated, the server will start automatically. |
|||
Then press <tt>enter</tt> |
|||
[[File:ConfigureStendhalServer08.png]] |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration08.png |
|||
'''To quit the server''', press [CTRL + c]... |
|||
When prompted for the name of the database host, this time you can safely press <tt>enter</tt> to accept the default localhost |
|||
[[File:ConfigureStendhalServer09.png]] |
|||
'''Warning:''' When prompted for the name of the database user you have to write exactly the same user you chose earlier when creating the database at Step 2. So copy from here: |
|||
... and answer ''yes'' to the question (by typing ''y'' or ''s'' or something else in your local language). |
|||
stendhal_user |
|||
[[File:ConfigureStendhalServer10.png]] |
|||
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt> |
|||
'''To start the server again''', just double-click the ''runserver.bat'' file as in the beginning of this step. |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration09.png |
|||
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. |
|||
'''Warning:''' When prompted for the name of the database user password you have to write exactly the same password you chose earlier when creating the database at Step 2. So copy from here: |
|||
Go to [[VisualGuideToInstallingStendhalStep5|Step 5. Install and run the Stendhal client to play in your local Stendhal server]] |
|||
stendhal_passwd |
|||
<br> |
|||
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt> |
|||
<br> |
|||
<br> |
|||
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration10.png |
|||
---- |
|||
[[VisualGuideInstallingStendhal|Back to Visual Installation Guide Step-By-Step]]<br> |
|||
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 in the previous step 2 when creating the database. |
|||
[[Stendhal | Back to stendhal main wiki page]] |
|||
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]] |
|||