Installer un serveur local Ragnarok Online (SQL) sous Windows

(MageGaHell’s Blog - Confilture - 5/05/2009)

Avant-propos

Ce "guide" est une sorte de défi que je me suis auto-lancé : savoir si je pouvais installer un serveur Ragnarok Online en local, en suivant les guides existant (que ce soit sur roeathena.fr ou eathena.ws ou ailleurs). Il en découle donc que vous n’apprendrez normalement rien de plus que dans ces guides (certains fort bien fait), mais au moins vous le feignasse, vous n’aurez pas à chercher partout...

Je considère qu’un serveur "local", même de "test" (et encore plus si "de développement") doit se rapprocher au maximum d’un "vrai" serveur en ligne. Il doit donc être en SQL et à jour et compilé (par soi-même) à partir de la SVN (trunk, stable étant un peu à la ramasse) et sécurisé au maximum. C’est aussi un bon entrainement en vue de l’étape suivante : l’installation d’un serveur Ragnarok Online sur en dédié.

I- Matériel requis.

 Cygwin pour la compilation, agrémenté d’une librairie mysql : [url="http://www.cygwin.com/"]http://www.cygwin.com/[/url]
 Tortoise SVN pour télécharger la SVN d’eathena (et éventuellement du Book of Ymir) : [url="http://tortoisesvn.net/"]http://tortoisesvn.net/[/url]
 EasyPhp pour installer et administrer la base de données : [url="http://www.easyphp.org/"]http://www.easyphp.org/[/url] (version 3.0, ce guide a été réalisé avec le 2.0b1)
 Savoir trouver sa propre IP LAN et se mettre en IP fixe sur son réseau local.
 Google
 Un maîtrise de l’anglais niveau scolaire.

II - Récupération de la SVN

 Téléchargez [url="http://tortoisesvn.net/"]Tortoise SVN[/url] et installez-le.
 Créer un répertoire quelque-part sur votre disque-dur, qui sera le futur répertoire de votre serveur. J’ai choisit : c :/guide/FoE (car j’ai intérieure nommé le projet Forge of Einherjar, et oui, je fais ça à fond, "comme pour un vrai").
 Faîtes un clic-droit sur le dossier et choisissez l’option "SVN checkout".
 Une fenêtre apparait.
Dans le champ "[b]URL Repository[/b]", copier l’adresse de la SVN : [url="http://svn.eathena.ws/svn/ea/trunk/"]http://svn.eathena.ws/svn/ea/trunk/[/url] (pour stable, c’est [url="http://svn.eathena.ws/svn/ea/branch..."]http://svn.eathena.ws/svn/ea/branch...[/url] que je juge obsolète).
Dans le champ "[b]Checkout Directory[/b]", laissez la valeur, normalement le répertoire sur lequel vous avez cliqué... Laissez bien le "[b]Checkout Depth[/b]" à "[b]Fully recursive[/b]" (pour qu’il prenne tous les sous-répertoires).
Enfin, laissez le bouton "[b]Revision[/b]" sur "[b]HEAD revision[/b]" pour télécharger la dernière version.
Cliquez sur OK et c’est parti pour le download de la SVN.
A la fin, vous obtenez un répertoire qui contient une copie de la SVN. Devant chaque nom de dossier/fichier, une icône indique son état par rapport à la SVN (normalement, tout devrait être vert).
Il faut maintenant compiler cette SVN afin d’obtenir un serveur exécutable.

III - Compilation

1°) Installation de Cygwin

Cygwin est une sorte de console d’émulation Linux (en schématisant).
Entrez donc avec moi dans le monde fascinant de la ligne de commande...

[url="http://www.cygwin.com/"]Télécharger cygwin[/url]. Il s’agit d’un seul fichier setup.exe
Celui-ci servira également à l’ugrade/reconfiguration de l’installation.
Exécutez donc le setup.
Premier écran : on vous demande d’où vous souhaitez effectuer l’installation. Choisissez évidemment "Install from Internet"
Second écran : on vous demande où installer cygwin. Pour l’exemple et la facilité j’ai mis ça dans c :/cygwin.
Dans la zone "[b]Install for[/b]", laissez bien cochez "[b]All users[/b]".
Dans la zone "[b]Default Text Type File[/b]", laissez bien "[b]Unix/binary[/b]".
Troisième écran : on vous demande où seront stocké les fichiers temporaires. J’ai mis ça dans c :/utils (là où j’ai stocké également le setup.exe).
Conserver le même répertoire sera utile en cas de réinstallation/reconfiguration.
Quatrième écran : on vous demande comment vous allez downloader tout ça.
Choisissez "[b]Direct Connection[/b]" (à moins que vous ayez une bonne raison pour pas le faire).
Cinquième écran : choisissez un site de download dans la liste. J’ai pris le premier, au pif.
[b]Sixième écran : les choses sérieuses commencent ![/b]
On va devoir choisir les "packages" à installer dans cygwin. N’hésitez pas à passer en "plein écran" histoire de bien voir l’arborescence proposée.
Déplier déjà l’onglet "[b]Devel[/b]".
Cherche la ligne "[b]gcc : C compiler upgrade helper[/b]". Là, cliquez sur l’espèce de rond avec des flèches : un numéro de version et des cases devraient apparaître (n’y aller par comme un bourrin sur le rond, car il y a plein d’option qui "cyclent"). Nul besoin normalement d’y toucher, elles devraient être comme il faut de base (cf l’image ci-dessous).
Notez que ça va automatiquement activer d’autres lignes (notamment le [b]gcc core compiler[/b]). ça tombe bien, c’était ce qu’on voulait.
Toujours dans "[b]Devel[/b]", descendez jusqu’à trouver la ligne "[b]make : The GNU version of ’make’ utility[/b]".
Là encore cliquez sur l’espèce de rond fléché pour faire apparaître la version et les cases.
Et là encore, ça va activer des dépendances...
Maintenant, repliez l’onglet "[b]Devel[/b]" et dépliez l’onglet "[b]Lib[/b]".
Descendez tout en bas pour trouver la ligne "[b]zlib : The zlib compression and decompression library[/b]".
Là encore, cliquez sur le rond pour faire apparaître le n° de version et les cases.
Ok, on a toutes nos packages/librairies pour le compilateur (gcc), make et zlib.
Cliquez donc sur suivant pour lancer le téléchargement et l’installation.

[b]2°) Rajoutons la gestion de Mysql à cygwin[/b]

D’abord, lancez cygwin que vous venez d’installer.
Une accueillante fenêtre s’ouvre.
Notez que cela créera automatiquement votre répertoire d’utilisateur dans le sous-dossier "[b]home[/b]" de cygwin.
Donc dans mon cas, c :/cygwin/home/MageGaHell

Téléchargez maintenant un package Mysql : [url="http://dev.mysql.com/downloads/mysq..."]http://dev.mysql.com/downloads/mysq...[/url]
Prenez le fichier "[b]Compressed GNU TAR archive (tar.gz)[/b]" de la version en cours. J’ai donc pris [b]mysql-5.0.77.tar.gz[/b]
Une fois ce fichier télécharger (30-35Mo environ), placez-le tel quel dans votre répertoire d’utilisateur cygwin.
Pour moi c’était donc dans c :/cygwin/home/MageGaHell/
Une fois que le fichier y est, dans la console de cygwin, tapez la ligne de commande suivante :

Où "[b]nomdufichier.tar.gz[/b]" est le nom de l’archive que vous venez de télécharger ([b]mysql-5.0.77.tar.gz[/b] pour moi donc).
Cela décompresse l’archive, dans un sous répertoire.
Rendez-vous dans ce sous-répertoire via la commande :

Donc, dans mon cas, [b]cd mysql-5.0.77[/b]
Ensuite, tapez cette ligne de commande :

Cela va checker si tout est bon et préparer la compilation... ça va donc prendre un moment...
Après ça, si tout est bon, faite un :

C’est reparti pour un tour et ça va être encore plus long !
Si ça plante, c’est qu’y’a de grande chance que vous n’ayez pas installé cygwin ou le package mysql comme il faut... Vérifiez !
Après ça, faite :

Et c’est reparti, cette fois c’est l’installation de mysql (avant c’était la compilation).
Voilà, mysql est installé avec cygwin... Nous allons pouvoir compilé la SVN SQL !

[b]3°) Compilation de la SVN[/b]

Toujours avec cygwin, rendez-vous dans le dossier où vous avez installé la SVN (moi c’était donc c :/guide/FoE/).
J’ai donc fait :

Une fois dans le répertoire, préparez la compilation avec :

Puis :

Et enfin :

Voilà, normalement votre SVN SQL est compilée !

Note : en cas d’erreur "[b]No rule to make target ’sql’. Stop[/b]", essayez les lignes de commande suivante :

Si là encore ça ne marche pas :

[b]4°)Le petit truc indispensable.[/b]

Si par curiosité vous lancez votre runserver-sql.bat, vous allez constater une erreur : ça va brailler et vous demander des .dll
Pas de panique, c’est normal !
Allez dans le sous-répertoire "[b]bin[/b]" de votre cygwin (donc pour moi : c :/cygwin/bin/). Trouvez les fichiers "[b]cygwin1.dll[/b]" et "[b]cygz.dll[/b]".
Copiez-collez les dans le répertoire de votre SVN (donc pour moi : c :/guide/FoE/).
Voilà qui réglera ce problème... Mais c’est pas pour ça que votre serveur arrivera à tourner : il lui faut une base de données SQL et qu’il soit configuré !

[b]IV - Installation de la base de données.[/b]

Pour ce faire, nous allons installer Easyphp (Apache&MySQL en local , en gros).
J’ai utilisé la [url="http://www.phpsources.org/ressource..."]version 1.8[/url] ou [url="http://www.download3k.com/Web-Autho..."]2.0b1[/url], ayant eu quelques petits soucis avec la 3.0
Je ne décrirais pas l’installation, qui est basique (c’est pas cygwin ^^).

[b]1°)Installation des bases de données (principale et log)[/b]

Une fois easyphp téléchargé et installé, lancez-le : une icône "E" noire apparaitra dans votre barre des tâches.
Double-cliquez dessus pour avoir l’état des services (Apache et MySQL) : il faut qu’il soit "Démarré" (vert).
Faîtes un clic-droit sur l’icône "[b]E[/b]" pour faire apparaître un menu.
Choisissez "[b]Administration[/b]". Une page (locale : [url="http://127.0.0.1/home/"]http://127.0.0.1/home/ [/url]) va s’ouvrir dans votre navigateur internet, présentant les menu d’administration.
Cliquez sur le bouton "[b]MySQL Administration[/b]" de la ligne "[b]phpmyadmin[/b]".

Vous arrivez sur l’interface d’administration de phpmyadmin.
Commençons par créer la première base de données.
Dans le champ "[b]Créer une base de donnée[/b]", renseigner le nom de la future base et validez.
Peu imaginatif, j’ai mis "[b]ragnarok[/b]" (mais vous pouvez changer).
La base va être alors créée. Mais elle est vide, il faut donc la remplir !
Une fois dans la base, cliquez sur l’onglet "[b]Importation[/b]" (note : pour Easyphp 1.8, c’est dans l’onglet SQL).
Utilisez le bouton "[b]Parcourir[/b]" pour aller chercher le fichier "[b]main.sql[/b]" dans le dossier "[b]sql-files[/b]" de votre SVN (donc pour moi : c :/guide/FoE/sql-files/main.sql).
Cliquez sur exécuter et hop, la structure "de base" est installé.
Si vous souhaitez gérer les mobs et les items via le SQL, répétez la manœuvre d’importation avec les fichier "[b]mob_db.sql[/b]" et "[b]items_db.sql[/b]" (pourquoi s’en priver ?).
Vous pouvez également importer "[b]mob_db2.sql[/b]" et "[b]items_db2.sql[/b]" si vous compter les utiliser (mob&items customs).

Bien, la base de données "principales" est prête.

Installons aussi [b]une autre base pour les logs[/b] (oui, ils ne sont plus dans la même base).
Retournez à l’interface "centrale" (en cliquant par exemple sur le lien "[b]Serveur:localhost[/b]").
Créez une seconde base.
Peu imaginatif, je l’ai nommé "log".

Ensuite, allez dans l’onglet "[b]Importation[/b]" et importer le fichier "[b]logs.sql[/b]" (toujours dans le dossier sql-files de votre SVN).
Voilà, vos bases sont prêtes ! Mais maintenant, il faut créer un (ou des) utilisateurs pour y accéder !

[b]2°) Création d’un utilisateurs pour se connecter aux bases[/b]

Retournez à l’interface "centrale" (en cliquant par exemple sur le lien "[b]Serveur:localhost[/b]").
Cliquez sur le lien "[b]Privilèges[/b]".
Vous verrez tout les utilisateurs pouvant accéder à vos bases (normalement que "root" pour l’instant).
Cliquez sur "[b]Ajouter un utilisateur[/b]".
Dans le champ "[b]Nom d’utilisateur[/b]" le login désiré. J’ai choisit "foe_bdd_connect".
Ensuite, à l’aide du menu déroulant, choisissez le serveur sur lequel l’utilisateur pourra ce connecter. Choisissez "[b]Local[/b]" pour avoir "localhost".
Enfin, pour des raisons de sécurité, il faut un [b]mot de passe[/b] compliqué.
Il y a un générateur aléatoire pour vous y aider. J’ai choisit "qXDGUH8CGuz8_vVE" : chiffres, lettres majuscules et minuscules et caractères spéciaux : ça devrait suffire.
Le but est ici d’éviter le banal/de base "ragnarok/ragnarok" en login/password. Autant prendre de bonne habitude même en local. [b]
Laissez tous les privilèges globaux décochés[/b] : cet utilisateur n’en a pas besoin.
Validez.

Editez à présent l’utilisateur crée pour lui ajouter des "[b]Privilèges spécifiques à une base de données[/b]".
Choisissez la base que vous avez créée (dans mon exemple : "ragnarok").
[b]Cochez tous les privilèges à part "GRANT".[/b]
Validez : cela donne "all privileges" à l’utilisateur sur cette base précise.
[b]Recommencer pour la seconde base (dans mon exemple : "log").[/b]

Voilà, vous avez un utilisateurs pouvant se connecter et agir sur les 2 bases de données du serveur RO.

[b]3°) Sécurisation des comptes et ajout d’un compte GM[/b]

Puisqu’on est là, on va renforcer la sécurité et se crée un compte GM.
Rendez-vous dans votre base principale (pour moi : "ragnarok").
Rendez-vous dans la table "[b]login[/b]" (cliquez dessus dans le menu à gauche).
Cliquez sur l’onglet "[b]Afficher[/b]".
Vous voyez alors que cette table contient un utilisateur, ayant pour [b]userid[/b] (login) : s1 et comme [b]user_pass [/b](password) : p1.
Niveau sécurité, c’est naze, nous allons donc le modifier.
Cliquez sur l’icône "crayon" pour modifier l’enregistrement.

Modifiez donc les champs "[b]userid[/b]" et "[b]user_pass[/b]" (et uniquement ceux là) pour mettre quelque-chose d’un peu plus compliqué.
J’ai choisit "foe_serv_connect" comme userid.
Ensuite, j’ai mis "SlyR4_23HJoMpQ6x" comme user_pass.
Validez et voilà un compte de connexion entre serveur plus sûr...

Créons au passage un (ou des) compte administrateur (GM 99).
C’est la même table "[b]login[/b]", ça tombe bien.
Cliquez sur l’onglet "[b]Insérer[/b]".
Dans le champ "[b]account_id[/b]", mettez "2000001" (c’est apparemment la tradition, mais théoriquement vous pouvez laissez ce champs vide ou mettre n’importe quoi à part 0 ou 1).
Dans le champ "[b]userid[/b]", mettez le login qui vous servira à vous connecter ingame. J’ai mis : "MageGaHell".
Dans le champ "[b]user_pass[/b]", mettez le mot de passe qui vous servira à vous connecter ingame. J’ai mis "zeugma_99b".
Note : il s’agit quand même du password du GM 99, donc faîtes compliqué (le mien est très moyen : pas assez long et pas assez diversifié et signifiant partiellement quelque-chose).
Dans le champ "[b]sex[/b]", choisissez "[b]M[/b]" ou "[b]F[/b]" selon que vous voulez un compte masculin ou féminin. [b]Ne choisissez jamais "S".[/b]
Mettez un email dans le champ "[b]email[/b]" (facultatif).
Dans le champ "[b]level[/b]", mettez [b]99[/b] (le plus haut niveau de GM).
Laissez tout le reste vide et valider (ne tenez pas compte du second formulaire identique en dessous, il n’est là que pour permettre de faire 2 enregistrement à la fois si besoin).

[b]Allons plus loin dans la sécurité : il n’est pas conseillé de laisser les mot de passe visible "en clair" dans la base de données.[/b]
Nous allons donc les crypter.
Pour cela, toujours quand vous êtes dans votre base principale (pour moi : "ragnarok"), cliquez sur l’onglet "[b]Importer[/b]".
Importez le fichier "[b]convert_passwords.sql[/b]" que vous trouverez toujours dans le dossier "[b]sql-files[/b]" de vote SVN.
Voilà, vos mots de passes sont cryptés en md5.
Note : s’il vous prend l’envie de rajouter des comptes (GM ou autre), [b]n’importez pas à nouveau "convert_passwords.sql"[/b] : il crypterait à nouveau tous les mots de passe, rendant les "anciens" inutilisable.
Utilisez alors cette syntaxe au cas par cas, en allant dans l’onglet SQL :

Où XXXXX est le l’account_id du compte dont vous souhaitez crypter le mot de passe
Plus simple encore : lors de l’insertion, utilisez le menu déroulant "[b]Fonction[/b]" et sélectionnez "MD5", en face du champ [b]user_pass[/b].

[b]V - Configuration (basique) du serveur.[/b]

La base de données est prête, le serveur compilé. Plus qu’à le configurer.
Là, nous allons d’abord faire une configuration "basique" pour tester le bouzin.

[b]1°) Liaison à la base de données SQL[/b]

Rendez-vous dans le dossier "[b]conf[/b]" de votre SVN (donc pour moi : c :/guide/FoE/conf/).
Editez (au bloc-note) le fichier "[b]inter_athena.conf[/b]"
Cherchez la partie "[b]Global SQL setting[/b]"
Remplacez les identifiants de base "ragnarok"/"ragnarok" par ceux de votre utilisateurs de connexion ("foe_bdd_connect"/"qXDGUH8CGuz8_vVE" pour moi)
Mettez donc le login aux lignes sql.db_username, char_server_id, map_server_id et log_db_id.
Mettez le mot de passe aux lignes sql.db_password, char_server_pw, map_server_pw et log_db_pw.
Si vous avez changez les noms des bases de données ("ragnarok" et "log"), modifiez également en conséquence les lignes sql.db_database, char_server_db, map_server_db et log_db_db
Enregistrez.

[b]2°) Connexions inter-serveurs.[/b]

C’est là qu’intervient l’utilisateur s1/p1. Qu’on a changé.
Il faut donc reporter ces changements dans le fichiers "[b]char_athena.conf[/b]" :

Et dans "[b]map_athena.conf[/b]" :

[b]Attention : si vous vous rappelez bien, nous avons crypté nos passwords utlisateurs en md5 ![/b]
Ouvrez donc le fichier "[b]login_athena.conf[/b]" et signalez cela au serveur :

[b]3°) Configuration des IPs (ultra-easy local mode)[/b]

Nous allons à présent configurer les IPs.
IP LAN, IP WAN, cela ferait presque peur, non ?
Mais dans ce point "facultatif", nous allons la jouer soft, voir ultra-soft.
Juste pour tester, car le guide est long et qu’on a quand même envie de voir tourner un peu son serveur.
Donc, c’est parti :
 Ouvrez le fichier "[b]char_athena.conf[/b]"
Décommentez la ligne [b]login_ip [/b] :

Et la ligne [b]char_ip[/b] :

 Ouvrez le fichier "[b]map_athena.conf[/b]"
Décommentez la ligne [b]char_ip[/b] :

Et la ligne [b]map_ip [/b] :

Et voilà. Oui, c’est tout.
Et oui, cela suffit à faire marcher le serveur en local.

[b]4°) Configuration des IPs (un peu plus sérieusement)[/b]

Bon, on va essayer de faire ça un peu mieux.
Il vous faut connaître votre [b]IP LAN [/b](IP locale de votre machine, personnellement c’est 192.168.1.22). Je vous fait confiance pour trouver votre propre IP et votre masque de sous-réseau vous même. Vous devez avoir une IP LAN fixe, sinon ça va être galère.
Il vous faut connaître votre [b]IP WAN[/b] (IP de votre connexion internet, en gros). Pour moi, c’est actuellement 86.68.95.78. Comment je sais ça ? Avec google (en tapant par exemple "my ip" et en allant sur un de nombreux sites l’affichant (comme [url="http://www.wimip.fr"]http://www.wimip.fr[/url]).
Notez que selon votre connexion internet/votre FAI cette IP change...
Vous pouvez utiliser [b]no-ip[/b] pour arranger ça.
Pour ça allez sur [url="http://www.no-ip.com/"]http://www.no-ip.com/[/url] et créez vous un compte.
Ensuite ajoutez un "[b]Host[/b]" qui pointe sur votre [b]IP WAN[/b] actuelle (86.68.95.78 pour moi). J’ai choisit mgh-foe.no-ip.org comme
Téléchargez et installez le petit logiciel de no-ip. Connectez-vous avez votre compte (avec votre mail/password).
Vous devriez voir votre "Host" : cochez-le.
[b]Voilà, le logiciel de no-ip maintiendra à jour la liaison IP WAN/ Host.[/b]

[b]Procédons donc à la configuration du serveur :[/b]

 Ouvrez le fichier "[b]char_athena.conf[/b]"
Décommentez la ligne [b]login_ip[/b] :

Où [b]IP LAN[/b] est votre IP LAN (donc pour moi 192.168.1.22).

Et la ligne [b]char_ip[/b] :

Où [b]IP WAN [/b]est votre IP WAN ou votre no-ip. Donc pour moi soit 86.68.95.78, soit mgh-foe.no-ip.org
J’ai choisit le second.

 Ouvrez le fichier "[b]map_athena.conf[/b]"
Décommentez la ligne [b]char_ip[/b] :

Où [b]IP LAN[/b] est votre IP LAN (donc pour moi 192.168.1.22).
Puis la ligne [b]map_ip[/b] :

Où [b]IP WAN[/b] est votre IP WAN ou votre no-ip. Donc pour moi soit 86.68.95.78, soit mgh-foe.no-ip.org
J’ai choisit le second

 Ouvrez le fichier "[b]subnet_athena.conf"[/b]
Ajoutez un [b]subnet [/b]sur votre IP LAN

Soit pour moi :

[i]Note : cela fonctionnera avec un subnet:255.0.0.0:IP LAN:IP LAN mais ce n’est pas optimum.[/i]

Voilà, c’est fait.
Lancez le runserver-sql.bat
Normalement, tout devrait être au vert.

[b]5°) Petit test rapide.[/b]

Downloadez un client récent d’un serveur "correct".
Créez un dossier "[b]data[/b]" et placez-y ce [b]sclientinfo.xml[/b] :

Vous pouvez évidemment modifier un peu ce sclientinfo.xml pour le personnaliser...

[i]Note : vous pouvez utiliser votre IP LAN dans la balise <address>[/i]

[i]Note 2 : vous ne pouvez y utiliser votre IP WAN/NO-IP si vous êtes l’Host.[/i]

Lancez, normalement vous pourrez vous connecter à votre local.

[b]6°) Configuration finale du serveur.[/b]

Bon, ça tourne... Il est donc temps d’appliquer vos modifications des conf : explorer les fichiers du dossier "[b]conf[/b]" (et autres) afin de mettre en place votre configuration (rates et autres réglages).
Vous pouvez en profiter pour mettre en place les traductions et ressources du Book Of Ymir.
Si vous vous faîtes des modifications dans les sources, il faudra recompiler le serveurs avec cygwin (voir partie III.3).

[b]7°) Et après ?[/b]

La suite logique est de faire son propre client : vous n’allez tout de même pas rester avec un truc volé à d’autres et sortis d’on ne sait où ?
De plus, il y a de grande chance que ça vous pète à la gueule...

Voilà, c’est tout pour le moment : Reste à faire :
 correction orthographique
 un second guide centralisateur sur "comment faire son client".
 vérifier que j’ai pas raconter trop de conneries dans ce guide et attendre le retour des pros...