Ceci est une ancienne révision du document !


SMI : Services Maintenance Interventions

La version actuelle 1.0.5 n'est pas compatible par défaut avec Ubuntu 16.04 et versions ultérieures, ne fonctionnant pas avec PHP 7.x et Mysql 5.7, une installation de PHP 5.6 et d'une version de Mysql antérieure telle que 5.5 ou 5.6 sont nécessaires. Voir plus bas la solution de la virtualisation simplifiée sous Docker

SMI est plus un GMAO (gestionnaire de maintenance) qu'un PGI ou ERP (progiciel de gestion intégré) écrit en language PHP qui permet la gestion d'un service après vente où un centre de maintenance technique. Il doit être sur un serveur local ou distant pour pouvoir fonctionner dans un explorateur web.

Avec ce logiciel il est possible de :

  • Gérer ses agendas.
  • Générer des bons d'intervention et de réparation.
  • Gérer le planning des techniciens.
  • Disposer d'un CRM.
  • Régler les droits d'accès pour chaque utilisateur.
  • Établir des contrats de maintenance.
  • Gérer un stock de pièces détachées.
  • Associer des pièces jointes

Site officiel

Pré-requis.

Avant de pouvoir installer SMI vous devez disposer soit de :

- Un serveur local Xampp équipé de Apache 2, php 5.6 une version de base de donnée MySql 5.5 ou 5.6 déjà bien configuré.

- Un espace web sur un serveur distant sur lequel vous avez les droits d'administration. Avec base de données MySql.

- Un serveur apache 2 équipé de php5.6 mysql 5.5 virtualisé sous Docker dans le cas des distributions Ubuntu récentes, voir plus bas pour la mise en œuvre.

Méthode d'installation sous Xampp

Commencer tout d'abord par télécharger l'archive contenant les fichiers de SMI, la version actuelle étant 1.0.5 sur le site officiel de SMI ici.

Rendez vous dans le répertoire racine www de votre serveur local Xampp et créez y un répertoire 'smi' en minuscule.

Ayant ouvert un terminal dans le dossier racine du serveur :

mkdir smi

Extraire tout le contenu de l'archive téléchargée avec FileRoller en mode graphique dans le répertoire smi ainsi créé.

Ou en terminal, se placer dans le dossier ou se trouve l'archive, admettons que le dossier racine du serveur soit www et se trouve dans votre répertoire personnel :

unzip  smi_1.0.5.zip -d  ~/www/smi/

Créer un répertoire de téléchargement et un répertoire de sauvegarde et un répertoire de logos pour SMI , pour cela, entrer dans le répertoire de smi et faire ceci :

mkdir telechgt && mkdir telechgt/fictec && mkdir svg && mkdir logos

Il faut maintenant donner des permissions au dossier de smi et tout son contenu pour que tout se passe bien, pour cela sortir du dossier smi et se situer dans son dossier parent :

cd ..
sudo chmod -R 777 smi

En console ou en utilisant l'interface graphique phpmyadmin, créer une base de donnée 'smi'. Créer un utilisateur nommé wwwrun et lui donner les droit suivants: 'SELECT', 'INSERT', 'UPDATE', DELETE', 'FILE', 'CREATE ', 'ALTER', 'INDEX', et 'DROP' sur la base smi que vous venez de mettre en place. (voir doc de MySql)

Ouvrir en édition le fichier inc/prm.inc.php, éditer les données dans les champs , ne pas oublier que l'utilisateur est wwwrun, il faut y mettre un mot de passe, laisser les répertoires de téléchargement et sauvegarde par défaut puisque nous les avons créés tels quels. Puis sauver.

De la racine du répertoire de SMI :

sudo nano inc/prm.inc.php

Il faut ensuite changer les droits pour le fichier prm.inc.php, se placer dans le répertoire de smi et taper ceci :

sudo chmod 644 inc/prm.inc.php

Et de la même façon, changer les droits pour le répertoire inc lui même :

sudo chmod 755 inc

Ce n'est pas encore tout, il faut maintenant initialiser la base de données smi pour qu'elle contienne les table nécessaire au fonctionnement initial. Les fichiers .sql à cet effet se trouvent dans smi/install/sql/ dans ce cas précis, nous utiliserons le fichier smi_1.0.5.sql

Si vous disposez déjà d'une sauvegarde de base de données smi, utilisez la, si elle est relative à une version précédente il faudra utiliser un fichier smi_x.x.x_to_x.x.x.sql correspondant à votre version sauvegardée pour la mettre à jour, AVANT le premier usage.

En ouvrant phpmyadmin, sélectionner la base de smi et se connecter avec l'identifiant défini pour celle-ci , ensuite , au-dessus cliquer sur l'onglet 'Importer' et cliquer sur le bouton 'choisir un fichier' spécifier le fichier voulu et au fond de la page cliquer sur 'Executer' des warning ou erreurs peuvent apparaître , elles sont souvent insignifiantes.

Maintenant que tous les fichiers et répertoires sont en place, que la base de données et l'utilisateur ont été créés, démarrer Xampp comme d'habitude en veillant à ce que apache2 et mysql soit bien actif, Ouvrir votre explorateur internet et taper cette adresse pour avoir accès à la page principale de SMI http://localhost/smi/index.php

Si tout s'est bien passé, vous ne devriez pas obtenir de messages d'erreur, si tel était le cas, se référer au forum officiel sur le site de SMI.

Installation sur serveur local.

Méthode uniquement valable pour les versions d'Ubuntu antérieures à 16.04, sous Ubuntu 16.04 et ultérieur il faut installer SMI en virtualisation sous Docker avec php5.6 et mysql5.5 par la méthode décrite plus bas, sans quoi SMI 1.0.5 ne fonctionnera pas où avec d'énormes contraintes de mise en œuvre! Pour raison d'incompatibilité du code aux versions actuelles de PHP7.0 et Mysql 5.7

Commencer tout d'abord par télécharger l'archive contenant les fichiers de SMI, la version actuelle étant 1.0.5 sur le site officiel de SMI ici.

Rendez vous dans le répertoire racine www de votre serveur local , généralement /var/www/ et créez y un répertoire 'smi' en minuscule.

Ayant ouvert un terminal dans le dossier racine du serveur :

mkdir smi

Extraire tout le contenu de l'archive téléchargée avec FileRoller en mode graphique dans le répertoire smi ainsi créé.

Ou en terminal, se placer dans le dossier ou se trouve l'archive, admettons que le dossier racine du serveur soit www et se trouve dans votre répertoire personnel :

unzip  smi_1.0.5.zip -d  /var/www/smi/

Créer un répertoire de téléchargement , un répertoire de sauvegarde et un répertoire de logos pour SMI , pour cela, entrer dans le répertoire de smi et faire ceci :

mkdir telechgt && mkdir telechgt/fictec && mkdir svg && mkdir logos

Il faut maintenant donner des permissions au dossier de smi et tout son contenu pour que tout se passe bien, pour cela sortir du dossier smi et se situer dans son dossier parent :

cd ..
sudo chmod -R 777 smi

En console ou en utilisant l'interface graphique phpmyadmin, créer une base de donnée 'smi'. Créer un utilisateur nommé wwwrun et lui donner les droit suivants: 'SELECT', 'INSERT', 'UPDATE', DELETE', 'FILE', 'CREATE ', 'ALTER', 'INDEX', et 'DROP' sur la base smi que vous venez de mettre en place. (voir doc de MySql)

Ouvrir en édition le fichier smi/inc/prm.inc.php, éditer les données dans les champs , ne pas oublier que l'utilisateur est wwwrun, il faut y mettre un mot de passe, laisser les répertoires de téléchargement et sauvegarde par défaut puisque nous les avons créés tels quels. Puis sauver.

De la racine du répertoire de SMI :

sudo nano inc/prm.inc.php

Il faut ensuite changer les droits pour le fichier prm.inc.php, se placer dans le répertoire de smi et taper ceci :

sudo chmod 644 inc/prm.inc.php

Et de la même façon, changer les droits pour le répertoire inc lui même :

sudo chmod 755 inc

Ce n'est pas encore tout, il faut maintenant initialiser la base de données smi pour qu'elle contienne les table nécessaire au fonctionnement initial. Les fichiers .sql à cet effet se trouvent dans smi/install/sql/ dans ce cas précis, nous utiliserons le fichier smi_1.0.5.sql

Si vous disposez déjà d'une sauvegarde de base de données smi, utilisez la, si elle est relative à une version précédente il faudra utiliser un fichier smi_x.x.x_to_x.x.x.sql correspondant à votre version sauvegardée pour la mettre à jour, AVANT le premier usage.

En ouvrant phpmyadmin, sélectionner la base de smi et se connecter avec l'identifiant défini pour celle-ci , ensuite , au-dessus cliquer sur l'onglet 'Importer' et cliquer sur le bouton 'choisir un fichier' spécifier le fichier voulu et au fond de la page cliquer sur 'Executer' des warning ou erreurs peuvent apparaître , elles sont souvent insignifiantes.

Maintenant que tous les fichiers et répertoires sont en place, que la base de données et l'utilisateur ont été créés, démarrer Xampp comme d'habitude en veillant à ce que apache2 et mysql soit bien actif, Ouvrir votre explorateur internet et taper cette adresse pour avoir accès à la page principale de SMI http://localhost/smi/index.php

Si tout s'est bien passé, vous ne devriez pas obtenir de messages d'erreur, si tel était le cas, se référer au forum officiel sur le site de SMI.

Installation locale de compatibilité sous Docker.

Cette méthode d'installation est la solution à l'incompatibilité du code de SMI avec les versions actuelles php 7.x et mysql 5.7, elle fait appel à Docker un système de virtualisation partielle qui permet la cohabitation de différentes versions de logiciels sans influer sur le système hôte lui-même, merci à Krodelabestiole pour son aide précieuse.

Après de nombreux essais et recherches, il s'est avéré que l'installation sous Ubuntu 16.04 de PHP 5.6 par un ppa est un jeu d'enfant mais il n'en est pas de même pour mysql 5.5 ou 5.6 qui est un véritable parcours du combattant pour l'utilisateur commun, Krodelabestiole, un membre du forum Ubuntu à eu l'idée géniale d'utiliser Docker pour lancer SMI dans son environnement compatible, sans pour autant modifier quoi que ce soit au système hôte. Merci à lui au passage.

Brève présentation de Docker, c'est un logiciel qui permet de mettre en 'container' toutes sortes de logiciels dans autant de versions que possible, soit combinés en environnement complet, soit installés de manière individuelle pour un usage précis. C'est une solution qui permet une virtualisation très légère du strict nécessaire sans pour autant faire tourner un OS complet comme le fait VirtualBox.

Installation sur serveur distant.

A compléter !

Au premier lancement de SMI il est nécessaire de le configurer pour pouvoir l'utiliser correctement, vous vous trouvez donc sur une page de login sur laquelle vous aller utiliser comme login 'Administrateur' et comme mot de passe 'Administrateur'. Vous arrivez directement sur la page d'accueil de SMI qui vous dit qu'il n'est pas configuré, cliquez donc sur configurer. Entrez les données de votre société, si vous êtes en France tout se passe bien, pour d'autres pays, il faudra procéder à une manipulation pour les villes et provinces, voir au point suivant.

Si vous avez entré tous les paramètres obligatoires correctement , la validation du formulaire devrait se faire. Attention: un problème de format des numéros de téléphones Belge se produit dans la version 1.0.0 il devrait toutefois être résolu dans la version 1.0.1.

Spécificités par pays.

SMI à été prévu à l'origine pour la France, et prend donc en charge par défaut les départements et villes françaises, mais à été adapté pour plusieurs autres pays dont la Belgique et la Suisse. Sans cela, impossible de terminer la première configuration. Pour que SMI puisse prendre en charge les villes et provinces d'autres pays, vous trouverez des fichiers CSV dans le répertoire install/csv/ pour chaque pays il faut un fichier 'dep' et un fichier 'villes'.

Exemple pour la Belgique, à adapter pour d'autres pays :

Copier les fichiers csv dans le répertoire d'importation de SMI en admettant que vous ayez créé les dossiers comme prescrits, positionnez vous dans le dossier principal de SMI et taper ceci :

cp install/csv/be_villes.csv telechgt/fictec/ && cp install/csv/be_dep.csv telechgt/fictec/

Une fois ces fichiers copiés, ouvrez SMI et se diriger dans le menu jusqu'à Administration/Données/Importations/villes et aussi Administration/Données/Importations/départements, dans les deux cas utiliser les fichiers copiés pour l'importation.

Après cette opération, revenir à la page de configuration par la page d'accueil que vous devriez maintenant pouvoir mener à bien.

SMI est un logiciel en permanente évolution qui devrait bientôt se doter d'une gestion de facturation et de stock, pour la prise en main je vous recommande donc de consulter sa documentation officielle.

  • smi.1496178909.txt.gz
  • Dernière modification: Le 30/05/2017, 23:15
  • par yoritomo