Administration

Migrer depuis ERPNext

Effectuez une sauvegarde de vos données/votre environnement avant de commencer à suivre ce guide.
Attention, ce guide n'a pas été testé sur les dernières versions d'ERPNext et Dokos. Vous pouvez remonter tout problème sur le système de suivi des tickets Dokos ou le forum.

Migrer depuis ERPNext

  • Ce guide de migration a été testé pour une migration d'ERPNext v11.x.x et v12.x.x vers Dokos v1.x.x ou Dokos v2.x.x
  • Il est recommandé de mettre à jour ERPNext vers la version v11.x.x ou v12.x.x avant de suivre ce guide

Pré-requis

Votre environnement bench doit fonctionner avec Python 3 (Python 3.10 minimum).

Si ce n'est pas le cas, lancez la commande suivante depuis votre dossier bench (`home/{utilisateur}/{votre_bench}):

bench migrate-env python3

Passer sur dokos

Changez l'URL de dépôt et mettre à jour bench

  • Dans le dossier local de votre utilisateur, allez dans le dossier de l'application bench
# soit :
cd "$HOME/.bench"
# ou alors :
cd "$HOME/bench-repo"

Généralement votre utilisateur est appelé frappe, mais cela peut aussi être un autre utilisateur, créé lors de l'installation de Frappe/ERPNext

  • Changez l'URL du dépôt et mettez à jour l'application:
git remote set-url origin https://gitlab.com/dokos/docli.git
git fetch origin
git reset --hard origin/master
pip install -e .

Changez l'URL dépôt par défaut de chaque application

  • Depuis votre dossier bench, généralement /home/frappe/frappe-bench, lancez les commandes suivantes
bench remote-reset-url dodock
bench remote-reset-url dokos

# Et, le cas échéant :
bench remote-reset-url payments  # Paiements
bench remote-reset-url hrms  # Gestion des ressources humaines
  • Ensuite migrez sur la branche courante pour configurer l'environnement de production
# Depuis ERPNext v14 ou antérieur
bench switch-to-branch v3.x.x

# Pour ERPNext v15
bench switch-to-branch v4

Les applications Frappe et ERPNext ne sont pas encore renommées en dodock et dokos dans bench. De ce fait, à l'exception de la modification des URL de dépôts et l'installation d'applications, vous devez encore appeler chaque application par son nom d'origine.

Vérifier que l'application est prête à être mise à jour

  • Depuis votre dossier bench - généralement /home/frappe/frappe-bench - lancez la commande suivante
bench remote-urls

Le résultat doit contenir:

frappe   https://gitlab.com/dokos/dodock.git
erpnext  https://gitlab.com/dokos/dokos.git

Mettre à jour l'application

  • Depuis votre dossier bench - généralement /home/frappe/frappe-bench - lancez la commande suivante
bench update --reset

Si vous rencontrez des problèmes lors de la migration, veuillez ouvrir un ticket dans le système de suivi des tickets dokos


CC-BY-SA 3.0