Mathieu Benoit
a2d3aa2a78
Added 30 .base.md files using the mmg (Multilingual Markdown Generator) format to automatically generate English (.md) and French (.fr.md) versions of all project documentation. Updated conf/make.documentation.Makefile to process all .base.md files via `make doc_markdown`.
11 KiB
Windows 10 version 2004 et plus ou 11 - publication et developpement
Un guide pour configurer un espace de travail et executer ERPLibre sur Windows 10 version 2004 et plus ou Windows 11. Il existe deux methodes d'installation, une automatique et l'autre manuelle.
"WSL2 Ubuntu 22.04" sera designe par "WSL2"
"PyCharm Professional" sera designe par "PyCharm"
Installer WSL2
Executez Powershell avec les droits administrateur et lancez la commande suivante :
wsl --install -d Ubuntu-22.04
Si vous avez des difficultes a ouvrir Powershell avec les droits administrateur, appuyez sur Windows + R, entrez la ligne suivante et appuyez sur OK. Les droits administrateur vous seront automatiquement demandes.
powershell.exe
Depannage - Optionnel
Si vous rencontrez des problemes, activez les options de virtualisation dans le BIOS si disponibles (hyper-v, vt-x, etc). Recherchez Activer ou desactiver des fonctionnalites Windows dans la barre de recherche Windows et assurez-vous que Sous-systeme Windows pour Linux est active avant de redemarrer votre machine.
Vous pouvez aussi essayer ces commandes powershell :
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2
Telechargez et installez le dernier package de mise a jour du noyau Linux de Microsoft avec le lien suivant :
https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
N'executez cette commande qu'en dernier recours car elle peut casser d'autres machines virtuelles :
bcdedit /set hypervisorlaunchtype auto
Autres methodes d'installation pour WSL2
Executez Powershell avec les droits administrateur et lancez la commande suivante :
curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004
Executez Powershell avec les droits administrateur et lancez les commandes suivantes :
Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing
Add-AppxPackage .\Ubuntu.appx
Installez WSL2 depuis le Microsoft Store avec le lien suivant :
https://apps.microsoft.com/store/detail/ubuntu-22041-lts/9PN20MSR04DW
Configurer WSL2 pour ERPLibre
Une fois WSL2 installe correctement, redemarrez votre ordinateur.
Vous pouvez ouvrir votre Ubuntu de plusieurs facons :
- Recherchez "Ubuntu" en cliquant sur la touche Windows
- Telechargez le Terminal Windows depuis le Microsoft Store
Si vous utilisez le Terminal Windows, vous n'avez qu'a cliquer sur la petite fleche a cote du signe + et vous verrez Ubuntu.
Configurer une interface graphique pour votre Ubuntu
- Mettre a jour votre Ubuntu
sudo apt-get update -y && sudo apt-get upgrade -y
- Installer le bureau XFCE4
sudo apt install -y xrdp xfce4 xfce4-goodies
- Configurer le bureau
sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
sudo sed -i 's/3389/3390/g' /etc/xrdp/xrdp.ini
sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
echo xfce4-session > ~/.xsession
- Configurer la connexion Bureau a distance
sudo nano /etc/xrdp/startwm.sh
Commentez ces lignes avec un #
test -x /etc/X11/Xsession && exec /etc/X11/Xsession
exec /bin/sh /etc/X11/Xsession
Ajoutez cette ligne a la fin du fichier
startxfce4
Quittez avec Ctrl+S, Ctrl+X
- Demarrer l'interface graphique du bureau Ubuntu
Ouvrez le terminal Ubuntu sur votre Windows et entrez cette commande
sudo /etc/init.d/xrdp start
Ensuite ouvrez Connexion Bureau a distance en cliquant sur la touche Windows et connectez-vous a localhost:3390
Memoire - Optionnel
Si WSL utilise trop de memoire, vous pouvez la reduire avec une etape simple. Il suffit d'aller dans C:\Users\VotreNomUtilisateur.wslconfig et de creer un fichier .wslconfig et d'ecrire :
sudo /etc/init.d/xrdp start
[wsl2]
memory=3GB
Installation des outils necessaires et a jour
sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev curl libbz2-dev rsync make git
Installation d'ERPLibre sous WSL2
Assurez-vous d'etre dans le repertoire ou vous souhaitez cloner le projet.
git clone https://github.com/ERPLibre/ERPLibre.git
cd ERPLibre
make install
Ajoutez un role a PostgreSQL, changez le champ USERNAME dans la commande avec votre nom d'utilisateur UNIX de votre environnement WSL2.
sudo service postgresql start
sudo su - postgres -c "createuser -s USERNAME" 2>/dev/null || true
Problemes courants lors de l'installation
Erreur lors de make install
Assurez-vous que toutes les dependances sont installees correctement. Relancez la commande suivante pour corriger les dependances cassees :
sudo apt-get install -f
PostgreSQL ne demarre pas
Verifiez le statut du service PostgreSQL avec la commande suivante :
sudo service postgresql status
Si PostgreSQL ne fonctionne pas, essayez de le redemarrer avec :
sudo service postgresql restart
Executer ERPLibre
A chaque redemarrage de votre machine, la commande suivante doit etre executee pour demarrer le service PostgreSQL s'il n'est pas deja en cours d'execution :
sudo service postgresql start
Ensuite lancez cette commande a la racine du projet :
./run.sh
Verification d'ERPLibre
Pendant qu'ERPLibre est en cours d'execution, assurez-vous que vous pouvez vous connecter a l'URL suivante http://localhost:8069 et que vous avez la possibilite de creer, modifier et supprimer des bases de donnees.
Configurer l'environnement de developpement - PyCharm
Installer PyCharm
Installez PyCharm depuis le lien suivant :
https://www.jetbrains.com/pycharm/download/#section=windows
Configurer Pycharm
Selectionnez Connect to WSL sous Remote Development. Ensuite selectionnez votre instance Ubuntu ("Ubuntu-22.04"). Pointez Project directory vers la racine du projet. Une fois que tout a ete selectionne et rempli correctement, cliquez sur Start IDE and Connect.
Appuyez sur CTRL+ALT+S, recherchez interpreter et dans la page Python Interpreter, cliquez sur Add Interpreter et selectionnez Add Local Interpreter....
Assurez-vous de selectionner Virtualenv Environment a gauche et le bouton radio Existing. Une fois les deux correctement selectionnes, pointez votre interpreteur vers le repertoire ../ERPLibre/.venv/bin/python du projet et cliquez sur OK.
Si ces dernieres etapes pour configurer votre environnement de developpement n'ont pas fonctionne, suivez les etapes "Manuelles" suivantes pour configurer votre environnement.
Installation manuelle
Installer Python 3.10.14
Vous pouvez supprimer les fichiers restants dans votre repertoire personnel concernant l'installation de Python une fois les etapes completees avec succes.
cd ~
wget https://www.python.org/ftp/python/3.10.14/Python-3.10.14.tgz
tar -xzf Python-3.10.14.tgz
cd Python-3.10.14
./configure --enable-optimizations
make -j $(nproc)
sudo make install
Verifier l'installation
python3.10
Definir Python 3.10.14 par defaut
alias python='/usr/local/bin/python3.10'
source ~/.bashrc
Configurer Pycharm
Ouvrez le repertoire du projet dans PyCharm.
Appuyez sur CTRL+ALT+S, recherchez interpreter et dans la page Python Interpreter, cliquez sur Add Interpreter et selectionnez On WSL....
Attendez que PyCharm detecte votre instance WSL2 et appuyez sur NEXT. Cliquez sur System Interpreter a gauche, selectionnez le bon interpreteur s'il ne l'a pas fait automatiquement et cliquez sur Create.
Fermez les parametres du projet. Lorsque PyCharm vous propose d'importer des modules, autorisez-le.
Problemes courants avec le developpement Windows
Terminal casse
Recherchez terminal dans les parametres, et sous Application Settings dans le champ Shell path: entrez la ligne suivante :
wsl.exe
Avertissements d'utilisation elevee de la memoire
Si vous constatez une utilisation elevee de la memoire, cliquez sur Help dans la barre d'outils et choisissez Change Memory Settings pour augmenter la memoire allouee a l'IDE.
Modules importes manquants ou incorrects
PyCharm peut ne pas reconnaitre completement certains details de requirements.txt et pyproject.toml (par exemple, des versions specifiques de modules). Si vous rencontrez des problemes a l'execution ou lors du debogage, recherchez la bonne version du module et reinstallez-le avec le gestionnaire de paquets de PyCharm.
Impossible d'executer ERPLibre depuis PyCharm
Si ERPLibre ne se lance pas depuis PyCharm, executez la commande suivante dans le repertoire racine du projet depuis le terminal de PyCharm ou WSL2 :
./script/ide/pycharm_configuration.py
Impossible de redemarrer ERPLibre
Lancez htop depuis le terminal de PyCharm ou WSL2 et fermez les processus Python lies a ERPLibre pour liberer le socket.
References
Installation de WSL Guide complet sur l'installation du Sous-systeme Windows pour Linux (WSL) sur Windows.
Documentation officielle de PostgreSQL Documentation officielle de PostgreSQL pour le depannage des problemes courants et pour en apprendre davantage sur les commandes et la configuration de PostgreSQL.
Installation et configuration de PyCharm Guide de demarrage rapide pour la configuration de PyCharm, incluant la gestion des modules Python et la configuration de l'environnement.
Depannage de WSL Guide de depannage pour les problemes courants rencontres avec WSL, fournissant des solutions pour divers problemes qui peuvent survenir.
Interface graphique Linux Instructions pour configurer une interface graphique (GUI) dans WSL, ce qui peut etre utile pour une meilleure integration des applications Linux.
Probleme de memoire Guide sur la gestion et la limitation de l'utilisation de la memoire dans WSL 2 pour eviter les problemes de consommation elevee de memoire.