DOCUMENTATION INSTALLATION ANTIBIOGARDE v4.0

DOCUMENTATION INSTALLATION
ANTIBIOGARDE v4.0
Version d’Antibiogarde
Version du document
Date dernière mise à jour du document
4.0
1.2
06/01/2009
TABLE DES MATIERES
Version Antibiogarde® Electronique ................................................................ 3 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 2 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
- Windows NT4
- Windows 2000 serveur
- Windows 2003 serveur
- Mandrake 7.0 et plus
- RedHat 7.0 et plus
Serveur Web
- IIS 5 et plus
- Apache 2.x et plus
Base de donnée
- 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
- Windows 95 / 98 / Me
- Windows NT4
- Windows 2000
- Windows XP
Résolution minimum
- 1024x768, couleur 24 bits
Navigateur Web
- IE 4.x et plus
- Mozilla Firefox 1.0 et plus
Langage
- 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-x86no_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\.
est
Le
dossier
contenant
les
fichiers
de
votre
site
WEB
Antibiogarde®
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.