Installation - Mise à jour: Difference between revisions

Jump to navigation Jump to search
m
Typo fichier conf
Tag: 2017 source edit
m (Typo fichier conf)
Line 18: Line 18:


==Sur votre poste/serveur dédié==
==Sur votre poste/serveur dédié==
===[[File:Logo_windows.png]] Avec DoliWamp (pour Windows) ===
===[[File:Logo_windows.png]] Avec DoliWamp (pour Windows)===
- '''Prérequis''': Windows
- '''Prérequis''': Windows


Line 41: Line 41:
- '''Prerequis''': Linux Debian, Ubuntu, ...
- '''Prerequis''': Linux Debian, Ubuntu, ...


- '''Niveau''' : Débutant
- '''Niveau'''<span> </span>: Débutant


Cette procédure fonctionne uniquement pour les utilisateurs Linux Debian, Ubuntu et dérivés et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre '''Avec Dolibarr (package standard zip)''' sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliDeb. DoliDeb est un package de Dolibarr spécialisé pour la distribution Debian ou Ubuntu. Ce package vous permet d'installer Dolibarr sous Ubuntu ou Debian (ou dérivé) avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.
Cette procédure fonctionne uniquement pour les utilisateurs Linux Debian, Ubuntu et dérivés et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre '''Avec Dolibarr (package standard zip)''' sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliDeb. DoliDeb est un package de Dolibarr spécialisé pour la distribution Debian ou Ubuntu. Ce package vous permet d'installer Dolibarr sous Ubuntu ou Debian (ou dérivé) avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.
Line 49: Line 49:


===[[File:Logo_rpm.png|40px]] Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm)===
===[[File:Logo_rpm.png|40px]] Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm)===
- '''Prerequis''' : Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse (peut également fonctioner pour toute distribution Linux à rpm)
- '''Prerequis'''<span> </span>: Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse (peut également fonctioner pour toute distribution Linux à rpm)


- '''Niveau''' : Débutant
- '''Niveau'''<span> </span>: Débutant


Cette procédure fonctionne uniquement pour les utilisateurs Linux d'une distribution gérant les packages rpm et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre suivant '''Avec Dolibarr (package standard zip)''' sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliRpm. DoliRpm est un package de Dolibarr spécialisé pour la distribution Fedora, Redhat, Mandriva, Mageia ou OpenSuse. Ce package vous permet d'installer Dolibarr sous ces OS avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.
Cette procédure fonctionne uniquement pour les utilisateurs Linux d'une distribution gérant les packages rpm et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre suivant '''Avec Dolibarr (package standard zip)''' sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliRpm. DoliRpm est un package de Dolibarr spécialisé pour la distribution Fedora, Redhat, Mandriva, Mageia ou OpenSuse. Ce package vous permet d'installer Dolibarr sous ces OS avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.
Line 59: Line 59:


===[[File:Gnu.png]] Avec Dolibarr (package standard .zip ou sources Git pour Windows, Mac OS, OS X, Linux, BSD, ...)===
===[[File:Gnu.png]] Avec Dolibarr (package standard .zip ou sources Git pour Windows, Mac OS, OS X, Linux, BSD, ...)===
- '''Prérequis''' : Apache, PHP et un serveur de base de données (MySQL ou PostgreSQL) sont présents et opérationnels, et le login/mot de passe d'accès (au serveur de base de donné, ou à l'utilisateur root système) est connu.
- '''Prérequis'''<span> </span>: Apache, PHP et un serveur de base de données (MySQL ou PostgreSQL) sont présents et opérationnels, et le login/mot de passe d'accès (au serveur de base de donné, ou à l'utilisateur root système) est connu.


- '''Niveau''' : Un peu de connaissances informatiques en administration Web.
- '''Niveau'''<span> </span>: Un peu de connaissances informatiques en administration Web.


Cette procédure décrit l'installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandriva, ...) mais elle est valable avec d'autres systèmes moyennant une adaptation des chemins à ceux de votre OS.
Cette procédure décrit l'installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandriva, ...) mais elle est valable avec d'autres systèmes moyennant une adaptation des chemins à ceux de votre OS.
Line 77: Line 77:
====Installation du serveur de base de donnée====
====Installation du serveur de base de donnée====


===== MySql ou MariaDB=====
=====MySql ou MariaDB=====
Installer le serveur de base de donnée (Voir la doc de votre serveur). Vérifiez que le serveur de base de données est lancé (<code>systemctl status mysqld.service</code> par exemple). L'activer le cas échéant (<code>systemctl enable --now mysqld.service</code>).
Installer le serveur de base de donnée (Voir la doc de votre serveur). Vérifiez que le serveur de base de données est lancé (<code>systemctl status mysqld.service</code> par exemple). L'activer le cas échéant (<code>systemctl enable --now mysqld.service</code>).


Line 184: Line 184:


====SELinux sur Fedora====
====SELinux sur Fedora====
Sur Fedora, comme SELinux est activé en général, il est aussi conseillé de lancer les commandes pour rendre le répertoire 'dolibarr' accepté par l'environnement SELinux (an absence de commande, vous devriez recevoir des nombreuses alertes d'anomalies) :
Sur Fedora, comme SELinux est activé en général, il est aussi conseillé de lancer les commandes pour rendre le répertoire 'dolibarr' accepté par l'environnement SELinux (an absence de commande, vous devriez recevoir des nombreuses alertes d'anomalies)<span> </span>:
<source lang="bash">
<source lang="bash">
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
Line 190: Line 190:
</source>
</source>


Afin de pouvoir utiliser la sauvegarde sqldump et d'autres fonctions sur dolibarr dans un contexte SELinux vous devez ajouter 2 commandes :  
Afin de pouvoir utiliser la sauvegarde sqldump et d'autres fonctions sur dolibarr dans un contexte SELinux vous devez ajouter 2 commandes<span> </span>:  
<source lang="bash">
<source lang="bash">
$ sudo setsebool -P httpd_can_network_connect_db 1
$ sudo setsebool -P httpd_can_network_connect_db 1
Line 225: Line 225:


==Sur un hébergement mutualisé (à accès restreint)==
==Sur un hébergement mutualisé (à accès restreint)==
Certains hébergeurs proposaient une installation "en un clic" (OVH par exemple) : ils ont pour la plus part abandonné car trop questionnés pour des questions d'utilisation/administration : ils vous renverront maintenant vers ce wiki ou vers le forum dolibarr.
Certains hébergeurs proposaient une installation "en un clic" (OVH par exemple)<span> </span>: ils ont pour la plus part abandonné car trop questionnés pour des questions d'utilisation/administration<span> </span>: ils vous renverront maintenant vers ce wiki ou vers le forum dolibarr.


Procédure générique:
Procédure générique:
Line 242: Line 242:
*Récupérer l'archive de la dernière version stable de Dolibarr et décompressez la localement..
*Récupérer l'archive de la dernière version stable de Dolibarr et décompressez la localement..


*Uploadez tout le contenu du répertoire dans le répertoire racine de votre site web, par exemple par FTP en mode binaire. NB : seul le contenu de htdocs est nécessaire au fonctionnement de dolibarr)
*Uploadez tout le contenu du répertoire dans le répertoire racine de votre site web, par exemple par FTP en mode binaire. NB<span> </span>: seul le contenu de htdocs est nécessaire au fonctionnement de dolibarr)


*Créez un répertoire nommé "documents", dans cette racine, qui servira à sauver tous les documents générés et stockés par Dolibarr (factures PDF, images uploadées, ...). Le serveur web doit avoir les permissions d'écrire dedans. Vous pouvez attribuer ces permission avec un client FTP.
*Créez un répertoire nommé "documents", dans cette racine, qui servira à sauver tous les documents générés et stockés par Dolibarr (factures PDF, images uploadées, ...). Le serveur web doit avoir les permissions d'écrire dedans. Vous pouvez attribuer ces permission avec un client FTP.
Line 252: Line 252:
*Pour des raisons de sécurité, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire de Dolibarr. Ceci verrouillera l'appel au processus d'installation (il vous faudra supprimer ce fichier pour permettre les mise à jour). Si ceci n'est pas fait, Dolibarr vous affichera un warning lorsque vous êtes logués comme administrateur.
*Pour des raisons de sécurité, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire de Dolibarr. Ceci verrouillera l'appel au processus d'installation (il vous faudra supprimer ce fichier pour permettre les mise à jour). Si ceci n'est pas fait, Dolibarr vous affichera un warning lorsque vous êtes logués comme administrateur.


=== Exemple de tutoriel d'installation assez complet===
===Exemple de tutoriel d'installation assez complet===
[[Installation - GANDI simple hosting|Comment installer un Dolibarr PARFAITEMENT fonctionnel chez l'hébergeur GANDI ?]]
[[Installation - GANDI simple hosting|Comment installer un Dolibarr PARFAITEMENT fonctionnel chez l'hébergeur GANDI ?]]


Line 266: Line 266:


==Installation avec Docker==
==Installation avec Docker==
=== Utiliser l'image docker officielle ===
===Utiliser l'image docker officielle===
Voir le fichier README à https://hub.docker.com/r/dolibarr/dolibarr
Voir le fichier README à https://hub.docker.com/r/dolibarr/dolibarr


=== Reconstruire son image docker ===
===Reconstruire son image docker===
Pour les administrateurs ayant une expérience de Docker, il est possible d'utiliser les fichiers de build Docker situés dans le référentiel source ici : https://github.com/Dolibarr/dolibarr/tree/develop/build
Pour les administrateurs ayant une expérience de Docker, il est possible d'utiliser les fichiers de build Docker situés dans le référentiel source ici : https://github.com/Dolibarr/dolibarr/tree/develop/build
  git clone https://github.com/Dolibarr/dolibarr/
  git clone https://github.com/Dolibarr/dolibarr/
Line 302: Line 302:




Note : (facultatif mais recommandé)
Note<span> </span>: (facultatif mais recommandé)


Il est préférable de supprimer les anciens script (et les programmes s'ils sont inclus dans l'archive téléchargée) avant de déployer les nouveaux: des anciens fichiers pourraient rester dans la novuelle installation, causant bug ou dysfonctionnement.
Il est préférable de supprimer les anciens script (et les programmes s'ils sont inclus dans l'archive téléchargée) avant de déployer les nouveaux: des anciens fichiers pourraient rester dans la novuelle installation, causant bug ou dysfonctionnement.
Line 309: Line 309:


*/custom si vous avez des modules externes (dolistore) -> assurez vous que vos modules sont compatibles avec la nouvelle version avant de mettre à jour !
*/custom si vous avez des modules externes (dolistore) -> assurez vous que vos modules sont compatibles avec la nouvelle version avant de mettre à jour !
*/conf/conf.php : les principaux paramètres de dolibarr
*/conf/conf.php<span> </span>: les principaux paramètres de dolibarr
*Vos modèles et/ou script php personnalisés (il est recommandé de reporter vos modifications dans les nouveaux fichier car les votres sont basées sur l'ancienne version)
*Vos modèles et/ou script php personnalisés (il est recommandé de reporter vos modifications dans les nouveaux fichier car les votres sont basées sur l'ancienne version)


Line 409: Line 409:
Se reporter à la page [[Sauvegardes]].
Se reporter à la page [[Sauvegardes]].


=====À partir de votre interface d'administration Dolibarr, sauvegardez :=====
=====À partir de votre interface d'administration Dolibarr, sauvegardez<span> </span>:=====


*le répertoire <code>/documents</code>,
*le répertoire <code>/documents</code>,
Line 417: Line 417:


=====Récupération de la sauvegarde distante (obligatoire, le fichier conf.php sera réutilisé plus tard)=====
=====Récupération de la sauvegarde distante (obligatoire, le fichier conf.php sera réutilisé plus tard)=====
Copier les répertoires distants suivants sur votre disque local :
Copier les répertoires distants suivants sur votre disque local<span> </span>:


*<code>/documents</code>,
*<code>/documents</code>,
Line 426: Line 426:


====Étape 4 - Supprimez l'ancienne version sur le serveur====
====Étape 4 - Supprimez l'ancienne version sur le serveur====
Avec votre logiciel ftp, '''supprimez''' les fichiers et répertoires suivants :
Avec votre logiciel ftp, '''supprimez''' les fichiers et répertoires suivants<span> </span>:


*les fichiers à la racine de votre répertoire distant,
*les fichiers à la racine de votre répertoire distant,
*install.lock dans le répertoire <code>/documents</code> (s'il existe),
*install.lock dans le répertoire <code>/documents</code> (s'il existe),
*les répertoires :
*les répertoires<span> </span>:
**<code>/build</code>,
**<code>/build</code>,
**<code>/dev</code>,
**<code>/dev</code>,
Line 440: Line 440:


====Étape 5 - Envoyer les nouveaux fichiers sur le serveur distant====
====Étape 5 - Envoyer les nouveaux fichiers sur le serveur distant====
Avec votre logiciel ftp, '''envoyer''' :
Avec votre logiciel ftp, '''envoyer'''<span> </span>:


*tous les fichiers et répertoires de l'archive décompressée de la nouvelle version,
*tous les fichiers et répertoires de l'archive décompressée de la nouvelle version,
*<code>config.php</code> de votre sauvegarde dans <code>/htdocs/config</code>
*<code>conf.php</code> de votre sauvegarde dans <code>/htdocs/conf</code>


====Étape 6 - Lancer la mise à jour====
====Étape 6 - Lancer la mise à jour====
Remettre votre site en ligne.
Remettre votre site en ligne.


Avec votre navigateur, connectez-vous à votre instance Dolibarr avec l'URL que vous utilisez habituellement (généralement : ''<nowiki>https://monsite.re/htdocs/index.php</nowiki>''). Dolibarr détecte la présence de fichiers d'une nouvelle version. Il lance le processus de mise à jour.
Avec votre navigateur, connectez-vous à votre instance Dolibarr avec l'URL que vous utilisez habituellement (généralement<span> </span>: ''<nowiki>https://monsite.re/htdocs/index.php</nowiki>''). Dolibarr détecte la présence de fichiers d'une nouvelle version. Il lance le processus de mise à jour.


À l'issue de ce processus, vous arrivez sur votre page de connexion habituelle. Vous noterez que le numéro de votre nouvelle version sera indiqué au-dessus du formulaire de connexion.
À l'issue de ce processus, vous arrivez sur votre page de connexion habituelle. Vous noterez que le numéro de votre nouvelle version sera indiqué au-dessus du formulaire de connexion.
Line 456: Line 456:


=Vidéos sur le sujet=
=Vidéos sur le sujet=
Installation en local :
Installation en local<span> </span>:


<youtube width="200" height="120">N0iweN8ukVU</youtube>
<youtube width="200" height="120">N0iweN8ukVU</youtube>


Installation sur serveur distant Infomaniak :
Installation sur serveur distant Infomaniak<span> </span>:


<youtube width="200" height="120">jsi1D4L1WAI</youtube>
<youtube width="200" height="120">jsi1D4L1WAI</youtube>


Installation et migration vers V15 en local :  
Installation et migration vers V15 en local<span> </span>:  


<youtube width="200" height="120">LKdQvRVxYKs</youtube>
<youtube width="200" height="120">LKdQvRVxYKs</youtube>

Navigation menu