Module Extra Admin Tools

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Module name Extra Admin Tools
Editor / Editeur Libre Expert - www.libre-expert.com
Download or buy page / Page achat ou téléchargement www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis Dolibarr min version 3.9.0   
Last update date / Date mise à jour fiche / Fecha última actualización 2019-07-23
Note / Nota

Fonctionnalités

Ce module vous fournira des outils d'administration complémentaires pour Dolibarr en un seul paquet :

  • un installateur de modules facile (pour utiliser des fichiers venant de Dolistore)
  • un gestionnaire de fichiers (copier, déplacer, supprimer, archiver, éditer, renommer, visualiser, rechercher)
  • un configurateur de sauvegardes : stockage incrémentiel, rapport par email (fonctionne ensemble avec cron, bash et tar)
  • un vérificateur d'intégrité de fichiers Dolibarr (pour garder un oeil sur les modifications)

Prérequis

Votre serveur web PHP doit avoir les permissions d'accéder aux répertoires que vous voulez utiliser.

Installation

  • Télécharger le fichier archive du module (.zip) depuis le site web www.dolistore.com ou le récupérer par tout autre manière.
  • Placer le répertoire du module dans le répertoire custom de Dolibarr:
    • Pour cela, aller dans Accueil - Configuration - Modules - Déployer/installer une app/module externe
    • Téléverser le fichier. Note: Si cela échoue, vous pouvez manuellement dézipper le fichier dans le répertoire custom via la ligne de commande: aller dans le répertoire *custom* et décompressez le zip avec la commande: unzip fichiermodule.zip
  • Le module est opérationnel et peut être activé.

Configuration

Pour mettre en place le module, extraire l'archive Zip fournie de préférence dans le répertoire "htdocs/custom/" de votre installation Dolibarr, Modifier les droits des fichiers si nécessaire pour permettre à votre serveur web d'accéder au nouveau dossier. Votre fichier "htdocs/conf/conf.php" doit être paramétré afin d'inclure le répertoire alternatif, en ajustant les paramètres ci-dessous (à modifier selon vos caractéristiques) :

  • $dolibarr_main_url_root_alt='/custom';
  • $dolibarr_main_document_root_alt='/var/www/dolibarr/htdocs/custom';

Utilisation

Une fois activé depuis le menu administrateur Configuration/Modules dans la rubrique "Autre", ce module comprendra 4 fonctionnalités, accessibles depuis le menu de gauche de la page d'accueil de Dolibarr pour les utilisateurs ayant le rôle d'administrateur :

  • La vérification de l'intégrité des fichiers de Dolibarr
  • Un installateur facile de modules pour Dolibarr
  • Un gestionnaire de fichiers
  • Un configurateur de sauvegardes


1) Le vérificateur d'intégrité
Cette fonctionnalité doit être initialisée la première fois que l'on se rend sur sa page, cette étape génère un fichier de référence contenant
une base de vérification des fichiers par md5sum. Lorsque l'on se rend ensuite sur le même menu,
il est proposé de faire une vérification d'intégrité des fichiers, récursivement depuis le répertoire "htdocs" de votre installation de Dolibarr.
Pour réinitialiser la base des md5sum, il faut supprimer manuellement le fichier "checklist" qui est une archive Zip placée à la base du dossier de ce module,
vous serez ensuite invité à réinitialiser la base md5sum à la prochaine visite sur la page de cette fonctionnalité.
  • Remarque : L'usage de cette fonctionnalité sur un système lent, engendrera un temps d'attente du rafraichissement de la page
2) L'installateur facile de modules
Cette fonctionnalité permet dans un premier temps de charger et simuler l'extraction d'une archive Zip de module pour Dolibarr, afin de vérifier que celle-ci se déploiera correctement.
Il y a trois possibilités de placement, à vous de voir en fonction de l'arborescence contenue dans l'archive Zip,
la méthode recommandée est de placer ses nouveaux modules dans le dossier "/htdocs/custom".
Puis la vérification faite, un boutton permet confirmer l'extraction réelle, il ne restera plus qu'à activer le module ainsi copié, dans le menu Configuration/Modules.
3) Le gestionnaire de fichiers
Il vous permettra d'agir sur l'arborescence de vos fichiers hébergés : copie, déplacement, suppression, archivage, édition, renommage, visualisation, recherche.
Utilisation du clic gauche pour sélectionner, et du clic droit pour voir apparaître les actions possibles.
4) Le configurateur de sauvegardes
Cette fonctionnalité travaille de pair avec l'application CRON ou équivalente, il faut la paramétrer pour lui demander d'exécuter toutes les heures
le script "simplebashbu.sh" situé dans le répertoire "scripts/" du module. Ce script lit avant exécution un fichier de configuration nommé "backupconfig.conf"
généré par la page de paramétrages au moment de l'appui sur le bouton "Enregistrer la configuration et tester l'accès à la base",
ce fichier est placé dans le même répertoire "scripts/" du module.
Exemple de programmation de CRON pour exécuter le script toutes les heures
0 * * * * /var/www/dolibarr/htdocs/custom/scripts/simplebashbu.sh
  • Important : Vous devez mettre en place cette programmation par vous-même sur votre serveur, car cela nécessite l'utilisateur "root".

L'action de ce script consiste en une sauvegarde intégrale des fichiers de Dolibarr une fois par semaine, au jour et à l'heure voulue, puis s'effectue une sauvegarde incrémentale les autres jours de la semaine. La base de données, elle, est sauvegardée intégralement chaque jour, à la même heure que les fichiers. Il résulte des fichiers Gzip placés dans le répertoire que vous aurez précisé dans la configuration de cette fonctionnalité, avec l'arborescence suivante :

  • ARCHIVED-BACKUPS pour les sauvegardes intégrales, chaque semaine sont ajoutés de 2 nouveaux fichiers Gzip, la base de données et les fichiers de Dolibarr
  • DAILY pour les sauvegardes quotidiennes
  • LOGS pour les rapports de sauvegardes

Un email peut être précisé pour envoyer un rapport à l'administrateur à chaque sauvegarde effectuée, il suffit que PHP Mail soit bien configuré sur votre serveur.