feat: New page for updates

parent 8b9e0cbf
......@@ -6,7 +6,8 @@ module.exports = function getSidebar (lang) {
collapsable: false,
children: [
'',
'migration-erpnext'
'migration-erpnext',
'mettre-a-jour-dokos'
]
},
{
......@@ -24,7 +25,8 @@ module.exports = function getSidebar (lang) {
collapsable: false,
children: [
'',
'erpnext-migration'
'erpnext-migration',
'updating-dokos'
]
},
{
......
......@@ -8,7 +8,7 @@ tags: ["setting up", "migration"]
- It is therefore recommended that you upgrade your ERPNext instance to v11.x.x or v12.x.x before following this guide
### Pre-requisites
## Pre-requisites
Your __bench__ environment needs to run on Python 3 (minimum Python 3.6).
......@@ -21,9 +21,9 @@ dokos is not compatible with Python 2.7
:::
### Switch to dokos
## Switch to dokos
#### Change the default repository URL and update __bench__
### Change the default repository URL and update __bench__
- In your user's local folder, go to your __bench application__ folder
......@@ -46,7 +46,7 @@ git remote set-url origin https://gitlab.com/dokos/docli.git
git pull origin master
```
#### Change the default repository URL for each application
### Change the default repository URL for each application
- From your bench folder - usually `/home/frappe/frappe-bench` - run the following commands
......@@ -67,7 +67,7 @@ The applications Frappe and ERPNext are not yet renamed to dodock and dokos in _
Therefore, except for resetting the remote url and installing an application, you still need to call each application with their initial names.
:::
#### Check that the application is ready to be upgraded
### Check that the application is ready to be upgraded
- From your bench folder - usually `/home/frappe/frappe-bench` - run the following command
......@@ -82,7 +82,7 @@ frappe https://gitlab.com/dokos/dodock.git
erpnext https://gitlab.com/dokos/dokos.git
```
#### Upgrade your application
### Upgrade your application
- From your bench folder - usually `/home/frappe/frappe-bench` - run the following command
......
---
tags: ["update", "upgrade"]
---
# Updating dokos
Updating dokos is very straightforward but may necessitate some Linux/Python/NodeJS knowledge in case of error.
## The main command
Go to you bench folder (`home/{user}/{your_bench}) and run:
`bench update`
This command will do the following:
1. Put in application in maintenance mode
2. Update your application with the latest version on Gitlab
3. Update your python environment with any new dependency requirement
4. Run all patches and migrations necessary to update your database
5. Build all your javascript and CSS files
6. Put your application back in normal mode
## Decomposed commands
- `bench update --pull` will only pull the latest changes for each application
- `bench update --patch` will only run the patches and migrations for your database
- `bench update --build` will only build all JS and CSS files necessary for the user interface
- `bench update --bench` will only update the docli (Bench) application
- `bench update --requirements` will only update the python and nodejs dependencies in your environment
## Troubleshooting
If a patch breaks during the update, please post a new message on the [community forum](https://community.dokos.io) with a full copy of the error message. Wait for a correction, if so, and then run `bench update` again.
If you have custom applications in your bench folder, please make sure that they don't interfere with the standard update process.
Before reporting a potential issue, please test the update again in an environment without any custom application.
\ No newline at end of file
......@@ -3,7 +3,7 @@
dokos v1.0.0 is based on Frappe/ERPNext v12.x.x
Below are the main differences with Frappe/ERPNext.
### dokos
## dokos
- The following domains are not present in dokos:
* Hospitality
* Healthcare
......@@ -35,7 +35,7 @@ Below are the main differences with Frappe/ERPNext.
- A new doctype __Item Booking__ allows you to open bookings on the portal for your customers.
- Refactor of the __Profile (/me)__ page on the portal to integrate a payment methods update widget (Only Stripe compatible for now).
### dodock [Framework]
## dodock [Framework]
- The user interface has been enhanced with a few major changes:
* The desk is now a big dashboard on which you can pin three types of elements: calendars, charts and cards
1. Calendars are fetching events for all doctypes with a "Calendar view"
......
---
tags: ["update", "upgrade"]
---
# Mettre à jour dokos
La mise à jour de dokos est simple, mais peut demander des connaissance des Linux/Python/NodeJS en cas d'erreur.
## La commande principale
Allez dans votre dossier bench (`home/{utilisateur}/{votre_bench}) et lancez:
`bench update`
Cette commande effectuera les actions suivantes:
1. Mise à jour de vos applications avec la dernière version disponible sur Gitlab
2. Bascule de votre application en mode maintenance
3. Mise à jour de votre environnement python avec toute nouvelle dépendance requise
4. Lancement de tous les patches et migrations nécessaires à la mise à jour de votre base de données
5. Consolidation de tous vos fichiers javascript et CSS
6. Bascule de votre application en mode normal
## Commandes décomposées
- `bench update --pull` récupérera seulement les derniers changements pour chaque application
- `bench update --patch` lancera seulement les patches et migrations pour votre base de données
- `bench update --build` consolidera seulement vos fichiers JS et CSS nécessaires à l'interface utilisateur
- `bench update --bench` mettra à jour seulement l'application docli (Bench)
- `bench update --requirements` mettra à jour seulement les dépendances python et nodejs dans votre environnement
## Résolution des problèmes
Si un patch tombe en erreur lors d'une mise à jour, veuillez publier un message sur le [forum communautaire](https://community.dokos.io) avec une copie intégrale du message erreur. Attendez la correction, le cas échéant, et lancez de nouveau `bench update`.
Si vous avez des applications personnalisées dans votre dossier bench, veuillez vous assurer qu'elles n'interférent pas avec le processus de mise à jour standard.
Avant de rapporter un problème potentiel, veuillez tester la mise à jour à nouveau dans un environnement sans application personnalisée.
......@@ -8,7 +8,7 @@ tags: ["installation", "migration"]
- Il est recommandé de mettre à jour ERPNext vers la version v11.x.x ou v12.x.x avant de suivre ce guide
### Pré-requis
## Pré-requis
Votre environnement __bench__ doit fonctionner avec Python 3 (Python 3.6 minimum).
......@@ -21,9 +21,9 @@ dokos est incompatible avec Python 2.7
:::
### Passer sur dokos
## Passer sur dokos
#### Changez l'URL de dépôt et mettre à jour __bench__
### 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__
......@@ -46,7 +46,7 @@ git remote set-url origin https://gitlab.com/dokos/docli.git
git pull origin master
```
#### Changez l'URL dépôt par défaut de chaque application
### 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
......@@ -67,7 +67,7 @@ Les applications Frappe et ERPNext ne sont pas encore renommées en dodock et do
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
### 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
......@@ -82,7 +82,7 @@ frappe https://gitlab.com/dokos/dodock.git
erpnext https://gitlab.com/dokos/dokos.git
```
#### Mettre à jour l'application
### Mettre à jour l'application
- Depuis votre dossier bench - généralement `/home/frappe/frappe-bench` - lancez la commande suivante
......
......@@ -3,7 +3,7 @@
La v1.0.0 de dokos est basée sur Frappe/ERPNext v12.x.x
Vous trouverez ci-dessous les principales différences avec Frappe/ERPNext.
### dokos
## dokos
- Les domaines suivants ne sont pas présent dans dokos:
* Hospitalité
* Santé
......@@ -35,7 +35,7 @@ Vous trouverez ci-dessous les principales différences avec Frappe/ERPNext.
- Un nouveau type de document __Réservation d'articles__ permet d'ouvrir les réservations via votre portail pour vos clients.
- Refonte de la page __Profil (/me)__ du portail pour intégrer un module de mise à jour des méthodes de paiement (Seul Stripe est compatible pour l'instant)
### dodock [Modèle d'application]
## dodock [Modèle d'application]
- L'interface utilisateur a été améliorée avec quelques changements majeurs:
* Le bureau est désormais un grand tableau de bord sur lequel vous pouvez attacher trois types d'éléments: calendriers, graphiques et cartes
1. Les calendriers récupèrent les événements de tous les types de document avec une "vue calendrier"
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment