Version 3.0 29/05/2013 Support BiBOARD E-mail : support@biboard.fr
Guide d installation de BiBOARD Ce document est destiné à l équipe informatique en charge de l installation de l application BiBOARD. Durée approximative : 2 heures Conformité & Mise en garde Compte tenu des contraintes inhérentes à la présentation sous format électronique, les spécifications visées par la présente documentation constituent une illustration aussi proche que possible des spécifications. Il est important, pour une utilisation sûre et efficiente de BiBOARD, de lire au préalablement la documentation. Evolution La présente documentation correspond à la version référencée. Entre deux versions majeures, des mises à jour évolutives ou correctives peuvent être réalisées sans modification de la documentation. Toutefois, des notes explicatives peuvent être jointes à la documentation existante pour exposer les modifications et/ou améliorations apportées par les mises à jour. Propriété & Utilisation Tout usage, représentation ou reproduction intégral ou partiel, fait sans le consentement de la société BiBOARD est illicite (Loi du 11 Mars 1957- Loi du 3 Juillet 1985). Ils constitueraient une contrefaçon sanctionnée par les articles 425 et suivants du Code Pénal. Tous droits réservés. Logiciel original et développé par la société BiBOARD. Documentation BiBOARD. Toute utilisation, à quelque titre que ce soit, non autorisée dans le cadre de la convention de licence, est strictement interdite sous peine de poursuites juridiques et de sanctions pénales (Loi du 3 juillet 1985, Art. 46). Les noms de produits ou de sociétés, tout logo, image ou représentation visuelle indiqués dans ce document ne sont utilisés qu à des fins d identification et peuvent constituer des marques déposées par leurs propriétaires respectifs. Page 2
Table des matières I. Prérequis pour BiBOARD... 5 A. Configuration «Utilisateur final»... 5 B. Configuration recommandée «Designer»... 5 C. Configuration minimale «Serveur»... 5 II. Installation des prérequis... 6 A. Internet Explorer... 6 B. Adobe Flash Player... 6 C. Internet Information Services (IIS)... 6 1. Windows Server 2003... 6 2. Windows Server 2008 R2... 7 D. Microsoft ASP.NET 2.0 AJAX Extension 1.0... 8 E. Microsoft.NET Framework 3.5 SP1... 8 F. Microsoft.NET Framework 4... 8 G. Windows Installer 4.5... 9 H. Powershell 1.0... 9 1. Windows Server 2003... 9 2. Windows Server 2008 R2... 9 I. Microsoft SQL Server 2008 R2 Express With Management Tools... 10 1. Installation... 10 2. Sélection des composants à installer... 11 3. Configuration de l instance... 12 4. Configuration du serveur... 13 5. Configurateur du moteur de base de données... 13 6. Installation en cours... 14 7. Fin de l installation... 15 8. Configuration de SQL Server 2008 R2... 15 Page 3
J. Système d exploitation... 16 III. Installation du logiciel BiBOARD... 17 A. Les fichiers d installation... 17 B. Les droits... 17 C. Les bases de données... 18 D. Les fichiers à paramétrer... 19 1. Web.config... 19 2. Fichiers personnalisés... 20 E. Gestionnaire des services Internet (IIS)... 20 1. Autorisations framework 4.0... 20 2. Création du site web BiBOARD... 21 3. Paramétrage du site Web... 22 F. Service BiBOARD PowerSystem... 26 1. Installation... 26 2. Configuration... 28 3. Démarrage... 30 G. Studio BiBOARD... 31 IV. FAQ... 32 A. Problème lié à l installation de Microsoft SQL Server 2008 R2... 32 B. Charger les sources de données sur un OS 64 bits... 32 C. Accéder à SQL Server à travers un pare-feu... 33 D. Si IIS est installé/modifié après le Framework 4... 33 E. Activer NTLM sous Windows Seven... 33 Page 4
I. Prérequis pour BiBOARD L installation des prérequis est à opérer sous un compte administrateur du serveur. Si le contrôle des comptes utilisateurs (UAC) est activé, il faudra exécuter les applications «En tant qu administrateur». A. Configuration «Utilisateur final» Configuration standard ordinateur de bureau Navigateur Internet : Microsoft Internet Explorer (version 7 minimum), Mozilla Firefox, Google Chrome ou Opera Applicatifs : Adobe Flash Player B. Configuration recommandée «Designer» Processeur : équivalent Intel Core 2 Duo Mémoire vive : 2 Go Espace disque dur : 100 Mo Systèmes d exploitation : o Microsoft Windows XP/VISTA/SEVEN (32/64 bits) Navigateur Internet : Microsoft Internet Explorer (version 7 minimum), Mozilla Firefox, Google Chrome, Safari ou Opera Applicatifs : Adobe Flash Player et pilotes ODBC C. Configuration minimale «Serveur» Processeur : équivalent Intel Xeon Serie 5500 ( 2.5 Ghz) Mémoire vive : 4 Go Espace disque dur : 6 Go Systèmes d exploitation : o Microsoft Windows Server 2003/2008 (R2-32/64 bits) Virtualisation : supportée par tous sauf Oracle VM Virtualbox Prérequis applicatifs à installer sur le serveur : 1- Internet Explorer 2- Adobe Flash Player 3- Microsoft Internet Information Services (IIS) 4- Microsoft ASP.NET 2.0 AJAX Extension 1.0 5- Microsoft.NET Framework 3.5 SP1 6- Microsoft.NET Framework 4 7- Windows Installer 4.5 8- Powershell 1.0 9- Microsoft SQL Server 2008 R2 Express with Management Tools 10- Les mises à jour prioritaires de Windows Applicatifs : pilotes ODBC Cliquer pour accéder directement au lien de téléchargement Page 5
II. Installation des prérequis A. Internet Explorer Sur le serveur BiBOARD, il est impératif d avoir au minimum la version 7 d Internet Explorer (IE). Par défaut, sous Windows Server 2003, Internet Explorer est en version 6. Veuillez vérifier votre version et installer IE 7 ou plus si celui-ci n est pas à jour. Par défaut, sous Windows Server 2008, Internet Explorer est en version 7. Par défaut, sous Windows Server 2008 R2, Internet Explorer est en version 8. B. Adobe Flash Player Afin de faire fonctionner les composants Flash, il est nécessaire d installer Adobe Flash Player en version 32 bits. Lien de téléchargement : Flash_Player C. Internet Information Services (IIS) 1. Windows Server 2003 Démarrer Panneau de Configuration Ajout/suppression de programmes Ajouter ou supprimer des composants Windows Serveur d'applications Services IIS Remarque : le CD/ROM d installation de Windows vous sera demandé. Installation de IIS - Windows Server 2003 Page 6
2. Windows Server 2008 R2 Gestionnaire du serveur Ajout de rôles Serveur Web (IIS) Installation de IIS - Windows Server 2008 R2 Page 7
Choix des services de rôle IIS - Windows Server 2008 R2 D. Microsoft ASP.NET 2.0 AJAX Extension 1.0 De la même manière que précédemment, vérifiez l installation de cet applicatif. S il n est pas présent, téléchargez-le sur le site de Microsoft et procédez à son installation. E. Microsoft.NET Framework 3.5 SP1 De la même manière que précédemment, vérifiez l installation de cet applicatif. S il n est pas présent, téléchargez-le sur le site de Microsoft et procédez à son installation. F. Microsoft.NET Framework 4 De la même manière que précédemment, vérifiez l installation de cet applicatif. S il n est pas présent, téléchargez-le sur le site de Microsoft et procédez à son installation. Page 8
L installation ainsi faite, si vous avez un système d exploitation en 64 bits, il vous faut activer la compatibilité 32 bits : Lancer l invite de commande. Si vous êtes sur un OS 2008 ou plus, lancer l invite de commande en faisant clic droit «Exécuter en tant qu administrateur». Tapez la commande suivante pour activer le mode 32 bits : cscript %SYSTEMDRIVE%\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1 G. Windows Installer 4.5 Vérifiez l installation de cet applicatif en exécutant la commande msiexec. Si la version est antérieure ou s'il n'est pas présent, téléchargez-le sur le site de Microsoft et procédez à son installation. H. Powershell 1.0 1. Windows Server 2003 Vérifiez sa présence dans Panneau de configuration Ajout/Suppression de programmes. S il n est pas présent, téléchargez-le sur le site de Microsoft et procédez à son installation. 2. Windows Server 2008 R2 Gestionnaire du serveur Ajout de fonctionnalités Windows PowerShell Page 9
Installation de Powershell I. Microsoft SQL Server 2008 R2 Express With Management Tools De la même manière que précédemment, vérifiez l installation de cet applicatif. S il n est pas présent, téléchargez-le en version 64 bits ou en version 32 bits (suivant votre OS) sur le site de Microsoft et procédez à son installation. Remarques : Les moteurs de bases de données Microsoft SQL Server 2000, 2005, 2008 et 2008 R2 peuvent cohabiter ensemble. Il est aussi possible d utiliser un serveur de base de données SQL Server qui se situe sur un autre serveur. 1. Installation Installation d une nouvelle instance ou ajout de fonctionnalités Page 10
Acceptation des termes du contrat de licence Installation du support du programme d installation 2. Sélection des composants à installer Les composants à sélectionner sont au minimum : Page 11
Services Moteur de base de données Outils de gestion - De base 3. Configuration de l instance Nommer l instance «BIBOARD» Séléction des composants Page 12
4. Configuration du serveur Création de l instance BiBOARD. Vérification du lancement des services SQL Server Database Engine et SQL Server Browser par le compte AUTORITE NT\SERVICE RESEAU et du type de démarrage automatique. Configuration des services 5. Configurateur du moteur de base de données Choisir le mode d authentification mixte. Saisir un mot de passe pour le compte sa. Ajouter au moins un compte administrateur du serveur, qui aura les droits administrateur dans SQL Server 2008 R2. Vous pouvez ajouter l utilisateur actuel qui doit être Administrateur du serveur. Page 13
Configuration du mot de passe de sa 6. Installation en cours Installation SQL Server 2008 R2 Express en cours Page 14
7. Fin de l installation Cliquer sur Fermer après l installation. Fin de l installation de SQL Server 2008 R2 Express 8. Configuration de SQL Server 2008 R2 Lancer Gestionnaire de configuration SQL Server depuis le dossier «Démarrer, Tous les programmes, Microsoft SQL Server 2008 R2, Outils de configuration». Développer l arborescence de l instance BIBOARD pour faire apparaître les protocoles, et faire clic droit sur TCP/IP et choisir Activer. Redémarrer le service SQL Server (INSTANCE). Page 15
J. Système d exploitation Il faut s assurer que toutes les mises à jour prioritaires soient installées sur le serveur. Pour cela procéder à un Windows Update : Windows Update - Windows 2003 Server Windows Update - Windows 2008 R2 Server Page 16
III. Installation du logiciel BiBOARD Important : la validation des prérequis matériels et logiciels de BiBOARD est obligatoire avant l installation. A. Les fichiers d installation Cliquer directement sur le lien HTTP ci-dessous afin de télécharger la dernière version de BiBOARD. BiBOARD_v13.zip Lien : http://www.biboard.fr/telechargements/technique/biboard_v13.zip Décompresser le fichier téléchargé à l endroit où sera installé BiBOARD. Dans ce guide, le dossier d'installation sera nommé BiBOARD_v13. B. Les droits Ajouter sur le dossier ".\BiBOARD_v13\Web" les droits en lecture pour le compte local «Service Réseau». Ajouter sur les dossiers «.\BiBOARD_v13\Web\Log» et «.\BiBOARD_v13\Web\temp» les droits en modification pour les comptes «Utilisateurs Authentifiés» et «Service Réseau». Page 17
Ajouter sur le dossier «.\BiBOARD_v13\Web\Database», les droits en contrôle total pour les comptes locaux «Service Réseau» et «SQLServerMSSQLUser$Nom_Serveur$Nom_Instance», et remplacer les droits de tous les objets enfants par ceux du dossier Database. Ajouter sur le dossier «.\BiBOARD_v13\Web\Database\backup», les droits en lecture et exécution pour le groupe local «IIS_IUSRS». C. Les bases de données Les bases de données liées au fonctionnement de BiBOARD vont s installer par un script PowerShell. Lancer l invite de commande. Si vous êtes sur un OS 2008 ou plus, lancer l invite de commande en faisant clic droit «Exécuter en tant qu administrateur». Exécuter la commande suivante afin d autoriser l exécution du script de création des bases de données SQL Server: Powershell set-executionpolicy RemoteSigned Se placer dans le répertoire «.\BiBOARD_v13\Web\Database» à l aide des commandes suivantes : Cd\ pour revenir à la racine du lecteur D: pour se positionner sur le lecteur D Cd NomDuDossier pour se positionner sur le dossier Dir pour lister le contenu du répertoire Une fois dans «.\BiBOARD_v13\Web\Database», exécuter ce script en remplaçant les trois variables : Powershell.\CreateDB.ps1 DATASOURCE ID PASSWORD DATASOURCE = Nom du serveur et de l instance SQL sur lequel est installé BiBOARD. ID = Compte utilisé pour la connexion, par défaut le compte sa. PASSWORD = Mot de passe du compte ID. Exemple : Powershell.\CreateDB.ps1 SERVEUR\BIBOARD sa XXXXX Page 18
Résultat de la commande PowerShell : les bases de données sont créées et jointes à SQL Server 2008 R2 D. Les fichiers à paramétrer 1. Web.config Ouvrir le fichier «.\BiBOARD_v13\Web\web.config» avec un éditeur de texte et modifier les valeurs en rouge suivant la configuration de votre serveur SQL Server 2008 R2 : <connectionstrings> Page 19
<remove name="biboardsqlserver" /> <add name="biboardsqlserver" connectionstring="data Source=localhost\biboard;database=biboard;User ID=sa;Password=MotDePasse;" providername="system.data.sqlclient" /> Data Source = Nom du serveur et de l instance SQL sur lequel est installé BiBOARD. Database = Nom de la base de données du référentiel BiBOARD. Password = mot de passe du compte User Id, "sa" dans notre cas. 2. Fichiers personnalisés Si vous souhaitez personnaliser BiBOARD avec vos propres fichiers (images, photos..), nous vous conseillons de créer un nouveau dossier au même niveau que le dossier Web et de placer vos fichiers. Exemple : «.\BiBOARD_v13\MON_DOSSIER_PERSONNALISE\». E. Gestionnaire des services Internet (IIS) 1. Autorisations framework 4.0 Ouvrir IIS Se positionner sur le serveur Cliquer sur Restrictions ISAPI et CGI Cliquer bouton droit pour Autoriser l ASP.NET v4.0 sur la ligne suivante : o C:\Windows\Microsoft.NET\Framework\V4.0.30319\aspnet_isapi.dll Page 20
Redémarrer IIS par l interface graphique ou bien par la commande «iisreset /restart». 2. Création du site web BiBOARD Lancer Gestionnaire des services Internet (IIS). Page 21
Faire clic droit sur «Sites» puis «Ajouter un site Web...». Renseigner : o le nom du site o le chemin d accès physique (Répertoire «.\BiBOARD_v13\Web») o le port Création du site Web 3. Paramétrage du site Web Cliquer sur «Authentification», désactiver l état «Authentification anonyme» et activer l état «Authentification Windows». Page 22
Mode d authentification Choix du mode d authentification Ajouter «board.aspx» comme document par défaut et s assurer qu il soit en première position. Page 23
Modifier la version du Framework du pool d applications utilisé par le site Web BiBOARD par la version v4.0.30319 en mode Classique. Veiller à ce que le site Web BiBOARD soit démarré. Cliquer sur «Parcourir» dans la partie droite. Page 24
Vous devriez avoir la page web ci-dessous s afficher. Si ce n est pas le cas, veuillez vérifier les étapes précédentes. Le premier affichage de la page web n est pas immédiat. Patienter un instant. A cette étape, faire une demande par mail au support BiBOARD à cette adresse support@biboard.fr en nous indiquant votre Identifiant Serveur. Nous vous communiquerons alors votre clé BiBOARD. Celle-ci se présente sous un fichier texte nommé licence.txt, il est à positionner dans le répertoire «.\BiBOARD_v13\Web\bin\» en lui ajoutant les droits en Lecture pour le compte «Service Réseau». Page 25
F. Service BiBOARD PowerSystem 1. Installation Exécuter "BiBoardPSInstall.msi" se trouvant dans «.\BiBOARD_v13\PowerSystem\» en double cliquant dessus ou directement par le bouton «Installer». Cliquer sur Suivant. Page 26
Choisir le dossier d installation. Conseil : opter pour la racine du dossier ".\BiBOARD_v13\", voir ci-dessous. Cliquer sur Suivant. Page 27
Cliquer sur Fermer à la fin de l installation. 2. Configuration Exécuter le configurateur de BiBOARD PowerSystem : «.\BiBOARD_v13\BiBOARD PowerSystem\BiBoardPowerConfig.exe». Si vous êtes sur un OS 2008 ou plus, lancer le configurateur en faisant clic droit «Exécuter en tant qu administrateur». Page 28
Saisir l adresse complète du serveur Web BiBOARD (exemple : http://serveur/). Laisser les autres valeurs par défaut. Voici un exemple de la configuration que vous devez avoir : Page 29
Valider la configuration en cliquant sur Appliquer puis OK. 3. Démarrage Ouvrir les services Windows (services.msc). Faire clic droit sur le service BiBOARD PowerSystem et Démarrer. Vérifier que le type de démarrage du service soit en Automatique. Remarque : si le serveur n est pas membre d un domaine, il faut obligatoirement que le service soit lancé par un compte local Administrateur de la machine et de BiBOARD. Page 30
G. Studio BiBOARD Lancer «.\BiBOARD_v13\BiBOARDStudio\BiBOARDStudio.exe» et renseigner l adresse Web du portail BiBOARD (exemple : http://portailwebbiboard:port). Page 31
Pour déployer le studio BiBOARD, copier/coller le répertoire «.\BiBOARDStudio» sur les postes designers. Un manuel d utilisation est disponible, cliquer ci-dessous pour le télécharger : Manuel_Utilisation_BiBOARD.pdf IV. FAQ A. Problème lié à l installation de Microsoft SQL Server 2008 R2 Symptôme : l installation des fichiers se lance et à la fin de celle-ci, MSSQLS annonce que l installation est un échec. Explication : la version de MSXML6 peut en être la cause. Résolution : avant l installation de MSSQLS, désinstaller et réinstaller MSXML6. Si celui-ci refuse de se désinstaller vous pouvez utiliser Windows Installer Clean Up. B. Charger les sources de données sur un OS 64 bits Symptôme : vous n avez pas accès aux drivers ODBC 32 bits. Explication : l interface par défaut affiche seulement les drivers ODBC 64 bits. Résolution : par Démarrer/Exécuter : «C:\WINDOWS\syswow64\odbcad32.exe». Page 32
C. Accéder à SQL Server à travers un pare-feu Symptôme : vous n avez pas accès à vos bases de données SQL Server. Explication : le pare-feu bloque les connexions. Résolution : ajouter les exceptions TCP 1433 et UDP 1434. D. Si IIS est installé/modifié après le Framework 4 Symptôme : lors de l ouverture du site Web BiBOARD celui-ci génère une erreur type. Explication : IIS installé et/ou modifié après le Framework 4, les dll.net sont alors mal référencées. Résolution : par Démarrer/Exécuter/cmd, lancer la commande suivante : «C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe i». E. Activer NTLM sous Windows Seven Symptôme : la connexion au portail BiBOARD est impossible suite à une demande d authentification qui n aboutit pas. Explication : sous certains postes en Windows Seven, la méthode d authentification NTLM n est pas activée par défaut. Résolution : dans les options de sécurité (se trouvant dans Panneau de configuration\outils d administration\stratégie de sécurité locale), modifier les paramètres de sécurité réseau des stratégies suivantes : - Sécurité de session minimale pour les clients basés sur NTLM SSP (y compris RPC sécurisé) : Exiger un niveau de chiffrement à 128 bits - Sécurité de session minimale pour les serveurs basés sur NTLM SSP (y compris RPC sécurisé) : Exiger un niveau de chiffrement à 128 bits - Autoriser Système local à utiliser l identité de l ordinateur pour le NTLM : Activé - Restreindre NTLM Trafic sortant vers des serveurs sortant vers des sites distants : Autoriser tout Ajouter une valeur DWORD 32 bits dans l éditeur du Registre (regedit), cette clé doit être créée dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa : Nom de la clé : LmCompatibilityLevel Type : DWORD Données de la valeur : 1 Base : Hexadécimale Page 33