Manuel Installation du logiciel

OpenClinic sur une machine Linux

INTRODUCTION
L’application ‘openclinic’ étant une application web, elle a besoin
d’abord d’un serveur web. Le serveur web utilisé par openclinic est
Apache Tomcat. On aura besoin alors d’installer Apache Tomcat en
premier lieu. Cependant, Apache Tomcat utilise java pour son
fonctionnement. On va alors devoir installer java, puis Tomcat par après.
Prenons qu’on a copié les fichiers d’installation de openclinic dans un
dossier Installation dans le dossier de notre utilisateur.

I. CONNECTION EN TANT QUE ROOT OU UTILISATEUR SUDO

Pour s’assurer d’avoir tous les droits nécessaires, il faut exécuter la
suite de ces instructions en étant connecte en tant qu’utilisateur root
(sudo -i ou su root pour se connecter en tant que root). Ou du moins
en tant qu’utilisateur ayant les droits sudo en précédant toutes les
commandes par sudo : (sudo nom_de_la_commande).

II. INSTALTION DE JAVA

❖ Aller dans le dossier où se trouve les fichiers d’installations

➢ cd /home/nom_utilisateur/Installation

❖ On décompresse alors java

➢ tar zxvf server-jre-8u202-linux-x64.tar.gz

❖ Déplacer le dossier dézippé ver le répertoire /var/java

➢ mv jdk1.8.0_202 /var/java

III. INSTALLATION DU SERVEUR WEB APACHE TOMCAT

❖ Aller sur le dossier là où se trouve le fichier Tomcat zippé

➢ cd /home/nom_utilisateur/Installation

YULCOM TECHNOLOGIES – TOGO

No 66 rue Kégbéya, Quartier Nyékonakpoé, Lomé, Togo
+228 70 32 12 41 – togo@yulcom-technologies.com
❖ On décompresse alors le fichier Tomcat

➢ tar zxvf apache-tomcat-8.5.35.tar.gz

❖ Déplacer le dossier dézippé vers le répertoire /var/tomcat

➢ mv apache-tomcat-8.5.35 /var/ tomcat

❖ Aller dans /var/tomcat/bin pour éditer le fichier catalina.sh

afin d’indiquer à Tomcat où on a installé java :
➢ cd /var/tomcat/bin
➢ nano catalina.sh
❖ Juste après les commentaires, mettre les lignes suivante :

CATALINA_OPTS="$CATALINA_OPTS -Djava.awt.headless=true"
export JAVA_HOME=/var/java

❖ Vérifier si réellement le chemin qu’on a indiqué à Tomcat

pour trouver java est correct
➢ ./catalina.sh run

❖ Copier les fichier db.cfg (fichier de connexion à la base de

données) et server.xml (fichier de configuration de Tomcat)
dans /var/tomcat/conf NB : il faut aller d’abord dans le
répertoire contenant ces fichiers puis faire la commande
suivante
➢ cp db.cfg server.xml /var/tomcat/conf

❖ Copier les librairies mysql-connector-xx (librairie Mysql qui

contient le driver de connexion) et primrose.jar (librairie de
openclinic) dans /var/tomcat/lib
➢ cp mysql-connector-xx primrose.jar /var/tomcat/lib

YULCOM TECHNOLOGIES – TOGO

No 66 rue Kégbéya, Quartier Nyékonakpoé, Lomé, Togo
+228 70 32 12 41 – togo@yulcom-technologies.com
IV. INSTALLATION MYSQL
❖ Se connecter d’abord à internet puis télécharger le paquet
MySQL

➢ apt-get update

➢ apt-get install mysql-server

❖ Ajouter quelques paramètres essentiels dans un fichier de

configuration de mysql
➢ cd /etc/mysql/mysql.conf.d
➢ nano mysqld.cnf
Dans la section [mysqld], Ajouter les paramètres suivants :
lower_case_table_names = 1
sql-mode = ansi
skip-ssl = 1
bind-address = 0.0.0.0

❖ Arrêter MySQL
➢ service mysql stop

❖ Supprimer les config et bases de données par défaut du

MySQL

➢ cd /var/lib/mysql

➢ rm -rf ./*

❖ Initialiser MySQL de nouveau :

➢ mysqld --initialize

❖ Démarrer MySQL

➢ service mysql start

❖ Rechercher le nouveau mot de passe par défaut de

l’utilisateur root :

➢ grep root /var/log/mysql/error.log

❖ Se connecter à MySQL avec l’utilisateur root

YULCOM TECHNOLOGIES – TOGO

No 66 rue Kégbéya, Quartier Nyékonakpoé, Lomé, Togo
+228 70 32 12 41 – togo@yulcom-technologies.com
 ➢ mysql -u root -p (saisir le mot de passe obtenu à l’étape
précédente.)
❖ Changer le mot de passe root pour faciliter le prochain accès
à MySQL :

➢ alter user 'root'@'localhost' identified by '';

➢ flush privileges;

❖ Créer un utilisateur MySQL avec comme nom openclinic et

mot de passe 0pen (conformément à l’utilisateur et mot de
passe défini dans le fichier db.cfg. Si vous voulez créer un
autre utilisateur, il faudra aussi changer l’utilisateur MySQL
défini dans db.cfg). Et lui ajouter les droits nécessaires

➢ create user 'openclinic'@'localhost' identified by '0pen';

➢ grant all privileges on *.* to 'openclinic'@'localhost';

➢ flush privileges;

❖ Charger le fichier dump (fichier sql qui contient la structure

des bases de données de openclinic).
➢ cd /home/nom_utilisateur/Installation
➢ mysql -u openclinic -p < nom_du_fichier_dump.sql

V. COPIER LES FICHIERS DE L’APPLICATION OPENCLINIC

❖ Aller sur le bureau ou dans le dossier où se trouve le fichier
openclinic.tar.gz zippé

➢ cd /home/nom_utilisateur/Installation
❖ On décompresse alors openclinic.tar.gz

➢ tar zxvf openclinic.code.tar.gz

YULCOM TECHNOLOGIES – TOGO

No 66 rue Kégbéya, Quartier Nyékonakpoé, Lomé, Togo
+228 70 32 12 41 – togo@yulcom-technologies.com
 ❖ On copie les fichiers de l’application contenu dans le dossier
web vers le répertoire /var/tomcat/webapps/openclinic

➢ mv web /var/tomcat/webapps/openclinic

VI. DEMARRER TOMCAT

❖ Supprimer le cache du serveur Tomcat

➢ cd /var/tomcat/work
➢ rm -rf Catalina
❖ Démarrer Tomcat en allant dans /var/tomcat/bin pour
exécuter le fichier de démarrage de Tomcat

➢ cd /var/tomcat/bin
➢ ./startup.sh
❖ Si vous voulez stopper Tomcat, exécuter le fichier suivant:

➢ ./shutdown.sh
Accéder à votre instance de openclinic dans votre navigateur en
saisissant l’url configuré dans le fichier server.xml, par exemple :
http://localhost/openclinic

YULCOM TECHNOLOGIES – TOGO

No 66 rue Kégbéya, Quartier Nyékonakpoé, Lomé, Togo
+228 70 32 12 41 – togo@yulcom-technologies.com