Installation illustrée de DotNetNuke en français
Document rédigé les 6 et 7 mars 2006 ; pas encore de mise à jour
URL: http://www.poirrier.be/~jean-etienne/info/csharp/installation-dnn/index.php
DotNetNuke est un outil "Open Source" (licence BSD) pour la création de portail web sur internet ou de système de gestion de contenu (CMS) ou de gestion de communauté. Approximativement dans la même catégorie (mais avec d'autres outils : PHP et MySQL), on trouve PHPNuke, PostNuke ou Portix2 (sans base de données !), par exemple.
Le but de ce tutoriel est d'installer DotNetNuke sur un serveur personnel et en français.
1. Pré-requis
Je suppose que MS-Visual Studio 2005, MS-SQL Server 2005 et MS-IIS (Internet Information Services) sont installés, chez vous, sur la même machine. De ce fait, la version 2 framework .Net devraient aussi être installée. Vous pouvez généralement obtenir des versions de développement avec un abonnement MSDN ou MA3D dans votre école (si vous êtes étudiant). Notez que cette installation peut également se faire avec MS-Visual Web Developer et MS-SQL Server 2005 Express, deux outils gratuits (mais pas libres) de Microsoft.
Ce tutorial s'inspire largement de celui de sbwalker et de celui de adefwebserver (mais ils sont en anglais). Vous pouvez vous référer à ces pages pour des explications plus étendues ("verbeuses" diront certains) sur certains points.
2. Téléchargement
Avant de pouvoir télécharger DotNetNuke, ils disent qu'il faut s'enregistrer sur leur site web : http://dotnetnuke.com/. Allez plutôt sur leur page sur SourceForge (http://sourceforge.net/projects/dnn), cliquez sur le bouton "Download", descendez dans la page jusque "File Release" et choisissez le Starter Kit de la dernière version en cours (4.0.2 lors de la rédaction de ce tutorial, le 6 mars 2006). Un dernier clic sur un des mirroirs (HEAnet et OVH.com fonctionnent bien) et vous voilà en train de télécharger DotNetNuke (un peu moins de 5Mo).
3. Installation du Starter Kit
Si ce n'est pas déjà fait, rendez-vous dans la console de gestion d'Internet Information Services et démarrez votre site web.
Rendez-vous dans le répertoire où vous avez téléchargé votre fichier et lancez-le (double-clic dessus, dans l'Explorateur). Dans la première fenêtre, le programme vous demande le contenu à installer. Laissez toutes les options cochées et cliquez sur le bouton "Next" (suivant).
Vous allez recevoir une fenêtre vous indiquant que l'installateur ne trouve pas de signature. Cette signature sert à vérifier que l'application n'a pas été corrompue par une personne malveillante. Le seul moyen de continuer est de cliquer sur "Oui" (pour quand même installer le logiciel).
Ensuite, l'installateur vous dit qu'il suffit de cliquer sur le bouton "Finish" pour terminer l'installation. Faites-le.
Après un temps relativement court (cela dépend de la puissance de votre machine), l'installation dit qu'elle a fini. Il ne vous reste plus qu'à cliquer sur le bouton "Close".
4. Créer notre première application DotNetNuke
Afin de créer notre première application DotNetNuke, lancez MS-Visual Studio 2005. Dans le menu File, choisissez l'option "New ..." puis "Web Site...".
Vérifiez bien que, dans le bas de la boîte de dialogue, le langage soit bien Visual Basic (sinon, vous ne verrez pas la suite !). Sélectionnez l'item "DotNetNuke Web Application ..." dans la section des templates personnels. Comme cette première application ne servira qu'à nous familiariser avec DotNetNuke, nous pouvons simplement la laisser dans http://localhost/. Veillez simplement à lui donner un nom évocateur (ici : DNN1). Cliquez sur le bouton "OK" et laissez votre ordinateur travailler pendant quelques temps.
A la fin de l'installation, votre écran devrait ressembler à celui-ci :
Il reste encore beaucoup de choses à faire : gérer la connexion au serveur MS-SQL Server 2005, configurer les accès et permissions, choisir un template (du site) et, finalement, installer DotNetNuke (hé oui, cela n'est pas encore fini !).
5. Configuration du serveur SQL
Par défaut avec ce Starter Kit, c'est l'utilisation de SQL Server 2005 Express qui est définie. Heureusement, l'équipe de DotNetNuke a tout prévu et ils ont écrit une page pour la configuration de MS-SQL Server 2005 (non-Express) : http://localhost/DNN1/Documents/SQLServer2005Config.html (remplacer "DNN1" par le nom de votre projet).
Lancez le SQL Server Management Studio. Dans l'explorateur d'objets (à gauche, normalement), sélectionnez l'item "Databases" dans le serveur SQL que vous voulez employer. Chez moi, je n'en ai qu'un : çà simplifie la vie. En production, cela peut être différent. Faites un clic droit sur "Databases" et choisissez "New Database...". Dans la boîte de dialogue qui apparaît, donnez simplement un nom à votre base de données (ici : DNN1 pour faire simple). Cliquez finalement sur le bouton OK.
Pour être complet (on pourrait s'en passer), on va utiliser la SQL Server Authorization. Pour cela, il nous faut un utilisateur.
Tout d'abord, dans l'explorateur d'objets de MS-SQL Server Management Studio, déroulez le dossier Security. Faites un clic droit ensuite sur le dossier des Logins et créez un nouveau login (j'ai choisi utilisateurdnn1). Donnez un mot de passe (pour l'identification par SQL et non par Windows ; ici, j'ai choisi un mot de passe très peu sécurisé pour m'en souvenir : utilisateurdnn1 ! Jamais personne ne doit pouvoir accéder à un site aussi mal sécurisé mais c'est une première approche et il sera toujours temps de changer le mot de passe par la suite). Indiquez la base DNN1 comme base par défaut. Validez en cliquant sur le bouton OK.
Toujours dans l'explorateur d'objets, déroulez votre base de données (DNN1 dans cet exemple) et déroulez encore le dossier de sécurité : tous les utilisateurs sont répertoriés dans le dossier ... "Users". Faites un clic droit dessus et choisissez de créer un nouvel utilisateur. Donnez-lui un nom (pas présent sur la capture d'écran ci-dessous), le login précédemment créé et, surtout, donnez lui un schéma et un rôle de db_owner.
La partie dans MS-SQL Server 2005 est terminée. Maintenant, il faut adapter la chaîne de connexion dans l'application. Retournons dans MS-Visual Studio 2005. Dans l'explorateur de solution (normalement, en haut à droite), renommez le fichier release.config en web.config (clic droit, Rename). Double-cliquez dessus pour l'éditer.
Dans la section "connectionStrings", la chaîne de connexion pour SQL Server 2005 (non-Express) est mise en commentaire.
Il faut supprimer (ou mettre en commentaire) le bloc contenant la chaîne pour Express et laisser (non commentée) le bloc contenant la chaîne pour SQL Server 2005. En l'adaptant, la chaîne devient connectionString="Server=COMPAQ;Database=DNN1;uid=utilisateurdnn1;pwd=utilisateurdnn1;" (adaptez si vous n'avez pas les mêmes noms).
Notez qu'il y a une seconde chaîne de connexion à modifier, juste après ...
Ce qui donne, en reprenant les deux modifications :
<connectionStrings> <add name="SiteSqlServer" connectionString="Server=COMPAQ;Database=DNN1;uid=utilisateurdnn1;pwd=utilisateurdnn1;" providerName="System.Data.SqlClient" /> </connectionStrings> <appSettings> <add key="SiteSqlServer" value="Server=COMPAQ;Database=DNN1;uid=utilisateurdnn1;pwd=utilisateurdnn1;" /> <add key="InstallTemplate" value="DotNetNuke.install.config" />
6. Configuration d'IIS
Normalement, il ne faut rien faire pour configurer IIS. Néanmoins, il faut vérifier certains choses ... Dans IIS, faites un clic droit sur le répertoire contenant DotNetNuke (DNN1 ici) et choisissez Propriétés. Dans l'onglet "Directory", donnez un nom à votre application (cliquez sur le bouton Apply). Et, dans l'onglet "ASP.Net", vérifiez bien que la version d'ASP.Net est bien supérieure à 2. Cliquez sur le bouton OK pour fermer les propriétés.
Normalement, il n'y a pas besoin de configurer les permissions sur le système de fichier.
7. C'est (presque) fini !
Ouf ! C'est fini. Maintenant, soit vous restez dans MS-Visual Studio 2005 et vous pouvez cliquer sur Ctrl + F5 pour installer DotNetNuke. Soit vous ouvrez un navigateur digne de ce nom et vous vous connectez à l'URL: http://localhost/DNN1. Si tout va bien, toute une série de lignes vont s'afficher. Laissez défiler. Tout en bas, à la fin, vous devriez avoir une phrase qui dit "Click Here To Access Your Portal". Cliquez dessus ! Voilà ! :-)
C'est un peu vide pour le moment mais çà fonctionne. On verra plus tard comment peupler le tout...
8. Installation du pack de langue française
A écrire ...
Save this page in del.icio.us