Wiki de FedeRez

Instructions de mises à jour inspirées de la documentation officielle.
https://wiki.dolibarr.org/index.php/Installation_-_Mise_%C3%A0_jour#Avec_Dolibarr_.28package_standard_.tgz.29

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 /srv.

cd /srv

Récupérez l'archive de la nouvelle version

wget http://www.dolibarr.org/files/dolibarr.tgz

Décompressez l'archive

tar xvfz dolibarr.tgz

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 déplacez 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)

cp -r dolibarr-x.y.z/* dolibarr

Vous pouvez alors supprimer le répertoire des fichiers sources

rm -fr dolibarr-x.y.z

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).

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é

echo > /srv/dolibarr/documents/install.lock
chmod 444 /srv/dolibarr/documents/install.lock

Dans /srv on récupère la dernière version de Dolibarr :

cd /srv
wget https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/5.0.0/dolibarr-5.0.0.tgz/download
tar -zxf download
rm download
mv dolibarr-5.0.0 dolibarr

mkdir dolibarr/documents
touch dolibarr/htdocs/conf/conf.conf
chown www-data:www-data -R /srv/dolibarr/documents
chown www-data:www-data -R /srv/dolibarr/htdocs

Puis on crée le VirtualHost Apache qui va servir la partie publique de Dolibarr :

cd /etc/apache2/sites-available
vim dolibarr.conf

dolibarr

<IfModule mod_ssl.c>
<VirtualHost *:443>
    ServerAdmin admin@federez.net
    ServerName compta.federez.net
 
    DocumentRoot /srv/dolibarr/htdocs
    <Directory /srv/dolibarr>
        Include /etc/apache2/ldap.conf
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>
 
    # Possible values include: debug, info, notice, warn, error, crit,
    # alert, emerg.
    LogLevel warn
    ErrorLog ${APACHE_LOG_DIR}/dolibarr-error.log
    CustomLog ${APACHE_LOG_DIR}/dolibarr-access.log combined
 
    # SSL
    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/myriagon.federez.net/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/myriagon.federez.net/privkey.pem
 
    <FilesMatch "\.(cgi|shtml|phtml|php)$">
        SSLOptions +StdEnvVars
    </FilesMatch>
</VirtualHost>
</IfModule>

a2ensite dolibarr
service apache2 reload

Aller sur l'installateur https://compta.federez.net/install/ et suivre les différentes étapes.

Une fois l'installation finie, les étapes suivantes permettent de figer la configuration et désactiver l'installeur :

cd /srv/dolibarr/
touch /srv/dolibarr/documents/install.lock
chmod go-w /srv/dolibarr

Deux types de sauvegarde sont à mettre en place :

• Sauvegarde de /srv/dolibarr/documents où sont placés les uploads
• Sauvegarde de la base de données.