Guide d installation Le Portail Sage v2.0 Pour les professionnels de l Habitat Social
Le Portail Sage 2.0 juin 2011 Sommaire 1 Prérequis d installation :... 3 2 Architecture technique... 4 2.1 Ordre d installation... 4 2.2 Schéma d architecture technique simplifié :... 4 2.2.1 Récupération des chaines de connexion aux différentes bases de données en s appuyant sur le catalogue.... 5 3 Installation du Portail... 6 3.1 Partie Serveur... 6 3.1.1 Installation du Portail... 6 3.1.2 Installation des services web... 14 3.2 Partie Client... 16 3.2.1 Installation du Client... 16 3.2.2 Installation des vignettes... 20 4 Vérifications du Fonctionnement... 26 5 Installation IIS (Serveur 2003)... 30 6 Installation IIS (Serveur 2008)... 36 7 Informations complémentaires... 40 7.1 DB Manager... 40 7.1 Sage News... 40 8 Messages d anomalies... 42 Guide d installation 2/44
Document indiquant la marche à suivre pour installer la partie Serveur et la partie client du Portail Sage. 1 Prérequis d installation : Avant de procéder à l installation, prenez quelques instants pour vérifier les prérequis définis ci-dessous. Ils vous permettront d installer l application dans des conditions optimales. Les prérequis sont présentés sous forme de check-list. Si l un des éléments de la check-list n est pas vérifié, l installation ne pourra aboutir. Point de contrôle Elément à vérifier Comment vérifier 1 J ai vérifié que le serveur sur lequel je m apprête à installer l application est conforme aux prérequis techniques Les prérequis techniques sont disponibles sur l espace client. 2 J ai vérifié que le serveur sur lequel je m apprête à installer l application possède un serveur web de type Internet Information Server et que ce dernier est bien activé. Méthode 1 : Démarrer > Rechercher > IIS. Si les services IIS sont installés, il apparaît la mention «Gestionnaire de services Internet (IIS)» sous l intitulé Programmes Méthode 2 : Panneau de Configuration > Programmes et Fonctionnalités > Activer ou désactiver les fonctionnalités Windows > Vérifier que «Serveur Web IIS» apparaît dans la liste des rôles du serveur. 3 J ai créé un utilisateur sur le domaine Je peux me connecter au domaine avec l utilisateur créé. Nota : Ne pas oublier de vérifier que l utilisateur autorisé ai bien les droits d accès en lecture écriture au niveau des répertoires de l application et notamment du répertoire contenant le fichier Catalogue.mdb. 4 J ai vérifié que le serveur sur lequel je m apprête à installer l application possède bien le Framework.NET 2.0 et ASP.NET 5 Si mes bases de données sont de type Oracle, j ai installé un client Oracle sur le serveur sur lequel je m apprête à installer l application 6 Je possède la clé d authentification qui me sera demandée lors de l installation du produit Méthode 1: Je me rends dans le répertoire C:\Windows\Microsoft.NET\Framework Le Framework 2.0 doit apparaître dans la liste affichée. Méthode 2: J accède au Panneau de Configuration > Programmes et Fonctionnalités > Le Framework 2.0 doit apparaître dans la liste. Je vérifie qu il existe bien un répertoire Oracle sur mon serveur. Cette clef, composée d une suite de 3 codes de 6 caractères alphanumériques, m est fournie par Sage Collectivités Locales et Habitat Social. 7 Je connais le chemin d accès à la base de données de Pour cela et de façon simple, je peux Le Portail Sage v2.0 3/44
catalogue Sage faire une recherche du fichier «Catalogue.mdb» 2 Architecture technique Le portail Sage est une application multi-tiers basée sur 3 couches : 1. Une couche de présentation qui s installe sur chaque poste client et qui permet à l utilisateur de définir ses propres vues en fonction de ses besoins 2. Une couche de services web qui effectue les traitements de calcul et qui nécessite pour cela un serveur Web 3. Une couche d accès et de traitement des données qui se situe côté base de données. 2.1 Ordre d installation L application se compose de 2 packages qui s installent automatiquement, mais dans un ordre précis. L installation principale s exécute sur un serveur web Windows ou un serveur sur lequel Internet Information Server est soit installé soit installable. 2.2 Schéma d architecture technique simplifié : Le Portail Sage v2.0 4/44
Figure 1 : schéma d'architecture générale Les couches 2 et 3 peuvent être mutualisées sur un seul et même serveur. Sur un serveur Terminal Services ou CITRIX, les couches 1 2 et 3 peuvent être également mutualisées sur un seul et même serveur. Le processus d installation fonctionne de manière chronologique : Dans un premier temps, l application vous propose d installer la couche n 2 située sur le serveur Web. Cette opération réalisée, vous devrez dans un second temps procéder à la mise en place de la couche n 1 (couche client) qui sera installée sur chaque poste client susceptible d utiliser l application Sage Le Portail. 2.2.1 Récupération des chaines de connexion aux différentes bases de données en s appuyant sur le catalogue. Sage Le Portail est capable de produire un «Mashup» de vignettes dont les données sont issues de bases de données différentes. Il est ainsi possible d obtenir dans une même page, deux vignettes identiques, mais dont le contenu diffère car liées à des bases de données différentes. Ce paramétrage s effectue en 2 parties : 1. Les vignettes doivent connaître à l avance la liste des bases de données qui peuvent être connectées. Pour cela, Sage le Portail se base sur le catalogue de bases de données issu de l application Sage DbManager. Cette dernière est un outil d administration qui permet de définir, par application Sage, la liste des bases de données et les droits de chaque utilisateur sur ces bases. Le résultat produit une chaine de connexion qui pourra ensuite être utilisée par toutes les applications, notamment Sage Le Portail. Il est donc nécessaire pour cela, que le catalogue qui contient l ensemble des bases connectables soit accessible par le serveur Web sous forme d un partage de fichier (SMB). Ce catalogue se nomme catalogue.mdb. Le paramétrage des vignettes permet de sélectionner la base de données parmi celles qui sont connectées. 2. Le paramétrage des vignettes permet de sélectionner la base de données parmi celles qui sont connectées. Le Portail Sage v2.0 5/44
3 Installation du Portail 3.1 Partie Serveur 3.1.1 Installation du Portail Sur le serveur, dans le dossier d installation contenant les éléments ci-dessous Lancer l application «Setup» Il peut apparaitre un message de sécurité du système d exploitation. Cliquez le bouton «Oui» Le Portail Sage v2.0 6/44
Ce setup lance la vérification des prérequis de l'installateur et enchaîne l'installation du noyau et des services Web. Lorsque vous avez cliqué sur le bouton «OK» et que les applications IIS et/ou ASP.Net 2.0 ne se trouvent pas installées sur le poste destinataire, le message ci-contre s affiche Cliquer sur «OK» Cliquer sur «Terminer» pour installer les applications nécessaires à l installation du Portail Sage. Vérifiez les prérequis d installation disponibles au chapitre 1 de cette documentation. Le Portail Sage v2.0 7/44
Procéder ensuite à l installation de IIS puis de ASP.NET 2.0 : Pour cela, aller dans Panneau de Configuration => Programmes et Fonctionnalités Nota : L installation IIS sur serveur 2003 est décrite au chapitre 5 L installation IIS sur serveur 2008 est décrite au chapitre 6 Sélectionner sur le panneau de droite «Activer ou Désactiver des fonctionnalités Windows» (Windows 7 ou Vista) Sélectionner sur le panneau de droite «Activer ou Désactiver des fonctionnalités Windows» Le menu de fonctionnalités Windows. Dans Service Internet (IIS) / : Compatibilité avec la gestion IIS 6. Cochez «Compatibilité avec la Métabase IIS et la configuration IIS 6» Service World Wide Web => Fonctionnalités de développement d application Cocher «ASP.NET» Puis cliquer sur OK Le Portail Sage v2.0 8/44
L installation des fonctionnalités Windows démarre Si vous utilisez l'assistant Ajout de rôles pour installer IIS, vous obtenez l'installation par défaut qui comporte un ensemble de services de rôle minimal. Si vous avez besoin de services de rôle IIS supplémentaires, tels que Développement d'applications ou État de santé et diagnostics, assurezvous d'activer les cases à cocher associées à ces fonctionnalités sur la page Sélectionner les services de rôle de l'assistant. Une fois l installation effectuée, relancer le programme Setup.exe du Portail. Une fois l installation effectuée, relancer le programme Setup.exe du Portail. Le message ne s affichant plus, le bouton Suivant est disponible. Cliquer sur ce bouton pour installer le Portail. Le Portail Sage v2.0 9/44
Après avoir pris connaissance du contrat de licence, Cocher la case «J accepte les termes du contrat de licence». Puis Cliquer sur «Suivant» Renseigner la clef d authenticité qui vous a été fournie par Sage, puis «Suivant». Si vous ne possédez pas la clef d authenticité, contactez Sage pour la recevoir. Dans le cas d une installation particulière (utilisateur avancé) ces paramètres peuvent être modifiés. Dans tous les autres cas, cliquer sur «Suivant». Le Portail Sage v2.0 10/44
Renseigner le domaine et l utilisateur qui permettra la connexion au Portail. De préférence, créer un utilisateur spécifique avec des droits utilisateur limité (accès DBManager nécessaire). Attention, cet utilisateur doit obligatoirement posséder un mot de passe Exemple : Si le compte «SagePortail» été créé sur le serveur nommé WS2008, il faudrait renseigner : «\\WS2008\SagePortail» sur la ligne utilisateur d exécution. Cf. ci-contre Cliquer sur «Suivant».. \\WS2008\SagePortail La saisie du mot de passe utilisateur est requise. Remarque : Un compte d utilisateur limité avec son mot de passe, dans le système d exploitation. Voir la création d un nouveau compte dans le Panneau de configuration Comptes d utilisateurs. Messages d anomalies possibles : Vous n avez pas saisi de mot de passe pour l utilisateur Le Portail Sage v2.0 11/44
Veuillez Vérifier votre le nom ou le mot de passe saisi Début d installation du Portail : Début de l installation du portail : Cliquer sur «Installer». Le Portail Sage v2.0 12/44
L installation du Portail est effectuée, Cliquer sur «Terminer» Le Portail Sage v2.0 13/44
3.1.2 Installation des services web Installation des services Web - Serveur Cliquer sur «Suivant», le chemin par défaut correspondant normalement au chemin du dossier d installation du Package. Cliquer sur «Suivant». Il est possible d installer les vignettes Taux sans installer les vignettes Financements. Par contre, l installation des vignettes Financements nécessite l installation des vignettes Taux. Par défaut les deux sont cochées. Cliquer sur «Suivant». Le Portail Sage v2.0 14/44
Indiquer le chemin d accès au catalogue DBmanager. Il s agit du catalogue partagé par toutes les applications Sage et énumérant la liste des bases de données ainsi que les droits de chaque utilisateur sur ces bases. Cliquer sur «Suivant». L installation de la partie Portail Serveur est terminée. Cliquer sur «Fermer». Cet écran reprend le chemin accès au package d installation de la partie client. Ce chemin est copié dans le presse papier Windows. Cliquer sur «Fermer». Le Portail Sage v2.0 15/44
3.2 Partie Client 3.2.1 Installation du Client Exemple d un POSTE CLIENT WINDOWS 7 Se connecter au serveur en utilisant le lien indiqué lors de l installation de la partie serveur dans l exemple de cette installation, on inscrira «\\WS2008SAAS\PortailInstall\Setup.exe» Affichage du contenu Comme pour la partie serveur, lancer l application Setup, et cela depuis chaque poste Client. Se connecter au serveur en tant qu administrateur Il est possible que le message suivant s affiche. Dans ce cas, cliquer sur Oui Le Portail Sage v2.0 16/44
Le programme d installation vérifie les prérequis nécessaires au bon fonctionnement du Portail. Une fois cette vérification effectuée, Cliquer sur «OK» Préparation de l installation sur le poste Client. Cliquer sur le bouton «Suivant» pour installer le Portail. Le Portail Sage v2.0 17/44
Après avoir pris connaissance du contrat de licence, cocher la case «J accepte les termes du contrat de licence» Puis cliquer sur «Suivant» Par défaut, la création d un raccourci sur le bureau est décochée. Vous pouvez ajouter automatiquement la création d un raccourci sur le bureau vers «Le Portail Sage» en cliquant sur Raccourci sur le bureau et en sélectionnant installer cette fonctionnalité puis cliquer sur «Suivant». Le Portail Sage v2.0 18/44
Cliquer sur «Suivant» Cliquer sur «Installer». Patienter pendant le déroulement de l installation. Le Portail Sage v2.0 19/44
Cliquer sur «Terminer». 3.2.2 Installation des vignettes Le répertoire indiqué par défaut est celui qui contient les vignettes à installer. Il n est pas à modifier. Le Portail Sage v2.0 20/44
Par défaut, toutes les vignettes sont proposées à l installation. Vous pouvez limiter l installation d un groupe de vignettes en décochant la case à cocher correspondante. Nous vous recommandons cependant de conserver la sélection présentée par défaut. Lorsque l application SageNews n est pas détectée sur le poste, le package l installe. Sage News est une solution qui permet notamment d avertir automatiquement l utilisateur lorsqu une nouvelle version de l un des progiciels Sage est disponible en téléchargement. Cliquer sur «Suivant». Attention : le fait de ne pas installer le SageNews provoque l arrêt de l installation du Portail, Le Portail Sage v2.0 21/44
Accepter les termes de la licence et Cliquer sur «Suivant» Cliquer sur «Suivant». Le Portail Sage v2.0 22/44
Cliquer sur «Suivant». L installation s exécute, une barre de progression est affichée. En fin de progression, cliquer sur «suivant» Le Portail Sage v2.0 23/44
Cliquer sur «Fermer». L installation de SageNews est terminée. Cliquer sur «Suivant». L installation de la partie CLIENT est terminée. Vous pouvez démarrer le Portail. Cliquez sur «Fermer» La case démarre le portail étant cochée par défaut. Le Portail Sage v2.0 24/44
Le Portail Sage v2.0 25/44
4 Vérifications du Fonctionnement Faire une vérification depuis le serveur, puis une vérification depuis les postes clients. L idéal étant de faire une connexion avec deux postes clients. Aller dans la barre de menu démarrer. Cliquer sur «Le Portail Sage». En fonction des paramètres de sécurité du serveur, le message suivant peut être affiché. Dans ce cas, pour accéder à l application, il suffit de cliquer sur «Autoriser l accès ou Débloquer». La fenêtre de connexion au portail apparaît pendant quelques instants pendant le chargement de l application. Le Portail Sage v2.0 26/44
Sur l écran suivant, renseigner : L adresse du serveur proxy Le domaine Le nom d utilisateur Le mot de passe Attention : cet utilisateur peut être différent de celui qui a été créé pour l accès au serveur sur lequel est installé le portail. Il s agit des utilisateurs autorisés par le proxy de la société. Pour valider les information saisies, cliquer ensuite sur «OK» Vous venez d installer une version d évaluation dont la validité est fixée à 3 mois d essai. Le message «votre configuration» s affiche si le serveur a été modifié (dans le cadre de cette documentation, c est le cas, le serveur ayant été installé sur plusieurs postes) Affichage de la page d accueil du Portail Le Portail Sage v2.0 27/44
En cliquant sur l icône «le Portail» de l image précédente, on accède à la page d information Le Portail Sage. De la même façon, en cliquant sur l icône «Les Produits» les informations commerciales concernant les produits Sage Collectivité Locales et Habitat Social sont proposées. C est également une autre page d information qui est proposée lorsque l on clique sur «Les Services» Pour accéder à l application Portail, il suffit de cliquer sur l onglet «Portail Sage» situé en haut de page (Page d accueil). L écran ci-contre est alors proposé. Le Portail Sage v2.0 28/44
En utilisant l onglet «Mon Portail», la fenêtre interactive ci-contre est proposée. Cette fenêtre est personnalisable par simple glisser-déposer des informations qui se trouvent dans la partie gauche de l écran. Ci-contre un exemple de paramétrage de la fenêtre «Mon Portail» Affichage de la courbe des taux Le Portail Sage v2.0 29/44
5 Installation IIS (Serveur 2003) Pour mémoire, vous trouverez ci-dessous le procédé d installation de IIS. Barre démarrer : Clic droit sur poste de travail puis gérer Cliquer sur Suivant > Patienter pendant la détection des paramètres réseau Le Portail Sage v2.0 30/44
Sélectionner l option Configuration personnalisée. Cliquer sur Suivant. Sélectionner dans la liste l élément Serveur d applications (IIS. Cliquer sur Suivant. Sélectionner l option ASP.NET Cliquer sur Suivant. Le Portail Sage v2.0 31/44
Cliquer sur Suivant. Patienter pendant la configuration du système. Si nécessaire, insérer à l emplacement approprié le CD-Rom/DVD d installation de Windows. Le Portail Sage v2.0 32/44
Sélectionner le fichier demandé et cliquer sur Ouvrir. Patienter pendant la configuration. Cliquer sur Terminer. Le Portail Sage v2.0 33/44
Pour vérifier l installation Démarrer / exécuter / INETMGR Attention, suite à l installation de IIS, ASP.NET v2.0.50727 n est pas présent dans la liste passer en mode commande (exécuter cmd), puis se positionner dans le répertoire c:\windows\microsoft.net\framework\v2.0.50727 Puis Lancer la commande aspnet_regiis i Le Portail Sage v2.0 34/44
L installation d Asp.Net est terminée. Dans le gestionnaire IIS, extension du service Web, la ligne correspondante apparaît maintenant, il convient d autoriser ASP.NET v2.0.50727 Le Portail Sage v2.0 35/44
6 Installation IIS (Serveur 2008) Pour Installer IIS sur le serveur 2008, procéder de la façon suivante : Cliquez sur Démarrer, sur Outils d'administration, puis sur Gestionnaire de serveur. Dans Résumé des rôles, cliquez sur Ajouter des rôles. Utilisez l'assistant Ajout de rôles pour ajouter le rôle de serveur Web. L assistant ajout de rôle est affiché. Cliquer sur Suivant Cocher la case Serveur Web (IIS) Le Portail Sage v2.0 36/44
Cliquer sur ajouter les fonctionnalités requises Cliquer sur Suivant Cliquer sur Suivant Le Portail Sage v2.0 37/44
Dans développement d applications : Cocher la case ASP.NET Puis en utilisant l ascenseur, Dans Service Internet (IIS) : Compatibilité avec la gestion IIS 6 cocher «Compatibilité avec la métabase IIS et la configuration IIS 6» Cliquer sur ajouter les fonctionnalités requises Rappel des rôles demandés. Cliquer sur Installer Le Portail Sage v2.0 38/44
Démarrage de l installation de IIS Résultat de l installation de IIS et rappel des services installés Cliquer sur Terminer Les rôles sont maintenant visibles dans le Gestionnaire de serveur. Fermer le gestionnaire de serveur et (re)lancer l installation du Portail sage Le Portail Sage v2.0 39/44
7 Informations complémentaires 7.1 DB Manager L exploitation de l information dans différents domaines d activités et ses spécificités. Demandent une gestion regroupée de données, afin d assurer le partage et l intégrité de l information. Sage Database Manager est le gestionnaire d administration des applications Sage qui permet d intégrer et administrer les bases des données, contrôler ses utilisateurs et gérer leur sécurité. DB Manager, regroupe diverses fonctionnalités d administration. Il assure la création, les modifications, les suppressions ou réparations des bases associées aux logiciels Sage, ainsi que les fonctionnalités de maintenance, telles que les réparations-compactages des informations, les vérifications de connexion entre le moteur de base et les produits Sage, le déverrouillage suite à des traitements spécifiques de métier, des mises à jour de produits. 7.1 Sage News Sage News est un système d information automatisé qui vous permet de rester en contact permanent avec Sage Collectivités locales, Habitat Social et Immobilier. Le module Sage News interroge notre serveur de news pour vérifier si une nouveauté est disponible. Il peut s agir d informations multiples comme la mise à disposition d une nouvelle version, le déroulement d une prochaine campagne de communication Le Portail Sage v2.0 40/44
Cette fonctionnalité permet d accéder à l historique des news. Vous pouvez ainsi retrouver facilement une information à laquelle vous n avez pas eu accès faute de temps. Sage News est automatiquement livré avec un pré-paramétrage qui vous permet d utiliser l outil avec une configuration standard. Cette configuration active tous les canaux de communication par défaut. Le Portail Sage v2.0 41/44
8 Messages d anomalies Ci-dessous quelques messages d anomalies rencontrés et leur méthode de résolution : Nota : Ne pas oublier de vérifier que l utilisateur autorisé ai bien les droits d accès en lecture écriture au niveau des répertoires de l application et notamment du répertoire contenant le fichier Catalogue.mdb. Message Cause et Résolution Au lancement du Portail, le message ci-contre s affiche Cause : L'erreur 401, est une erreur qui est provoquée lorsqu'une page appelée, se trouvant dans un répertoire protégé, dont la personne n'ayant pas fourni les bons code d'accès s'affiche Résolution : Vérifier les droits affectés à l utilisateur autorisé à accéder au Portail Sage. Au lancement du Portail, le message ci-contre s affiche Cause : Le nom du proxy est incorrect. Résolution : Vérifier les paramètres de connexion internet concernant le proxy utilisé par votre société. Pour cela : sur la page internet, Outils > Options Internet > Connexion > paramètres réseaux Message rencontré lors de l installation du serveur sous Windows 7 avec tentative d accès depuis un poste client: Cause : le paramétrage du Pare-feu du serveur Résolution : panneau de configuration, paramètres avancés du Pare-feu, règles de trafic entant, sélectionner la règle «Services World Wide Web (http) et l activer La connexion sous-jacente a été fermée : une erreur inattendue s est produite lors de la réception. Le Portail Sage v2.0 42/44
Le serveur n existe pas ou l adresse du serveur à changé Cause : ici il s agit d une tentative d accès au portail à partir du poste client alors que le serveur a été désinstallé Résolution : vérifier l adresse du serveur dans le fichier PortalDataClient.dll ou réinstaller le serveur La demande a échoué avec l état http 404 : Not Found. La page.asmx n est pas trouvée alors qu elle existe. Cause : Dotnet n est pas activé. Résolution : se rendre dans Gestionnaire des services Internet (IIS) Extension du service Web cliquer sur Asp.Net v2.0.50727 puis sur le bouton Autoriser Au lancement du Portail, le message ci-contre s affiche Cause (1): Ce problème peut se produire si vous importez une grande quantité de données et si le délai de connexion pour IIS 6.0 est trop faible. Résolution (1): Vous pouvez augmenter la valeur de délai d'expiration de connexion dans IIS 6.0. Procédez comme suit : Dans Gestionnaire de services IIS, cliquez avec le bouton droit de la souris sur site Web par défaut (ou sur le site où est installée votre application Web MCMS) et puis cliquez sur Propriétés.Cliquez sur l'onglet site Web. Dans la section connexions, dans la zone Délai d'expiration de connexion, augmentez les secondes une valeur qui est suffisant pour la longueur de l'importation. Le Portail Sage v2.0 43/44
Cause (2): Un conflit de port est détecté. Si plusieurs applications utilisent.net Framework Remoting, vous pouvez facilement utiliser http Channel par erreur pour vous connecter à un domaine d'application serveur qui écoute à l'aide de Tcp Channel. Si c est le cas, le client reçoit l'exception suivante : "La connexion sous-jacente a été fermée : une erreur inattendue s'est produite lors de la réception. Résolution (2): vous devez vérifier s'il n'y a pas de canaux incompatibles entre le client et le serveur. Pour modifier le port, se rendre dans Gestionnaire des services Internet (IIS) Clic droit sur Site Web par défaut et changer le numéro de port dans Port TCP Cause (Environnement 32 Bits): Pool d application au niveau de IIS n est pas conforme à l utilisation du portail. Résolution: Ouvrir IIS puis développer l arborescence sur la droite Site > Défaut Web Site > Data Web Service. Clic sur Data Web Service et sur la partie droite de l écran, sélectionner Paramètres de base. Sur la fenêtre qui s affiche, choisir Classic.Net AppPool puis valider par «OK» Cause (Environnement 64 Bits): Pool d application au niveau de IIS n est pas conforme à l utilisation du portail. Résolution: Ouvrir IIS puis développer l arborescence sur la droite : Pool d Application. Clic droit sur Pool d Application, puis créer un nouveau Pool. Nommer le Pool (exemple Pool32) choisir «Classique» comme mode préféré. Valider par «Ok» Le nouveau Pool apparaît ensuite dans la liste des pools d applications. Sélection du nouveau pool, puis dans partie gauche de l écran choisir caractéristiques avancées Indiquer «True» pour la propriété «Activer les applications 32 Bits» puis valider par OK Le Portail Sage v2.0 44/44