En partant d'un module qui fonctionne pour une application asp.net la migration vers IIS est une simple formalité quand on sait que l'élément module a changé de place dans le fichier web.config. Pour la beauté du geste nous allons utiliser la console d'administration pour installer le module.
On commence par créer un répertoire dans c:\inetpub pour y copier l'application demoCas qui utilise le module. On modifie ensuite le fichier web.config pour enlever toute référence au module en supprimant l'élément
<module>. Je rappelle que la dll du module se trouve dans le répertoire bin de l'application. Et on lance la console pour ajouter une nouvelle application.
Ajout d'une nouvelle application
Pour ajouter le module à l'aide de la console, on sélectionne le module dans le panneau de gauche et on double clic sur l'item module du panneau central
Gestion des modules
La liste des modules installés et hérités sur le serveur apparaît. On choisit maintenant d'ajouter un module managé (premier lien dans le panneau de droite). Il ne reste plus qu'à remplir la boîte dialogue avec le nom que l'on veut donner au module et ...
liste déroulante de choix de module
de sélectionner le module dans la liste déroulante, dans notre cas le dernier.
La case à cocher « invoke only... »
option du module
est l'option qui permet d'étendre la porté du module à l'ensemble des éléments de l'application. Si on désire un fonctionnement comme IIS6, il suffit de cocher la case, ce que nous ne ferons pas ici.
On clique le bouton OK pour ajouter le module à la liste et le tour est joué.
La console a ajouté ce qu'il au fichier web.config
<configuration>
<system.web>
<!--
...
-->
</system.web>
<system.webServer>
<modules>
<add name="casModule" type="Upmc.CasModule.CasModule" />
</modules>
</system.webServer>
</configuration>
en l'occurrence l'élément
system.webServer avec l'élément module. C'est à la limite plus facile en faisant un copier/coller.
Je rappelle que le module a besoin de paramètres qui sont dans la section <appSettings> du fichier web.config. On peut toujours ajouter la dll et les paramètres pour toutes les applications. Mais IIS avec sa gestion des requêtes intégrées (integrated processing) et son nouveau système de configuration hiérarchique permet de mettre le module à la disposition de toutes les ressources du serveur.
Passons maintenant à l'étape suivant en adaptant le module pour cette nouvelle version d'IIS, en commençant par les paramètres.