Changes

Jump to navigation Jump to search
Line 203: Line 203:  
= Procédure de mise à jour =
 
= Procédure de mise à jour =
 
Ce chapitre décrit le processus pour mettre à niveau une installation existante de Dolibarr d'une ancienne version vers une autre. Le processus est le même quel que soit la version depuis laquelle vous venez et la version vers laquelle vous allez, mais sera différent selon la distribution ou système d'exploitation utilisé pour votre première installation. Il est recommandé d'utiliser le même type de distribution pour la mise à jour que celle utilisée pour la première installation.
 
Ce chapitre décrit le processus pour mettre à niveau une installation existante de Dolibarr d'une ancienne version vers une autre. Le processus est le même quel que soit la version depuis laquelle vous venez et la version vers laquelle vous allez, mais sera différent selon la distribution ou système d'exploitation utilisé pour votre première installation. Il est recommandé d'utiliser le même type de distribution pour la mise à jour que celle utilisée pour la première installation.
 +
 +
== Sauvegarde ==
 +
 +
Avant de faire une mise à jour, il est recommendé de faire un sauvegarde de la base de donnée mais aussi des documents, de cette façon même en cas de catastrophe vous ne perdrez pas vos preciseuses données
 +
https://wiki.dolibarr.org/index.php/Sauvegardes
 +
 +
 +
 +
== [[File:Logo_windows.png]] Avec DoliWamp (package Windows .exe) ==
 +
 +
Si vous aviez installé la version de Dolibarr spécifique nommé DoliWamp (qui embarque le serveur Web, PHP et Mysql), la procédure à suivre est celle-ci (Dans tout autre cas, utilisez une des procédures des chapitres suivant):
 +
 +
* Télécharger la nouvelle version de DoliWamp.
 +
 +
* Lancer le .exe et laissez vous guider dans toutes les étapes de migration en cliquant suivant,suivant,... à chaque fois sans rien changer aux valeurs proposées par défaut.
 +
 +
* Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).
 +
 +
== [[File:Logo_ubuntu.png]] Avec DoliDeb (package Debian / Ubuntu .deb) ==
 +
Si vous aviez installé Dolibarr via un packagage Debian-Ubuntu, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .deb.
 +
Par exemple en suivant la procédure [[Dolibarr pour Ubuntu ou Debian]].
 +
 +
* Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).
 +
 +
== [[File:Logo_rpm.png|40px]] Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm) ==
 +
Si vous aviez installé Dolibarr via un packagage rpm, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .rpm.
 +
 +
* Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).
 +
 +
== [[File:Gnu.png]] Avec Dolibarr (package standard .tgz) ==
 +
 +
Cette procédure décrit la mise à jour de Dolibarr depuis une ancienne version vers une plus récente par la méthode manuelle, avec la distribution standard.
 +
 +
* Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)
 +
<source lang="bash">
 +
$ cd /var/www
 +
</source>
 +
 +
* Récupérez l'archive de la nouvelle version
 +
<source lang="bash">
 +
$ wget http://www.dolibarr.org/files/dolibarr.tgz
 +
</source>
 +
 +
* Décompressez l'archive
 +
<source lang="bash">
 +
$ tar xvfz dolibarr.tgz
 +
</source>
 +
 +
* Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-x.y.z) vers  le répertoire où vous avez votre ancienne version de Dolibarr. Ceci a pour effet de remplacer les anciens fichiers par les nouveaux tout en conservant les fichiers qui vous sont spécifiques (comme le fichier conf.php ou encore vos modules complémentaires non officiels installés).
 +
* Si vous deplacez ou renommez également le dossier de votre ancienne version de Dolibarr, pensez à modifier les chemins dans le fichier /conf/conf.php (sinon vous risquez un fatal error: Cannot redeclare versiontostring)
 +
<source lang="bash">
 +
$ cp -r dolibarr-x.y.z/* dolibarr
 +
</source>
 +
 +
* Vous pouvez alors supprimer le répertoire des fichiers sources
 +
<source lang="bash">
 +
$ rm -fr dolibarr-x.y.z
 +
</source>
 +
 +
* Lancer Dolibarr dans votre navigateur habituel. Ceci fera apparaître l'assistant de migration: L'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).
 +
 +
ou
 +
 +
Lancer les 2 étapes de migration en ligne de commande:
 +
<source lang="bash">
 +
$ cd htdocs/install
 +
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
 +
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
 +
$ php step5.php oldx.oldy.oldz x.y.z > output3.html
 +
</source>
 +
Note: z doit être "0" car seul les versions majeures ont un script de migration à exécuter.
 +
 +
Le code retour sera 0 en cas de succès, 1 en cas d'erreur (voir alors le fichier sortie output.html ou output2.html)
 +
 +
Note: Si vous avez un message signalant que le processus de mise à jour est vérrouillé par un fichier install.lock, supprimer ce fichier (il est stocké dans le répertoire racine ou "documents" de Dolibarr) puis rafraichissez la page.
 +
 +
* Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de verrouiller le répertoire d'installation en créant un fichier install.lock dans le répertoire de donnée de Dolibarr. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois loggé
 +
<source lang="bash">
 +
$ echo > documents/install.lock
 +
$ chmod 444 documents/install.lock
 +
</source>
    
= Sauvegarde =
 
= Sauvegarde =
40

edits

Navigation menu