Use your data to test last version

From Dolibarr Open Source ERP CRM Wiki

En verysmall.png Page waiting for translation. To translate, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar".
It verysmall.png Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica".
Pt verysmall.png Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar".
De verysmall.png Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".

Les testeurs parmi vous voudront certainement, à un moment ou l'autre, tester les dernières mises-à-jour disponibles afin de vérifier l'état de certains bugs ou valider une nouvelle version.

Afin d'utiliser vos données en toute quiétude, voici une procédure à suivre pour éviter les pertes...

Attention! Cette documentation a pour base des exemples pris d'une installation Dolibarr avec la configuration suivante

  • Linux Debian Etch
  • MySQL 4.1
  • Apache2

Dans le cas où vous utiliseriez un autre type de machine, merci de procéder aux modifications d'usage.

Contents

Copie

Comme vos données ont une valeur importante, il serait dommage de les perdre. Afin de tester une mise-à-jour, pourquoi ne pas copier vos données ailleurs?

Répertoire

Étant donné que, fort probablement, toute votre installation de Dolibarr réside dans un unique répertoire, une copie sera facile.

cp -ra /var/www/dolibarr /var/www/dolibarrtest

Cette commande copiera votre répertoire Dolibarr (supposé être dans /var/www/dolibarr ici) dans un second répertoire dolibarrtest sur lequel vous mènerez vos tests. Le -ra veut dire récursif et conserve les droits sur les fichiers. Cette dernière option vous permettra de ne pas vous soucier des questions de droits sur les fichiers après copie.

Base de données

  • Faites une sauvegarde de votre base de données:
mysqldump -u utilisateur -p --result-file=dolibarr.date.sql base_de_donnees
  • Éditez le fichier résultant et modifiez la ligne USE base_de_donnees; en début de fichier pour la remplacer par un nouveau nom de base de données, celui de la base de données de tests, par exemple USER base_de_donnees_test; dans ce cas-ci.
  • Créez la nouvelle base de données si ce n'est pas déjà fait. Si la base de données existe, droppez-la et recréez-la, afin de n'obtenir au final que les données réellement extraites de votre base de données courante.
mysqladmin -u utilisateur -p drop base_de_donnees_test
mysqladmin -u utilisateur -p create base_de_donnees_test

Il se peut que vos permissions ne vous autorisent pas à dropper/créer une base de données. Dans ce cas, reportez-vous à votre documentation de MySQL concernant les permissions.

  • Importez les données de votre base de départ dans votre nouvelle base
mysql -u utilisateur -p base_de_donnees_test < dolibarr.date.sql

Hôtes virtuels d'Apache

Si vous utilisez des hôtes virtuels dans Apache, il faudra en créer un nouveau pour votre installation de test. Par exemple, si vous aviez quelque chose comme ceci dans un fichier nommé /etc/apache2/sites-available/dolibarr:

<VirtualHost *:80>
 ServerName dolibarr.mondomaine.net
 ServerAdmin webmaster@mondomaine.net
 DocumentRoot /var/www/dolibarr/htdocs
 DirectoryIndex index.php
 ErrorLog  /var/log/apache2/dolibarr-error.log
 CustomLog /var/log/apache2/dolibarr-access.log combined
</VirtualHost>

... il faudra à présent en faire une copie dans, par exemple, /etc/apache2/sites-available/dolibarrtest:

<VirtualHost *:80>
 ServerName dolibarrtest.mondomaine.net
 ServerAdmin webmaster@mondomaine.net
 DocumentRoot /var/www/dolibarrtest/htdocs
 DirectoryIndex index.php
 ErrorLog  /var/log/apache2/dolibarrtest-error.log
 CustomLog /var/log/apache2/dolibarrtest-access.log combined
</VirtualHost>

Attention, ceci ne suffit pas à rendre cet hôte disponible, il faudra également:

  • mettre en place le sous-domaine spécifié, avec notamment des règles de redirection sur la machine qui sert de DNS à votre domaine
  • faire un lien symbolique depuis /etc/apache2/sites-enabled/dolibarrtest vers /etc/apache2/sites-available/dolibarrtest

ln -s /etc/apache2/sites-enabled/dolibarrtest /etc/apache2/sites-available/dolibarrtest

  • recharger la config d'Apache2

/etc/init.d/apache2 reload

Fichier de configuration

Enfin, le fichier de configuration /var/www/dolibarrtest/htdocs/conf/conf.php doit absolument être modifié. Tant qu'il n'est pas modifié, votre installation dolibarrtest se connectera en effet toujours à votr vraie base de données, pas celle de test! Éditez le fichier de configuration et modifiez le nom de la base de données à laquelle se connecter. Dans la lignée des exemples ci-dessus, renommez base_de_donnees en base_de_donnees_test. Renommez également les répertoires auxquels votre configuration fait référence. Les /var/www/dolibarr deviennent /var/www/dolibarrtest.

Vérifications

Si vous avez bien réalisé les étapes préparatoires, vous devriez à présent pouvoir charger votre nouveau portail dans votre navigateur et vérifier qu'il s'agit bien d'un portail distinct. Comment faire?

Modification DB

  • Modifiez une petite information (par exemple modifiez vos détails persos) sur votre portail de test
  • Déloggez-vous
  • Loggez-vous sur votre portail de production
  • Vérifiez si l'information a changé. Si elle a changé, reparcourez les étapes ci-dessus pour voir ce que vous avez manqué. Aucune modification n'aurait dû être apportée!
  • Si aucune modification n'a été apportée, c'est bien! Retournez sur votre portail de test et vérifiez que la modification que vous y aviez apportée y est toujours... bien.

Modification documents

  • Ajoutez un document à l'une de vos fiches sur votre portail de test
  • Déloggez-vous
  • Loggez-vous sur votre portail de production.
  • Vérifiez si le nouveau document s'y trouve. S'il s'y trouve, reparcourez les étapes ci-dessus pour voir ce que vous avez manqué. Aucune modification n'aurait dû être apportée!
  • Si aucune modification n'a été apportée, c'est bien! Retournez sur votre portail de test et vérifiez que la modification que vous y aviez apportée y est toujours... bien.


Mise-à-jour

Vous avez tout copié, et votre configuration vous met à l'abri de modifications indésirées dans votre répertoire de production? Vous avez vérifié que vous pouviez accéder à votre portail de test depuis votre navigateur? Bien! Maintenant, récupérez la dernière version de Dolibarr et copiez-là aussi sec par-dessus l'autre, qui est dans /var/www/dolibarrtest (si on vous le demande, choisissez "écraser"). Ensuite, pointez votre navigateur sur le portail de test, et ajoutez "install/" dans l'URL. Le processus d'installation/mise-à-jour de Dolibarr devrait vous proposer une mise-à-jour. Acceptez et suivez les étapes.

Votre portail de test est maintenant mis-à-jour à la dernière version. Bravo!

Personal tools
  • Ask to contact@dolibarr.org to request an account to contribute to this documentation
  • Log in
In other languages
FrenchSpanishDeutsch
No translation in Deutsch.
Italian
No translation in Italian.
Greek
No translation in Greek.
<multilanguagemanager_cn>
No translation in &lt;multilanguagemanager_cn&gt;.

Social networks
Follow us on Google+ Follow us on Facebook Follow us on LinkedIn Follow us on Twitter