Tutos

OpneSI sont un ERP opensource dont la focalisation se fait sur la gestion commerciale et la comptabilité française (mais qui peut être utilisé pour d’autres comptas).

Le serveur dédié OVH Release 2 est une distribution spécialement conçue par OVH sur le système d’exploitation Linux / Gentoo. La procédure a pour objectif de vous aider à installer OpenSi sur le serveur dédié OVH Release 2.

Utiliser la fonctionnalité emerge peut se révéler « peu pertinente » dans le cadre de cette distribution. En effet, il se peut que certains fichiers en soient altérés et mettent en péril vos mises à jour.

L’ensemble de ce tuto a pour objectif de vous aider à installer OpenSi sur la GENTOO OVH.

Installation des programmes nécessaires

OpenSi nécessite mysql, java et tomcat pour fonctionner.

Mysql est installé par défaut sur la Gentoo ainsi que PHP. Toutefois, Tomcat et java sont à installer. Connectez-vous sur la gentoo via putty ou tout autre outil en mode administrateur.

Procédure pour installer JAVA JDK

Avant de commencer à installer tomcat, il est nécessaire d’installer java de chez sun.

Une petite vérification pour commencer. Théoriquement , la version 4 de java est déja installée. Toutefois, pour faire fonctionner OpenSi, il faut avoir au moins la version 5 ou plus

1 – Petite vérification

[root@ordi ~]# java -version

Vous devriez voir apparaitre un numéro de version de java. Si ce n’est pas le cas, ce n’est pas grave.

2 – Installez SUN-JAVA JDK

Pour installer sun java, il faut aller sur le site de SUN et télécharger JAVA

Vous pourriez éventuellement rencontrer une petite difficulté à ce niveau car il n’y a pas de possibilité pour télécharger ce module via la commande wget. Donc, vous pouvez le télécharger sur votre bureau, un espace ftp puis récupérer votre fichier via la commande wget

3 – Se mettre dans le répertoire opt

[root@ordi ~]# cd /opt/

4 – Téléchargez la dernière version de sun-jdk

[root@ordi ~]# wget http://monadresseftp

5 – Installez Sun Java jdk (pour une gentoo 64 Bits)

[root@ordi ~]# sh jdk-6u10-linux-x64.bin

Le fichier va se décompresser et créer un répertoire qui va s’appeler jre1.6-0_10.

Comme pour tomcat, le répertoire peut différer en fonction de la version que vous avez téléchargé.

6 – Créez un lien symbolique

Pour pouvoir déclarer java au sein de la gentoo, on va créer un lien symbolique qui va se trouver dans le répertoire /usr/lib64/jvm.

Si jvm n’existe pas, il faudra le créer avec cette commande

[root@ordi ~]# mkdir /usr/lib64/jvm

- A défaut, vous pouvez passer à l’étape ci dessous

[root@ordi ~]# ln -s /opt/jdk1.6-0_10/ /usr/lib64/jvm/

7 – Déclaration de java au sein de la Gentoo

[root@ordi ~]# JAVA_HOME=/usr/lib64/jvm/jdk1.6-0_10

puis

[root@ordi ~]# export JAVA_HOME=/usr/lib64/jvm/jdk1.6-0_10

[root@ordi ~]# export PATH=$PATH:/usr/lib64/jvm/jdk1.6-0_10/bin

8 – vérification du bon fonctionnement de java

[root@ordi ~]# java -version

Vous devriez voir apparaitre un numéro de la dernière version de java. Si ce n’est pas le cas, il faut vérifier ou se trouve votre erreur.

Si tout es ok, vous pouvez continuez l’installation

Vous devriez voir apparaitre un numéro de la dernière version de java. Si ce n’est pas le cas, il faut vérifier ou se trouve votre erreur.

Si tout es ok, vous pouvez continuez l’installation

Procédure pour installer ANT

1 – On se met dans le répertoire opt

2 – Téléchargez Ant

Nous allons maintenant installer ANT : Récupérez tout l’abord le binaire sur le site de ANT : http://ant.apache.org/bindownload.cgi

3 – Installer ant

1. wget http://mirror.mkhelif.fr/apache/ant/binaries/apache-ant-1.8.0-bin.tar.gz ====> #adaptez l’url
2. tar -xvzf apache-ant-1.8.0-bin.tar.gz
3. mv apache-ant-1.8.0 ant

Procédure pour installer Tomcat

on va installer tomcat dans le répertoire opt de la gentoo.

1 – On se met dans le répertoire opt

[root@ordi ~]# cd /opt/

2 – Téléchargez Tomcat

Veuillez noter que le lien permettant de récupérer le tar de Tomcat n’est pas stable. Il peut changer en fonction de l’arrivée des nouvelles versions de l’outil. Dans ce cas, je vous invite à visiter cette page http://tomcat.apache.org/download-60.cgi et copier le lien de téléchargement pour obtenir la dernière version. Si vous avez une autre version, il suffira de changer uniquement le -6.0.18 par votre version pour effectuer l’installation

[root@ordi ~]# wget http://east.unified.net/apache/tomcat/tomcat-6/v6.0.18/bin/apache-tomcat-6.0.18.tar.gz

3 – Décompressez le programme

[root@ordi ~]# tar -xzf apache-tomcat-6.0.18.tar.gz

4 – On se met à l’intérieur du répertoire de tomcat

[root@ordi ~]# cd /apache-tomcat-6.0.18/

5 – Déplacez le répertoire webapps

La gentoo release a 2 partitions par défaut, la première concerne les fonctionnement de la Gentoo, la deuxième, le répertoire Home, concerne toutes les données (site web/ logs …). Ce dernier répertoire contient à peu près 90% de l’espace de votre disque.

On va déplacer le répertoire webapps via un lien symbolique vers le répertoire Home.

on déplace webapps avec ses droits

[root@ordi ~]# mv webapps /home/

On crée le lien symbolique

[root@ordi ~]# ln -s /home/webapps/ /opt/apache-tomcat-6.0.18/

Vous devriez avoir dans le répertoire /home/webapps, tous les fichiers de tomcat du répertoire webapps. Dans le répertoire /opt/apache-tomcat-6.0.18/ vous devez avoir le lien symbolique qui est crée et qui redirige vers le répertoire /home/webapps/.

6 – Exporter les variables java

[root@ordi ~]#

[root@ordi ~]# export JAVA_HOME=/opt/jdk1.6-0_10

Paramétrage de tomcat

La procédure d’installation est terminée et si tout est correcte. Il faut procéder maintenant au paramétrage de tomcat.

Pour préserver la sécurité de l’environnement, on va créer un groupe et un utilisateur que l’on va appeller tomcat ainsi qu’attribuer ces droits à l’ensemble du répertoire webapps du répertoire /home/

1 – Création du groupe tomcat

[root@ordi ~]# groupadd tomcat

2 – création du user tomcat

[root@ordi ~]# adduser tomcat

3 – Attribution des droits dans le répertoire /home/webapps

[root@ordi ~]# chown -R tomcat:tomcat /home/webapps/*

On va procéder maintenant au paramétrage pour permettre à tomcat de démarrer. On va créer un fichier dans le répertoire etc/init.d que l’on va appeler tomcat6

4 – Se déplacer dans le répertoire init.d

[root@ordi ~]# cd /etc/init.d/

5 – Editez le fichier tomcat6

[root@ordi ~]# vi tomcat6

7 – Copiez ces lignes dans le fichier créé. Ce bout de code vous permettra de démarrer tomcat

#!/sbin/runscript
# Copyright 1999-2008 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $

opts="${opts} reload"

TOMCAT="/opt/apache-tomcat-6.0.18/bin"

depend() {
    need net
    use mysql dns logger netmount postgresql
    after sshd
}

start() {
    ebegin "Demarrage de Tomcat avec JDK"
    sh ${TOMCAT}/startup.sh
    eend $?
}

stop() {
   ebegin "Arret Tomcat avec JDK"
   sh ${TOMCAT}/shutdown.sh
   eend $?
}

reload() {
   if ! service_started "${myservice}" ; then
       eerror "Tomcat ne fonctionne pas ! veuillez utiliser la commande start"
   else
       ebegin "Redemarage de Tomcat"
       sh ${TOMCAT}/shutdown
       sleep 5
       sh ${TOMCAT}/startup.sh
       eend $?
       fi
}

7 – Enregistrez le fichier et quittez

Rendre exécutable fichier

chmod +x /etc/init.d/tomcat6

Appuyer sur echap puis écrivez « :wq » sans les guillements
8 – Changement du port de connexion à tomcat

Si vous voulez modifier le port, éditez server.xml

[root@ordi ~]# vi /opt/apache-tomcat-6.0.18/conf/server.xml

[root@ordi ~]# vi /opt/apache-tomcat-6.0.18/conf/context.xml

Si vous souhaitez remplacer le port initial du serveur tomcat alors remplacez 8080 par 8180 dans :

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
    <Connector port="8080" maxHttpHeaderSize="8192"

10 – Context et redémarrage de Démarrez Tomcat

vi /opt/apache-tomcat-6.0.18/conf/context.xml

==> changer <context> par <Context allowLinking= »true »>

[root@ordi ~]# /etc/init.d/tomcat6 start

les commandes ci dessous sont aussi applicables :

/etc/init.d/tomcat6 stop ==> arrête tomcat

/etc/init.d/tomcat6 restart ===> redémarre tomcat

/etc/init.d/tomcat6 start ===> démarrage de tomcat
Si tout fonctionne correctement, vous devez voir les messages de type (chemin pouvant varier en fonction de votre installation) suivants :

Using CATALINA_BASE: /opt/apache-tomcat-6.0.18

Using CATALINA_HOME: /opt/apache-tomcat-6.0.18

Using CATALINA_TMPDIR: /opt/apache-tomcat-6.0.18/temp

Using JRE_HOME: /usr/lib/j2sdk1.5-sun/ (ou la version que vous avez installé)
Dans votre navigateur, tapez http://mondomaine:8080 (ou le port que avez créé) permettra de savoir si le serveur tomcat fonctionne correctement. Vous devriez voir une page spécifique dédiée à tomcat.

Si tout est bon alors vous pouvez passer à l’étape suivante.

Paramétrage de MYSQL

Sur la gentoo, il se peut que lors du démarrage de OpenSi, vous ne puissiez pas vous connecter, donc il est nécessaire de faire cette petite opération sur mysql en commentant cette commande skip-networking

1 – Editez le fichier de config de mysql

[root@ordi ~]# vi /etc/mysql/my.cnf

2 – mettez en commentaire skip-networking

Rechercher la ligne ou vous trouverez skip-networking et mettez là en commentaire en mettant un # au début de la ligne puis enregistrer en appuyant sur echap puis tapez « :wq » sans les guillements

3 – redémarrez mysql

[root@ordi ~]# /etc/init.d/mysql restart

Si tout est bon alors vous pouvez passer à la dernière étape, l’installation de Opensi

Procédure pour installer OpenSi

Installation de la partie serveur

1 – Télécharger le fichier serveur de OpenSi

Dans un premier temps, mettez vous dans le répertoire /home/webapps

[root@ordi ~]# cd /home/webapps/

Puis il faut ensuite télécharger OpenSi. Ce ficher est disponible à la section du téléchargement du site de OPENSI. Opensi.org.
Il faudra l’exporter sur votre bureu, le mettre sur un ftp et le rapatrier sur le serveur

[root@ordi ~]# wget monadresse/fichiersopensi

2 – Extrayez l’archive

[root@ordi ~]# tar -xzf opensi-serveur-4.5.3.tgz

3 – Placez vous dans le répertoire OpenSi et compiler l’application

[root@ordi ~]# cd /OpenSi/WEB-INF
[root@ordi ~]# /opt/ant/bin/ant

Vous pouvez à ce moment changer le nom du répertoire OpenSi par celui que vous souhaitez (attention à la suite du tuto qui est basé sur le répertoire OpenSi
4 – Installez OpenSi

[root@ordi ~]# ./deploy

5 – Copier le fichier opensi.cfg

[root@ordi ~]# cp /home/webapps/OpenSi/opensi.unix.cfg /home/webapps/OpenSi-parametres/configuration/opensi.cfg

6 – Paramétrez le fichier OpenSi.cfg

Placez vous dans le répertoire configuration

[root@ordi ~]# cd /home/webapps/OpenSi-parametres/configuration/

7 – Editez le fichier OpenSi.cfg

[root@ordi ~]# vi OpenSi.cfg

Modifier les synthaxes suivantes ou à vérifier

- L’attribution des chemins

     app.UploadDir: /home/webapps/OpenSi    ==> Ce paramètre peut être modifié si vous avez donné un autre répertoire

Puis

      opensi.absdir: /home/webapps/OpenSi   ==> Ce paramètre peut être modifié si vous avez donné un autre répertoire

- La connexion à la base de données

     jdbc.Url: jdbc:mysql://localhost/OpenSi   ==> Ce paramètre peut être modifié si vous avez donné un autre répertoire

Pour améliorer la sécurité de votre application, vous pourvez changer ces paramètres

jdbc.User: OpenSi ===> par un user créer dans la base de données jdbc.Password: OpenSi ===> par mot de passe dans la base de données

- Le paramétrage des emails

email.MailHost: ===> insérer vos éléments ici

email.From: ===> insérer vos éléments ici

email.maintenance: ===> insérer vos éléments ici

- Le paramètre concernant les log, veuillez supprimer le #. le log se trouveras directement dans le répertoire de OpenSi
9 – Vérifier les droits d’accès aux différents répertoires (pdf, graph, logos, iobuffer, photos_articles, photos_familles, photos_marques, rapports) qui doivent être en 777.

A défaut, vous pouvez réaliser cette opération

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/pdf/

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/graph/

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/iobuffer/

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/photos_articles/

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/photos_familles,/

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/photos_marques/

[root@ordi ~]# chmod -R 777 /home/webapps/OpenSi/rapports/

9 – Procédure de création de la base de données

Placez vous dans le répertoire mysql

[root@ordi ~]# cd /home/webapps/OpenSi/database/mysql

10 – Créez la base

- Modifier l’accès à la base de données (non obligatoire :

Si vous souhaitez modifier les droits de base de données, nom utilisateur, nom base de données, pour une meilleure sécurité, veuillez changer ces paramètres en éditant le fichier General.sql. Toutefois, il se peut que les mises à jour soit plus difficiles à réaliser.

 GRANT ALL PRIVILEGES on *.* to 'OpenSi'@'localhost' identified by 'OpenSi';  ==> OpenSi par le nom d'utilisateur et de la base de données

 create database OpenSi;   ==> OpenSi par le nom de la base de données

 use OpenSi;  ==> OpenSi par le nom de la base de données

- lancer le script d’installation

il est nécessaire de passer par le mode console

[root@ordi ~]# mysql -u root -p < General.sql

Cette opération va prendre un certains temps. Dès que c’est fait l’installation est terminée et on peut procéder à l’installation de la partie client

Installation de la partie client

La partie client nécessite aboslument le navigateur firefox 3 , téléchargeable ici : http://www.mozilla-europe.org/fr/firefox/

Rendez vous sur la zone de téléchargement de OpenSi et cliquez sur le client.xpi correspondant à votre serveur. Le client va s’installer automatiquement. Si vous souhaitez plus d’information sur la partie client, veuillez vous rendre ici sur opensi.org

Finalisation de l’install

Relancez tomcat pour prendre en compte les changements

[root@ordi ~]# /etc/init.d/tomcat6 restart

Astuce !

Vous pouvez créer un lanceur avec : firefox -chrome chrome://OpenSi/content/login.xul

comme commande

Voiloù, une aide bien utile pour moi et pour ceux qui veulent utiliser le logiciel