Guide d’installation BiBOARD
Version 3.0 29/05/2013 Support BiBOARD E-mail :
[email protected]
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.
© BiBOARD
Page 2
Guide d’installation BiBOARD
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
© BiBOARD
Page 3
Guide d’installation BiBOARD
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.
G.
Service BiBOARD PowerSystem ................................................................................................................ 26 1.
Installation ........................................................................................................................................... 26
2.
Configuration ....................................................................................................................................... 28
3.
Démarrage ........................................................................................................................................... 30 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
© BiBOARD
Page 4
Guide d’installation BiBOARD
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
© BiBOARD
Page 5
Guide d’installation BiBOARD
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
© BiBOARD
Page 6
Guide d’installation BiBOARD
2. Windows Server 2008 R2
Gestionnaire du serveur
Ajout de rôles
Serveur Web (IIS)
Installation de IIS - Windows Server 2008 R2
© BiBOARD
Page 7
Guide d’installation BiBOARD
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.
© BiBOARD
Page 8
Guide d’installation BiBOARD
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
© BiBOARD
Page 9
Guide d’installation BiBOARD
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
© BiBOARD
Page 10
Guide d’installation BiBOARD
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 :
© BiBOARD
Page 11
Guide d’installation BiBOARD
Services Moteur de base de données
Outils de gestion - De base
Séléction des composants
3. Configuration de l’instance
Nommer l’instance « BIBOARD »
© BiBOARD
Page 12
Guide d’installation BiBOARD
Création de l’instance BiBOARD.
4. Configuration du serveur
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.
© BiBOARD
Page 13
Guide d’installation BiBOARD
Configuration du mot de passe de sa
6. Installation en cours
Installation SQL Server 2008 R2 Express en cours
© BiBOARD
Page 14
Guide d’installation BiBOARD
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).
© BiBOARD
Page 15
Guide d’installation BiBOARD
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
© BiBOARD
Page 16
Guide d’installation BiBOARD
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 ».
© BiBOARD
Page 17
Guide d’installation BiBOARD
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
© BiBOARD
Page 18
Guide d’installation BiBOARD
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 :
© BiBOARD
Page 19
Guide d’installation BiBOARD
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
© BiBOARD
C:\Windows\Microsoft.NET\Framework\V4.0.30319\aspnet_isapi.dll
Page 20
Guide d’installation BiBOARD
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).
© BiBOARD
Page 21
Guide d’installation BiBOARD
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 ».
© BiBOARD
Page 22
Guide d’installation BiBOARD
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.
© BiBOARD
Page 23
Guide d’installation BiBOARD
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.
© BiBOARD
Page 24
Guide d’installation BiBOARD
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 [email protected] 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 ».
© BiBOARD
Page 25
Guide d’installation BiBOARD
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.
© BiBOARD
Page 26
Guide d’installation BiBOARD
Choisir le dossier d’installation. Conseil : opter pour la racine du dossier ".\BiBOARD_v13\", voir ci-dessous.
Cliquer sur Suivant.
© BiBOARD
Page 27
Guide d’installation BiBOARD
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 ».
© BiBOARD
Page 28
Guide d’installation BiBOARD
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 :
© BiBOARD
Page 29
Guide d’installation BiBOARD
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.
© BiBOARD
Page 30
Guide d’installation BiBOARD
G. Studio BiBOARD
Lancer « .\BiBOARD_v13\BiBOARDStudio\BiBOARDStudio.exe » et renseigner l’adresse Web du portail BiBOARD (exemple : http://PortailWebBiBOARD:port).
© BiBOARD
Page 31
Guide d’installation BiBOARD
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 ».
© BiBOARD
Page 32
Guide d’installation BiBOARD
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 « C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe –i ».
suivante :
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. 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 : Résolution :
- 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
© BiBOARD
Page 33
Guide d’installation BiBOARD