VisualGuideToInstallingStendhalStep5: Difference between revisions

Jump to navigation Jump to search
Content deleted Content added
imported>Kymara
remove distracting update notes which would be in history
imported>Hendrik Brummermann
added navigation menu
 
(54 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Navigation for Stendhal Top|Building & Hosting}}
==Step 5. Configure marauroa to access the MySQL database==


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


Note: if you have already installed the client to connect to the official server, you can use it if it is the same version. However, '''this time''' you have to connect to '''Server name:''' ''localhost'' and create a new account there.
Open a command prompt window.


To run the client:
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration01.png


Go to arianne website and download the [http://sourceforge.net/project/platformdownload.php?group_id=1111&sel_platform=410 Stendhal client zip file]
cd to ''marauroa/'' folder


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


Unzip the folder that you get, wherever you choose.
At prompt, copy from here:


[[File:InstallStendhalClient02.png]]
java -cp libs/marauroa-x.x.jar;libs/stendhal-server-0.XX.jar games.stendhal.server.core.engine.GenerateINI


Double-click the ''stendhal-{{version}}.jar'' file in the client.
which is Case SenSiTivE! And remember to change the 0.XX to whatever version you have as well as the marauroa version. (the photos below are outdated so they look a little different - don't worry!)


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


Create a new account (because your new local Stendhal server doesn't have any player account yet).
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration03.png


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


Type as '''Server name:''' ''localhost'' instead of the default server.
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration04.png


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


And the same '''every time you log in to the game''' in your local server.
When prompted for the name of the database:


[[File:InstallStendhalClient06.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration06.png


Choose the ''localhost'' server.
Press enter to accept the default or write your own.


[[File:InstallStendhalClient07.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration07.png


Then press <tt>enter</tt>


==How to set up a player account as admin==
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration08.png


There's a folder called ''data'' inside the Stendhal server folder.
When prompted for the name of the database host, this time you can safely press <tt>enter</tt> to accept the default localhost


Go into ''data''
<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:SetUpPlayerAdmins01.png]]
stendhal_user


Go into ''conf''
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt>


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


Edit the ''admins.txt'' file with your favourite text editor, e.g. Notepad.
'''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:


[[File:SetUpPlayerAdmins03.png]]
stendhal_passwd


Add the player names to the list and hit [enter] at the end of the last one. Save this file.
and USE your mouse and right-click anywhere inside the window and choose paste. Then press <tt>enter</tt>


[[File:SetUpPlayerAdmins04.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_server/Step4MarauroaConfiguration/Step4MarauroaConfiguration10.png


Now restart your server, and it will read the names from ''admins.txt'' and give them [[Stendhal:Administration|adminlevel]] 5000!
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


Go to [[VisualGuideToInstallingStendhalStep6|Step 6. Run MySQL as a service (if it is not running already)]]


<br>
<br>