Affichage et gestion d'une page de maintenance
Attention cette note technique ne sera valide qu'après application du Service Pack 1 .Net 2013. le filtre sur le rôle AdminMaintenance n'est disponible qu'à partir de la version 2016. Il est possible d'afficher une page de Maintenance ne donnant donc pas accès à l'application. Voici les explications permettant d'afficher et/ou de retirer cette page:
I) Affichage de la page de gestion de la maintenance:
I-1) Affichage de la page
Pour afficher la page permettant le paramétrage de la page de Maintenance, ajoutez une entrée en mode avancé :
OpenPage("Security/MaintenancePage.aspx")
I-2) Droits sur le répertoire APP_Data
Vérifier les droits de lecture/écriture du compte d'exécution du pool sur le répertoire APP_Data
II) Gestion de la page de maintenance
II-1) Paramétrage et affichage du message de maintenance
Sur le site, allez sur la page de maintenance que vous avez préalablement créée. Le code de la page de maintenance s'affiche et est modifiable.
Pour activer la page de maintenance, saisissez le login et mot de passe (utilisateur ayant des droits d'admin) et cliquez sur "Activer le mode maintenance". Si la cas "Sauf pour rôle [AdminMaintenance]" est coché, alors tous les utilisateurs seront redirigés sur l'écran ci-desous à l'exception des utilisateurs ayant le rôle AdminMaintenance.
Voici dans ce cas le résultat obtenu:
II-1) Désactivation de la page de maintenance.
Pour désactiver la maintenance, saisissez le login et mot de passe admin et cliquez sur "Désactiver le mode maintenance".
III) Informations complémentaires
III-1) Version On-premise
La mise en maintenance d'un site web onpremise crée dans le répertoire APP_Data un fichier maintenance_mode.on qui contiens le texte (+ mise en forme) du message à afficher. La désactivation du mode maintenance renomme ce fichier en maintenance_mode.off (permet de conserver le message customisé d'une mise en maintenance à l'autre)
III-2) Version AZURE
Dans AZURE, le mode maintenance actif ou non est géré dans une table AZURE AVTMaintenanceMode dont la clé est composée de la clé de déploiement AZURE (AVTPackageKey) et du nom de l'application (ApplicationName)
Il peut y avoir un délai de 5mn entre l'activation du mode maintenance et sa propagation sur toutes les instances AZURE La sortie du mode maintenance est elle instantannée sur toutes les instances.
Ajouter #define AZURE sur la première ligne des fichiers Global.asax.cs et Security/MaintenancePage.aspx.cs ==> Fait par AzureStudio Ajouter l'assembly System.Data.Services.Client dans la section compilation du fichier Web.config ==> Fait par AzureStudio Ajouter la dll Avanteam.Azure.Tools.dll dans le bin du site web