Dupliquer une instance de prod en instance de test

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.

= Duplication d'une instance Dolibarr =

Afin d'utiliser vos données en toute quiétude, voici une procédure à suivre pour créer une nouvelle instance de test Dolibarr depuis une instance déjà existante. Cette nouvelle instance vous permettra de mener les tests (migration puis utilisation de l'application) en toute quiétude.

Attention! Cette documentation a pour base des exemples pris d'une installation Dolibarr avec la configuration suivante Dans le cas où vous utiliseriez un autre type de machine, merci de procéder aux modifications d'usage.
 * Linux Debian Etch
 * MySQL 4.1
 * Apache2

Répertoire
Étant donné que, fort probablement, toute votre installation de Dolibarr réside dans un unique répertoire, une copie sera facile. 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
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.
 * Faites une sauvegarde de votre base de données:
 * É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.
 * Importez les données de votre base de départ dans votre nouvelle base

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: ... il faudra à présent en faire une copie dans, par exemple, /etc/apache2/sites-available/dolibarrtest:

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
 * recharger la config d'Apache2

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, vous pouvez faire une montée de version de Dolibarr sans risque dans votre instance de test. Pour cela, suivre la procédure de mise a jour décrite sur la page Installation - Mise à jour

Votre portail de test sera alors prêt avec une nouvelle version de Dolibarr. Bravo!