DOCUMENTATION INSTALLATION ANTIBIOGARDE v4.0 Version d Antibiogarde 4.0 Version du document 1.2 Date dernière mise à jour du document 06/01/2009
TABLE DES MATIERES 1 Version Antibiogarde Electronique... 3 2 Spécifications Techniques... 3 2.1 Serveur... 3 2.2 Client... 3 3 Installation Antibiogarde Electronique... 4 3.1 Installation et configuration du serveur... 4 3.1.1 Installation du serveur WEB / PHP... 4 3.2 Environnement MySQL... 21 3.2.1 Plate-forme Windows... 21 3.3 Configuration de votre environnement... 22 3.3.1 Configuration de MySql... 22 3.3.2 Modification du mot de passe du compte d'administration de MySQL... 24 3.3.3 Création de la base de données Antibiogarde... 24 3.3.4 Copie du schéma de la base de données... 24 3.3.5 Création du compte utilisateur autorisé à se connecter à la base de données. 24 3.3.6 Modification du mot de passe pour l'utilisateur user_atb... 24 3.3.7 Copie des fichiers du site WEB Antibiogarde Electronique... 25 3.3.8 Modification des paramètres de connexion à la base de données MySQL... 25 3.3.9 Configuration du site WEB... 26 3.4 Installation de phpmyadmin... 27 3.5 Tests... 27 4 Activation d ANTIBIOGARDE... 28
1 Version Antibiogarde Electronique Numéro de version : Version 4.0 / décembre 2008 Détail de la version : - Antibiogarde 2 Spécifications Techniques 2.1 Serveur Système d'exploitation Serveur Web Base de donnée - Windows NT4 - Windows 2000 serveur - Windows 2003 serveur - Mandrake 7.0 et plus - RedHat 7.0 et plus - IIS 5 et plus - Apache 2.x et plus - MySQL 4.x et plus (MySQL 3.x plus supporté) Langage développement - PHP 4.x et PHP 5.x Taille disque utilisée - Pages web : < 100 Mo - Base de donnée : < 20 Mo 2.2 Client Système d'exploitation Résolution minimum Navigateur Web Langage - Windows 95 / 98 / Me - Windows NT4 - Windows 2000 - Windows XP - 1024x768, couleur 24 bits - IE 4.x et plus - Mozilla Firefox 1.0 et plus - HTML - Javascript
3 Installation Antibiogarde Electronique Ce CD-ROM d'installation est conçu pour s'installer sur les plates-formes suivantes, toutefois, d'autres plates-formes supportant PHP4, MySQL peuvent être utilisées, mais aucun support n'est fourni. Windows - Windows 2003 - Windows 2000 - Windows NT4 (avec IIS installé ou Apache) Linux - Mandrake 7.0 et plus - RedHat 7.0 et plus (avec Apache) L'installation d'antibiogarde se déroule en plusieurs étapes. Chaque étape peut être effectuée séparément si vous avez déjà des éléments configurés. Ci-dessous sont décrites les différentes étapes d'installation et de configuration de votre serveur pour héberger Antibiogarde Electronique. Deux serveurs WEB peuvent être utilisés : Apache et IIS. Aucun support n'est prévu sur l'installation du serveur WEB IIS. 3.1 Installation et configuration du serveur Si vous désirez installer Antibiogarde Electronique sur une plate-forme: Linux : Une trame d'apache et de PHP4 est disponible à la section 3.1.1.2. Windows NT/2000 : Vous désirez installer Apache et PHP4, allez à la section 3.1.1.1. Vous désirez configurer PHP4 pour votre serveur IIS ou Apache, allez à la section 3.1.1.3. Windows 2003 : Vous désirez configurer PHP5 pour votre serveur IIS ou Apache, allez à la section 3.1.1.4. 3.1.1 Installation du serveur WEB / PHP 3.1.1.1 Serveur Apache sur une Plate-forme Windows Avant de lancer l'installation de votre serveur Apache, vérifiez qu'aucune application n'utilise le port 80 (HTTP), c'est à dire qu'aucun autre serveur WEB n'est activé. Vous pouvez télécharger les programmes d'installation du serveur WEB Apache 2.0 en deux versions : Ce programme est disponible sur le cd : D:/progs/apache/win32 x86/ apache_2.0.43-win32-x86- no_ssl.exe ou D:/progs/apache/win32 x86/ apache_2.0.43-win32-x86-no_ssl.msi.
a. Spécifiez le nom de domaine que vous allez utiliser pour Apache, ainsi que le nom de machine. Le troisième champ contient l'adresse email du webmaster du site. Si vous ne désirez pas utiliser de nom de domaine pour Antibiogarde Electronique, laissez les paramètres par défaut et ne modifiez que le champ "Server Name", en lui précisant l'adresse IP que vous voulez utiliser. b. Sélectionnez Installation personnalisée ( "Custom" )
c. Cliquez sur "Apache HTTP Server 2.0.43", puis cliquez sur "Change" pour sélectionner le répertoire d'installation de votre serveur Apache. d. Cliquez sur "Apache Runtime", puis cliquez sur "Change" pour sélectionner le répertoire d'installation du runtime Apache. La méthode de configuration de votre serveur WEB pour utiliser PHP4 est décrite dans la section 1.1.3
3.1.1.2 Installation d'apache et de PHP sur plate-forme Linux RedHat / Mandrake Pour éviter les problèmes de compatibilité entre les différentes distributions Linux, reportez-vous au CD d'installation de votre serveur Linux pour installer les packages nécessaires au fonctionnement d'antibiogarde Electronique. Les applications nécessaires sont les suivantes : Apache-2.0.x.x au minimum PHP 4.x.x au minimum MySQL 4.0.x au minimum : Cette version minimum sous Windows et Linux, car elle doit supporter les requêtes SQL comportant des UNION. Pour vérifier que ces packages sont installés sur votre serveur, saisissez les commandes suivantes dans un shell ayant les droits administrateur (compte root) : shell > rpm -qa grep apache shell > rpm -qa grep mysql shell > rpm -qa grep php Les packages devant être installés sont: apache 1.3.x.x mysql 4.0.x mysql-devel mysql-server php-4.x.x php-mysql mod_php Les deux derniers packages ne sont pas toujours disponibles sur distributions Linux. S'ils n'existent pas sur votre CD-ROM d'installation Linux, cela signifie que ces fichiers sont intégrés dans le module php4.x.x. Si vous n'avez pas le CD d'installation de votre serveur Linux, les packages nécessaires sont téléchargeables sur http://rpmfind.net/ Pour installer un nouveau package sur votre serveur Linux, tapez sous un shell administrateur : shell > rpm -ivh <nom du package RPM> 3.1.1.3 Installation de PHP 4 sous Windows NT/2000 Ce programme est disponible sur le cd : D:/progs/php/php4/win32 x86/php-4.3.6-installer.exe
a. Sélectionnez le mode "Advanced" pour définir les dossiers d'installation b. Spécifiez le dossier d'installation de base de PHP4
c. Effectuez une sauvegarde des fichiers modifiés par l'installation d. Spécifiez l'adresse du serveur SMTP gérant votre domaine.
e. Pour pouvoir suivre les problèmes éventuels, cochez " Display all errors" f. Spécifiez le type de serveur WEB que vous voulez utiliser avec PHP4
g. Cochez uniquement l'extension.php Dans le cas d'une utilisation de PHP avec un serveur IIS, une nouvelle fenêtre vous demandera de spécifier les services devant reconnaître les extensions sélectionnées auparavant. h. Sélectionnez " WWW Service Master Properties" ainsi que toutes les options qui sont listées dans cette fenêtre. Cette liste dépend de votre installation IIS. A l'issue de cette étape, consulter le chapitre 3.2 pour installer votre serveur de base de données MySQL. Votre serveur de base de données MySQL peut ne pas être installée sur le même serveur que votre application WEB. Si votre environnement MySQL est déjà configuré, vous pouvez aller directement à la section 3.3
3.1.1.4 Installation de PHP 5 sous Windows 2003 server La version de PHP 4 ne fonctionne pas sous windows 2003 server, il est donc nécessaire d installer la version 5 qui est disponible sur le cd : D:/progs/php/php5/php-5.0.5-installer.exe a. Cliquez sur «Next» b. Licence cliquez sur «I Agree»
c. Sélectionnez le mode "Advanced" pour définir les dossiers d'installation d. Spécifiez le dossier d'installation de base de PHP5
e. Effectuez une sauvegarde des fichiers modifiés par l'installation f. Cliquez sur «Next»
g. Cliquez sur «Next» h. Spécifiez l'adresse du serveur SMTP gérant votre domaine.
i. Pour pouvoir suivre les problèmes éventuels, cochez " Display all errors" j. Spécifiez le type de serveur WEB que vous voulez utiliser avec PHP5
k. Cochez uniquement l'extension.php l.cliquez sur «Next» Plusieurs DLL nécessaires ne sont pas mises en place par l installeur PHP5, il est donc nécessaire de copier la dll suivante dans le répertoire c:\php\ : php5isapi.dll
Il est aussi nécessaire de copier les dlls suivantes dans le répertoire c:/winnt/system32 ou c:\windows\system32\ : libmysql.dll php_mysql.dll Il est maintenant nécessaire de configurer IIS correctement pour cela, lancez le gestionnaire de service Internet dans lequel nous allons ajouter une extention serveur de la manière suivante : a. Faites un «clic droit» sur extention sdu serveur et sélectionnez «Ajouter une nouvelle extension de service web» b. Saisissez PHP dans le nom d extension, C:\PHP\php5isapi.dll dans les fichiers requis et cochez la case «Définir le statut de l extention à Autorisée»
c. l extention serveur est maintenant créée. Nous allons maintenant configurer les sites web pour php, pour cela faites un «clic droit» sur «Sites Web», Onglet Répertoire de base : a. Cliquez sur «Configuration»
b. Modifiez l enregistrement.php ou cliquez sur «Ajouter» s il n existe pas dans la liste des extentions. b. Faites pointer l extention.php sur c:\php\php5isapi.dll
3.2 Environnement MySQL 3.2.1 Plate-forme Windows Ce programme est disponible sur le cd : D:/progs/MySQL/Win32 x86/install/setup.exe a. Sélectionnez le dossier d'installation de votre serveur MySQL b. Choisissez le mode d'installation personnalisée
c. Sélectionnez toutes les options d'installation 3.3 Configuration de votre environnement L'exemple de configuration ci-dessous prend en compte les paramètres suivants : Votre lecteur de CD-ROM se trouve sur l'unité D:\. Le dossier d'installation de MySQL est c:\mysql. Le dossier d'installation de PHP est c:\php. Le dossier d'installation d'apache est c:\program files\apache Group\Apache2\. Le dossier contenant les fichiers de votre site WEB Antibiogarde est c:\inetpub\wwwroot\antibiogarde. Le compte utilisateur permettant de se connecter à la base de données Antibiogarde aura pour login "user_atb" et pour mot de passe "motdepasse". Le compte d'administration de MySQL aura pour login "root" et pour mot de passe "admin". Attention, dans le cas d'une utilisation d'apache, les désignations des répertoires doivent utiliser des '/' en remplacement des '\'! Ouvrez une invite de commandes MSDOS et placez-vous dans le dossier d'installation de mysql, sousdossier /bin/. Si votre installation de MySQL est déjà configurée, allez directement à l'étape 3.2. 3.3.1 Configuration de MySql Lancez l'application windows 'c:\mysql\bin\winmysqladmin.exe'
a. Entrez le login 'root' et le mot de passe 'admin' d'administration de mysql b. Vérifiez les données du fichier 'my.ini'. Ensuite, faites un clic droit sur le feux en haut à droite de l'interface et 'win9x' ou 'winnt' selon le système d'exploitation puis : 'Install the service' si ce n'est pas déjà fait 'Start the service' Si la configuration est correcte, le feux doit être vert.
3.3.2 Modification du mot de passe du compte d'administration de MySQL c:\mysql\bin> mysqladmin -u root password admin c:\mysql\bin> mysqladmin reload 3.3.3 Création de la base de données Antibiogarde c:\mysql\bin> mysqladmin create ANTIBIOGARDE 3.3.4 Copie du schéma de la base de données c:\mysql\bin> mysql ANTIBIOGARDE mysql > \. d:\database\antibiogarde3.2.sql 3.3.5 Création du compte utilisateur autorisé à se connecter à la base de données mysql > grant usage on ANTIBIOGARDE.* to user_atb@localhost; mysql > grant select, insert, delete, update on ANTIBIOGARDE.* to user_atb@localhost; Il ne vous reste plus qu'à configurer le mot de passe d'administration du site WEB, ce compte sera utilisé pour personnaliser votre site Antibiogarde Electronique. mysql > insert into ADMINISTRATEURS VALUES('motdepasse','nom','prenom'); mysql > exit; 3.3.6 Modification du mot de passe pour l'utilisateur user_atb Dans l'invite de commande, tapez la commande suivante : c:\mysql\bin > mysqladmin -u user_atb password motdepasse
3.3.7 Copie des fichiers du site WEB Antibiogarde Electronique Si vous utilisez IIS, créez un nouveau site dans la console d'administration des services Internet, dans lequel vous copierez les fichiers contenus dans le dossier du CDROM "d:\site_web\". Dans le dossier "c:\winnt\" ou "c:\windows\" (suivant la version de windows que vous utilisez), éditez le fichier "php.ini", modifiez le paramètre "include_path", et faites-le pointer vers : "c:\inetpub\wwwroot\antibiogarde\scripts\" et vers le répertoire courant ".", puis redémarrez votre service IIS. Vérifiez ensuite que les lignes suivantes existent dans le fichier php.ini : Otez le point-virgule ( commentaire ) de la première ligne suivante, et mettez le devant la seconde ligne. error_reporting = E_COMPILE_ERROR E_ERROR E_CORE_ERROR ;error_reporting = E_ALL Pour les install avec PHP 5 sous Windows 2003 serveur il est aussi nécessaire de supprimer le commentaire de la ligne : extension=php_mysql.dll 3.3.8 Modification des paramètres de connexion à la base de données MySQL Dans le dossier du site WEB, éditez le fichier "config.inc.php" dans le dossier : "c:\inetpub\wwwroot\antibiogarde\scripts\biogarde2_ext\conf". Sur certains sytèmes, il est nécessaire de supprimer la lecture seule de ce fichier afin de l'éditer. Attention, il est important de respecter la casse lors de la saisie du nom de la base de données. Modifiez les lignes suivantes, en fonction du nom de la machine, du compte utilisateur, du mot de passe et du nom de la base configurés : $realpath_upload = "c:/inetpub/webroot/antibiogarde/upload/"; $db_host = "localhost"; $db_user = "user_atb"; $db_password = "motdepasse"; $db_name = "ANTIBIOGARDE";
3.3.9 Configuration du site WEB Si vous avez installé Antibiogarde dans un sous-dossier de votre site WEB, modifiez en conséquence le paramètre "$path_site", se trouvant également dans le fichier 'config.inc.php'. Modifiez la variable "$nom_hopital_local" pour définir le nom de l'hôpital dans lequel vous vous situez. Les deux derniers éléments à configurer sont les suivants : Ouvrez le fichier histo.js situé dans le sous-dossier modules du site Web. Modifiez la ligne " var path_site = '<dossier web de antibiogarde>'; " et remplacez <dossier web de antibiogarde> par le chemin sur lequel vous avez installé votre site Web Antibiogarde. Effectuez la même opération sur le fichier fctst.js du sous-dossier modules. Dans le cas d'une utilisation de PHP avec un serveur Apache, il est nécessaire d'apporter les modifications suivantes au fichier 'c:\program files\apache Group\Apache2\conf\httpd.conf' : Ajout des lignes suivantes en fin de fichier : ScriptAlias /php/ "c:/php/" AddType application/x-httpd-php.php Action application/x-httpd-php "/php/php.exe" DirectoryIndex index.php index.htm index.html Les trois premières lignes permettent l'interprétation des fichiers php par l'exécutable 'php.exe'. La dernière ligne indique la page par défaut à afficher Modification de la clé 'DocumentRoot': DocumentRoot="c:/inetpub/wwwroot/antibiogarde" Modification de la zone : # # This should be changed to whatever you set DocumentRoot to # <Directory "c:/inetpub/wwwroot/antibiogarde"> Ces deux dernières modifications permettent de fixer la racine du site sur le serveur. Afin que les modifications de la configuration d'apache soient prises en compte, il est nécessaire de redémarrer le service : Démarrer/Programmes/Apache.../Control Apache Server/Restart
3.4 Installation de phpmyadmin Ce programme est disponible sur le cd : D:/progs/phpmyadmin/Win32 x86/phpmyadmin-2.5.4.exe. Editez le fichier "config.inc.php" dans le dossier "phpmyadmin", puis modifiez les paramètres suivants : Nom de l'hôte MySQL : $cfg['servers'][$i]['host'] = 'localhost'; Type d'authentification : $cfg['servers'][$i]['auth_type'] = 'config'; Nom du compte administrateur MySQL : $cfg['servers'][$i]['user'] = 'root'; Mot de passe administrateur MySQL : $cfg['servers'][$i]['password'] = ''; Pour tester le bon fonctionnement de phpmyadmin, connectez-vous sur : http://www.domain.com/phpmyadmin/index.php. Une fenêtre d'authentification apparaît, saisissez le login et le mot de passe de compte administrateur MySQL. Vous accédez alors à votre serveur MySQL et gérez ainsi toutes les bases de données existantes sur le serveur. Dans un deuxième temps, fermez votre navigateur et recommencez la démarche en utilisant le compte utilisateur Antibiogarde que vous avez créé, vous accédez alors uniquement à la base de données ANTIBIOGARDE. 3.5 Tests Le premier test à effectuer est de vérifier si les extensions PHP sont bien prises en compte par le serveur WEB. Pour cela, connectez-vous avec votre navigateur WEB sur la page : http://www.domain.com/phpinfo.php. Si cette page ne s'affiche pas correctement,vérifier que l'extension PHP est bien définie au sein de IIS, si vous utilisez ce serveur WEB. Nous voici arrivé à la phase de tests de l'installation de votre site Antibiogarde Electronique. Connectez vous alors avec votre navigateur WEB sur http://www.domain.com/index.php Si vous constatez des messages d'erreurs lors de la connexion à votre site Antibiogarde Electronique, veuillez vous reporter à la section bugs rencontrés.
4 Activation d ANTIBIOGARDE Vous disposez d un fichier Activation.txt sur le CD comportant votre Login et Mot de passe vous permettant de vous connecter au site d activation à l adresse suivante : http://www.antibiogarde.org/activation Ecran d identification
Ecran de votre compte Cette procédure d activation va vous permettre de générer un fichier d activation intitulé antibiogarde.key en cliquant sur le bouton GENERER CLE ACTIVATION. Cliquez sur Enregistrer puis déposez ce fichier antibiogarde.key à la racine du site antibiogarde dans le même répertoire que le fichier index.php.